M2M Sentinel SDK 是 M2M Sentinel 的官方多语言客户端库，同时提供 Model Context Protocol（MCP）服务器和 Coinbase AgentKit ActionProvider。它面向在 Base 上运行的自主应用，提供确定性的 EVM 字节码能力观测和常见代理解析。调用方拥有交易策略的最终决定权。
主要能力
- EVM 字节码能力分析：对给定地址的字节码进行确定性观测，返回事实性能力证据和限制，而非安全保证或交易建议。
- 常见代理解析：支持 EIP-1967 等常见代理模式的解析。
- 多语言 SDK：提供 JavaScript、TypeScript 和 Python 客户端。
- MCP 服务器：可连接 Claude Desktop、Cursor、Windsurf 或任何兼容 MCP 的 LLM 代理。
- Coinbase AgentKit 集成：提供 ActionProvider。
- Base Account wallet_sendCalls 守卫：guardWalletSendCalls 是面向 Base Account / EIP-5792 批处理的客户侧执行身份边界。它先预检锚点调用并评估调用方策略，再调度剩余调用，并将剩余调用以最多四个为一波固定到第一个可信区块身份。每一波结算后按请求索引升序进行验证和策略检查，失败或拒绝会停止后续调度。所有检查通过后才转发原始分离请求。它不签名、不广播、不托管资金、不推断内部 UserOperation 语义，也不作安全声明。
- 交易预检示例：公共仓库包含一个仅使用模拟的交易边界示例 examples/transaction_preflight.js，它观测一个调用方提供的 Base 交易，将观测结果传递给调用方拥有的策略，并仅到达模拟签名/发送回调。在证据未验证、执行未解决、观测不匹配或缺少 Diamond 选择器映射时拒绝继续。它从不签名或发送交易；可选的实时模式仅使用调用方提供的 API 密钥头，且由调用方负责。
- 自主 x402 微支付：支持无头机器对机器（M2M）场景。
使用方式
- MCP 服务器：可通过 Smithery 一键安装，或使用本地 Stdio（claude_desktop_config.json），或远程 Streamable HTTP。当前 MCP 端点：https://api.m2msentinel.com/mcp；旧版 HTTP+SSE 兼容端点：https://api.m2msentinel.com/sse，消息地址：https://api.m2msentinel.com/messages。
- JavaScript/TypeScript 客户端：提供认证 SDK 快速入门。
- Python 客户端：提供交易特定预检示例。
- 快速尝试：可使用 Base USDC 示例地址 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 进行无需钱包或 API 密钥的快速尝试。响应包含事实性能力证据和限制，而非安全保证或交易建议。实时演示可能被限流（HTTP 429 带 Retry-After）或在上游证据源失败时不可用（HTTP 503）。其他地址仅接收公共预览。完整的 /v1/audit/:address 分析仍受 API 密钥或明确授权的 x402 支付保护；演示不会静默支付。客户端在演示错误后不会自动重试或回退到受保护路由。源代码 SDK 导出包含一个可运行的无凭据 JavaScript 示例 examples/try_public_demo.js，但它不包含在最后验证的 npm 1.2.7 制品中。
适用场景
- 在 Base 上运行的自主应用或代理，需要在交易前获取字节码能力观测和代理解析。
- 使用 MCP 的 LLM 代理（如 Claude Desktop、Cursor、Windsurf）需要集成链上情报。
- 使用 Coinbase AgentKit 的开发者需要 ActionProvider。
- 需要 Base Account / EIP-5792 批处理预检和策略评估的场景。
- 无头机器对机器微支付场景。
限制
- 调用方拥有交易策略；SDK 不提供安全保证或交易建议。
- 不签名、不广播、不托管资金。
- 完整分析需要 API 密钥或 x402 支付。
- 演示可能限流或不可用。
- 客户端不会自动重试或回退到受保护路由。
- 当前导出将 npm 1.2.8 标记为本地发布候选，而非已验证的发布制品；该候选版本不确立注册表发布或可安装性。安装命令使用最后验证的 npm 发布 1.2.7。
- 许可证：MIT License。版权所有 (c) 2026 M2M Sentinel。
