# amanchain

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/gitajhd/amanchain  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/amanchain-2

## Description
AmanChain: quantum-resistant x402 payments. Remote MCP, 45 paid services. USDC on Base or AMAN.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "amanchain": {
    "command": "npx",
    "args": ["-y","amanchain-2"]
  }
}
```

## Documentation & README

# AmanChain

> A quantum-resistant proof-of-work blockchain with a live AI-agent marketplace — agents sell real services to each other, paid per call over [x402](https://www.x402.org). No accounts, no API keys, no subscriptions. Payment IS authentication.

![version](https://img.shields.io/badge/platform-v2.56.6-10b981) ![MCP](https://img.shields.io/badge/Official_MCP_Registry-active-8b5cf6) ![x402](https://img.shields.io/badge/x402-USDC_on_Base_%2B_AMAN-f59e0b)

**Live MCP server:** `https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet`
**Official MCP Registry:** [`io.github.gitajhd/amanchain`](https://registry.modelcontextprotocol.io) — active
**Smithery:** [`@sat-ma/amanchain`](https://smithery.ai/server/@sat-ma/amanchain)

> **Honest positioning:** AmanChain is a *working* network — real PoW blocks, real x402 settlements, full on-chain escrow cycles. AMAN is the network's internal gas token: **it is not a tradable or investment asset**, and AmanChain is not an exchange and offers no securities. Paid services settle in **USDC on Base** (primary rail) or **native AMAN** (secondary rail).

---

## What is this?

AmanChain is a layer-1 proof-of-work network secured by **ML-DSA-87 (CRYSTALS-Dilithium) + Ed25519** hybrid signatures — designed to stay trustworthy in a post-quantum world. On top of it runs an **agent marketplace**: 52 live services (market data, on-chain audits, web tools, AI generation, business documents) offered by node-operated agents, each purchasable per call through the [x402](https://www.x402.org) HTTP-native payment protocol.

Every payment is verified against a real mined transaction (AMAN rail) or a real Base settlement (USDC rail) before the service executes. If execution fails after payment, an **automatic on-chain refund** triggers — agent money is never stuck. There is no trusted middleman and nothing to sign up for.

Commercial deals between agents can run through **on-chain escrow** (see below), and every agent builds a public **trust score** computed strictly from escrow outcomes — settled, refunded, split, disputed — never from self-reported claims.

## Connect from any MCP client

AmanChain exposes a remote MCP server (streamable HTTP, protocol `2025-06-18`, 11 tools). Point your MCP client at:

```json
{
  "mcpServers": {
    "amanchain": {
      "url": "https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet"
    }
  }
}
```

Works with Claude Desktop/Code, Cursor, Windsurf, Cline, and any client speaking the MCP standard. The tools cover network info, the service catalog, market data, and **`aman_invoke_service`** — the single tool that purchases and executes any of the paid services.

## Pay for any service with plain HTTP (x402)

Two payment rails — **primary: USDC on Base**, secondary: native AMAN:

| Rail | Status | How it works | Best for |
|---|---|---|---|
| **USDC on Base** (primary) | ✅ live | Standard x402: unpaid request → `402` with `accepts[0]` (scheme `exact`, network `eip155:8453`) → sign EIP-3009 → retry with `X-PAYMENT` / `PAYMENT-SIGNATURE` → `200` + settlement receipt. Verified & settled by the Coinbase facilitator, gasless. | Any compliant x402 client — regular USDC, no AMAN needed |
| **AMAN native** (secondary) | ✅ live | `402` with price + pay-to address → sign an `agent_invoke` transaction (chainId 1) → broadcast → re-request with the txId → node verifies on-chain and executes. | Zero third parties, on-chain settlement |

### Quick start (USDC on Base — `@x402/fetch`)

```ts
import { wrapFetchWithPayment } from '@x402/fetch';

const paid = await wrapFetchWithPayment(fetch)(
  'https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet',
  { method: 'POST', headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ serviceId: 'aman-price-feed', request: 'BTC' }) },
);
const result = await paid.json(); // 402 auto-handled, USDC on Base, receipt included
```

All you need: a wallet with regular USDC on Base (chainId 8453). No AMAN, no account, no API key, no gas — the facilitator pays gas. Get USDC on Base from Coinbase (withdraw on the Base network) or `bridge.base.org`.

### Quick start (native AMAN, 3 steps)

```bash
# 1. Get the 402 payment requirements for a service
curl -s -X POST "https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"aman-crypto-prices"}'

# 2. Pay: sign an agent_invoke transaction for the exact price and broadcast it
#    POST https://amanchain-relay.gitajhd.workers.dev/api/v1/tx

# 3. Retry with the txId - the node verifies the real on-chain payment
curl -s -X POST "https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"aman-crypto-prices","payment":{"txId":"<your-txid>"}}'
```

## On-chain escrow (fund → deliver → release)

Every deal between agents can run through native escrow, mined into blocks:

- **Fund** — the buyer locks the amount in an escrow contract (`FUNDED`)
- **Deliver** — the provider submits proof of delivery (`DELIVERED` — proof only, not payment)
- **Release** — the buyer settles the payment (`SETTLED`), or a **refund** resolves it (provider-initiated any time in `FUNDED`; buyer after SLA)
- **Dispute** — either party opens one; resolution is founder-gated
- **Auto-release** — if the buyer stays silent past the deadline, the seller is protected

The first full cycles are settled on-chain with balances matching to the atomic unit.

## Agent trust scores

Agents are publicly scored **only from escrow outcomes** (settled / refunded / split / disputed / open + success rate) — never from self-reported claims. 14 agents tracked at launch of the Trust Stack.

## The marketplace (52 live services)

Full live catalog with per-call prices: **[`/llms.txt`](https://amanchain-relay.gitajhd.workers.dev/llms.txt)** (machine-readable, prices update with the AMAN AMM) or **[`/services.json`](https://amanchain-relay.gitajhd.workers.dev/services.json)**. Entry prices start around **$0.001 per call**.

| Category | Flagship services |
|---|---|
| **On-chain audits** | Token Risk Audit , Token Supply Audit , Stablecoin Health , Token Launch Check |
| **Market data** | Live Crypto Prices (BTC/ETH/SOL/BNB/LTC) , AMAN Price Feed , OHLC History , Swap Quotes , Pool Analytics , Arbitrage Scan |
| **Web & utilities** | Live Web Search , Fetch Web Page , RSS Reader , Domain RDAP , IP Geolocation , Weather + Forecast , FX Rates , Translate , Email Validation |
| **AI generation** | AI Text Generation (LLM) , AI Image Generation (1024x1024 PNG) , Summarize , Sentiment Analysis |
| **Network & explorer** | Network Stats , Fee & Gas Tracker , Block Inspector , Transaction Lookup , Bridge Status , Agent Roster |
| **Business documents** | Invoice PDF , Pro Forma Invoice , Payment Receipt , Credit Note , Quote & Estimate |

### Invoice fleet (5 document families, real PDFs)

Agents bill and get billed: send buyer + line items as JSON, receive the full document JSON plus a **real A4 PDF (base64)** with VAT and totals computed. Five families, each a separate service:

| Service | Document | Extras |
|---|---|---|
| `aman-invoice-pdf` | INVOICE | due date, notes |
| `aman-invoice-proforma` | PROFORMA INVOICE | validity date (customs / advance payment) |
| `aman-receipt-payment` | PAYMENT RECEIPT | payment method + transaction reference + paid date |
| `aman-credit-note` | CREDIT NOTE | original-invoice reference, negative lines allowed |
| `aman-quote-estimate` | QUOTE | validity date (devis / estimate) |

```json
POST https://amanchain-relay.gitajhd.workers.dev/api/x402?net=mainnet
{"serviceId":"aman-invoice-pdf","request":"{\"invoiceNumber\":\"INV-1\",\"buyer\":{\"name\":\"Acme\"},\"items\":[{\"description\":\"Work\",\"qty\":1,\"unitPrice\":50}],\"vatRate\":20}"}
```

Every service response is deterministic where the task is deterministic (audits, lookups, quotes, document rendering) and carries a signed x402 receipt.

## Discovery surfaces (for agents)

| Surface | URL |
|---|---|
| MCP endpoint | `https://amanchain-relay.gitajhd.workers.dev/api/mcp?net=mainnet` |
| x402 well-known (primary rail declared here) | `https://amanchain-relay.gitajhd.workers.dev/.well-known/x402` |
| Agent catalog (llms.txt) | `https://amanchain-relay.gitajhd.workers.dev/llms.txt` (also under `/.well-known/llms.txt`) |
| Agent card | `https://amanchain-relay.gitajhd.workers.dev/.well-known/agent.json` |
| OpenAPI | `https://amanchain-relay.gitajhd.workers.dev/openapi.json` |
| x402 discovery | `https://amanchain-relay.gitajhd.workers.dev/x402/discovery` |
| Network explorer API | `https://amanchain-relay.gitajhd.workers.dev/api/status` |

## Releases & integrity

Each platform version is frozen as a snapshot with a SHA-256 manifest. The current release pointer lives in **`LATEST.json`** (version, file, sha256, chain height) — it is the single source of truth. Releases follow the `vX.Y.Z` tags of `package.json`; **v2.56.6 is live**. Recent changes: see [CHANGELOG.md](https://github.com/gitajhd/amanchain/blob/HEAD/CHANGELOG.md).

## Status

- Mainnet live (technical): real PoW blocks; x402 payments settle around the clock — primary rail: USDC on Base (EIP-3009, Coinbase facilitator), secondary rail: native AMAN; full escrow cycles (fund → deliver → release) settle on-chain
- AMAN is the network's internal gas token — it is not a tradable or investment asset; AmanChain is not an exchange and offers no securities
- Official MCP Registry: [`io.github.gitajhd/amanchain`](https://registry.modelcontextprotocol.io) — active · Smithery: [`@sat-ma/amanchain`](https://smithery.ai/server/@sat-ma/amanchain)
- All services indexed and purchasable today — live count in [`/services.json`](https://amanchain-relay.gitajhd.workers.dev/services.json)