io.github.aiguardrail/backend

Collar Guardrail — Pre-Trade Risk Layer

Deterministic pre-trade risk checks for AI agents on Robinhood Chain. Returns allow/warn/deny.

1.0.5
Version
remote
Transport
6
Tools

Security review

Review passed

Reviewed 1d ago.

  • tools: 6 tools scanned
  • metadata: scanned

No findings.

Tools (6)

  • evaluate_trade

    Pre-trade risk check for a proposed trade. Call this BEFORE executing any trade and treat a "deny" decision as a hard stop. Evaluated at a fixed Tier 1 ceiling ($5,000 notional). For higher limits, use `evaluate_trade_paid` (Tier 2, $25,000) which settles an x402 payment on-chain.

  • evaluate_trade_paid

    Pre-trade risk check gated by an x402 payment. Evaluated as COLR Tier 2: $25,000 notional ceiling, 10/25 per-minute rate limits. No COLR holdings are required — the on-chain payment is the credential. FLOW ---- 1. Call WITHOUT payment_proof → the tool returns a `PaymentRequiredOutput` describing the on-chain payment (network, asset, amount, payTo, resource). 2. Settle the payment on-chain using an x402-capable client. The facilitator returns a proof string. 3. Call again with `payment_proof=<proof>` → the tool forwards the proof to the guardrail's x402-paid endpoint and returns a full `EvaluateTradeOutput` with `tier=2`.

  • check_token_safety

    Honeypot / contract safety check for any ERC-20 token.

  • simulate_balance

    Simulate a wallet's ERC-20 balance after a hypothetical trade using eth_call state override. Read-only: no transaction is ever sent.

  • get_supported_assets

    List every asset in the guardrail's official Robinhood Chain registry, with its canonical contract address.

  • verify_audit_trail

    Verify the tamper-evident audit trail for a wallet's past guardrail decisions.