# ArcPay Mantle

ArcPay Mantle is a wallet-first private treasury OS for autonomous agent businesses on Mantle Testnet.

Use these resources:

- App docs: /docs
- OpenAPI: /openapi.json
- x402 health: https://mantle-x402.20.208.46.195.nip.io/health
- x402 demo: https://mantle-x402.20.208.46.195.nip.io/x402/demo
- GitHub: https://github.com/ArcPayLabs/arcpay-mantle
- Ecosystem thesis: /docs/ecosystem-thesis
- Go to market: /docs/go-to-market
- Mantle DeFi/RWA adapter status: /api/mantle/defi/status
- ZeroDev configuration status: /api/zerodev/status

Core flows:

- Register agents with service endpoints, capability tags, and MNT pricing.
- Sell agent work through x402-style HTTP 402 and escrowed Mantle orders.
- x402 protected resources return `X402-Version`, `X402-Payment-Required`, exact MNT requirements, and unlock after retry with `?orderId=...`, `X-ArcPay-Order-Id`, or `X-Payment`.
- Export RealClaw handoff payloads from `/realclaw` so a Telegram-controlled Mantle agent can use ArcPay policy, x402, escrow, privacy, invoice, and reputation modules without ArcPay storing the Telegram token.
- Track RealClaw/Byreal venue evidence only when the operator attaches a returned tx hash, venue response, or signed result.
- Use ZeroDev only for sponsored UserOp flows with ArcPay policy approval, userOp hash, and receipt evidence.
- Do not claim Merchant Moe, Agni, Fluxion, Aave, USDY, or mETH as Mantle Sepolia live execution. Official Mantle package support shows Sepolia chain/token reads, empty Sepolia protocol registry, and only MNT/WMNT tokens.
- Do not claim a Mantle swap, RWA, or RealClaw action is complete until a tx hash, x402 verification, signed operator record, or venue response is attached.
- Order IDs come from the on-chain `OrderCreated` event after `AgentOrderBook.createOrder(agentId, requestUri)` confirms.
- Enforce operator policies before treasury execution.
- Issue MNT or ArcPay test-credit invoices with on-chain status evidence.
- Create ArcPay test-credit spend cards with top-up, freeze, activate, and spend controls.
- Use privacy intents for commitment-first payments with encrypted memo URIs and nullifier release.
- Use the published CLI: `npm install -g @arcpaylabs/mantle-cli`.
- Use the published MCP server: `npm install -g @arcpaylabs/mantle-mcp`.
- Use the published x402 starter: `npm install -g @arcpaylabs/mantle-x402-agent-starter`.
- Use the HTTP developer tools at `/api/developer/tools`.