Important
🟢 Live on Base Mainnet (December 2025)
- Escrow:
0x37A7B1f10b87f31ad916Fb3518118f8AA0d8d2fC - Entitlements:
0x3c8f32F9cF41Dc255129d6Add447218053743b33
See DEPLOYMENTS.md for full details.
AgentNexus is a decentralized infrastructure platform for discovering, purchasing, and executing autonomous AI agents on Base L2. Built on Base, it leverages Account Abstraction (ERC-4337) to provide a seamless, secure, and non-custodial experience for users and agents alike.
The platform consists of three layers: a Next.js frontend for user interaction and marketplace browsing, a Node.js/Express backend that orchestrates agent execution in isolated Docker environments, and Solidity smart contracts (Foundry) that manage ownership, payments, and access control. See ARCHITECTURE.md for a deep dive.
This project is NOT:
- A consumer-facing AI app
- A trading platform or financial product
- A token launch or ICO
- A permissionless agent marketplace (agents require registration)
- A custodial wallet service (users control their own keys)
- A no-code AI builder
AgentNexus is infrastructure software intended for technically competent users who understand blockchain technology and smart contracts.
Version: v0.1.0 (Base Mainnet Launch)
Deployment: Live on Base Mainnet (December 2025)
See STATUS.md for detailed project status and DEPLOYMENTS.md for contract addresses. For the grant brief, 3–6 month roadmap, and reviewer-friendly FAQ, see docs/grant-brief.md.
| Component | Status |
|---|---|
Smart Contracts (AgentNexusEscrow, AgentNexusEntitlements) |
✅ Deployed to Base Mainnet |
| Account Abstraction (ERC-4337) | ✅ Implemented |
| Agent Execution Environment | ✅ Docker-based, sandboxed |
| Compliance Toggles | ✅ Implemented (disabled by default) |
| CCTP Integration | ✅ Mainnet Proof |
| Frontend Marketplace | 🚧 In Development |
- No Private Keys in Agents: Agents run in ephemeral containers without wallet access
- Smart Contract Security: Contracts use
ReentrancyGuardand standard OpenZeppelin libraries - Sandboxed Execution: Docker containers are hardened with
seccompprofiles and read-only filesystems - Audit-Ready Logging: Structured logging available (toggle-controlled)
- Compliance Features: Geo/KYC toggles, agent category restrictions, and runtime isolation are implemented but disabled by default
- Agent Zero: Our flagship autonomous agent is functional but under active development
- Consumer protection mechanisms (this is B2B infrastructure)
- Financial advice or trading guarantees
- Key recovery services
Note: We only provide support for the setup described below. Custom configurations or deployment scenarios are your responsibility.
- Node.js v20+
- Docker (for agent execution)
- Foundry (for smart contracts)
- pnpm
-
Clone the repository
git clone https://github.com/up2itnow/AgentNexus2.git cd AgentNexus2 -
Install dependencies
pnpm install
-
Environment Setup Copy
.env.exampleto.envand fill in your API keys (Alchemy, WalletConnect, etc.). -
Run Locally
pnpm dev
For smart contract deployment, see the smart-contracts/ directory README.
AgentNexus supports x402, an internet-native payment protocol for pay-per-request API access using USDC on Base.
| Endpoint | Price | Description |
|---|---|---|
GET /agents/:id/premium-analytics |
0.05 USDC | Agent analytics with execution trends, revenue breakdown |
GET /agents/:id/detailed-metrics |
0.02 USDC | Performance metrics, status distribution, duration analysis |
GET /agents/x402/status |
Free | Check x402 configuration |
# backend/.env
ENABLE_X402=true # Enable x402 payments
X402_NETWORK=base-sepolia # or "base" for mainnet
X402_PAYMENT_RECIPIENT=0xYourWalletAddress # Receives payments
X402_MAX_PAYMENT_USDC=100 # Safety limit per request# Request without payment → 402
curl -i http://localhost:3001/agents/test-id/premium-analytics
# HTTP/1.1 402 Payment Required
# X-Payment-Required: <base64-encoded payment request>
# After paying USDC and retrying with payment proof → 200
curl -i http://localhost:3001/agents/test-id/premium-analytics \
-H "X-Payment: <base64-encoded payment payload>"
# HTTP/1.1 200 OK✅ Transaction: 0x6c4907aa... | Block 35126450 | 0.05 USDC
AgentNexus now supports funding via Circle CCTP from Arbitrum and Optimism.
- Client requests regular premium resource.
- Paywall includes
cctproutes for Arbitrum/Optimism. - Client burns USDC on source chain and submits proof.
- Permissionless Relayer mints and credits on Base.
✅ Receiver Contract: 0x661a9903... (Base Sepolia)
✅ Mainnet Proof: See docs/proofs/cctp-ethmainnet-to-basemainnet.json for tiny-amount verification (Burn Eth -> Mint Base).
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
Apache 2.0 - See LICENSE for details. Third-party protocol and dependency notices are documented in NOTICE.
AgentNexus is natively compatible with the emerging agent payments and inter-agent communication protocol stack:
| Protocol | Status | Description |
|---|---|---|
| x402 (HTTP 402 Payment Protocol) | ✅ Native | Pay-per-request USDC payments over HTTP — the internet-native payment rail for AI agents |
| AP2 (Agent Payments Protocol) | ✅ Compatible | Aligned with Google/Coinbase/Ethereum Foundation's Agent Payments Protocol — our x402 implementation is AP2-ready |
| MCP (Model Context Protocol) | ✅ Compatible | Agents can invoke payment actions via MCP tool calls — drop-in integration with Claude, Cursor, and any MCP-enabled AI runtime |
| A2A (Agent-to-Agent) | ✅ Supported | Full agent-to-agent payment flows — agents can pay each other autonomously without human intervention |
| CCTP (Circle Cross-Chain Transfer Protocol) | ✅ Integrated | Native Circle CCTP v2 support — bridge USDC from Arbitrum, Optimism, and Ethereum to Base in a single atomic flow |
In February 2026, Google announced a partnership with Coinbase and the Ethereum Foundation to extend the Agent Payments Protocol (AP2) with x402 as the HTTP-native payment layer. This makes our existing x402 implementation institutionally validated infrastructure — not experimental.
AgentNexus was built on these primitives from day one. We are one of the earliest production deployments of the full AP2/x402/CCTP/A2A payment stack on Base Mainnet.
agent-wallet-sdk — the TypeScript SDK powering AgentNexus payments — is available on npm as
elizaos-plugin-agentwalletfor direct integration into any ElizaOS agent.