mutinynet-cli

What This Skill Does

The mutinynet-cli skill is an essential tool for developers and testers working within the Bitcoin Lightning Network ecosystem. It serves as an interface for the Mutinynet Bitcoin testnet faucet, enabling users to interact with testnet funds and lightning capabilities without needing to manage local node infrastructure from scratch. This skill allows you to programmatically request on-chain testnet bitcoin, handle lightning network payments, establish lightning channels, and generate BOLT11 invoices. By abstracting away the complex command-line interactions, it provides a seamless way to verify protocol integrations, test wallet logic, and ensure that your lightning applications behave as expected under testnet conditions.

Installation

To install this skill into your OpenClaw agent, execute the following command in your terminal:

clawhub install openclaw/skills/skills/benthecarman/mutinynet-cli

Ensure that you have cargo and the Rust toolchain installed, as the underlying binary relies on the mutinynet-cli package. Once installed, ensure you perform the initial setup by running the login command. You will need a GitHub account to authenticate via the device flow, which grants the agent the necessary authorization to interact with the faucet's services securely.

Use Cases

• Development & Testing: Validate lightning invoice payment flows in your dApp or wallet without risking mainnet funds.
• Channel Management: Automate the opening of testnet lightning channels between your node and the faucet to establish connectivity and routing paths.
• Liquidity Provisioning: Rapidly fund testnet wallets or nodes that need immediate on-chain capacity to perform lightning operations.
• Protocol Verification: Test how your application handles different invoice types, including LNURL, lightning addresses, and standard BOLT11 invoices.

Example Prompts

1. "I need to test my new wallet app. Can you send 20,000 sats to my testnet address tb1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsx using the mutinynet-cli?"
2. "Generate a BOLT11 invoice for 5,000 sats so I can test receiving payments in my application."
3. "Open a lightning channel to my node with public key 02abc...def using 100,000 sats from the Mutinynet faucet."

Tips & Limitations

• Authentication: Always remember that the CLI requires a token stored in ~/.mutinynet/token. If you receive authentication errors, rerun the mutinynet-cli login command.
• Environment Variables: You can override the default faucet URL by setting the MUTINYNET_FAUCET_URL environment variable if you are using a custom instance of the faucet.
• On-chain Defaults: The default on-chain transaction amount is 10,000 sats. If you require a different amount, always specify it as the second argument in your command.
• Network Dependency: Because this interacts with the Mutinynet testnet, ensure your local node is correctly synced to the signet/testnet chain to avoid channel synchronization issues.