# AxonGate

Name: AxonGate
Basename: axongate.base.eth
Summary: x402-paid Clean Context Broker that converts public web pages into clean markdown for RAG, research, and autonomous agents.
Canonical base URL: https://web-production-8136ee.up.railway.app
Human docs: https://web-production-8136ee.up.railway.app/docs
Operator dashboard: https://web-production-8136ee.up.railway.app/operator
Quickstart: https://web-production-8136ee.up.railway.app/quickstart
Paid smoke test guide: https://web-production-8136ee.up.railway.app/paid-test
Interactive demo: https://web-production-8136ee.up.railway.app/demo
OpenAPI JSON: https://web-production-8136ee.up.railway.app/openapi.json
Swagger UI: https://web-production-8136ee.up.railway.app/swagger
Manifest: https://web-production-8136ee.up.railway.app/manifest.json
Agent card: https://web-production-8136ee.up.railway.app/.well-known/agent.json
Agent card alias: https://web-production-8136ee.up.railway.app/.well-known/agent-card.json
x402 discovery: https://web-production-8136ee.up.railway.app/.well-known/x402
x402 JSON alias: https://web-production-8136ee.up.railway.app/.well-known/x402.json
Resource listing: https://web-production-8136ee.up.railway.app/discovery/resources
Sitemap: https://web-production-8136ee.up.railway.app/sitemap.xml
Python client example: https://github.com/sauliusbeconis/AxonGate/blob/main/examples/python_client.py
cURL examples: https://github.com/sauliusbeconis/AxonGate/blob/main/examples/curl.md
Paid buyer example: https://github.com/sauliusbeconis/AxonGate/blob/main/examples/paid_buyer.mjs
MCP server example: https://github.com/sauliusbeconis/AxonGate/blob/main/examples/axongate_mcp.mjs
MCP guide: https://github.com/sauliusbeconis/AxonGate/blob/main/examples/mcp.md

## Payment

Protocol: x402
Network: Base mainnet, eip155:8453
Accepted asset: USDC, 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Vault address: 0xcD11393c8505C5A44F8b998E0c96BcC5698d76A7
Preferred payment header: PAYMENT-SIGNATURE
Legacy transaction hash header: X-AxonGate-Payment-Hash
Retry credit header: X-AxonGate-Retry-Credit
Source attribution header: X-AxonGate-Source
Facilitator: https://facilitator.payai.network

## Paid Endpoint

POST https://web-production-8136ee.up.railway.app/v1/x402/access
Content-Type: application/json
Body example:
{
  "target_url": "https://example.com/source",
  "tier": "fresh",
  "force_refresh": true
}

Tiers:
- cached: 0.015 USDC, cache-only; no upstream fetch on miss
- basic: 0.02 USDC, standard cache, 3600 seconds
- fresh: 0.03 USDC, bypass cache
- deep: 0.05 USDC, short cache, 1800 seconds
Recommended tier for uncached public web context: fresh

Successful response shape:
- status: success
- target_url: requested source URL
- tier: resolved price tier
- markdown: cleaned markdown returned from the upstream reader
- cache: cache hit metadata
- payment: network, vault, token, and amount metadata
- ueg_receipt: revenue, dynamic gas, supplier cost, and projected margin

## Retry Endpoint

POST https://web-production-8136ee.up.railway.app/v1/x402/retry
Use only when AxonGate returns a retryable 503 with X-AxonGate-Retry-Credit after payment was accepted but upstream delivery failed.

## Safety And Supply Guards

AxonGate rejects private, loopback, multicast, and link-local target hosts; performs DNS and redirect preflight checks; enforces allowed target ports; caps supplier content size; rate-limits probes, unpaid requests, paid requests, retry credits, and target domains; and runs a dynamic Unit Economic Guardian before supplier work. Bad upstream supply should not be charged to AxonGate beyond the bounded retry credit policy.