Pro Rout · Developer guide

Reference

Pro Rout: account contracts, local MCP tools and the local x402 wire contract.

Account contracts

Pro Rout account operations keep invited Human profile and draft saves, plus existing records and downloads. Current sign-in is email-only. X, GitHub and Google linking and Solana wallet sign-in are still being built.

Agent names, profiles and publication have a separate, default-off rollout. Those interfaces do not establish production reservations until the migration, restore and hosted acceptance gates pass. NFT holder authority and swapping are not implemented by the account schemas.

The generated reference below is derived from the strict account workspace schemas. It describes their shapes, not current admission or partner access.

Generated contracts

These are private application request bodies. They do not establish external partner credentials or access.

Expand workspace preference save schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "fields": {
      "type": "object",
      "properties": {
        "communityId": {
          "type": "string",
          "enum": [
            "atlas",
            "forge",
            "orbit",
            "lumen",
            "grove"
          ]
        }
      },
      "required": [
        "communityId"
      ],
      "additionalProperties": false
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483646
    }
  },
  "required": [
    "fields",
    "expectedRevision"
  ],
  "additionalProperties": false
}

Expand public profile save schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "fields": {
      "type": "object",
      "properties": {
        "displayName": {
          "type": "string",
          "minLength": 1,
          "maxLength": 48
        },
        "bio": {
          "type": "string",
          "maxLength": 280
        },
        "accent": {
          "type": "string",
          "enum": [
            "mint",
            "lilac",
            "sand"
          ]
        },
        "cover": {
          "type": "string",
          "enum": [
            "infinity",
            "layers",
            "aperture"
          ]
        }
      },
      "required": [
        "displayName",
        "bio",
        "accent",
        "cover"
      ],
      "additionalProperties": false
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483646
    }
  },
  "required": [
    "fields",
    "expectedRevision"
  ],
  "additionalProperties": false
}

Local MCP tools

Tool	Input	Effect
pro_route_capabilities	Empty object	Reports available and disabled capabilities
pro_route_search_docs	query, optional product	Searches reviewed public text locally
pro_route_read_doc	product, section	Returns one approved guide
pro_route_handoff_guide	Empty object	Returns fixed destinations and boundaries

All tools are read-only or pure validation. Unknown fields are rejected. No tool accepts credentials, an account ID, arbitrary URLs, filesystem paths or a command to run.

Error handling

Private workspace writes use an expected revision. A stale write returns a conflict: keep the user's input and explicitly reload before replacing saved work. A network error never silently substitutes sample data. Sign-out and identity changes clear private UI state.

Local report wire contract

Preview only: this contract belongs to the loopback x402 sandbox. No matching production route or hosted tool exists.

POST a JSON report request to http://127.0.0.1:4402/reports/collection-configuration with Content-Type: application/json, Authorization: Bearer sandbox-demo-only (a public local fixture, not a credential) and an Idempotency-Key of 1–64 letters, digits, hyphens or underscores. The maximum body is 16 KiB and unknown fields are rejected. The package README and src/demo.ts contain a complete request.

Header	Meaning
PAYMENT-REQUIRED	Base64 JSON x402 v2 challenge; custom scheme pro-route-sandbox.
PAYMENT-SIGNATURE	Base64 JSON mock approval; no wallet signature is accepted.
PAYMENT-RESPONSE	Base64 JSON mock settlement receipt; mock: identifiers only.

The report includes a canonical SHA-256 digest, the validated configuration and its limitations. It explains the supplied input; it does not inspect a chain, verify ownership or audit a contract. The codec is the pinned official @x402/core package; the mock payload is validated separately.

Next: Troubleshooting

Search documentation