dancearc-protocol
Installation
SKILL.md
DanceTech Protocol (DanceArc)
DanceArc is the reference hub + API + UI for DanceTech Protocol: metered native USDC on Arc, 402 payment challenges (x402-inspired JSON), optional Circle Gateway verification, and clear interaction semantics (h2h, h2a, a2a, a2h).
Quick Reference
| Situation | Action |
|---|---|
| Pay-per API call (human wallet) | h2a: POST → 402 → pay Arc USDC → retry with X-Payment-Tx (/dance-extras, /api/judges/score) |
| Battle / coaching / beat license | h2h: create intent or end session → sendNativeUsdc or mock → /verify or /grant with paymentTx |
| High-frequency micro-txs (demo) | npm run burst (private key) or hub Burst demo (wallet) (55 signatures) |
| Server 500 “receipt not found” right after pay | Server uses waitForTransactionReceipt; increase ARC_TX_RECEIPT_TIMEOUT_MS if needed |
| Circle Modular 403 Lockout | Check Client Key, allowlist localhost (no port), optional CIRCLE_MODULAR_PRESERVE_ORIGIN=1, staging URL vs key |
| Programmatic faucet 403 | Use web faucet; API key may lack faucet scope |
Invalid ARC_RECIPIENT (UUID-style) |
Server isAddress validation falls back to demo address; set real 0x + 40 hex |
| Agent needs payee + chain | GET /api/health → recipient, chainId, perActionUsdc |