mako-verifier

# MAKO > 适用于 Base 上代理商务的信任层。一次调用即可安全路由 x402 支出。 [](https://x402.org) [](https://opensource.org/licenses/MIT) [](https://agentic.market/?service=mako-pollinateresearch-com) [](https://mako.pollinateresearch.com/.well-known/x402.json) 当买方代理即将花费 USDC 调用另一个 x402 服务时，MAKO 会在一调用中返回正确的结果： | 端点 | 功能 | 价格 | 方法 | 路径 | |---|---|---|---|---| | **路由** ⭐ | 单次调用组合：最佳调用服务 + 签名收据 | $0.05 | POST | `/api/route` | | 验证器 | 是否应通过此特定调用？ | $0.25 | POST | `/api/agent-commerce/verify` | | 脉冲 | 该端点表现如何？ | $0.02 | GET | `/api/pulse/score` | | 定价指数 | 该类工作的价格是否公平？ | $0.02 | GET | `/api/pricing/index` | | 声誉评分 | 钱包操作员是否值得信赖？ | $0.03 | GET | `/api/reputation/wallet` | | 市场聚合器 | Polymarket + Kalshi + Limitless 顶级预测市场，标准化 + 签名 | $0.05 | GET | `/api/markets/aggregate` | `POST /api/route` 是主要产品：单次调用组合验证器 + 脉冲 + 定价指数 + 声誉评分，应用约束并返回最佳 x402 服务和 EIP-191 签名收据。四个底层支柱仍然可以单独调用，以获取原始信号。 每次付费调用都写入同一账本。脉冲、定价指数、声誉评分和路由都从中读取 - 因此每个表面都随着其他表面的使用而变得更加锋利。飞轮已经开始转动：[`mako.pollinateresearch.com/pulse`](https://mako.pollinateresearch.com/pulse) 上的实时脉冲排行榜目前对 agentic.market 目录中的 248+ 服务进行评分（目录中总共 700+ 个服务），路由目录涵盖 13 个任务桶中的 28 个服务。 该存储库是开放的客户端 SDK 和协议规范。参考部署在 Base 主网上运行，网址为 `mako.pollinateresearch.com` - 这个 SDK 和您自己的买方代理都以相同的方式调用它。 ## 集成 **AsterPay** - 截至 2026-05-13 已上线。MAKO Pulse 作为 `extensions.reliability` 显示在 AsterPay 的 x402 促进者响应中，由 `0x12BBC7Cde00eB800588243A0B3B4E8E802673BFf` 使用 EIP-191 和 RFC 8785 规范 JSON 签名。调用 AsterPay 前端 x402 服务的买方代理支付每 Pulse 附加调用的 $0.02 脉冲费用；AsterPay 的促进者分割并转发我们的份额。合作伙伴关系在他们的签名者注册表中公开列出： ``` https://asterpay.io/.well-known/reconciliation-signers.json ``` 与 AsterPay 集成后，MAKO → AsterPay 的可靠性读取和 AsterPay → MAKA 的每日对账 webhook 有效载荷采用相同的规范信封形状。有关线路格式和验证伪代码，请参见 [`docs/asterpay-integration.md`](./docs/asterpay-integration.md)。 该集成形状 - 每个路由的 `extensions.reliability` + 链结算费用块 - 可以推广到任何 x402 促进者。我们正在将相同的模式应用于其他促进者和预测市场合作伙伴。 ## 为什么存在 x402 解决了代理如何支付的问题：`402 Payment Required` HTTP响应携带价格、网络、结算资产和收款人，后续请求包含签名的 EIP-3009 转账授权。Coinbase 的促进者在一次往返中在链上结算。 x402 没有解决代理是否应该支付的问题。当自主代理开始花费真正的 USDC 调用真正的服务时，它们需要： - **预支出验证**，目标是可调用的、模式有效的，并且结算准备就绪。捕获 agentic.market 上 30%+ 的服务实际上并没有对无付款探测返回干净的 402 响应 - 在电汇调用之前。 - **端点可靠性评分**，基于所有验证的总体情况，而不是操作员自我报告的正常运行时间。 - **市场价格情报**，以便路由代理可以选择满足规格的最便宜选项，并且预算代理可以确定每任务分配的美元金额。 - **每钱包操作员声誉**，在卖方操作的所有端点中汇总可靠性和结算行为 - 在结构上与新兴的 ERC-8004 无信任代理声誉语义兼容。 封闭式企业替代方案存在于该部分（Prove Identity，Trulioo Know-Your-Agent）。MAKO 是开放的、原生的 x402 版本，它将每个基本要素作为可调用的付费端点提供，而不是将它们捆绑在单个 API 密钥后面。 ## 快速入门（TypeScript） ```bash npm install @pollinate/mako ``` ```ts import { MakoClient } from "@pollinate/mako"; import { createWalletClient, http } from "viem"; import { privateKeyToAccount } from "viem/accounts"; import { base } from "viem/chains"; const wallet = createWalletClient({ account: privateKeyToAccount(process.env.AGENT_PRIVATE_KEY as `0x${string}`), chain: base, transport: http(), }); const mako = new MakoClient({ wallet }); // 路由 - 单次调用推荐（$0.05） const route = await mako.route({ task: "crypto-data", execution_mode: "recommend", buyer_wallet: wallet.account.address, constraints: { max_price_usdc: "0.20", min_reliability_score: 0.50, min_reputation_score: 0.50, preferred_jurisdictions: ["US", "EU"], }, }); if (route.verdict === "callable") { // route.recommendation.endpoint 是最佳 x402 服务调用 // route.receipt 是 EIP-191 签名证明，有效期为 60 秒 // route.alternatives 列出最多 3 个排名靠后的备用方案 console.log("Calling:", route.recommendation.endpoint); // ... 对推荐目标进行实际付费调用 } else { // verdict ∈ "no_match" / "all_filtered" / "all_unreliable" // best_available_anyway 显示如果过滤器过紧，则显示最接近的匹配项 console.warn("No clean match:", route.reason); } ``` 如果您想要原始信号而不是组合答案，可以单独调用四个支柱： ```ts const verdict = await mako.verify({ target_url: "https://target.example/api/foo", intended_task: "...", max_price_usdc: 0.10 }); const pulse = await mako.pulse({ endpoint: "https://target.example/api/foo", window: "30d" }); const pricing = await mako.pricingIndex({ category: "trading_signals", window: "30d" }); const reputation = await mako.reputation({ address: "0x...", window: "30d" }); ``` 有关 Python 和 MCP 买方代理示例，请参见 [`examples/`](./examples)。 ## 通过 MCP（Hermes Agent，OpenClaw，Claude Desktop，Cline）使用 在 MCP 原生代理运行时中使用 MAKO 的最快方法是官方 MCP 服务器，发布在 npm 上为 [`@pollinateresearch/mako-mcp`](https://www.npmjs.com/package/@pollinateresearch/mako-mcp)。它将所有六个付费端点公开为 MCP 工具（`mako_route`、`mako_verify`、`mako_pulse`、`mako_pricing`、`mako_reputation`、`mako_markets_aggregate`），处理 x402 支付流程端到端，并与任何兼容 MCP 的客户端一起工作。 ```bash npm install -g @pollinateresearch/mako-mcp ``` 添加到您的 MCP 客户端配置（Claude Desktop 示例）： ```json { "mcpServers": { "mako": { "command": "mako-mcp", "env": { "X402_BUYER_PRIVATE_KEY": "0x..." } } } } ``` 五个工具可供代理使用：`mako_route`、`mako_verify`、`mako_pulse`、`mako_pricing`、`mako_reputation`。每个调用都在 Base 主网上通过 Coinbase CDP 以实时 USDC 结算，并响应中包含 EIP-191 签名收据。 源代码、与 Hermes Agent 和 OpenClaw 的集成配方以及完整设置：[`github.com/ChrisDover/mako-mcp-server`](https://github.com/ChrisDover/mako-mcp-server)。 ## MAKO 路由 - 单次调用路由（主要产品） `POST /api/route` - $0.05 USDC 路由是组合的顶点。买方代理提交规范的任务名称（例如 `crypto-data`、`search`、`governance-brief`、`endpoint-verification`）以及可选的约束（最大价格、最低可靠性/声誉阈值、首选司法管辖区、禁止操作员）。MAKO 根据脉冲 + 定价指数 + 声誉评分信号评估每个目录候选者，应用硬过滤器，并返回： - 最高评分的**推荐**（端点 + 操作员钱包 + 广告价格 + 可靠性/声誉/公平性数据） - 多达 3 个**排名靠后的备用方案**用于降级 - 一个**EIP-191 签名收据**，在 60 秒内有效，涵盖买方在确切约束下的推荐 - **决策有效载荷**，以便任何人都可以无信任地重新哈希和验证签名 复合评分（默认权重）： ``` score = 0.40 × reliability + 0.30 × fairness + 0.20 × reputation + 0.10 × jurisdiction_bonus ``` 响应形状： ```json { "verdict": "callable", "task": "crypto-data", "recommendation": { "endpoint": "https://api.nansen.ai", "operator_wallet": "0x93053f1e...", "price_quoted_usdc": "0.10", "endpoint_reliability_score": 0.97, "operator_reputation_score": 0.94, "fairness_note": "比类别中位数低 8% ($0.11)", "jurisdiction": "US", "kya_status": "unknown", "rank": 1 }, "alternatives": [ { "endpoint": "https://public.zapper.xyz", "rank": 2, ... } ], "candidates_evaluated": 4, "candidates_passing_filters": 4, "receipt": { "checked_at": "2026-05-08T23:25:06Z", "message_hash": "0x...", "signature": "0x...", "signer": "0x12BBC7Cde00eB800588243A0B3B4E8E802673BFf", "signature_scheme": "eip191" }, "decision_payload": { ... }, "request_id": "rt_...", "issued_at": 1746719999, "receipt_expires_unix": 1746720059, "execution_result": null } ``` `verdict` ∈ `callable` / `no_match` / `all_filtered` / `all_unreliable`。`no_match` 情况（任务不在目录中）返回 422 且不收费。过滤失败的判决返回 200 + `best_available_anyway`（即使过滤，仍然接近匹配），以便买家看到接近可行的方案。 **v1 仅支持 `execution_mode: "recommend"`**。执行和 execute_with_fallback（MAKO 代表买家实际调用所选服务）将在 v2 中发布。 目录（v1，由当前 Pulse 人口手动策划）：28 个服务，涵盖 13 个任务桶 - `endpoint-verification`、`pulse-score`、`pricing-data`、`reputation-data`、`governance-brief`、`proposal-signal`、`crypto-data`、`market-data`、`search`、`image-generation`、`ai-inference`、`data-extraction`、`agent-storage`。目录扩展将在 v2 中自动从 agentic.market 导入。 默认可靠性/声誉阈值在启动时故意放松（0.50），因为验证者账本稀疏。路由量聚集了账本；冷启动即产品。 ## 四个底层支柱 ### 验证器 - 预支出信任检查 `POST /api/agent-commerce/verify` - $0.25 USDC 头部路线。买方代理描述了它即将执行的操作以及它愿意花费的金额；MAKO 检查目标的 `/.well-known/x402.json`，验证路由模式，检查结算准备情况，并返回机器可读的判决。 响应形状： ```json { "service": "_MAKO Agent Commerce Verifier", "verdict": "callable", "score": 86, "recommended_route": "GET /api/governance/proposal-signal", "price_usdc": 0.05, "schema_valid": true, "settlement_ready": true, "warnings": [], "call_plan": { "method": "GET", "url": "https://target.example/api/foo", "query": { "key": "value" } }, "receipt": { "message_hash": "0x...", "signature_scheme": "sha256" } } ``` `verdict` ∈ `callable` / `proceed_with_caution` / `not_callable`。`risk_mode: "strict"` 提高了被视为可调用的标准。`receipt` 是哈希锚定的，可以针对返回标头中的 `record_id` 验证，查询路径为 `GET /api/agent-commerce/receipts/{record_id}`。 参见 [`examples/01-verify.ts`](./examples/01-verify.ts)。 ### 脉冲 - 端点可靠性 `GET /api/pulse/score` - $0.02 USDC 脉冲询问：“这个特定网址今天表现如何？”它读取 MAKA 的验证账本并返回可调用率、模式合规率、结算成功率、延迟 p50/p95 和 0-100 的可靠性评分，在可配置的窗口内（`7d`、`30d`、`90d`、`all`）。 ```json { "endpoint": "https://target.example/api/foo", "reliability_score": 87, "status": "healthy", "window": "30d", "verifications": { "total": 42, "callable": 39, "not_callable": 2, "degraded": 1 }, "rates": { "callable_rate": 0.929, "schema_compliance_rate": 1.0, "settlement_success_rate": 0.976 }, "latency": { "p50_ms": 240, "p95_ms": 612 }, "confidence": "high", "receipt": { "message_hash": "0x...", "signature_scheme": "sha256" } } ``` 公开显示 Pulse 读取的排行榜，网址为 [`mako.pollinateresearch.com/pulse`](https://mako.pollinateresearch.com/pulse)，JSON 格式为 `/pulse.json`。当您需要为特定网址按需获取新鲜分数时，请使用付费的 `/api/pulse/score` 路由。 参见 [`examples/02-pulse-score.ts`](./examples/02-pulse-score.ts)。 ### 定价指数 - 市场价格情报 `GET /api/pricing/index` - $0.02 USDC 定价指数询问：“对于这种工作，公平的价格是多少？”它将 MAKA 验证的每个端点分组到九个类别之一（`crypto_intelligence`、`trading_signals`、`governance`、`compliance`、`trust_layer`、`data_feeds`、`ai_inference`、`agent_infrastructure`、`other`），并返回每个类别的价格分布。 ```json { "category": "trading_signals", "window": "30d", "sample_size": { "verifications": 412, "unique_endpoints": 38 }, "pricing_usdc": { "min": 0.005, "p25": 0.02, "median": 0.05, "mean": 0.084, "p75": 0.10, "p95": 0.25, "max": 0.50 }, "endpoint_count_by_price_band": { "free": 2, "0.001_to_0.01": 8, "0.01_to_0.05": 14, "0.05_to_0.10": 9, "0.10_to_0.25": 4, "above_0.25": 1 }, "confidence": "high", "computed_at": "2026-05-08T14:22:11Z", "receipt": { "message_hash": "0x...", "signature_scheme": "sha256" } } ``` 分布统计数据仅在**唯一端点**（最新观察价格）上计算，因此高容量端点无法影响指数。省略 `category` 以获取类别中位数、均值和 p95 的市场范围分解。 为路由代理选择满足规格的最便宜端点而构建，为预算代理管理每任务美元计费分配而构建，为运营商定价自己的服务而构建。 参见 [`examples/03-pricing-index.ts`](./examples/03-pricing-index.ts)。 ### 声誉评分 - 每钱包操作员信任 `GET /api/reputation/wallet` - $0.03 USDC 声誉评分询问：“这个卖家在他们经营的所有业务中值得信赖吗？”脉冲是按端点计算的，而声誉评分是按钱包计算的 - 它聚合了给定卖家钱包操作的所有 x402 端点的可调用率、模式合规性、结算准备度和最近度，并返回 0-100 的综合评分和一个层级（`trusted` / `reliable` / `developing` / `unreliable` / `unknown`）。 ```json { "wallet": "0x4f3a2d1e9c7b6a5f8e3d2c1b0a9f8e7d6c5b4a3f", "chain": "eip155:8453", "window": "30d", "reputation_score": 87, "tier": "trusted", "confidence": "high", "sub_scores": { "callable_rate": 0.94, "schema_compliance_rate": 0.99, "settlement_success_rate": 0.91, "recency_factor": 1.0 }, "weights_used": { "callable_rate": 0.40, "schema_compliance_rate": 0.20, "settlement_success_rate": 0.30, "recency_factor": 0.10 }, "activity": { "total_verifications": 312, "unique_endpoints": 4, "categories_operated": ["crypto_intelligence", "trading_signals"], "first_seen_at": "2026-03-12T08:14:08Z", "last_verified_at": "2026-05-09T20:42:11Z", "days_active_in_window": 28 }, "warnings_summary": [{ "warning": "schema_drift", "count": 3 }], "receipt": { "message_hash": "0x...", "signature_scheme": "sha256" } } ``` 模式在结构上与新兴的 ERC-8004 无信任代理声誉语义兼容：`score`、`tier`、`confidence`、子评分和权重都是显式的，并且收据是哈希锚定的。为反向代理评估代理、路由代理选择等价价格的卖家以及担保/纠纷服务而构建。 参见 [`examples/04-reputation.ts`](./examples/04-reputation.ts). ## DAO 治理运营（原始产品线） MAKO 从同一域名上仍然可用的早期服务线发展而来： - `POST /api/governance/weekly-brief` - $1.00 USDC. 根据 Snapshot 和 Tally 提案源生成中立的 DAO 治理每周简报。返回源链接的 Markdown 以及结构化提案元数据。 - `GET /api/governance/proposal-signal` - $0.05 USDC. 最近的 Snapshot 提案，带有截止日期、选择、分数和紧急标志。足够频繁调用，以便在购买完整每周简报之前进行决策。 这些仅为信息目的 - MAKA 不会投票、不签署交易或托管资金。参见 [`examples/05-governance-brief.ts`](./examples/05-governance-brief.ts). ## 架构 参见 [`ARCHITECTURE.md`](./ARCHITECTURE.md) 以获取四柱图、数据流和关于验证账本如何从一个源向脉冲、定价指数和声誉评分提供信息的更长说明。 ## 状态 - **网络：** Base 主网（`eip155:8453`） - **结算资产：** 在 `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` 处的 USDC - **促进者：** Coinbase CDP（带有 `x402.org/facilitator` 备用） - **已列出：** [agentic.market](https://agentic.market/?service=mako-pollinateresearch-com) - **实时发现：** [`/.well-known/x402.json`](https://mako.pollinateresearch.com/.well-known/x402.json) - **实时脉冲排行榜：** [`/pulse`](https://mako.pollinateresearch.com/pulse) - 目前对 700+ 目录服务中的 248+ 进行评分 - **路由目录：** 28 个服务，涵盖 13 个任务桶，由当前 Pulse 人口手动策划 - **收据签署者：** `0x12BBC7Cde00eB800588243A0B3B4E8E802673BFf`（EIP-191） - **源代码：** 本仓库 ## 自主托管 要运行您自己的 MAKA 促进者，您需要： - 一个 Base 主网钱包来接收付款 - 一个与 EIP-3009 兼容的促进者（推荐 Coinbase CDP，x402.org/facilitator 作为备用） - 一个 FastAPI 兼容的主机（Render、Fly、Railway、Heroku - 均可；参考部署使用 Heroku） 生产代码位于操作员的私有仓库中，不在此处分发。该 SDK 调用到任何兼容的 MAKA 部署，使用相同的 x402 协议，因此自我托管的端点是即插即用的：通过 `MakoClient` 构造函数将 `baseUrl` 传递给它。 ```ts const mako = new MakoClient({ wallet, baseUrl: "https://my-mako.example.com", }); ``` ## 贡献 参见 [`CONTRIBUTING.md`](./CONTRIBUTING.md)。问题和 PR 欢迎 - 特别是： - 买方代理集成（LangChain、AutoGen、CrewAI 等） - 额外的语言 SDK（Python、Go、Rust） - 将 [`@pollinateresearch/mako-mcp`](https://www.npmjs.com/package/@pollinateresearch/mako-mcp) MCP 服务器与特定代理运行时（Hermes Agent、OpenClaw、Cline、Cursor）配对的配方 - 特定垂直领域的示例（DEX 交易、治理、合规） ## 安全 参见 [`SECURITY.md`](./SECURITY.md)。通过电子邮件（chrisdover@gmail.com）或 PGP（应要求提供）报告漏洞 - 请不要在公共问题上发布安全敏感的发现。 ## 运营商 由 [Pollinate Research](https://pollinateresearch.com) 构建和运营。 联系方式：chrisdover@gmail.com · `chrisdmacro.base.eth` · [`github.com/ChrisDover`](https://github.com/ChrisDover) ## 许可证 MIT - 参见 [`LICENSE`](./LICENSE).