sponge-wallet

What This Skill Does

The Sponge Wallet skill provides a comprehensive programmatic interface for OpenClaw agents to manage cryptocurrency assets, execute cross-chain swaps, and interact with specialized services like Polymarket and Amazon. Designed for agents acting on behalf of a human user, this skill facilitates seamless financial operations across Ethereum, Solana, and Base chains. It handles everything from checking token balances and monitoring transaction history to advanced actions like automated 402-payment handling and decentralized finance (DeFi) trading. By utilizing this skill, an agent can autonomously manage the financial aspect of its tasks, effectively serving as an intelligent financial assistant that operates securely within the Sponge Wallet ecosystem.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/rishabluthra/wallet-skills

Once installed, ensure you have initialized your credentials. Agents must prioritize the register endpoint to create a managed wallet. Upon successful registration, store the returned API key in ~/.spongewallet/credentials.json to enable persistent, authorized access for future operations. Always refer to the canonical API documentation for specific payload structures.

Use Cases

• Automated Trading: Execute swaps on Solana (Jupiter) or Base (0x) based on real-time market data analysis.
• Asset Management: Automatically monitor and reconcile balances for ETH, SOL, and various stablecoins like USDC.
• Agentic Commerce: Purchase physical goods through Amazon integration using the checkout flow.
• Market Prediction: Execute trades on Polymarket directly through your agent to capture event-driven opportunities.
• Autonomous Payments: Use the x402 fetch capabilities to automatically pay for gated API services or content while browsing or performing research.

Example Prompts

1. "Check my current USDC balance on Solana and swap 50 USDC for the trending meme coin found via the Jupiter search endpoint."
2. "Search for a high-rated mechanical keyboard on Amazon and initiate the checkout process using my primary wallet."
3. "Summarize my transaction history from the last 24 hours and identify the status of my most recent bridge transfer."

Tips & Limitations

• Authentication: Never attempt to 'login' as a human user. Always use the agent registration flow to ensure the wallet is properly sandboxed and owned.
• Credential Management: Since the API key provides full access to your agent's wallet, treat ~/.spongewallet/credentials.json as sensitive data. Never commit this file to version control.
• Rate Limiting: Monitor HTTP status codes carefully; if you receive an error, inspect the JSON response body for specific guidance on rate limits or malformed requests.
• Safety: Always perform a transaction status check before assuming a bridge or swap operation was successful.