Protocols v1.2

ENGINEER_REFERENCE

Complete documentation for the FOB Trust Layer. Interface directly with autonomous agent kernels, cryptographic mandates, and low-latency settlement rails.

AUTHENTICATION

All API interactions require an FOB-Auth-Token. High-privilege actions (like Mandate overrides) require additional biometric signing via the FOB Mobile Guardian.

Authorization: Bearer fob_live_72x99_44kL...
POST /v1/payment/execute

EXECUTE_TRANSACTION

Consensus Required

Triggers an immutable on-chain settlement. The protocol validates the request against the active agent mandate in real-time before broadcasting to the ledger.

REQUEST PARAMETERS

mandate_id UUID (Required)

The specific cryptographic mandate allowing this spend.

amount_usd Float (Required)

Total settlement amount in micro-cents.

nonce String (Unique)

Prevent replay attacks. Valid for 60 seconds.

PAYLOAD_SCHEMA 
{
  "mandate_id": "mdt_0xf492...",
  "agent_id": "agt_kyc_certified_v1",
  "execution": {
    "method": "IMMEDIATE_SETTLEMENT",
    "amount": 2450.00,
    "currency": "USDC"
  },
  "signature": "sig_78x...990"
}
Execute in Dashboard

Interactive Explorer

ERROR_PROTOCOLS

System Code Reason Resolution Path
401_AUTH_REVOKED The provided token has been manually blacklisted or has expired. Refresh via Console
403_MANDATE_CAP Requested amount exceeds the available mandate liquidity pool. Increase Staking Lock
429_RATE_THROTTLE Concurrent execution calls exceeded the allowed Tier limit. Upgrade to Tier_02
503_LEDGER_SYNC Temporary delay in blockchain consensus verification. Retry with Expiry+10s