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.

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:

SPONGE_API_KEY environment variable (if set, skips stored credentials)
~/.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.

sponge-wallet