AgentStamp

为你的智能体盖上身份印章。

一个基于 x402 的轻量级平台，集成了 AI 智能体身份认证、公共智能体注册、声誉评分、跨协议护照以及数字许愿池——所有功能均可通过 Base 和 Solana 链上的 USDC 微支付进行结算。

在线访问： https://agentstamp.org

快速开始

git clone https://github.com/vinaybhosle/agentstamp.git
cd agentstamp
npm install
cp .env.example .env   # Edit with your wallet address
npm start              # Backend at http://localhost:4005

Web 前端

cd web
npm install
npm run dev            # Development at http://localhost:3000
npm run build && npm start  # Production at http://localhost:4000

种子演示数据

npm run seed           # 5 agents, 5 stamps, 10 wishes, 5 endorsements

架构

• 运行时： Node.js + Express

• 数据库： SQLite (better-sqlite3, WAL 模式)

• 支付： x402 协议 — Base + Solana 上的 USDC（双链）

• 签名： Ed25519 密钥对（自动生成）

• 前端： Next.js 16 + Tailwind CSS + shadcn/ui

• SDK： npm 上的 agentstamp-verify (Express + Hono 中间件)

• MCP： 位于 /mcp 的实时 MCP 服务器（流式 HTTP 传输，17 种工具）

• HTTPS： Cloudflare Tunnel

• 进程管理器： PM2

安全性

• Helmet 启用 HSTS（2 年最大有效期，包含子域名，预加载）

• x402 故障关闭保护 — 如果支付中间件失败，付费路由将返回 503（而非免费）

• 钱包验证中间件 — 未提供钱包地址的变更请求将返回 401

• 速率限制 — 每个 IP 每分钟 100 次请求

• MCP 会话限制 — 最多 1000 个会话，30 分钟空闲超时，5 分钟清理

• 进程错误处理 — uncaughtException（优雅关闭）+ unhandledRejection

• 输入清理 — HTML 标签剥离、字段验证、参数化 SQL 查询

• 文件权限 — Ed25519 密钥和 .env 文件权限设为 0o600

API 参考

印章 — 身份证书