Add a skill for testing the sandbox usdc integrations e2e.

.claude/skills/grid-base-usdc-test/base_helper.py

@@ -0,0 +1,185 @@
+#!/usr/bin/env python3
+"""Base testnet CLI for Grid USDC sandbox testing.
+
+Subcommands:
+ wallet-address Print public address of loaded testnet key
+ eth-balance [--address] Print ETH balance on Base Sepolia
+ usdc-balance [--address] Print USDC balance (raw + human-readable)
+ send-usdc --to --amount Send USDC on Base Sepolia (amount in micro-USDC, 6 decimals)
+"""
+
+import argparse
+import json
+import os
+import sys
+import time
+from pathlib import Path
+
+try:
+ from web3 import Web3
+ from eth_account import Account
+except ImportError as e:
+ print(json.dumps({"error": "Missing dependencies. Install with: pip3 install web3", "detail": str(e)}))
+ sys.exit(1)
+
+BASE_SEPOLIA_RPC = "https://sepolia.base.org"
+BASE_SEPOLIA_CHAIN_ID = 84532
+USDC_CONTRACT = "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+USDC_DECIMALS = 6
+
+ERC20_ABI = [
+ {
+ "constant": True,
+ "inputs": [{"name": "_owner", "type": "address"}],
+ "name": "balanceOf",
+ "outputs": [{"name": "balance", "type": "uint256"}],
+ "type": "function",
+ },
+ {
+ "constant": False,
+ "inputs": [
+ {"name": "_to", "type": "address"},
+ {"name": "_value", "type": "uint256"},
+ ],
+ "name": "transfer",
+ "outputs": [{"name": "", "type": "bool"}],
+ "type": "function",
+ },
+]
+
+
+def load_account(creds_path=None):
+ creds_path = creds_path or os.path.expanduser("~/.grid-credentials")
+ with open(creds_path) as f:
+ creds = json.load(f)
+ private_key = creds.get("baseTestnetPrivateKey")
+ if not private_key:
+ print(json.dumps({"error": "baseTestnetPrivateKey not found in ~/.grid-credentials"}))
+ sys.exit(1)
+ if not private_key.startswith("0x"):
+ private_key = "0x" + private_key
+ return Account.from_key(private_key)
+
+
+def get_web3():
+ w3 = Web3(Web3.HTTPProvider(BASE_SEPOLIA_RPC))
+ if not w3.is_connected():
+ print(json.dumps({"error": "Failed to connect to Base Sepolia RPC", "rpc": BASE_SEPOLIA_RPC}))
+ sys.exit(1)
+ return w3
+
+
+def get_usdc_contract(w3):
+ return w3.eth.contract(address=Web3.to_checksum_address(USDC_CONTRACT), abi=ERC20_ABI)
+
+
+def cmd_wallet_address(args):
+ acct = load_account()
+ print(json.dumps({"address": acct.address}))
+
+
+def cmd_eth_balance(args):
+ w3 = get_web3()
+ if args.address:
+ address = Web3.to_checksum_address(args.address)
+ else:
+ acct = load_account()
+ address = acct.address
+ balance_wei = w3.eth.get_balance(address)
+ print(json.dumps({
+ "address": address,
+ "wei": balance_wei,
+ "eth": float(Web3.from_wei(balance_wei, "ether")),
+ }))
+
+
+def cmd_usdc_balance(args):
+ w3 = get_web3()
+ usdc = get_usdc_contract(w3)
+ if args.address:
+ address = Web3.to_checksum_address(args.address)
+ else:
+ acct = load_account()
+ address = acct.address
+ raw = usdc.functions.balanceOf(address).call()
+ print(json.dumps({
+ "address": address,
+ "contract": USDC_CONTRACT,
+ "raw": raw,
+ "amount": raw / (10 ** USDC_DECIMALS),
+ "ui_amount": f"{raw / (10 ** USDC_DECIMALS):.6f}",
+ }))
+
+
+def cmd_send_usdc(args):
+ acct = load_account()
+ w3 = get_web3()
+ usdc = get_usdc_contract(w3)
+ recipient = Web3.to_checksum_address(args.to)
+ amount = int(args.amount)
+
+ nonce = w3.eth.get_transaction_count(acct.address)
+
+ tx = usdc.functions.transfer(recipient, amount).build_transaction({
+ "chainId": BASE_SEPOLIA_CHAIN_ID,
+ "from": acct.address,
+ "nonce": nonce,
+ "gas": 100_000,
+ "maxFeePerGas": w3.eth.gas_price * 2,
+ "maxPriorityFeePerGas": w3.to_wei(0.001, "gwei"),
+ })
+
+ signed = acct.sign_transaction(tx)
+ tx_hash = w3.eth.send_raw_transaction(signed.raw_transaction)
+ tx_hash_hex = tx_hash.hex()
+
+ print(json.dumps({"status": "sent", "tx_hash": tx_hash_hex, "message": "Waiting for confirmation..."}))
+
+ for _ in range(60):
+ time.sleep(2)
+ try:
+ receipt = w3.eth.get_transaction_receipt(tx_hash)
+ if receipt is not None:
+ if receipt["status"] == 1:
+ print(json.dumps({"status": "confirmed", "tx_hash": tx_hash_hex, "block": receipt["blockNumber"]}))
+ return
+ else:
+ print(json.dumps({"status": "failed", "tx_hash": tx_hash_hex, "receipt_status": receipt["status"]}))
+ sys.exit(1)
+ except Exception:
+ pass
+
+ print(json.dumps({"status": "timeout", "tx_hash": tx_hash_hex, "message": "Transaction sent but confirmation timed out."}))
+ sys.exit(1)
+
+
+def main():
+ parser = argparse.ArgumentParser(description="Base Sepolia helper for Grid USDC sandbox testing")
+ sub = parser.add_subparsers(dest="command")
+ sub.required = True
+
+ sub.add_parser("wallet-address", help="Print public address of loaded testnet key")
+
+ eth_bal = sub.add_parser("eth-balance", help="Print ETH balance on Base Sepolia")
+ eth_bal.add_argument("--address", help="Address to check (default: own wallet)")
+
+ usdc_bal = sub.add_parser("usdc-balance", help="Print USDC balance on Base Sepolia")
+ usdc_bal.add_argument("--address", help="Address to check (default: own wallet)")
+
+ send = sub.add_parser("send-usdc", help="Send USDC on Base Sepolia")
+ send.add_argument("--to", required=True, help="Recipient address (0x...)")
+ send.add_argument("--amount", required=True, help="Amount in micro-USDC (6 decimals)")
+
+ args = parser.parse_args()
+
+ dispatch = {
+ "wallet-address": cmd_wallet_address,
+ "eth-balance": cmd_eth_balance,
+ "usdc-balance": cmd_usdc_balance,
+ "send-usdc": cmd_send_usdc,
+ }
+ dispatch[args.command](args)
+
+
+if __name__ == "__main__":
+ main()