Reason Codes Reference

Value exceeds max_single policy limit

Example: $500 transaction when max_single is $100

Would exceed daily spending limit

Example: $600 when $500 already spent today (max_daily: $1000)

Would exceed weekly spending limit

Example: Near end of week with budget exhausted

Would exceed monthly spending limit

Example: Large purchase near month end

Value exceeds require_human_above threshold

Example: $750 transaction when ask_me_above is $500

Value malformed, negative, or precision overflow

Example: Negative amount or NaN value

Currency code not recognized

Example: Unknown or malformed currency symbol

Chain identifier not recognized

Example: Unknown blockchain network

Action format or structure invalid

Example: Missing required fields in action

First-time payment recipient

Example: Paying a vendor for the first time

Target in merchant blocklist

Example: Known scam or sanctioned address

Target not verified in registry

Example: Vendor not in trusted registry

Contract below minimum age threshold

Example: Contract deployed 2 hours ago (min: 72h)

Target revoked in registry

Example: Previously approved vendor now flagged

Chain not in allowed_chains list

Example: Transaction on Polygon when only Base allowed

Chain not recognized by policy

Example: New L2 not yet in configuration

Transaction crosses chain boundaries

Example: Bridge operation between networks

Currency in blocked_currencies list

Example: Meme coin when only stables allowed

Currency not in configuration

Example: New token not yet categorized

Price oracle data too old

Example: Price data over 5 minutes old

Exceeds configured rate limits

Example: 100 transactions in 1 minute (max: 50)

Unusual transaction burst pattern

Example: 20 transactions in 10 seconds

Possible split transaction attack

Example: Five $99 transactions to same address

Known wallet drainer detected

Example: Interacting with flagged drainer

Address confusion attack detected

Example: Similar address to known contact

Token with sell restrictions detected

Example: Token that cannot be sold

Phishing attempt detected

Example: Spoofed merchant or contract

Agent confidence below threshold

Example: Agent reports 40% confidence (min: 70%)

Confidence not provided in action

Example: Action missing confidence field

Action hash seen within window

Example: Same action submitted twice in 10 seconds

Emergency stop engaged

Example: System-wide emergency halt active

Verification service unreachable

Example: Registry API timeout

Escalation expired without response

Example: No human response within timeout