spongewallet

CLI for creating, claiming, and using Sponge agent wallets from the terminal.

spongewallet is the terminal entrypoint for Sponge Wallet. It wraps the SDK CLI and exposes the common flows for onboarding, wallet operations, swaps, bridges, and paid API requests.

Install

Run it directly:

npx spongewallet --help

Or install it:

npm install -g spongewallet

Quickstart

Create an agent wallet:

npx spongewallet init

Restrict the later claim to one email:

npx spongewallet init --email [email protected]

Claim a pending agent or log in with device flow:

npx spongewallet login

Inspect the current session:

npx spongewallet whoami

Print MCP config for Claude Code or Cursor:

npx spongewallet mcp print

Core flow

1. init creates an agent immediately, prints addresses and MCP config, and stores pending claim metadata locally.
2. login claims that pending agent if claim metadata exists. Otherwise it falls back to normal device-flow authentication.
3. Use top-level commands like balance, send, history, tokens, and onramp for day-to-day operations.

Common commands

# Session
npx spongewallet init
npx spongewallet login
npx spongewallet whoami
npx spongewallet logout
npx spongewallet mcp print

# Wallets and transfers
npx spongewallet balance
npx spongewallet send base 0xabc... USDC 10
npx spongewallet history 20 --chain base

# Transactions, swaps, and bridges
npx spongewallet tx status base 0x123...
npx spongewallet swap quote SOL USDC 1
npx spongewallet swap tempo pathUSD USDC.e 1
npx spongewallet bridge base solana USDC 25

# Paid requests
npx spongewallet pay x402 --url https://api.example.com/premium
npx spongewallet pay mpp --url https://tempo.example.com/premium --chain tempo

Command groups

• init, login, logout, whoami, mcp: session setup and authentication
• balance, send, history, tokens, search-tokens, onramp, tx, swap, bridge, pay: balances, transfers, swaps, bridging, and payments
• keys, card, plan, trade, auth: stored secrets and approval flows
• market, advanced: venue-specific and low-level commands

Authentication

By default, the CLI uses Sponge device-flow authentication. After login, credentials are stored at:

~/.spongewallet/credentials.json

For non-interactive usage, set an API key:

export SPONGE_API_KEY=<agent-api-key>

What It Wraps

This package is a thin launcher around @paysponge/sdk. If you want the SDK and the CLI in one dependency, install:

npm install @paysponge/sdk

Docs

• CLI docs: https://docs.paysponge.com/cli
• Authentication: https://docs.paysponge.com/authentication
• Overview: https://docs.paysponge.com

Notes

This is early access software. Command surface and flows may still change.