@solid-money/cli

The Solid Agent Wallet CLI. Sign x402 payments with USDC on Base from the terminal using an API key issued by the Solid app — no passkey, no OAuth, no connect-wallet.

Install

npm install -g @solid-money/cli

Requires Node.js 20+.

Authenticate

1. Open the Solid app → Agent Wallet tab → Generate API key.

2. Copy the key (shown once). It starts with sk_solid_live_.

3. Run:

   solid login
   # paste your key when prompted

Alternatives:

# env var (recommended for CI / scripts)
export SOLID_API_KEY=sk_solid_live_…

# one-off
solid whoami --api-key sk_solid_live_…

The config file lives at ~/.config/solid/config.json (mode 600).

Commands

| Command | Purpose | | --- | --- | | solid login | Save an API key (interactive). | | solid logout | Remove the saved key. | | solid whoami | Print the agent wallet address tied to the current key. | | solid wallet list | List the agent wallet(s) bound to the current key. | | solid balance | Read USDC balance on Base for the agent wallet. | | solid probe <url> | Inspect a merchant's 402 challenge without paying. | | solid pay <url> | Discover, sign, and settle an x402 payment. | | solid config show | Show the active config (key redacted). | | solid config set <key> <value> | Set api-key or base-url. |

All commands accept --json for machine-readable output.

Detection (auth-check)

$ solid whoami
Agent wallet: 0xAbC…1234
Network:      Base mainnet (eip155:8453)
Asset:        USDC
Key:          sk_solid_live_…f9aA

$ solid wallet list --json
{
  "wallets": [
    {
      "name": "agent",
      "address": "0xAbC…1234",
      "network": "eip155:8453",
      "asset": "USDC"
    }
  ]
}

Exit code is non-zero (2) if the key is missing or rejected — useful for gating in scripts.

Transport (x402 pay)

# Default: probe the URL, show what's being paid, confirm, then sign + settle.
solid pay https://ai.fuse.io/api/fuse/stats --max-usdc 0.02

# Power-user: skip discovery, sign for an explicit recipient.
solid pay https://example.com/paid --max-usdc 0.10 \
  --recipient 0x… --skip-discovery

# POST with body and a custom header.
solid pay https://example.com/api/create --max-usdc 0.50 \
  -X POST -d '{"title":"hi"}' -H 'X-Project: demo'

# Machine output for piping.
solid pay https://example.com/data --max-usdc 0.01 -y --json | jq .merchant.body

--max-usdc is a dollar amount (decimal). The CLI converts it to atomic USDC units (6 decimals) before sending. The backend re-runs discovery and will reject the payment if the merchant's advertised price exceeds your cap, or if its payTo doesn't match the recipient the CLI authorized.

Example

End-to-end, paying the Fuse AI /api/fuse/stats endpoint ($0.01):

$ solid probe https://ai.fuse.io/api/fuse/stats
HTTP 402 from https://ai.fuse.io/api/fuse/stats
x402 version: 2
Advertised payment options:
  ✓ exact/eip155:8453 0x833…2913  →  $0.01 to 0xDef…cAfe

$ solid pay https://ai.fuse.io/api/fuse/stats --max-usdc 0.02
? Pay $0.01 to 0xDef…cAfe for GET https://ai.fuse.io/api/fuse/stats? › yes
Paid $0.01 to 0xDef…cAfe
Tx:       0xabc…
Settled:  2026-05-25T09:58:11.142Z
Merchant: HTTP 200

Response:
{"chainId":122,"latestBlock":…}

Notes

• Protocols & chains: x402 v2, exact scheme, USDC on Base mainnet (eip155:8453), EIP-3009 (transferWithAuthorization). The Coinbase CDP facilitator settles on the backend's behalf — the agent EOA never holds gas; only USDC float matters.
• MPP: not supported in v0.1. The Solid Agent Wallet signs x402 only.
• Balance probe: solid balance reads USDC on-chain directly via a single eth_call to mainnet.base.org. Override with --rpc-url or SOLID_BASE_RPC_URL if you hit rate limits.
• Funding the agent wallet: open Solid app → Agent Wallet → Deposit. The CLI cannot top up the wallet — that flow needs passkey signing.
• Key management: issue and revoke keys from the Agent Wallet tab. The CLI's API-key surface is intentionally narrow (/agents/me read-only + /agents/me/x402-pay write); a compromised CLI key cannot mint new keys, change the policy, or rotate the underlying EOA.

Environment variables

| Var | Purpose | | --- | --- | | SOLID_API_KEY | API key (overrides config file). | | SOLID_API_BASE_URL | API base (default: https://accounts.solid.xyz/accounts/v1). | | SOLID_BASE_RPC_URL | Custom Base RPC used by solid balance. | | XDG_CONFIG_HOME | Where the config dir lives (default: ~/.config). |

Building from source

git clone https://github.com/Solid-Money/solid-cli.git
cd solid-cli
npm install
npm run build
node dist/index.js --help