[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_131":132},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":49,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":82,"_83":49,"_84":-5,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96},"apiUrl","https://odel.app/api","creator","emmanuel39hanks","moduleId","coal","@emmanuel39hanks/coal","displayName","Coal — Payments for AI agents","tagline","Payment rails for AI agents. Pay merchants in USDC on Base. Dual-protocol: x402 + OKX APP.","iconKey","https://avatars.githubusercontent.com/u/36555309?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.usecoal.xyz/api/mcp\",\"transport\":\"streamable-http\",\"authType\":\"headers\",\"requiredSecrets\":[{\"name\":\"X-Coal-Agent-Key\",\"scope\":\"per-user\",\"header\":\"X-Coal-Agent-Key\"},{\"name\":\"X-Coal-Api-Key\",\"scope\":\"per-user\",\"header\":\"X-Coal-Api-Key\"}]}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363432000,"updatedAt",1788780290000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.emmanuel39hanks%2Fcoal","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",1,"upstreamUpdatedAt",1782475596000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/emmanuel39hanks/coal","githubRepoFullName","emmanuel39hanks/coal","releaseId","ext-emmanuel39hanks-coal","version","1.3.0","descriptionMarkdown","# Coal\n\n> **0G APAC Hackathon 2026 — Track 3: Agentic Economy**\n>\n> Payments for humans **and** AI agents — one checkout, real USDC on Base, verifiable receipts on 0G.\n\n| Surface | URL |\n|---|---|\n| Marketing site | [usecoal.xyz](https://usecoal.xyz) |\n| Public API | [api.usecoal.xyz](https://api.usecoal.xyz) |\n| Hosted checkout | [usecoal.xyz/pay/...](https://usecoal.xyz) |\n| Live AI-agent demo (Claude buying ebooks) | [agent.usecoal.xyz](https://agent.usecoal.xyz) |\n| Demo merchant store (with download flow) | [store.usecoal.xyz](https://store.usecoal.xyz) |\n| MCP server (multi-tenant) | [mcp.usecoal.xyz/api/mcp](https://mcp.usecoal.xyz/api/mcp) |\n| x402 oracle paywall demo | [oracle.usecoal.xyz/api/price/ETH](https://oracle.usecoal.xyz/api/price/ETH) |\n| Live 0G health (all 5 components) | [api.usecoal.xyz/api/0g/health](https://api.usecoal.xyz/api/0g/health) |\n| Docs site | [usecoal.xyz/docs](https://usecoal.xyz/docs) |\n| React SDK on npm | [`coal-react`](https://www.npmjs.com/package/coal-react) v0.4.1 |\n\n## 🎥 Watch\n\n| Video | Length | Link |\n|---|---|---|\n| **Pitch video** (for judges) | ~5 min | **https://youtu.be/FOieBgJ3j4A** |\n| **Launch / demo video** (for users) | ~2 min | **https://youtu.be/fnlcOIcK-yk** |\n| **Pitch deck** (PDF) | 12 slides | **https://www.usecoal.xyz/coal-pitch-deck.pdf** |\n\n**Coal is a programmable commerce platform for hosted checkout, merchant APIs, payment links, paywalls, recurring billing, and agentic commerce flows.**\n\nCoal is built around a simple split:\n\n- `Coal` handles checkout orchestration, merchant operations, payer-info capture, recurring billing, and dual-protocol agent settlement flows on Base.\n- `0G` adds the sidecar layer for artifact storage, receipt proof anchoring, merchant memory, and AI commerce endpoints.\n\nThis repo is an active product branch, not a tiny demo. The current codebase includes:\n\n- hosted checkout and payment links (humans)\n- **dual-protocol agent payments** — Coinbase x402 (v1) and OKX APP (v2) on the same `/verify` endpoint\n- **MCP server** for Claude Desktop / Cursor / ChatGPT agents (multi-tenant, per-request credentials)\n- merchant dashboard and onboarding\n- payer-info collection at checkout\n- recurring billing foundations\n- widget/embed surfaces + `coal-react` SDK on npm\n- docs site + OpenAPI playground\n- demo store with verified-payment download flow\n- live agent demo running on 0G Compute (Qwen)\n- live 0G storage / chain / compute / KV / DA integration\n\n## 0G Integration — 5 Components on Mainnet\n\nCoal uses **five** 0G network components. **All live on 0G mainnet.** Full setup walkthrough lives on the docs site at [usecoal.xyz/docs](https://usecoal.xyz/docs).\n\n### 1. 0G Storage — Immutable Artifact Layer\nEvery payment receipt, merchant profile, and encrypted memory snapshot is published to 0G Storage as an immutable, content-addressed artifact. AI agents and apps can discover merchants and verify payments by reading these artifacts directly from the decentralized storage network.\n\n- **Receipt payloads:** tx hash, amount, payer address, merchant, metadata\n- **Merchant profiles:** name, products, paywalls, supported tokens, API endpoints\n- **Encrypted memory:** AES-256-GCM encrypted full catalog + settings (only Coal can decrypt)\n- Explorer: [storagescan.0g.ai](https://storagescan.0g.ai)\n\n### 2. 0G Chain — Receipt Proof Anchoring\nAfter publishing a receipt to 0G Storage, Coal anchors a SHA-256 hash of the receipt payload on-chain via the `CoalReceiptAnchor V2` smart contract. Creates a tamper-proof, independently verifiable proof that a specific payment happened at a specific time. V2 calls the DASigners precompile (`epochNumber()`) and embeds the current DA epoch into every anchor event.\n\n- Contract: `0x24a80A3Bb16d26D4063Ecd4B2fD64C6856E25E8b`\n- Chain: 0G mainnet (chain ID 16661)\n- Explorer: [chainscan.0g.ai/address/0x24a80A3B...](https://chainscan.0g.ai/address/0x24a80A3Bb16d26D4063Ecd4B2fD64C6856E25E8b)\n\n### 3. 0G Compute — AI Commerce Inference\nCoal's agent-facing APIs use 0G Compute for AI inference on the decentralized GPU network:\n\n- **Memory query:** Natural language Q&A against merchant data (\"What products does this merchant sell?\")\n- **Commerce routing:** AI decides which merchant or product fits an agent's request\n- **Policy evaluation:** AI evaluates scenarios against merchant rules (\"Can this customer get a refund?\")\n- **Sealed Inference:** Privacy-preserving inference with per-response TEE attestation via `broker.inference.verifyService()`. Responses from sealed queries carry a verification signature from the Intel TDX + NVIDIA H100/H200 enclave they ran inside.\n\n### 4. 0G KV — Mutable Merchant Mirror\nKV writes keep merchant profiles, memory pointers, and paywall manifests always-current on top of the 0G log layer, so agent discovery returns fresh data without walking the full log history.\n\n- `merchant:profile:latest` — merchant profile bundle\n- `merchant:memory:latest` — memory pointer (storage URI + root hash + timestamp)\n- `paywall:{id}:manifest:latest` — x402 paywall manifest\n\n### 5. 0G DA — Payment Event Streaming\nEvery confirmed payment, subscription lifecycle event, and webhook delivery is posted as a DA blob to the 0G Data Availability layer via a gRPC sidecar. External systems monitoring the DA stream see events in real time.\n\n- 6 event types: `payment_confirmed`, `subscription_created`, `subscription_renewed`, `webhook_delivered`, `paywall_access_granted`, `receipt_anchored`\n- In-memory demo feed: [api.usecoal.xyz/api/0g/da-events](https://api.usecoal.xyz/api/0g/da-events)\n\n### Architecture\n\n```mermaid\nflowchart TB\n subgraph Actors\n M[\"Merchant
Console Dashboard\"]\n C[\"Customer
Browser / Wallet\"]\n AG[\"AI Agent
AgentKit / x402\"]\n end\n\n subgraph Coal[\"Coal Platform\"]\n direction TB\n API[\"Console API
Products, Links, Keys, Settings\"]\n CHK[\"Checkout Engine
Sessions, Payments, Verification\"]\n PW[\"Paywall Gateway
x402, Access Control, Manifests\"]\n RP[\"Receipt Publisher
Proof Generation, Anchoring\"]\n ACI[\"Agent Commerce API
Memory, Routing, Policy Eval\"]\n SUB[\"Subscription Engine
Recurring Billing, Renewals\"]\n WH[\"Webhook Delivery
Events, Retries, HMAC Signing\"]\n DB[(\"Neon Postgres\")]\n AUTH[\"Privy Auth\"]\n end\n\n subgraph ZG[\"0G Network — 5 Components Live on Mainnet\"]\n direction TB\n ZGS[\"1. 0G Storage
Immutable receipt logs
Merchant profiles
Encrypted memory snapshots\"]\n ZGC[\"2. 0G Chain
CoalReceiptAnchor V2
Calls DASigners precompile
SHA-256 proof anchors\"]\n ZGX[\"3. 0G Compute
AI commerce inference
Sealed Inference with TEE
Per-response attestation\"]\n ZGK[\"4. 0G KV
Mutable merchant mirror
Per-merchant stream IDs
Live agent discovery\"]\n ZGD[\"5. 0G DA
Payment event streaming
gRPC sidecar
6 event types\"]\n end\n\n BASE[\"Base (Coinbase L2)
USDC settlement
RPC fallback: Alchemy → mainnet.base.org\"]\n\n M -->|API| API\n C -->|Checkout| CHK\n AG -->|x402 / API| PW\n AG -->|Commerce| ACI\n\n RP -->|publish| ZGS\n RP -->|anchor| ZGC\n ACI -->|infer| ZGX\n API -->|mirror| ZGK\n RP -->|DA events| ZGD\n\n CHK --> BASE\n API --> DB\n API --> AUTH\n\n style Coal fill:#1a1a2e,stroke:#334155,color:#e2e8f0\n style ZG fill:#115e59,stroke:#2dd4bf,color:#ccfbf1\n style BASE fill:#1d4ed8,stroke:#60a5fa,color:#bfdbfe\n style Actors fill:#f8fafc,stroke:#cbd5e1,color:#1e293b\n```\n\n## Agent Payments — Dual-Protocol (x402 + OKX APP)\n\nCoal's paywall `/verify` endpoint accepts **both** payment envelopes on the same URL — Coinbase's x402 (v1) and OKX's APP (v2). The dispatch picks the right settlement path based on the header version:\n\n- **x402 v1** — Coinbase agent payment standard, EIP-3009 `transferWithAuthorization` on Base USDC. Gasless for the agent.\n- **APP v2** — OKX's agent payment whitepaper format. Same EIP-3009 wire underneath, different envelope.\n\nImplementation:\n\n- [`backend/lib/x402-settle.ts`](https://github.com/emmanuel39hanks/coal/blob/main/backend/lib/x402-settle.ts) — x402 v1 settlement\n- [`backend/lib/app-settle.ts`](https://github.com/emmanuel39hanks/coal/blob/main/backend/lib/app-settle.ts) — OKX APP v2 settlement\n- [`backend/app/api/paywalls/[id]/verify/route.ts`](./backend/app/api/paywalls/[id]/verify/route.ts) — version dispatch\n\nTry the live x402 paywall on the oracle demo:\n\n```bash\ncurl -i https://oracle.usecoal.xyz/api/price/ETH\n# returns 402 Payment Required with the X-PAYMENT challenge\n```\n\n## MCP Server (Claude Desktop / Cursor / ChatGPT)\n\nCoal ships a multi-tenant MCP server at [`mcp.usecoal.xyz/api/mcp`](https://mcp.usecoal.xyz/api/mcp). 13 tools cover the full agent-commerce loop:\n\n- `discover_merchants`, `search_products`, `get_merchant_profile`\n- `query_merchant_memory` (TEE-backed natural-language Q&A)\n- `check_paywall`, `create_checkout`, `get_checkout_status`\n- `verify_receipt` (3-step proof trail: Base TX → 0G Storage → 0G Chain)\n- `get_0g_health`, `agent_wallet_status`\n- `pay_merchant` (USDC on Base via EIP-3009, gasless)\n- `download_product` (verifies on-chain payment, returns signed download URL)\n- `setup_instructions`\n\nThe server holds **no long-lived secrets** — every user passes their own wallet key via `X-Coal-Agent-Key` and their own Coal API key via `X-Coal-Api-Key` on each request.\n\n```json\n// Claude Desktop config\n{\n \"mcpServers\": {\n \"coal\": {\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\",\n \"https://mcp.usecoal.xyz/api/mcp\",\n \"--header\",\n \"X-Coal-Agent-Key:0xYOUR_WALLET_PRIVATE_KEY\"\n ]\n }\n }\n}\n```\n\nSource: [`examples/coal-mcp-server/`](https://github.com/emmanuel39hanks/coal/blob/main/examples/coal-mcp-server/). Docs: [`frontend/app/docs/sdk/mcp/`](https://github.com/emmanuel39hanks/coal/blob/main/frontend/app/docs/sdk/mcp/).\n\n## What Is Live\n\n### Merchant product surface\n\n- Products, payment links, paywalls, API keys, team management, analytics, settings\n- Console auth through Privy\n- Async on-chain verification and webhook delivery\n- Hosted renewal checkouts for recurring billing\n\n### Checkout surface\n\n- Public checkout pages under `/pay/[slug]` and `/pay/checkout/[id]`\n- Payer-info configuration and validation\n- Direct settlement-token payments on Base\n- Widget/embed flow using the real checkout lifecycle\n\n### Agentic / 0G surface\n\n- Merchant profile publication to 0G Storage\n- Merchant memory snapshots with encrypted storage payloads\n- Verifiable receipt publication + 0G chain anchoring\n- Agent-facing paywall manifests and verification routes\n- AI commerce APIs backed by 0G Compute\n- Console operator page at `/console/0g`\n\n## 📈 Traction\n\n**Distribution:**\n- MCP server listed on [Smithery](https://github.com/emmanuel39hanks/coal/blob/main/[https://smithery.ai/server/coal-commerce) and the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=coal) as well as [PulseMCP](https://www.pulsemcp.com/servers/coal)\n- React SDK [`coal-react`](https://www.npmjs.com/package/coal-react) v0.4.1 shipped on npm\n- Documentation live at [usecoal.xyz/docs](https://usecoal.xyz/docs) with SDK, MCP, paywalls, agent-payments guides\n\n**Engagement beyond code:**\n- Walkthrough articles for builders + merchants\n- Small bounty program — developers building on top of Coal\n- Test users running live flows on the agent sandbox\n- Daily replies + DMs across X, LinkedIn, Farcaster, Reddit, Discord, Telegram\n\n**Inbound signal:**\n> *\"x402 + APP wire compat actually working is a real one… happy to point the mapper crawler at agent.usecoal.xyz for endpoint stability data in our public catalog.\"*\n> — CDP-verified Coinbase Developer Platform builder\n\n**Live proof anyone can check right now:**\n- API health: [api.usecoal.xyz/api/0g/health](https://api.usecoal.xyz/api/0g/health) → all 5 0G components green\n- Receipt anchor on 0G Chain: [`0x24a80A3Bb16d26D4063Ecd4B2fD64C6856E25E8b`](https://chainscan.0g.ai/address/0x24a80A3Bb16d26D4063Ecd4B2fD64C6856E25E8b)\n- Live agent demo: [agent.usecoal.xyz](https://agent.usecoal.xyz) → Claude buys products end-to-end on mainnet in under 10 seconds\n\n---\n\n## Project Stats\n\n| Metric | Value |\n|--------|-------|\n| Test suite | 500+ tests across 35 files |\n| 0G components live on mainnet | 5 — Storage, Chain, Compute, KV, DA |\n| 0G receipt anchor (mainnet) | [`0x24a80A3Bb16d26D4063Ecd4B2fD64C6856E25E8b`](https://chainscan.0g.ai/address/0x24a80A3Bb16d26D4063Ecd4B2fD64C6856E25E8b) |\n| Base USDC (mainnet) | [`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`](https://basescan.org/address/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) |\n| Networks | Base mainnet (USDC) + 0G mainnet (chain ID 16661) |\n| Agent-payment protocols supported | Coinbase x402 (v1) + OKX APP (v2) |\n| MCP tools | 13 |\n| React SDK | [`coal-react`](https://www.npmjs.com/package/coal-react) v0.4.1 |\n| Live demo (Claude buying ebooks) | [agent.usecoal.xyz](https://agent.usecoal.xyz) |\n| Live 0G health | [api.usecoal.xyz/api/0g/health](https://api.usecoal.xyz/api/0g/health) |\n\n## Quick Start for Judges\n\n1. **Watch an agent buy something autonomously:** open [agent.usecoal.xyz](https://agent.usecoal.xyz), fund a fresh agent wallet from the on-screen prompt, and ask Claude to buy any of the listed merchant products. End-to-end Base USDC payment + on-chain receipt + product download, no human in the loop.\n2. **Verify all 5 0G components live on mainnet:**\n ```bash\n curl -s https://api.usecoal.xyz/api/0g/health | python3 -m json.tool\n ```\n Expect `status: \"ok\"` with `storage`, `chain`, `compute`, `kv`, and `da` all `ok: true`.\n3. **Verify a receipt's 3-step proof trail:** visit `/verify/[session-id]` on any paid checkout — shows Base TX → 0G Storage root → 0G Chain anchor with explorer links to each.\n4. **Connect the MCP server to your own agent:** paste the config snippet from the [MCP Server](#mcp-server-claude-desktop--cursor--chatgpt) section above into Claude Desktop, restart, and the 13 Coal tools show up.\n5. **Try the dual-protocol paywall:** `curl -i https://oracle.usecoal.xyz/api/price/ETH` returns a 402 with the `X-PAYMENT` challenge, then resubmit with an x402 v1 OR an OKX APP v2 payment header and the same endpoint settles it.\n6. **Run an example locally:** clone the repo, `cd examples/coal-react-checkout`, `cp .env.example .env.local`, fill in your API key, `npm install && npm run dev`. See also `examples/demo-store/` for the merchant-side flow with verified downloads.\n7. **Browse the dashboard:** sign in at [usecoal.xyz](https://usecoal.xyz) with Privy → Console → 0G to see all 5 components with live mainnet status, activity feed, and publish controls.\n\n## Core Thesis\n\nCoal is not being replaced by 0G.\n\n- `Coal` is the payment execution and merchant operations layer.\n- `0G` is the storage, proof, memory, and AI layer around it.\n\nThat is the correct mental model for the repo.\n\n## Repo Layout\n\n```text\ncoal/\n├── backend/ # Next.js API app, Prisma, on-chain verification, 0G logic\n│ └── lib/0g/ # All 5 0G component implementations (Storage, Chain, Compute, KV, DA)\n├── frontend/ # Next.js UI app, docs site, dashboard, checkout surfaces\n├── contracts/ # CoalReceiptAnchor V2 Solidity contract + Foundry project\n├── coal-mini-app/ # World App mini-app frontend (separate deploy)\n├── packages/ # JS + React SDK surfaces\n├── examples/ # Runnable integrations:\n│ ├── coal-react-checkout/ # React checkout demo\n│ ├── coal-agent/ # Live AI-agent demo (Claude → Coal merchants)\n│ ├── coal-mcp-server/ # Multi-tenant MCP server\n│ ├── coal-oracle-agent/ # x402 oracle paywall demo\n│ ├── demo-store/ # Storefront with verified-payment download flow\n│ └── agentkit-action/ # AgentKit action provider\n├── scripts/ # Deploy + sync scripts\n└── README.md # You are here\n```\n\n## System Architecture\n\nTwo separate Next.js apps are deployed from the same repo:\n\n- [backend](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend) runs the API, verification jobs, agent routes, and 0G services\n- [frontend](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend) runs the dashboard, docs, checkout UI, and public pages\n\n## Examples\n\nThe repo also includes runnable integration examples under [examples](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/examples):\n\n- [coal-react-checkout](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/examples/coal-react-checkout)\n A full Next.js checkout demo built on `@coal/react`, including hosted checkout launch, success handling, receipt verification, and an agent-style simulation flow.\n- [agentkit-action](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/examples/agentkit-action)\n A Coal action provider for AgentKit with checkout, receipt verification, paywall, merchant-memory, and policy-evaluation actions.\n- [demo-store](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/examples/demo-store)\n A storefront-style example that creates Coal sessions, receives webhooks, and now verifies receipts against the 0G proof trail.\n\nIf you want the quickest demo path, start with [coal-react-checkout](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/examples/coal-react-checkout) and [examples/coal-react-checkout/README.md](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/examples/coal-react-checkout/README.md).\n\n## Key Surfaces\n\n### Merchant-facing\n\n- [Console dashboard](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/app/console/page.tsx)\n- [Products](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/app/console/products/page.tsx)\n- [Payment links](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/app/console/payment-links/page.tsx)\n- [Subscriptions](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/app/console/subscriptions/page.tsx)\n- [0G operator page](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/app/console/0g/page.tsx)\n\n### Public checkout\n\n- [Slug checkout](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/app/pay/[slug]/page.tsx)\n- [Direct checkout session page](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/app/pay/checkout/[id]/page.tsx)\n- [Payment view component](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/components/PaymentView.tsx)\n\n### APIs\n\n- [Merchant API checkouts](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/checkouts/route.ts)\n- [Pay session](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/pay/session/route.ts)\n- [Pay confirm](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/pay/confirm/route.ts)\n- [Verify payments cron](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/cron/verify-payments/route.ts)\n- [0G health](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/0g/health/route.ts)\n- [Console 0G status](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/console/0g/route.ts)\n\n### Agent / 0G routes\n\n- [Merchant profiles](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/agent/merchant-profiles/[merchantId]/route.ts)\n- [Memory ingest](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/agent/memory/ingest/route.ts)\n- [Memory query](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/agent/memory/query/route.ts)\n- [Commerce route](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/agent/commerce/route/route.ts)\n- [Support answer](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/agent/commerce/support-answer/route.ts)\n- [Policy evaluation](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/agent/commerce/policy-eval/route.ts)\n- [Recommendations](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/agent/commerce/recommend/route.ts)\n\n## Authentication Model\n\nCoal has three auth surfaces:\n\n- **Merchant API requests** use `x-api-key` with `coal_live_*` keys\n- **Dashboard and `/api/console/*` routes** use Privy Bearer JWTs\n- **MCP server (per-request)** — each tool call carries the caller's own credentials in headers: `X-Coal-Agent-Key` (wallet private key, used by `pay_merchant` / `agent_wallet_status`) and `X-Coal-Api-Key` (Coal API key, used by `create_checkout` / `query_merchant_memory`). The server holds no long-lived secrets.\n\nLegacy Better Auth has been retired from runtime use.\n\n## Settlement Model\n\nCoal settles to the configured Base settlement token.\n\n- `USDC` is the fallback default\n- older `MNEE_*` environment aliases remain only as compatibility helpers\n- the product is no longer MNEE-first\n\n## Local Development\n\n### Prerequisites\n\n- Node.js `24+`\n- npm\n- Neon or another Postgres database\n- (Optional) Alchemy API key for Base — Coal falls back to a public Base RPC if you skip this, so you can run locally without one\n- Privy app credentials\n\n### 1. Install dependencies\n\n```bash\ncd backend && npm install\ncd ../frontend && npm install\ncd ..\n```\n\n### 2. Configure environment files\n\n```bash\ncp backend/.env.example backend/.env\ncp frontend/.env.example frontend/.env\n```\n\nThen fill in the required values in:\n\n- [backend/.env.example](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/.env.example)\n- [frontend/.env.example](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/.env.example)\n\nImportant backend values:\n\n- `DATABASE_URL`\n- `ALCHEMY_API_KEY` *(optional — see RPC fallback note below)*\n- `BASE_RPC_FALLBACK_URL` *(optional — second-tier RPC, e.g. Coinbase Developer Platform or QuickNode)*\n- `PRIVY_APP_ID`\n- `PRIVY_APP_SECRET`\n- `NEXT_PUBLIC_FRONTEND_URL`\n- `NEXT_PUBLIC_API_URL`\n- `CRON_SECRET`\n\n**Base RPC fallback chain.** Coal wraps the Base RPC in a viem `fallback()` transport so a single provider outage cannot stop payments. Priority order: `ALCHEMY_API_KEY` (if set) → `BASE_RPC_FALLBACK_URL` (if set) → `https://mainnet.base.org` (always). The local public node is the floor so the app boots even without an Alchemy key. See [`backend/lib/chain.ts`](https://github.com/emmanuel39hanks/coal/blob/main/backend/lib/chain.ts).\n\nImportant frontend values:\n\n- `NEXT_PUBLIC_API_URL`\n- `NEXT_PUBLIC_PRIVY_APP_ID`\n- `NEXT_PUBLIC_CHAIN_ENV`\n- `NEXT_PUBLIC_COINBASE_BUNDLER_KEY`\n\n### 3. Prepare the database\n\n```bash\ncd backend\nnpx prisma db push\n```\n\n### 4. Run both apps\n\nOpen two terminals:\n\n```bash\n# Terminal 1\ncd backend\nnpm run dev\n```\n\n```bash\n# Terminal 2\ncd frontend\nnpm run dev\n```\n\nDefault local URLs:\n\n- Frontend: `http://localhost:3000`\n- Backend: `http://localhost:3001`\n\n## Verification Commands\n\n### Backend\n\n```bash\ncd backend\nnpm run typecheck\nnpm test\nnpm run build\n```\n\n### Frontend\n\n```bash\ncd frontend\nnpm run typecheck\nnpm run build\n```\n\n### 0G storage benchmark\n\n```bash\ncd backend\nnpm run 0g:storage:benchmark\n```\n\n## 0G Notes\n\n0G is opt-in. Coal still works without it.\n\nFor complete setup instructions for all 5 components (Storage, Chain, Compute, KV, DA), see the docs site at [usecoal.xyz/docs](https://usecoal.xyz/docs).\n\nMinimum environment variables to enable 0G:\n\n```bash\n# Storage + Chain\nZERO_G_ENABLED=true\nZERO_G_CHAIN_RPC_URL=https://evmrpc.0g.ai\nZERO_G_CHAIN_PRIVATE_KEY=0x...\nZERO_G_RECEIPT_ANCHOR_ADDRESS=0x24a80A3Bb16d26D4063Ecd4B2fD64C6856E25E8b\nZERO_G_STORAGE_INDEXER_URL=https://indexer-storage-turbo.0g.ai\nZERO_G_STORAGE_ENCRYPTION_KEY=<32-byte hex>\n\n# Compute\nZERO_G_COMPUTE_ENABLED=true\nZERO_G_COMPUTE_PROVIDER=\nZERO_G_COMPUTE_BASE_URL=\nZERO_G_COMPUTE_API_KEY=\nZERO_G_COMPUTE_MODEL=\nZERO_G_SEALED_INFERENCE_ENABLED=true\n\n# KV\nZERO_G_STORAGE_STREAM_ID=0x<64-hex-chars>\n\n# DA (requires running a sidecar — see 0G-SETUP.md)\nZERO_G_DA_ENABLED=true\nZERO_G_DA_GRPC_URL=:51001\nZERO_G_DA_GRPC_TLS=false\n```\n\nThe main implementation lives in:\n\n- [`backend/lib/0g/storage.ts`](https://github.com/emmanuel39hanks/coal/blob/main/backend/lib/0g/storage.ts) — Storage + KV\n- [`backend/lib/0g/chain.ts`](https://github.com/emmanuel39hanks/coal/blob/main/backend/lib/0g/chain.ts) — Chain anchor writes\n- [`backend/lib/0g/compute.ts`](https://github.com/emmanuel39hanks/coal/blob/main/backend/lib/0g/compute.ts) — AI inference + TEE attestation\n- [`backend/lib/0g/da.ts`](https://github.com/emmanuel39hanks/coal/blob/main/backend/lib/0g/da.ts) — DA event streaming via gRPC\n- [`backend/lib/0g/merchant.ts`](https://github.com/emmanuel39hanks/coal/blob/main/backend/lib/0g/merchant.ts) — merchant profile + memory publishing\n- [`backend/lib/receipts/proof.ts`](https://github.com/emmanuel39hanks/coal/blob/main/backend/lib/receipts/proof.ts) — receipt proof pipeline\n- [`contracts/0g-receipt-anchor/src/CoalReceiptAnchor.sol`](https://github.com/emmanuel39hanks/coal/blob/main/contracts/0g-receipt-anchor/src/CoalReceiptAnchor.sol) — V2 contract with DASigners precompile call\n\n## SDK / Widget\n\nCanonical package surfaces:\n\n- JS widget/runtime: [packages/coal-js/coal.js](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/packages/coal-js/coal.js)\n- React package: [packages/react](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/packages/react)\n- Public widget asset: [frontend/public/coal-widget.js](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/public/coal-widget.js)\n\n## Docs\n\nCoal ships a docs site and a live docs playground:\n\n- Docs: `http://localhost:3000/docs`\n- Playground: `http://localhost:3001/api/docs/ui`\n\nKey files:\n\n- [frontend/app/docs](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/frontend/app/docs)\n- [backend/app/api/docs/route.ts](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/docs/route.ts)\n- [backend/app/api/docs/ui/route.ts](https://github.com/emmanuel39hanks/coal/blob/main/Users/emmanuel/Documents/schemalabs/coal/backend/app/api/docs/ui/route.ts)\n\n## Deployment\n\nCoal deploys as **six** Vercel projects from the same monorepo, each with its own `rootDirectory`:\n\n| Vercel project | Domain | Root |\n|---|---|---|\n| `coal` | [www.usecoal.xyz](https://www.usecoal.xyz) | `frontend/` |\n| `coal-backend` | [api.usecoal.xyz](https://api.usecoal.xyz) | `backend/` |\n| `coal-agent` | [agent.usecoal.xyz](https://agent.usecoal.xyz) | `examples/coal-agent/` |\n| `coal-mcp-server` | [mcp.usecoal.xyz](https://mcp.usecoal.xyz) | `examples/coal-mcp-server/` |\n| `coal-oracle-agent` | [oracle.usecoal.xyz](https://oracle.usecoal.xyz) | `examples/coal-oracle-agent/` |\n| `coal-demo-store` | [store.usecoal.xyz](https://store.usecoal.xyz) | `examples/demo-store/` |\n\nHelper scripts:\n\n- [`scripts/check-all.sh`](https://github.com/emmanuel39hanks/coal/blob/main/scripts/check-all.sh) — backend + frontend typecheck + tests + build sweep.\n- [`scripts/deploy.sh`](https://github.com/emmanuel39hanks/coal/blob/main/scripts/deploy.sh) — local prebuild + push to Vercel for any subset of the six projects.\n\n## Branch Strategy\n\n- `main` is the only branch on the public repo. Vercel production targets `main`.\n- All development happens through the public repo's `main` (PRs merge there).\n\n## 👥 Team\n\nThree co-founders, friends for years. Shipping consumer products, payments, and AI tools together.\n\n| Role | Name | LinkedIn |\n|---|---|---|\n| Co-founder · Engineering | **Emmanuel Haankwenda** | [linkedin.com/in/emmanuelhaankwenda](https://www.linkedin.com/in/emmanuelhaankwenda/) |\n| Co-founder · Engineering | **Bernard Namangala** | [linkedin.com/in/bernard-namangala](https://www.linkedin.com/in/bernard-namangala-665a231a5/) |\n| Co-founder · Product & Design | **Andre Haankwenda** | [linkedin.com/in/andrehaankwenda](https://www.linkedin.com/in/andrehaankwenda/) |\n\nCoal went from zero to mainnet in six weeks. None of that happens without this team.\n\n## License\n\n[MIT](https://github.com/emmanuel39hanks/coal/blob/main/LICENSE) — Copyright (c) 2026 Coal.\n","changelogMarkdown","videoKey","requiredSecretsJson","[{\"name\":\"X-Coal-Agent-Key\",\"scope\":\"per-user\",\"header\":\"X-Coal-Agent-Key\"},{\"name\":\"X-Coal-Api-Key\",\"scope\":\"per-user\",\"header\":\"X-Coal-Api-Key\"}]","publishedAt","priceCents","trialDays",0,"upstream",{"_119":120,"_121":122,"_123":124,"_125":126,"_127":128,"_129":130},"requiredSecrets",[111,112],"tags",[99,100,101,102,103,104,105,106,107,108,109,110],"assets",[],"stats",{"_97":86,"_98":86},"ratingAvg","reviewCount","0g","0g-labs","agentic-commerce","agents","ai-agents","base","hackathon","nextjs","stablecoin-payments","usdc","web3","x402",{"_113":118,"_115":116,"_117":118},{"_113":114,"_115":116,"_117":114},"name","X-Coal-Api-Key","scope","per-user","header","X-Coal-Agent-Key","topics",[99,100,101,102,103,104,105,106,107,108,109,110],"license","MIT","language","TypeScript","registryName","io.github.emmanuel39hanks/coal","homepage","https://usecoal.xyz","packages",[],"ENV",{"_133":134,"_135":136,"_137":138},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]