防护规则 | Xona Docs

在触及任何签名器之前运行的支出上限、允许的主机以及审批钩子。

防护规则在触及任何签名器之前运行，因此行为异常的智能体无法绕过它们。金额上限同时适用于付费调用和转账；允许的主机仅适用于 x402 调用。

xpay guardrail set \
  --max-per-tx 0.5 \
  --max-per-day 5 \
  --require-approval-above 1 \
  --allowed-hosts 'api.payai.network,*.xona.xyz'

金额达到或超过 requireApprovalAbove 的调用需要明确审批：启用生物识别解锁时为 Touch ID 提示，否则为终端中的 y/n 确认。在 MCP 服务器中仅支持 Touch ID，智能体发起的大额付款会以系统对话框的形式出现，需要你亲自批准。在 SDK 中，可以将 onApprovalRequired 钩子接入任何你喜欢的方式：推送通知、生物识别提示或 webhook。

上限可以防止超支，但无法区分正常付款与遭受提示词注入的付款。为此，可以启用可选的 Bento 意图防火墙：每笔付款在签名前都会经过恶意意图筛查（提示词注入、钱包盗空）。使用 xpay bento enable 开启。