my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

#1	{
#2	"skillId": "sponge-wallet",
#3	"name": "sponge-wallet",
#4	"description": "Crypto wallet, token swaps, cross-chain bridges, and access to paid external services (search, image gen, web scraping, AI, and more) via x402 payments.",
#5	"category": "wallet",
#6	"path": "sponge-wallet/SKILL.md",
#7	"url": "https://x402.wtf/api/skills/sponge-wallet",
#8	"tags": [
#9	"sponge",
#10	"solana",
#11	"wallet"
#12	],
#13	"requiredEnv": [
#14	"SPONGE_API_KEY"
#15	],
#16	"homepage": null,
#17	"attestation": {
#18	"status": "pending",
#19	"isFormallyVerified": false,
#20	"attestationPda": null,
#21	"verificationTimestamp": null
#22	},
#23	"markdown": "---\nname: sponge-wallet\nversion: 0.2.2\ndescription: Crypto wallet, token swaps, cross-chain bridges, and access to paid external services (search, image gen, web scraping, AI, and more) via x402 payments.\nhomepage: https://wallet.paysponge.com\nmetadata:\n openclaw:\n emoji: \"\\U0001F9FD\"\n category: finance\n primaryEnv: SPONGE_API_KEY\n requires:\n env:\n - SPONGE_API_KEY\n---\n\n# Sponge Wallet API — Agent Skills Guide (OpenClawd Edition)\n\nThis skill gives Clawd access to the Sponge Wallet REST API — a full crypto wallet\nwith swaps, bridges, trading, payments, banking, and paid external services.\n\n## Quick Start\n\n```bash\n# Base URL\nSPONGE_API_URL=\"https://api.wallet.paysponge.com\"\nSPONGE_API_KEY=\"sponge_live_...\" # set in .env or export\n\n# Required header on every request\n# Sponge-Version: 0.2.2\n# Authorization: Bearer $SPONGE_API_KEY\n# Content-Type: application/json\n```\n\n## What You Can Do\n\n1. Manage crypto — check balances, transfer tokens (EVM/Solana/Tempo), swap on Solana/Base/Ethereum/Polygon/Arbitrum/Tempo, bridge cross-chain\n2. Create payment links — generate reusable x402 payment URLs\n3. Access paid external services — search, image gen, web scraping, AI, data enrichment\n4. Banking — KYC onboarding, virtual bank accounts (receive USD as USDC), off-ramp to bank\n5. Trade — Polymarket prediction markets, Hyperliquid perpetuals\n6. Checkout — shop from online stores via URL checkout\n7. Store cards — encrypted card data for checkout, virtual cards, Sponge Card\n8. Fiat onramp — buy crypto with card/bank via Stripe or Coinbase\n\n## Top-Level API Reference\n\n```\nBase: https://api.wallet.paysponge.com\nAuth: Authorization: Bearer <SPONGE_API_KEY>\nVer: Sponge-Version: 0.2.2 (REQUIRED on every request)\n\nPaid services (search, image gen, scraping, AI, data, etc.):\n GET /api/discover -> find services by query/category\n GET /api/discover/:serviceId -> get endpoints, params, pricing\n POST /api/paid/fetch -> call service (auto-selects x402 or MPP)\n POST /api/x402/fetch -> call service (x402 USDC only)\n POST /api/mpp/fetch -> call service (MPP on Tempo)\n\nWallet & tokens:\n GET /api/balances -> get all balances\n POST /api/transfers/evm -> EVM transfer (ETH/USDC)\n POST /api/transfers/solana -> Solana transfer (SOL/USDC)\n POST /api/transfers/tempo -> Tempo transfer (pathUSD etc.)\n POST /api/transactions/swap -> Solana/EVM swap\n POST /api/transactions/base-swap -> Base swap\n POST /api/transactions/tempo-swap -> Tempo swap\n POST /api/transactions/bridge -> cross-chain bridge\n GET /api/solana/tokens -> list SPL tokens\n GET /api/solana/tokens/search -> search Jupiter token list\n GET /api/transactions/status/:txHash -> transaction status\n GET /api/transactions/history -> transaction history\n\nTrading:\n POST /api/polymarket -> Polymarket prediction markets\n POST /api/hyperliquid -> Hyperliquid perps/spot\n\nBanking:\n POST /api/bank/onboard -> start KYC\n GET /api/bank/status -> KYC status\n POST /api/bank/virtual-account -> create virtual bank account\n GET /api/bank/external-accounts -> list linked bank accounts\n POST /api/bank/external-accounts -> link bank account\n POST /api/bank/send -> off-ramp USD to bank\n\nCards & checkout:\n POST /api/cards -> fetch user's card\n POST /api/virtual-cards -> issue per-transaction virtual card\n POST /api/checkout -> URL checkout from online stores\n GET /api/checkout/:sessionId -> checkout status\n POST /api/credit-cards -> store encrypted card data\n POST /api/onramp/crypto -> fiat-to-crypto onramp link\n\nPlanning:\n POST /api/plans/submit -> submit multi-step plan\n POST /api/plans/approve -> approve and execute plan\n POST /api/trades/propose -> propose single swap\n```\n\n## Authentication\n\n### For AI Agents — Use `register`, NOT `login`\n\nRegister with agent-first mode to get an API key immediately:\n\n```bash\ncurl -sS -X POST \"https://api.wallet.paysponge.com/api/agents/register\" \\\n -H \"Sponge-Version: 0.2.2\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"name\":\"Clawd\",\"agentFirst\":true}'\n```\n\nReturns `apiKey` immediately in agent-first mode. Store it in `~/.spongewallet/credentials.json`.\n\n### Human Login (only for existing accounts)\n\n```bash\n# Step 1: Request device code\ncurl -sS -X POST \"https://api.wallet.paysponge.com/api/oauth/device/authorization\" \\\n -H \"Sponge-Version: 0.2.2\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"clientId\":\"spongewallet-skill\"}'\n\n# Step 2: Poll for token\ncurl -sS -X POST \"https://api.wallet.paysponge.com/api/oauth/device/token\" \\\n -H \"Sponge-Version: 0.2.2\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"grantType\":\"urn:ietf:params:oauth:grant-type:device_code\",\n \"deviceCode\":\"<deviceCode>\",\n \"clientId\":\"spongewallet-skill\"\n }'\n```\n\n### Standard Credential Storage\n\nStore credentials in `~/.spongewallet/credentials.json`:\n```json\n{\n \"apiKey\": \"sponge_live_...\",\n \"claimCode\": \"ABCD-1234\",\n \"claimUrl\": \"https://wallet.paysponge.com/device?code=ABCD-1234\"\n}\n```\n\n## Common Operations\n\n### Check Balances\n```bash\ncurl -sS \"https://api.wallet.paysponge.com/api/balances?chain=base\" \\\n -H \"Authorization: Bearer $SPONGE_API_KEY\" \\\n -H \"Sponge-Version: 0.2.2\"\n```\n\n### Transfer USDC on Base\n```bash\ncurl -sS -X POST \"https://api.wallet.paysponge.com/api/transfers/evm\" \\\n -H \"Authorization: Bearer $SPONGE_API_KEY\" \\\n -H \"Sponge-Version: 0.2.2\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"chain\":\"base\",\"to\":\"0x...\",\"amount\":\"10\",\"currency\":\"USDC\"}'\n```\n\n### Swap on Solana\n```bash\ncurl -sS -X POST \"https://api.wallet.paysponge.com/api/transactions/swap\" \\\n -H \"Authorization: Bearer $SPONGE_API_KEY\" \\\n -H \"Sponge-Version: 0.2.2\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"chain\":\"solana\",\"inputToken\":\"SOL\",\"outputToken\":\"USDC\",\"amount\":\"0.1\",\"slippageBps\":50}'\n```\n\n### Paid Services (3-Step Flow)\n\nStep 1 — Find a service:\n```bash\ncurl -sS \"https://api.wallet.paysponge.com/api/discover?query=web+scraping\" \\\n -H \"Authorization: Bearer $SPONGE_API_KEY\" \\\n -H \"Sponge-Version: 0.2.2\"\n```\n\nStep 2 — Get service details (DO NOT SKIP):\n```bash\ncurl -sS \"https://api.wallet.paysponge.com/api/discover/{serviceId}\" \\\n -H \"Authorization: Bearer $SPONGE_API_KEY\" \\\n -H \"Sponge-Version: 0.2.2\"\n```\n\nStep 3 — Call the endpoint:\n```bash\ncurl -sS -X POST \"https://api.wallet.paysponge.com/api/paid/fetch\" \\\n -H \"Authorization: Bearer $SPONGE_API_KEY\" \\\n -H \"Sponge-Version: 0.2.2\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"url\":\"<url_from_step2>\",\"method\":\"POST\",\"body\":{...},\"chain\":\"base\"}'\n```\n\n### Bridge USDC to Hyperliquid for Trading\n```bash\ncurl -sS -X POST \"https://api.wallet.paysponge.com/api/transactions/bridge\" \\\n -H \"Authorization: Bearer $SPONGE_API_KEY\" \\\n -H \"Sponge-Version: 0.2.2\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"sourceChain\":\"base\",\"destinationChain\":\"hyperliquid\",\"token\":\"USDC\",\"amount\":\"50\"}'\n```\n\n### Trade on Hyperliquid\n```bash\ncurl -sS -X POST \"https://api.wallet.paysponge.com/api/hyperliquid\" \\\n -H \"Authorization: Bearer $SPONGE_API_KEY\" \\\n -H \"Sponge-Version: 0.2.2\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"action\":\"order\",\"symbol\":\"ETH\",\"side\":\"buy\",\"type\":\"limit\",\"amount\":\"0.1\",\"price\":\"3000\"}'\n```\n\n## Chain Reference\n\nSupported chains: `ethereum`, `base`, `polygon`, `arbitrum-one`, `tempo`, `solana`\n\n## Error Handling\n\n\| Status \| Meaning \| Common Cause \|\n\|--------\|---------\|--------------\|\n\| 400 \| Bad Request \| Missing/invalid fields \|\n\| 401 \| Unauthorized \| Missing or invalid API key \|\n\| 403 \| Forbidden \| Permission denied \|\n\| 404 \| Not Found \| Resource does not exist \|\n\| 429 \| Rate Limited \| Too many requests \|\n\| 500 \| Server Error \| Transient; retry later \|\n\n## Security\n\n- Never share your API key in logs, posts, or screenshots\n- Store API key in environment variable `SPONGE_API_KEY`\n- Rotate the key if exposure is suspected\n- Use `sponge_test_` keys for development, `sponge_live_` for production\n\n## Integration with Clawd\n\nThe Sponge Wallet can be used by Clawd in two ways:\n\n1. Direct REST calls — use `fetch_url` tool or `curl` via shell to hit the Sponge API\n2. MCP Server — connect to `https://api.wallet.paysponge.com/mcp` with `Authorization: Bearer $SPONGE_API_KEY` header for structured tool access\n"
#24	}
#25

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public