选择你需要的托管服务。

回忆 – 只读

托管 MCP 端点在 mcp.whitemagic.dev/mcp（streamable-http），面向精选公开语料库提供回忆：文档、规范、发布说明与 grimoire。目录探测可免密钥调用 initialize / tools/list；匿名免费额度为每客户端 IP 每日 3 次调用（无需密钥、无需请求头）；免费评估密钥可在 mcp.whitemagic.dev/keys 即时获取（每日 50 次回忆、无需账户、邮箱可选）；支持 OAuth 2.1 的客户端亦可直接使用。偏好本地？请按版本固定的安装指南启用完整的本地写入路径。你的本地存储不会被上传。

托管记忆 – 写入测试版（next 通道）

实验性通道 next.mcp.whitemagic.dev/mcp 在只读语料库旁提供邀请制写入测试版：具备写入作用域的密钥获得隔离的租户存储，其读取结果以 partition: tenant | corpus 标签融合租户与语料库。 写入作用域覆盖评估密钥的每日样本（20 次写入 / 1 MB）与 x402 task 及以上租约的每付款方每日预算（500 次写入 / 10 MB）。 每条路径均受配额、每密钥写入速率限制、通道每日预算与磁盘保护约束；拒绝操作以无内容方式审计。 租户控制：在 next 通道主机上使用该租户密钥调用 GET /tenant/export 与 DELETE /tenant?confirm=1。租户方案（$5/月每 128 MB，含 10,000 次写入/月，超出 $1/10,000 次）是测试版开放期间的已发布方向； 只读主通道保持不变。

验证、锚定与收据

无状态验证 API 位于 api.whitemagic.dev：免密钥的 /health、/info 与 /openapi.json；密钥调用的 /verify（bundle → 结论，可附签名验证收据）、 /verify-receipt、/verify-anchor 与 /anchors（OpenTimestamps 证明托管；免密钥获取于 /anchors/<digest>）。2026-11-07 查阅的服务元数据显示验证器版本为 0.5.1，并支持 0.1–0.6 规范； OpenAPI 合约 的合约修订版本为 0.4.1（共 20 个路径，涵盖验证、AER1 检查、锚定、支付收据、公证、Memory Crystals 与 ERC-8004 适配器）。免密钥 POST /aer1/verify 针对 AER1 draft 22 配置分别返回结构和身份判定。集成前请查看实时 /info 元数据。格式与五分钟走查见 信任页 与 收据页。

上下文证明（Proof-of-Context）公证

为智能体决策提供审计轨迹：POST /notarize 对调用方提供的上下文摘要或提示词哈希以及有界声明——动作标签、模型标识、可选元数据与调用方智能体地址——进行签名， 返回带防篡改 UTC 时间戳的 Ed25519 证明。读取免密钥：GET /notarize/<digest>。 服务不会观察底层上下文或执行过程；它证明的是调用方所提交的内容，而非该声明为真。 集成 POST /notarize 前，请核对当前服务元数据与访问要求。

# Python（whitemagic-pay）
receipt = client.notarize_context(
    context_digest="sha256:...",   # 或 prompt_hash
    action="agent.decision",
    model="gemini-2.5-flash",
    metadata={"epoch": 1},
)

// TypeScript
const receipt = await client.notarizeContext({ contextDigest: "sha256:...", action: "agent.decision" });

评测端点

面向评测框架的 Add / Search / Delete，作用于按参与者隔离的存储：api.whitemagic.dev/eval（免密钥健康检查在 /eval/health；访问令牌按需申请；仅供评测的基础设施，无 SLA）。

ERC-8004 任务结论映射

托管适配器位于api.whitemagic.dev/erc8004/validate，根据核心收据验证器的结论和任务绑定映射结果：TRUSTED → ACCEPT，PROVISIONAL → NEEDS_EVIDENCE，UNTRUSTED → REJECT。此适配器不评估签发者策略，也不要求锚定。chain_integrity、signatures_valid、policy_compliant、resource_caps_respected 与 anchors_verified 五项检查均返回 null（未报告）。 它返回 Ed25519 签名的规范 JSON 声明；该签名不是对任务事实的独立证明。服务不会向链上提交声明或结算交易。 请参阅实时API 信息。 调用通过 x402；本页已公布的端点价格见上方摘要。

客户端加密的 Memory Crystals

客户端加密的智能体状态存储：api.whitemagic.dev/crystals。状态载荷在客户端使用 ChaCha20-Poly1305 AEAD 加密；只要密钥留在客户端，加密就能保护明文。服务端存储由 SHA-256 对象 ID 寻址的密文。所有读取与写入都需要通过显式所有者注册表映射的身份验证断言；支付或会话通行证本身不建立所有权。所有者映射由操作员手动确认，不会自动按首位读取者分配，也不提供自助映射流程。现有未映射旧数据会保留在受保护隔离区，直到操作员明确确认映射。若需要处理现有未映射水晶，可通过 联系页面请求所有权审核；请勿发送明文、加密密钥或持有者凭证。已映射所有者可通过 GET /crystals/owner-locator 获取注册表中的定位符。wm-crystal/1.0 envelope 格式保持不变。读取和谱系查询保持免费，并需通过已验证的所有者范围访问。读取使用 Cache-Control: private, no-store；只有通过所有者身份验证后才会返回条件 ETag/304 响应，不使用共享缓存。谱系查询按已验证的所有者范围进行：GET /crystals/lineage；写入仍通过 x402 按上方已公布价格收费。/info 元数据声明水晶专属大小上限为 2 MiB；通用 API 请求体上限为 1 MiB；水晶端点另有 2 MiB 专属上限。请参阅在线API 信息 与OpenAPI 合约。

计量与密钥

计量调用通过 x402 以 Base 上的 USDC 按次结算：对密钥方法发起免密钥调用会返回 HTTP 402，支付要求就在 challenge 中——无需账户、无需发票。免费评估密钥保持免费（每日 50 次回忆、邮箱可选），匿名免费额度每客户端每日 3 次调用、完全无需密钥，按合同密钥则拥有更高配额与带计量的审计记录。范围与条款见 与实验室合作 或 联系我们。

x402 快速开始

使用 x402 的方法会通过 HTTP 402 返回支付要求，并以 base64 形式放在 PAYMENT-REQUIRED 头中。捕获的 /mcp challenge 声明了上方的单次、任务、集群和日票租约档位；这并非成功付款调用的证明。付款钱包的首次付费调用还会返回欢迎会话通行证（响应头 X-Session-Pass 与工具结果中均有）；复用它即可跳过逐次支付。

想用客户端库？开源 whitemagic-pay SDK 会自动协商挑战、签名许可、缓存租约并重试——还能在无钱包时领取免费水龙头通行证。 PyPI · npm · 源码

pip install whitemagic-pay        # Python
npm install whitemagic-pay        # TypeScript

# Python
from whitemagic_pay import X402Client
client = X402Client(private_key="0xYOUR_FUNDED_BASE_KEY", preferred_tier="task")
status, data, headers = client.request("POST", "https://mcp.whitemagic.dev/mcp", data={...})

// TypeScript
import { X402Client } from "whitemagic-pay";
const client = new X402Client({ privateKey: process.env.AGENT_WALLET_KEY, preferredTier: "task" });
const { status, data } = await client.request("POST", "https://mcp.whitemagic.dev/mcp", { ... });

# 还没有钱包？水龙头提供免费 10 分钟通行证：
client.claim_faucet("https://mcp.whitemagic.dev")   # Python
await client.claimFaucet("https://mcp.whitemagic.dev"); // TypeScript

手动付款方（Python，eth-account）： 为 challenge 签署 EIP-3009 授权，并用 base64 载荷重试。

python3 - <<'PY'
import base64, json, secrets, time, urllib.request, urllib.error
from eth_account import Account
from eth_account.messages import encode_typed_data

URL = "https://mcp.whitemagic.dev/mcp"
acct = Account.from_key("0xYOUR_FUNDED_BASE_KEY")

body = {"jsonrpc": "2.0", "id": 1, "method": "tools/call",
        "params": {"name": "memory.search",
                   "arguments": {"query": "recall where we left off"}}}
req = urllib.request.Request(URL, data=json.dumps(body).encode(),
                             headers={"Content-Type": "application/json"})
try:
    urllib.request.urlopen(req)
except urllib.error.HTTPError as e:
    challenge = json.loads(e.read())

tier = challenge["accepts"][0]        # $0.002 call; [1..3] = task/swarm/day
now = int(time.time())
auth = {"from": acct.address, "to": tier["payTo"], "value": str(int(tier["amount"])),
        "validAfter": str(now - 60), "validBefore": str(now + 300),
        "nonce": "0x" + secrets.token_hex(32)}
domain = {"name": tier["extra"]["name"], "version": tier["extra"]["version"],
          "chainId": 8453, "verifyingContract": tier["asset"]}
msg = encode_typed_data(full_message={
    "types": {"TransferWithAuthorization": [
        {"name": "from", "type": "address"}, {"name": "to", "type": "address"},
        {"name": "value", "type": "uint256"}, {"name": "validAfter", "type": "uint256"},
        {"name": "validBefore", "type": "uint256"}, {"name": "nonce", "type": "bytes32"}]},
    "primaryType": "TransferWithAuthorization", "domain": domain, "message": auth})
sig = acct.sign_message(msg).signature.hex()
payment = {"x402Version": 2, "resource": challenge.get("resource"), "accepted": tier,
           "payload": {"signature": sig if sig.startswith("0x") else "0x" + sig,
                       "authorization": auth},
           "extensions": challenge.get("extensions") or {}}
req.add_header("PAYMENT-SIGNATURE",
               base64.b64encode(json.dumps(payment).encode()).decode())
resp = urllib.request.urlopen(req)
print("pass:", resp.headers.get("X-Session-Pass"))  # reuse for later calls
print(resp.read(300).decode())
PY

复用通行证——无需逐次签名：

curl -s https://mcp.whitemagic.dev/mcp \
  -H "X-Session-Pass: wm_pass_..." \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"memory.search","arguments":{"query":"..."}}}'

常见 402 错误：载荷不是 base64 JSON；授权中缺少 signature；nonce 重放（每次授权仅可使用一次，需重新签名）；USDC 不足或链不匹配。免费替代：X-WM-Trial: 1 每日 10 次调用、即时 评估密钥 （每日 50 次回忆），或 POST /faucet 获取 10 分钟通行证。

记录什么，以及边界

网关审计条目可能包含密钥名称或“unknown”、时间戳、方法、状态、字节数、规范化路由、JSON-RPC 方法与工具名称、客户端类别、受限的 User-Agent 类别、延迟和决策详情。条目不包含工具参数、查询文本、响应内容、持有者令牌或原始 User-Agent 字符串。对于无法识别且非空的 User-Agent，会以截短的 SHA-256 指纹表示。匿名试用限额会在内存中使用客户端 IP 进行每日计数；faucet 使用 IP 和可选的付款方/地址标识，并会将两者写入部分持久审计条目。bundle 验证在内存中处理，提交的 bundle 内容不会作为 bundle 内容存储。详见《隐私政策》 与 《服务条款》。评测端点会保存按参与者隔离的记录，以支持 Add/Search/Delete 操作；没有公布统一的自动过期计划。API 还可能持久化撤销文件、锚定证明、支付收据、调用方声明公证记录（保存提交的摘要和受限声明，不保存底层提示词或执行过程）、客户端加密的水晶对象、防重放断言 nonce 和服务签名密钥。可选验证缓存保存在内存中，代码设置的有效期为 15 分钟；断言 nonce 保留至过期时间加上时钟偏差容许值。网关审计日志按周期轮转，目标保留 90 天；旧归档可能不会立即过期。托管存储与持久授权状态的备份最多保留 4 份每周远程副本和 12 份每周本地副本；从活动存储中删除的服务记录仍可能存在于这些备份中。审计日志不包含在该备份集中。所有者映射、服务签名密钥、收据和水晶密文等其他持久状态没有统一过期计划。 Glimind 会收到运行工具调用 span，其中包含受限的工具名称、HTTP 状态、延迟、服务标签和错误类别，不含参数、结果、载荷、令牌、密钥或 IP 地址。详见《隐私政策》。托管回忆通道只读且限流；其他端点遵循上文列出的访问和付费条款。各项服务均不提供 SLA，并在部分内核限制下运行——一律披露，不作隐藏。