wallet_skill

Overview

This skill manages an x402 wallet used for paid API calls. It lets you check USDC balance, redeem one-time invite codes for credits, and obtain the deposit address for adding funds on the Base network. Use it to avoid failed requests from insufficient funds and to troubleshoot basic payment issues.

How this skill works

The wallet is auto-created on first use and stored locally. The skill queries wallet info to return the Base network address, current USDC balance, and a deposit link. It can redeem invite codes once each to add credits instantly and provides guidance for depositing USDC to the wallet address.

When to use it

• Before expensive API calls to verify sufficient USDC balance
• When you have an invite or promo code to redeem for free credits
• To get the Base network deposit address or deposit link for adding funds
• If an API request fails due to 'insufficient balance' or 'payment failed'
• When balance changes seem delayed and you need confirmation

Best practices

• Always run a balance check (get_wallet_info) before initiating costly operations
• Only deposit USDC on the Base network; other networks or tokens are irreversible
• Redeem invite codes via redeem_invite and then recheck balance to confirm credit
• If a payment fails, retry after confirming balance and waiting a few seconds for network confirmation
• Store and back up your local wallet file securely if you need recovery

Example use cases

• Check wallet balance before sending a large batch of paid API requests
• Redeem a promo invite code to cover the cost of a single expensive operation
• Retrieve the deposit link/address to top up USDC from an exchange or wallet
• Diagnose a 'payment failed' error by confirming balance, retrying, and checking network confirmations