402-LAB

402-LAB — 向 Agent 销售氛围编程产品

在线体验： https://handsel-mandate-demo.vercel.app（Base 主网，真实 USDC）。当前销售的商品是国税厅企业登记状态查询，每次调用 0.02 USDC，已列入 x402 Bazaar。使用说明。

分为三个部分。

• 卖家端 demo/ — 使用官方 x402 SDK 构建的支付网关。销售我们的商品（demo/tools/nts.js），也可以直接部署在卖家现有 API 前面（demo/upstream.js、Seller Studio 导出 + UPSTREAM_SECRET）。402 响应包含 Bazaar 发现元数据。运营、部署和验证流程
• 买家端 mcp/ — 402-LAB MCP 服务。用户只需委托「不超过 1 美元」，Claude Desktop、Cursor 和 Chrome 扩展就会在 x402 Bazaar 中查找商品，仅在预算范围内付款并返回结果。服务会强制执行上限、单笔限额、网络和卖家允许列表。npm run mcp。配置与权限模型
• 宣传与运营 — 宣传文案与视频制作、销售申请表。

快速开始：npm ci && npm test、npm run demo（本地模拟，无需密钥）、npm run mcp（买家钱包）。

安装买家 MCP（无需克隆仓库）

{ "mcpServers": { "402-lab": { "command": "npx", "args": ["-y", "github:Kairose-master/handsel-mandate"],
  "env": { "BUYER_PRIVATE_KEY": "0x...", "NETWORK": "eip155:84532", "MANDATE_MAX_USDC": "1" } } } }

在 Claude Desktop 中，双击通过 npm run build:mcpb 生成的 dist/402-lab.mcpb 即可安装（在安装界面输入密钥）。注册表、Smithery、mcp.so、Cursor 目录、x402 生态系统提交文件和流程请参阅 docs/directories.md。

首个成功标准是外部买家实际使用外部卖家的工具。目前仅有 2 笔内部钱包结算，不保证会带来买家流量或收入。

---

Handsel Mandate — 浏览器委托原型

以下是 402-LAB 的基础链上委托流程。runtime/buyer.js 连接到固定的卖家端点，现在支持 Base Sepolia 和独立的 Base 主网合约制品。**主网制品尚未部署、安装或经过安全审查，也尚未确认与公开在线支付服务的实际兼容性。**这与 MCP 买家流程相互独立。

Seller Studio · 卖家端草案

我们新增了一个本地 Studio，用于整理通过氛围编程构建的工具的商品说明、调用示例和价格，并导出 x402 集成配置。运行 node scripts/seller-studio.js 后，打开 http://127.0.0.1:4173。无需安装依赖即可运行。支持商品预览、预算限制模拟购买和 JSON 下载。不执行实际 API 调用、付款、Bazaar 登记或公开销售。范围与后续集成步骤。

这是一个 Chrome MV3 扩展草案：用户设置预算、允许使用的工具和有效期，浏览器 Agent 在这些范围内模拟购买。

v0.5：链上受限权限 + BlockFlow + x402。 在 Coinbase Smart Account 上，将网络专属的 MandateValidator 安装为合约所有者。将用户批准的总预算、单笔限额、收款人、有效期、Agent 和 BlockFlow 绑定记录到链上；只有 Agent 预先预留了支付金额时，才允许进行相应的 EIP-3009 支付。必须同时启用 allowMainnet: true 和 owner CLI 的 --confirm-mainnet，才能启用主网。

新的 Session 模式不包含所有者密钥，Agent 不能任意转账或发放新委托。撤销在链上确认后，未结算的预留也会失效。系统会将收据与 RPC 返回的 USDC Transfer 和 AuthorizationUsed nonce 进行比对。Sepolia 流程也尚未执行公开链上安装或结算。主网移植版本也尚未部署或经过安全审查。请参阅安装与验证范围。旧的 full-owner 模式仅保留在现有配置中，不提供相同的安全保障。

x402 签名必须先通过 DAMBI 兼容的前置策略网关，之后才能预留预算。在 Agent 执行过程中，仅允许 allow / evaluated / enforcing 判定。

安装

1. 克隆此仓库，或使用 Download ZIP 下载。
2. 在 Chrome 中打开 chrome://extensions → 开启开发者模式 → 加载已解压的扩展程序 → 选择 extension/。
3. 点击工具栏中的 Handsel 图标打开侧边栏。也可以在扩展程序选项中打开相同页面。
4. 检查委托的目标、总预算、单笔限额、期限和允许使用的工具，然后启用。
5. 运行演示 Agent：使用 0.03 + 0.05 的模拟 USDC 进行搜索和文档提取，并留下收据。
6. 如果将总预算和单笔限额都设为 0.05，搜索后会阻止提取。第一次调用仍会保留，整个操作并非原子性的。

连接独立 Agent 扩展

也请将 examples/agent-extension/ 加载为已解压的扩展程序。在 Handsel 连接栏中保存该扩展的 ID 后，启用新的委托。在演示扩展弹窗中输入 Handsel 扩展 ID，即可通过扩展间消息请求购买。

支持的 API：status、catalog、purchase（mandateId、requestId、serviceId）。响应为 {ok,result} 或 {ok:false,error}。只有已连接的一个扩展可以访问。更改连接会撤销现有委托。外部 Agent 不能创建委托、更改连接或扩大权限。

不会自动连接浏览器内置 AI 或 Aside 类产品。只有这类产品支持扩展消息/API 连接时，才能为其接入适配器。不会向普通网页公开支出 API。

테스트

Node 22+에서 npm ci 후 npm test. BlockFlow 통합 테스트까지 실행하려면 BlockFlow 저장소를 ../BlockFlow에 clone하거나 BLOCKFLOW_ROOT=/absolute/path/to/BlockFlow npm test를 사용합니다. 테스트는 실제 BlockFlow 컴파일, Coinbase Smart Account의 EIP-1271 래핑 서명, x402 payload의 AA payer 주소를 확인합니다. Chrome/체인 실제 설치 검증은 아래 체크리스트로 별도 수행합니다.

• 아이콘 클릭 → 사이드패널 열림
• 생성 → 데모 구매 → 재시작 후 예산/영수증 유지
• 만료/회수/건당/총예산 초과 차단
• 연결되지 않은 데모 확장 호출 거절
• 연결 후 데모 확장 호출 성공
• 두 패널 동시 호출에도 총예산 초과 없음

구현 경계

• 정수 micro-USDC로 금액 계산, service worker의 직렬 큐로 상태 갱신, request ID로 중복 차감 방지.
• 서비스 가격은 고정 로컬 카탈로그에서 읽습니다. 외부 요청이 가격을 지정할 수 없습니다.
• 목표의 의미나 API 품질은 검증하지 않습니다. 자연어를 금융 권한으로 자동 컴파일하지 않습니다.
• 내보낸 JSON은 서명되지 않은 데모 기록이며 법률상 위임장 또는 온체인 권한이 아닙니다.
• 저장소의 코드/영수증은 공개되지 않고 확장 로컬 저장소에만 기록됩니다. 동기화/원격 분석 없음.

통합 구조

위임 입력 → BlockFlow 검증·산출물 바인딩 → 사람이 온체인 grant → 에이전트 reserve → EIP-1271 x402 결제 → RPC 영수증 대조 순서입니다. 컴파일러 커밋·작업트리·정책·컨트랙트 바이트코드·소유자 슬롯을 검사하고 불일치하면 차단합니다.

BlockFlow는 워크플로 구조를 검증합니다. 예산 제약은 별도로 작성한 MandateValidator가 집행하며, BlockFlow가 임의 BPMN 전체를 지출 모듈로 자동 변환하는 것은 아닙니다. endpoint와 자연어 목표는 온체인 결제 의미로 강제되지 않습니다.

다음 단계

남은 검증은 실제 Base Sepolia USDC와 facilitator를 이용한 배포·정산, 별도 보안 검토, 사람 지갑 승인 UI입니다. 현재 승인은 로컬 human-only CLI이고 구매마다 예약 가스가 발생합니다. 임의 UserOperation에 대한 session 권한이나 범용 ERC-7579 모듈을 주장하지 않습니다.

References: Chrome Side Panel, Messaging, x402 Bazaar.