Mutinynet CLI
by @benthecarman
Interact with the Mutinynet Bitcoin testnet faucet. Get testnet bitcoin on-chain, pay lightning invoices, open lightning channels, and generate bolt11 invoic...
clawhub install mutinynet-cliπ About This Skill
name: mutinynet-cli description: Interact with the Mutinynet Bitcoin testnet faucet. Get testnet bitcoin on-chain, pay lightning invoices, open lightning channels, and generate bolt11 invoices. Use when the user needs signet/testnet bitcoin, wants to test lightning payments, or mentions Mutinynet. compatibility: Requires cargo (Rust toolchain) for installation and network access to faucet.mutinynet.com metadata: author: benthecarman version: "0.1.1" repository: https://github.com/benthecarman/mutinynet-cli license: MIT allowed-tools: Bash(mutinynet-cli:*)
Mutinynet Faucet CLI
A CLI tool for interacting with the Mutinynet Bitcoin testnet faucet.
Install
Download a prebuilt binary from GitHub Releases, or install from source:
cargo install mutinynet-cli
Commands
Login
Authenticate with GitHub via device flow. Required before using commands that need a token.
mutinynet-cli login
Send on-chain bitcoin
Send testnet bitcoin to an address. Default amount is 10,000 sats. Accepts Bitcoin addresses or BIP21 URIs.
mutinynet-cli onchain [sats]
Examples:
mutinynet-cli onchain tb1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsxmutinynet-cli onchain tb1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsx 50000Pay a lightning invoice
Pay a lightning invoice. Accepts bolt11 invoices, LNURL, lightning addresses, and nostr npubs.
mutinynet-cli lightning
Examples:
mutinynet-cli lightning lnbc1...mutinynet-cli lightning user@walletofsatoshi.comOpen a lightning channel
Open a lightning channel from the faucet node to your node.
mutinynet-cli channel [--push-amount ] [--host ]
Examples:
mutinynet-cli channel 02abc...def 100000mutinynet-cli channel 02abc...def 100000 --push-amount 50000 --host localhost:9735Generate a bolt11 invoice
Generate a bolt11 invoice from the faucet node. Omit amount for a zero-amount invoice.
mutinynet-cli bolt11 [amount]
Examples:
mutinynet-cli bolt11 5000mutinynet-cli bolt11Configuration
| Option | Environment Variable | Default |
|-----------|--------------------------|--------------------------------|
| --url | MUTINYNET_FAUCET_URL | https://faucet.mutinynet.com |
| --token | MUTINYNET_FAUCET_TOKEN | Loaded from ~/.mutinynet/token |
Common workflows
1. First time setup: Run mutinynet-cli login to authenticate with GitHub.
2. Fund a wallet: Use mutinynet-cli onchain to receive testnet sats.
3. Test lightning: Use mutinynet-cli lightning to pay or mutinynet-cli bolt11 to receive.
βοΈ Configuration
| Option | Environment Variable | Default |
|-----------|--------------------------|--------------------------------|
| --url | MUTINYNET_FAUCET_URL | https://faucet.mutinynet.com |
| --token | MUTINYNET_FAUCET_TOKEN | Loaded from ~/.mutinynet/token |