Kustodia

Global escrow & agentic payments platform — fiat + crypto, 10 chains, 36 MCP tools, 6 agent protocols

🌐 Website · 📖 Docs · 🤖 AI Agents · ⚡ Blinks

🏗️ Architecture

• Frontend: Next.js 14 (TypeScript, Tailwind CSS) → Netlify
• Backend: Express.js RESTful API (TypeScript) → GCP Cloud Run
• Database: PostgreSQL (GCP Cloud SQL)
• Cache: Redis (GCP Memorystore)
• Blockchain: Arbitrum, Base, Polygon, Injective, Solana
• Smart Contracts: Solidity (UUPS proxy, EVM) + Anchor/Rust (Solana)
• Storage: GCS + IPFS (Pinata) — evidence pinned for public access
• Agent Protocols: MCP stdio/HTTP, x402 Pay-Per-Call, AP2 (Google), CDP AgentKit, OWS, Visa TAP, REST API

📁 Project Structure

├── frontend/          Next.js landing page & developer portal
├── backend/           RESTful API + MCP server (36 tools)
├── contracts/         Solidity smart contracts (UUPS proxy)
├── solana/            Anchor program (kustodia_escrow)
├── examples/          Quickstart examples (Node.js, Python, MCP config)
├── docs/              Architecture & API documentation
├── shared/            TypeScript types shared between FE/BE
└── infrastructure/    Terraform IaC for GCP

🚀 Quick Start

Prerequisites

• Node.js 18+
• PostgreSQL 15+
• Redis

Frontend

cd frontend && npm install && npm run dev

Backend

cd backend && npm install && cp .env.example .env && npm run dev

Solana Program

cd solana/kustodia_escrow && anchor build && anchor deploy

⚡ Solana Blinks

Shareable P2P escrow links powered by Solana Actions v2.4.

• Program ID: 7jfdakCiwpfnmpSCjmbLjCxPqmPaNvimxypfZXhJ1LFE (Devnet + Mainnet)
• Token: USDC (SPL)
• Instructions: make_offer, take_offer, confirm_delivery, refund, raise_dispute, resolve_dispute
• Distribution: WhatsApp deep links, QR codes, Phantom deeplinks, dial.to

🤖 AI Agent Integration

36 MCP tools for autonomous agent commerce:

• Escrow management — create, fund, release, dispute, refund
• Trust scores — wallet reputation badges (New → Elite)
• Blinks — create shareable escrow payment links
• Gasless accounts — ERC-4337 session keys (ZeroDev)
• Delivery oracle — auto-release on carrier confirmation
• Agent-to-agent — discover and trade with other agents

Compatible with Claude Desktop, OpenAI GPTs, Google Gemini, and any MCP client.

📚 Documentation

• Escrow Architecture — Full system design (37 tools, 7 modes, 10 chains)
• E2E Test Protocol — Test matrix & validation
• Recurring Payments — Subscription billing
• Agent-to-Agent Trading — A2A escrow protocol
• Examples — Quickstart code (Node.js, Python, MCP config)

💰 Revenue Model

• 3% escrow fee — deducted from seller payout at release
• x402 per-call — $0.01–$0.15 per MCP tool call
• Recurring — 1% setup + 0.5% per-cycle
• Crowdfund — 3% platform fee per milestone

🔐 Security

• JWT + API Key authentication (agent keys + standard keys)
• HMAC-SHA256 for payment processor API calls
• Bridge wallet architecture (relayer-signed on-chain txs)
• MCP spending guards (per-tx + daily limits)
• Audit trail on every tool call

📈 Status

• Fiat escrow (MXN↔USD, SPEI + Wire, 4 routes)
• Web3 escrow (Arbitrum, Base, Polygon, Injective)
• Solana Blinks (Devnet + Mainnet, P2P escrow via shareable links)
• Crowdfunding (milestone-based, investor voting)
• Recurring payments (6 intervals, delegated + manual)
• 36 MCP tools + 6 agent protocols
• Trust scores (wallet reputation system)
• Delivery oracle (17track universal tracking, auto-release)
• FHE Privacy (Fhenix coFHE encrypted escrows)
• Evidence storage (IPFS + GCS dual upload)
• Production deployment (GCP Cloud Run)
• Solana Mainnet deployed (March 22, 2026)
• Phase 2 — Mainnet validation (real funds at scale)

👥 Team

Built by the Kustodia team for secure marketplace payments in Latin America.

License: Proprietary Contact: soporte@kustodia.mx