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:
CODEBLOCK0
Commands
Login
Authenticate with GitHub via device flow. Required before using commands that need a token.
CODEBLOCK1
Send on-chain bitcoin
Send testnet bitcoin to an address. Default amount is 10,000 sats. Accepts Bitcoin addresses or BIP21 URIs.
CODEBLOCK2
Examples:
Pay a lightning invoice
Pay a lightning invoice. Accepts bolt11 invoices, LNURL, lightning addresses, and nostr npubs.
CODEBLOCK3
Examples:
Open a lightning channel
Open a lightning channel from the faucet node to your node.
CODEBLOCK4
Examples:
Generate a bolt11 invoice
Generate a bolt11 invoice from the faucet node. Omit amount for a zero-amount invoice.
CODEBLOCK5
Examples:
Configuration
| Option | Environment Variable | Default |
|---|
| INLINECODE8 | INLINECODE9 | INLINECODE10 |
| INLINECODE11 |
MUTINYNET_FAUCET_TOKEN | Loaded from
~/.mutinynet/token |
Common workflows
- 1. 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.
Mutinynet 水龙头 CLI
用于与 Mutinynet 比特币测试网水龙头交互的 CLI 工具。
安装
从 GitHub Releases 下载预构建二进制文件，或从源码安装：
bash
cargo install mutinynet-cli
命令
登录
通过设备流使用 GitHub 进行身份验证。使用需要令牌的命令前必须执行此操作。
bash
mutinynet-cli login
发送链上比特币
向地址发送测试网比特币。默认金额为 10,000 聪。接受比特币地址或 BIP21 URI。
bash
mutinynet-cli onchain <地址> [聪数]
示例：
- - mutinynet-cli onchain tb1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsx
- mutinynet-cli onchain tb1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsx 50000
支付闪电发票
支付闪电发票。接受 bolt11 发票、LNURL、闪电地址和 nostr npubs。
bash
mutinynet-cli lightning <发票>
示例：
- - mutinynet-cli lightning lnbc1...
- mutinynet-cli lightning user@walletofsatoshi.com
开启闪电通道
从水龙头节点向您的节点开启闪电通道。
bash
mutinynet-cli channel <公钥> <容量> [--push-amount <聪数>] [--host <主机:端口>]
示例：
- - mutinynet-cli channel 02abc...def 100000
- mutinynet-cli channel 02abc...def 100000 --push-amount 50000 --host localhost:9735
生成 bolt11 发票
从水龙头节点生成 bolt11 发票。省略金额可生成零金额发票。
bash
mutinynet-cli bolt11 [金额]
示例：
- - mutinynet-cli bolt11 5000
- mutinynet-cli bolt11
配置
| 选项 | 环境变量 | 默认值 |
|---|
| --url | MUTINYNETFAUCETURL | https://faucet.mutinynet.com |
| --token |
MUTINYNET
FAUCETTOKEN | 从 ~/.mutinynet/token 加载 |
常见工作流程
- 1. 首次设置：运行 mutinynet-cli login 使用 GitHub 进行身份验证。
- 充值钱包：使用 mutinynet-cli onchain <地址> 接收测试网聪。
- 测试闪电网络：使用 mutinynet-cli lightning <发票> 支付，或使用 mutinynet-cli bolt11 <金额> 接收。
