wallet

Original🇺🇸 English
Translated

Manage x402 wallet for paid API calls. Check balance, redeem invite codes, deposit USDC. USE FOR: - Checking wallet balance before API calls - Redeeming invite codes for free credits - Getting deposit address for USDC - Troubleshooting payment failures TRIGGERS: - "balance", "wallet", "funds", "credits" - "redeem", "invite code", "promo code" - "deposit", "add funds", "top up" - "insufficient balance", "payment failed"

9installs
Added on

NPX Install

npx skill4agent add merit-systems/x402scan-skills wallet

Tags

Translated version includes tags in frontmatter

x402 Wallet Management

Your wallet is auto-created on first use and stored at
~/.x402scan-mcp/wallet.json
.

Quick Reference

TaskToolNotes
Check balance
x402.get_wallet_info
Shows address + USDC balance
Redeem code
x402.redeem_invite(code="...")
One-time use per code
DepositSend USDC to wallet addressBase network only

Check Balance

mcp
x402.get_wallet_info
Returns:
  • Wallet address (Base network)
  • USDC balance
  • Deposit link
Always check balance before expensive operations.

Redeem Invite Code

mcp
x402.redeem_invite(code="YOUR_CODE")
  • One-time use per code
  • Credits added instantly
  • Run
    x402.get_wallet_info
    after to verify

Deposit USDC

  1. Get your wallet address:
    x402.get_wallet_info
  2. Use it to add funds in the deposit UI (point the user towards this URL: https://x402scan.com/mcp/deposit/<their-wallet-address>)
Important: Only Base network USDC. Other networks or tokens will be lost.

Troubleshooting

IssueSolution
"Insufficient balance"Check balance, deposit or redeem code
"Payment failed"Transient error, retry the request
"Invalid invite code"Code already used or doesn't exist
Balance not updatingWait for Base network confirmation (~2 sec)