sponge-wallet

Sponge Wallet Skill

Multi-chain crypto wallet with transfers, swaps, and paid API access.

Authentication

IMPORTANT: If any tool returns "Not authenticated" or "Invalid API key", run the login flow.

Login is two-phase (because Claude Code runs commands non-interactively):

Phase 1 — Start the device flow (returns a URL and code as JSON):

node <skill-path>/scripts/wallet.mjs login

Show the verification_url and user_code to the user. Tell them to open the URL in their browser and enter the code.

Phase 2 — After the user confirms they have approved, poll for the token:

node <skill-path>/scripts/wallet.mjs login --poll <device_code> <interval> <expires_in>

Use the device_code, interval, and expires_in values from Phase 1 output.

Credentials are saved to ~/.spongewallet/credentials.json automatically.

Credential resolution order:

1. SPONGE_API_KEY environment variable (if set, skips stored credentials)
2. ~/.spongewallet/credentials.json (saved by login)

Other auth commands:

• node wallet.mjs whoami — show current auth status
• node wallet.mjs logout — remove stored credentials

How to Execute

node <skill-path>/scripts/wallet.mjs <tool_name> '<json_args>'

Output is JSON with status: "success" or status: "error".

Available Tools

Wallet & Balance

Tool	Description	Required	Optional
get_balance	Check balances across chains	—	chain
get_solana_tokens	Discover all SPL tokens in wallet	chain	—
search_solana_tokens	Search Jupiter token database	query	limit

Transfers

Tool	Description	Required	Optional
evm_transfer	Transfer ETH/USDC on Ethereum/Base	chain, to, amount, currency	—
solana_transfer	Transfer SOL/USDC on Solana	chain, to, amount, currency	—

Swaps

Tool	Description	Required	Optional
solana_swap	Swap tokens via Jupiter	chain, input_token, output_token, amount	slippage_bps

Transactions

Tool	Description	Required	Optional
get_transaction_status	Check tx status	transaction_hash, chain	—
get_transaction_history	View past transactions	—	limit, chain

Funding & Withdrawals

Tool	Description	Required	Optional
request_funding	Request funds from owner	amount, chain, currency	—
withdraw_to_main_wallet	Return funds to owner	chain, amount	currency

Paid APIs (Sponge x402)

Tool	Description	Required	Optional
sponge	Unified paid API interface	task	See REFERENCE.md
create_x402_payment	Create x402 payment payload	chain, to, amount	token, decimals

Chain Reference

Test keys (sponge_test_*): sepolia, base-sepolia, solana-devnet, tempo Live keys (sponge_live_*): ethereum, base, solana

Common Workflows

Check Balance → Transfer → Verify

node wallet.mjs get_balance '{"chain":"base"}'
node wallet.mjs evm_transfer '{"chain":"base","to":"0x...","amount":"10","currency":"USDC"}'
node wallet.mjs get_transaction_status '{"transaction_hash":"0x...","chain":"base"}'

Swap Tokens on Solana

node wallet.mjs search_solana_tokens '{"query":"BONK"}'
node wallet.mjs solana_swap '{"chain":"solana","input_token":"SOL","output_token":"BONK","amount":"0.5"}'

Sponge Paid APIs

node wallet.mjs sponge '{"task":"search","query":"AI research papers"}'
node wallet.mjs sponge '{"task":"image","prompt":"sunset over mountains"}'
node wallet.mjs sponge '{"task":"predict","semantic_search":"will-trump-win-2028"}'
node wallet.mjs sponge '{"task":"crawl","url":"https://example.com"}'
node wallet.mjs sponge '{"task":"parse","document_url":"https://example.com/doc.pdf"}'
node wallet.mjs sponge '{"task":"prospect","apollo_query":"Stripe","apollo_endpoint":"companies"}'

Error Handling

Error	Resolution
Not authenticated	Run node wallet.mjs login
Invalid API key	Run node wallet.mjs login to re-authenticate
Chain 'X' is not allowed	Use correct key type (test vs live) for the chain
Insufficient balance	Use request_funding
Address not in allowlist	Add recipient in the dashboard

See REFERENCE.md for detailed parameter docs.