Guardrail | Xona Docs

Hạn mức chi tiêu, host được phép và hook phê duyệt chạy trước khi bất kỳ signer nào được sử dụng.

Guardrail chạy trước khi bất kỳ signer nào được sử dụng, nên một agent hoạt động sai không thể vượt qua chúng. Hạn mức số tiền áp dụng cho cả lệnh gọi trả phí lẫn chuyển tiền; host được phép chỉ áp dụng cho lệnh gọi x402.

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

Các lệnh gọi bằng hoặc vượt requireApprovalAbove cần được phê duyệt rõ ràng: lời nhắc Touch ID khi đã bật mở khóa sinh trắc học, nếu không thì là xác nhận y/n trong terminal. Trong MCP server chỉ dùng Touch ID, một khoản thanh toán lớn của agent sẽ hiện lên dưới dạng hộp thoại hệ thống để bạn tự tay phê duyệt. Trong SDK, hãy nối hook onApprovalRequired với bất cứ thứ gì bạn muốn: push notification, lời nhắc sinh trắc học hoặc webhook.

Hạn mức ngăn chi tiêu quá mức, nhưng không thể phân biệt một khoản thanh toán hợp lệ với một khoản bị prompt injection. Để làm việc đó, hãy bật tường lửa ý định Bento (tùy chọn): mọi khoản thanh toán đều được sàng lọc ý định độc hại (prompt injection, rút cạn ví) trước khi ký. Bật bằng xpay bento enable.