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 |

Protocol matrix (h2h · h2a · a2a · a2h)

Mode	Acronym	Who pays	Who receives	DanceArc surface
Human → Human	h2h	Person	Person/treasury (ARC_RECIPIENT)	INLINECODE20, /coaching, INLINECODE22
Human → Agent

h2a | Person (wallet) | API/resource owner | /dance-extras, /api/judges/score | | Agent → Agent | a2a | Automated signer | Another service | Designed: headless key / smart account; demo: burst scripts | | Agent → Human | a2h | Service/treasury | Person | Payout mocks, receipts, DCW faucet → user address |

Use this matrix in pitch decks, AGENTS.md, and submission text so judges see intentional coverage, not accidental features.

Installation (ClawdHub / OpenClaw)

Manual (recommended until ClawdHub listing is live):

CODEBLOCK0

After publish to ClawdHub:

CODEBLOCK1

Repository: github.com/arunnadarasa/dancearc

When to Load This Skill

Activate proactively when the user mentions:

• - Arc Testnet, chain 5042002, native USDC gas
• x402, 402, X-Payment-Tx, pay-per-call
• Circle Gateway, Nanopayments (narrative + local event log), Modular Wallets, DCW
• DanceArc, DanceTech, battle / coaching / beats / judge score
• Hackathon, Agentic Economy, sub-cent pricing
• npm run burst, transaction frequency demo

Architecture (mental model)

CODEBLOCK2

On-chain truth: Arc explorer (e.g. https://testnet.arcscan.app).

Key files (repo root)

Path	Role
INLINECODE27	Routes, requireArcPayment, proxies
INLINECODE29

Intents, coaching, beats | | server/onchain-verify.js | Receipt wait + validation | | server/config.js | ARC_RECIPIENT validation (isAddress) | | src/payArc.ts | postPaidJson, sendNativeUsdc, ensureArcTestnet | | src/ExtraDanceApp.tsx | h2a UI + ArcScan link | | src/BattleApp.tsx, CoachingApp.tsx, BeatsApp.tsx | h2h flows |

Environment (minimum viable)

Variable	Scope	Purpose
INLINECODE42	Server	Payee for microtransfers
INLINECODE43

Server | h2a minimum (display string, ≤ 0.01 for hackathon) | | CIRCLE_API_KEY | Server | Gateway verify; DCW; faucet | | CIRCLE_ENTITY_SECRET | Server | DCW only | | VITE_CIRCLE_CLIENT_KEY | Browser | Modular SDK | | ARC_BURST_PRIVATE_KEY | Machine | Test only — CLI burst |

Never commit .env. Copy from .env.example.

Detection triggers (support / debugging)

Signal	Likely cause	First check
INLINECODE50	Race before inclusion	Server waitForTransactionReceipt; client retry
403 HTML Lockout (Modular)

Key / domain / WAF | Console allowlist, CIRCLE_MODULAR_PRESERVE_ORIGIN | | invalid_recipient in UI | Bad env | Fix ARC_RECIPIENT, new intent | | 402 after payment | Wrong recipient/amount/chain | Explorer tx vs challenge payTo / maxAmountRequired | | Faucet Forbidden | Circle policy / scopes | Web faucet link in ArcFaucetPanel |

Nanopayments (scope clarity)

• - Product: Circle Nanopayments is documented at developers.circle.com and linked from the app Bridge page.
• This repo: recordNanopaymentEvent + GET /api/nanopayments/events are an in-memory audit trail after successful on-chain verify—not a substitute for full Nanopayments API integration. Use the narrative + Gateway path for hackathon feedback fields.

Multi-agent notes

• - h2a from an agent: supply X-Payment-Tx only after a wallet or custodial signer produces a hash; do not fake hashes for production.
• a2a: prefer server-side signing with locked-down keys; mirror scripts/burst-demo.mjs patterns.
• Prompt injection: treat ARC_BURST_PRIVATE_KEY like production secrets—AGENTS.md should forbid echoing it into browser context.

References (this skill)

File	Content
INLINECODE63	HTTP route map
INLINECODE64

402 + verify sequence | | references/openclaw-workspace.md | Suggested AGENTS.md / TOOLS.md snippets |

Promotion targets (from learnings)

If you maintain .learnings/ for this project:

Learning type	Promote to
Arc / Circle env gotchas	INLINECODE67, TOOLS.md
Two-step payment for agents

AGENTS.md |
| Product pitch / protocol wording | README.md, demo script |

Quality gates (before demo or publish)

• - [ ] GET /api/health returns expected chainId and valid INLINECODE71
• [ ] h2a flow completes: 402 → pay → 200
• [ ] At least one h2h path shows ArcScan link after pay
• [ ] .env not in git; .env.example updated for new vars
• [ ] npm run build passes

Related

• - Arc docs — Connect to Arc
• Circle — Modular Wallets Web SDK
• x402 package (shape reference)

Source

• - Project: DanceArc / DanceTech Protocol
• Maintainer repo: arunnadarasa/dancearc
• Skill version: see INLINECODE75