# Contour Name Protocol

> Independent name infrastructure built for Arc Testnet. Read configuration from the manifest before making RPC calls.

## Machine-readable integration

- [Deployment manifest](/deployment-manifest.json): canonical chain, settlement, normalization, release, and contract metadata.
- [Well-known manifest](/.well-known/chain-name-service.json): stable manifest discovery alias.
- [Runtime discovery](/runtime-manifest.json): WSS-free HTTPS endpoints, manifest-declared capabilities, release evidence status, and live readiness URLs. Require readiness before execution.
- [OpenAPI](/api/openapi.json): recommended public HTTP routes and schemas.
- [Service status](/status): live registration, marketplace, permit issuer, and hosted MCP readiness checks.
- [Contour MCP](/api/mcp): hosted Streamable HTTP MCP endpoint.
- [ABI index](/abi): curated SDK ABI surfaces for supported protocol and settlement workflows.
- [Developer documentation](/developers): public SDK, workspace React, MCP, API, App Kit, and x402 integration.

## Read API

- GET /api/name/{label}: direct Arc registry, registrar, and resolver read.
- GET /api/reverse/{address}: forward-confirmed reverse read.
- GET /api/metadata/{tokenId}: application companion metadata for a registered name NFT.
- GET /api/image/{tokenId}: deterministic 1200x630 SVG for the same verified name snapshot.
- GET /api/account?owner={address}: owned names, credits, proceeds, and listings.
- GET /api/market: live fixed-price listings.
- GET /api/registration/readiness: registration contract, signer, controller, and pause readiness.
- GET /api/marketplace/readiness: marketplace contract, settlement, fee, and pause readiness.
- POST /api/registration/preflight: approval and wallet transaction plan.
- POST /api/registration/prepare: wallet-bound permit and registration calldata.

OpenAPI intentionally excludes internal verification, issuer-v1, compatibility, manifest, and MCP transport routes. Public response envelopes are route-specific: successful read routes generally include deployment context, while readiness and registration responses have their own shapes. CORS and cache headers are also route-specific. Integer token IDs and timestamps are decimal strings. Errors include an error value and may include a stable code and deployment context.

NFT metadata compatibility: the canonical V1 registrar does not implement ERC-721 Metadata or tokenURI. /api/metadata/{tokenId} and /api/image/{tokenId} are application companion endpoints for Contour display and sharing.

## Current deployment

- Chain: Arc Testnet (eip155:5042002)
- Namespace: .contour
- Manifest schema: 1.1.0
- Manifest SHA-256: 0x89465361d1eacb7f1f8eea2d50a93f6e6fe7c4c4a55345624ca16ef42ff665c2
- Release ID: 0x66aeb7b208fdfb6eb9f728a3d0b12d6d3b7132eb0e363b38f7c388c358edefdc
- Deployment state: active
- RPC: https://rpc.testnet.arc.network
- Explorer: https://testnet.arcscan.app
- Settlement: USDC at 0x3600000000000000000000000000000000000000

- registry: 0xdD69B92f6fAE6da3825b7d126Fe058e78E7F8482 (ABI: /abi/registry.json)
- baseRegistrar: 0x0DF136b94f99CAfcC010723b51f8D8EC10A0B907 (ABI: /abi/baseRegistrar.json)
- controller: 0xFbA7618c929075728b82c69B0B2A8C8d98e4B6A3 (ABI: /abi/controller.json)
- publicResolver: 0x3Ea097FFc2089a5Ae24DF46F18d621D007577f5C (ABI: /abi/publicResolver.json)
- reverseRegistrar: 0x5ecE3F5815813668307BdCe1405B5C765E526837 (ABI: /abi/reverseRegistrar.json)
- universalResolver: 0x3FAD66f9F3Ca165118D5b292Fa6036e273718Bf0 (ABI: /abi/universalResolver.json)
- marketplace: 0xD63f77a01De40b3964051bA03F4158cceFf1ca46 (ABI: /abi/marketplace.json)

## Public SDK and workspace packages

- Public npm package: contour-sdk (ESM; Node.js >=20.9 <25).
- Install: npm install contour-sdk viem
- Public exports include ARC_TESTNET, ArcNameClient, and fetchDeploymentManifest.
- Repository-only workspaces: @contour/config, @contour/normalization, @contour/react, and @contour/mcp.
- @contour/react provides TanStack Query hooks; @contour/mcp is the smaller stdio MCP server. Neither is part of the public SDK package.

## Hosted Contour MCP

Endpoint: /api/mcp

Resource: contour://runtime

Tools: normalize_label, get_name, reverse_lookup, get_account_names, get_market, prepare_registration_request, prepare_permit_request, prepare_approval, prepare_renewal, prepare_market_token_approval, prepare_market_token_approval_revoke, prepare_market_usdc_approval, prepare_market_listing, prepare_market_buy, prepare_market_cancel, prepare_claim_proceeds, prepare_claim_referral, prepare_transfer, prepare_market_invalidate.

prepare_registration_request and prepare_permit_request have identical schemas. They accept rawLabel, normalizationAccepted, account, durationYears, and an optional requestId, then return an unexecuted POST template for /api/registration/prepare. The permit-named tool is only a hosted compatibility alias. prepare_approval remains the backwards-compatible registration-controller allowance; use prepare_market_usdc_approval for purchases and prepare_market_token_approval for listing authorization. Cancel, approval revoke, liability claims, and stale-listing invalidation remain plannable while the marketplace is paused. get_account_names and get_market return structured snapshots without a formal outputSchema; the other seventeen hosted tools advertise output schemas.

The MCP has no private-key, signing, or broadcast tool. Reads and unsigned plans use the canonical Arc HTTPS RPC.

## Repository stdio MCP

Resource: contour://manifest

Tools: normalize_label, get_name, reverse_lookup, prepare_issuer_request, prepare_approval, prepare_renewal, prepare_market_token_approval, prepare_market_token_approval_revoke, prepare_market_usdc_approval, prepare_market_listing, prepare_market_buy, prepare_market_cancel, prepare_claim_proceeds, prepare_claim_referral, prepare_transfer, prepare_market_invalidate.

The stdio-only prepare_issuer_request accepts the complete issuer intent and returns separate issuer-v1 challenge and permit POST templates. It does not make either request or sign the wallet challenge. The hosted and stdio registration-helper schemas are intentionally different.

## Upstream Arc and Circle tooling

- Arc Docs MCP: https://docs.arc.io/mcp
- Arc Docs MCP setup: https://docs.arc.io/ai/mcp
- Circle App Kit: https://docs.arc.io/app-kit
- Circle App Kit installation: https://docs.arc.io/app-kit/tutorials/installation
- Circle x402 SDK reference: https://developers.circle.com/gateway/nanopayments/references/sdk
- Circle x402 concept: https://developers.circle.com/gateway/nanopayments/concepts/x402

## Attribution

Contour is an independent application built on Arc Testnet and is not sponsored or endorsed by Circle. Arc is a trademark of Circle Internet Group, Inc. and/or its affiliates.