sponge-wallet

name	sponge-wallet
description	Manages crypto wallets, transfers tokens, swaps on DEXes, checks balances, and accesses paid APIs (search, image gen, prediction markets, web scraping, document parsing, sales prospecting) via x402 micropayments. Use when the user asks about wallet balances, token transfers, swaps, blockchain payments, or paid API services.

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.