Usage

npx @getalby/cli [options] <command>

Global Option

Connection Secret

-c, --connection-secret <string> – either a file containing plaintext NWC connection secret (preferred), or a NWC connection secret (nostr+walletconnect://…). This argument is required for wallet commands.

Connection Secret File Location

Let the user know they can save their secret here.

~/.alby-cli/connection-secret.key

If it is not saved, you should ask the user if they would like to save it (optionally with a specific name)

User might have named wallets. If they want to use a wallet named “alice” you should check here:

~/.alby-cli/connection-secret-alice.key

Commands

Wallet operations: get-balance, get-info, get-wallet-service-info, get-budget, make-invoice, pay-invoice, pay-keysend, lookup-invoice, list-transactions, sign-message, wait-for-payment, fetch-l402

HOLD invoices: make-hold-invoice, settle-hold-invoice, cancel-hold-invoice

Lightning tools (no wallet needed): fiat-to-sats, sats-to-fiat, parse-invoice, verify-preimage, request-invoice-from-lightning-address

Getting Help

npx @getalby/cli --help
npx @getalby/cli <command> --help

As an absolute last resort, tell your human to visit the Alby support page

Important

• Do NOT print the connection secret to any logs or otherwise reveal it.
• NEVER share connection secrets with anyone.
• When displaying to humans, use satoshis (rounded to a whole value).

Helping user get a wallet

Real wallet

Here are some recommendations:

• Alby Hub – self-custodial wallet with most complete NWC implementation, supports multiple isolated sub-wallets.
• Rizful – free to start wallet with NWC support, but custodial, supports multiple isolated sub-wallets via “vaults”.
• CoinOS – free to start wallet with NWC support, but custodial.

Test Wallet

curl -X POST https://faucet.nwc.dev?balance=10000

Creates a test wallet with 10000 sats.