wallet.sh

The agent-native wallet.

Zero accounts. One key. Infinite payments.

$ curl -fsSL https://wallet.prim.sh/install.sh | sh

Base USDC

Multi-wallet

Owner funding

llms.txt ● Mainnet

MCPToolsCLIRESTSDK

What agents use it for

Service payments

Pay for spawn, relay, infer, and other primitives without human API keys. The wallet is the identity and the payment source.

Autonomous budgeting

Give agents their own wallets with limits. Let them decide when to spend on computation, storage, or data.

Multi-primitive flows

Spawn compute, call models, store artifacts, and ship goods — all from the same wallet address.

Owner funding

Humans top up wallets in fiat or crypto. Agents spend via x402 without touching custody or keys.

API reference

# Wallet management
POST   /v1/wallets                    # Register wallet (free, EIP-191 sig)
GET    /v1/wallets                    # List wallets
GET    /v1/wallets/:address           # Wallet details + balance
DELETE /v1/wallets/:address           # Deactivate wallet (irreversible)

# Funding
POST   /v1/wallets/:address/fund-request   # Request USDC funding
GET    /v1/wallets/:address/fund-requests  # List fund requests
POST   /v1/fund-requests/:id/approve       # Approve request
POST   /v1/fund-requests/:id/deny          # Deny request

# Policy + control
GET    /v1/wallets/:address/policy    # Get spending policy
PUT    /v1/wallets/:address/policy    # Update spending policy
POST   /v1/wallets/:address/pause     # Pause wallet
POST   /v1/wallets/:address/resume    # Resume wallet

Quick start

1POST /v1/wallets with EIP-191 signature → register wallet (free)
2POST faucet.prim.sh/v1/faucet/usdc → get 10 test USDC
3Call any paid endpoint → receive 402 → sign payment → resend

Tips

Wallet registration is free — no x402 payment required.
The signed message must be: Register <address> with prim.sh at <timestamp>
Timestamp must be within 5 minutes of server time (ISO 8601 UTC).
Use @x402/fetch or any x402-compatible client to handle payments automatically.
Pause a wallet to temporarily block spending without deactivating it.

Ownership

All resources scoped to the wallet address extracted from the x402 payment signature. Wallet registration uses EIP-191 signature for ownership proof.

Action	Cost	Notes
Wallet registration	free	Self-hosted keystore
API call	$0.001	x402 floor (self-hosted)
Policy update	$0.005	x402 floor (self-hosted)