| 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 <address> [sats]
Examples:
mutinynet-cli onchain tb1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsxmutinynet-cli onchain tb1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsx 50000
Pay a lightning invoice
Pay a lightning invoice. Accepts bolt11 invoices, LNURL, lightning addresses, and nostr npubs.
mutinynet-cli lightning <invoice>
Examples:
mutinynet-cli lightning lnbc1...mutinynet-cli lightning user@walletofsatoshi.com
Open a lightning channel
Open a lightning channel from the faucet node to your node.
mutinynet-cli channel <pubkey> <capacity> [--push-amount <sats>] [--host <host:port>]
Examples:
mutinynet-cli channel 02abc...def 100000mutinynet-cli channel 02abc...def 100000 --push-amount 50000 --host localhost:9735
Generate 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 bolt11
Configuration
| Option | Environment Variable | Default |
|---|
--url | MUTINYNET_FAUCET_URL | https://faucet.mutinynet.com |
--token | MUTINYNET_FAUCET_TOKEN | Loaded from ~/.mutinynet/token |
Common workflows
- First time setup: Run
mutinynet-cli login to authenticate with GitHub.
- Fund a wallet: Use
mutinynet-cli onchain <address> to receive testnet sats.
- Test lightning: Use
mutinynet-cli lightning <invoice> to pay or mutinynet-cli bolt11 <amount> to receive.
