--- name: theloopbreaker.com description: theloopbreaker.com provides on-chain trust infrastructure for AI agents and email senders operating on the LoopBreaker/Vaultfire protocol. It exposes read-only endpoints for verifying sender trust, querying risk scores, inspecting insurance and dispute vaults, and retrieving protocol-wide metrics across Base, Avalanche, Arbitrum, and Polygon. host: theloopbreaker.com --- # theloopbreaker.com theloopbreaker.com is a trust-layer data host built around the ERC-8004 agent identity standard and the Vaultfire smart contract suite. It serves AI agents that need to evaluate counterparty trustworthiness before interacting, delegating, or routing messages. Its distinguishing feature is the combination of on-chain bond/vouch data, x402 payment proof, and dispute/insurance vault state into a single queryable surface — all read-only, no transaction execution. ## When to use this host Use theloopbreaker.com when an agent needs to evaluate on-chain trust for AI agent addresses or x402-bonded email senders within the Vaultfire/ERC-8004 ecosystem, monitor insurance and dispute vault health, or look up Vaultfire contract addresses across Base, Avalanche, Arbitrum, and Polygon. Do not use this host for executing any on-chain transactions — it is strictly read-only; use direct RPC calls or a transaction-capable host instead. Do not use it for general email deliverability checks, bulk address screening, off-chain reputation lookups, token price feeds, or chains outside its supported four networks. For cross-chain aggregated rankings or non-ERC-8004 identity systems, this host is not suitable. ## Capabilities ### Protocol & Contract Discovery Provides the foundational reference data — deployed contract addresses, chain metadata, and aggregate protocol state — that other lookups depend on for context and integration. - **`fetch-vaultfire-trust-contracts`** — Returns deployed Vaultfire trust-related smart contract addresses, chain metadata, and per-chain breakdowns across Base, Avalanche, Arbitrum, and Polygon. - **`fetch-trust-protocol-stats`** — Returns live protocol-wide trust metrics including total registered agent identities, active bonds, per-chain agent counts, and bonded token value by chain. ### Agent Trust Scoring Evaluates the on-chain trustworthiness of individual addresses and surfaces ranked comparisons across all registered agents, covering identity, bonds, vouching, and slash history. - **`fetch-agent-risk-score`** — Returns a composite on-chain risk score (0–100) and risk band for an address on a given chain, broken down by identity, reputation, bonds, vouching, and age components. - **`fetch-trustrank-leaderboard`** — Returns a ranked list of AI agents by trust score from the live ERC-8004 registry, filtered by chain. ### Email Sender Verification Classifies inbound email senders by checking their on-chain bond, x402 payment proof, and VNS identity, returning an inbox/review/spam routing recommendation with a signed receipt. - **`verify-email-trust-lane`** — Verifies a sender's wallet address or VNS name against bond, payment, and x402 headers, returning an inbox/review/spam routing recommendation and signed receipt envelope. ### Vault & Dispute Health Monitoring Surfaces live operational metrics for the insurance vault and dispute resolution contract, enabling agents to monitor pool balances, claim activity, and stake exposure. - **`fetch-trust-insurance-stats`** — Returns live insurance vault stats for a given chain, including pool balance, contributor count, claim count, and total paid out, along with the vault contract address. - **`fetch-trust-dispute-stats`** — Returns live dispute resolution statistics for a blockchain network, including filed count, resolved count, and total stake at risk, along with the dispute contract address. ### Cross-Chain Bridge Status Reports the current operational state of the Trust cross-chain bridge, including pause status, relayer count, and message throughput, for agents that depend on cross-chain identity propagation. - **`fetch-trust-bridge-status`** — Returns live cross-chain bridge state for a given chain, including message counts, pause status, relayer count, bridge contract address, and synced entity totals. ## Workflows ### Counterparty Trust Assessment *Use when an agent needs to decide whether to interact with, delegate to, or accept a vouch from an unknown address on a supported chain.* 1. **`fetch-vaultfire-trust-contracts`** — Confirm the correct contract addresses and RPC endpoints for the target chain before making on-chain lookups. 2. **`fetch-agent-risk-score`** — Retrieve the composite risk score and band for the target address, broken down by identity, bonds, vouching, and age. 3. **`fetch-trustrank-leaderboard`** — Cross-reference the address against the full leaderboard to understand its relative standing among all registered agents. ### Email Sender Trust Triage *Use when an agent needs to route an inbound x402-bonded email and wants to validate both the sender's on-chain standing and the broader protocol health before acting on the recommendation.* 1. **`fetch-trust-protocol-stats`** — Check that the protocol is active and bonds are present on the relevant chain before trusting verification results. 2. **`verify-email-trust-lane`** — Submit the sender address, message ID, and payment transaction to receive an inbox/review/spam routing recommendation and signed receipt. ### Vault Health Pre-Claim Check *Use when an agent needs to assess whether the insurance vault has sufficient funds and the dispute system is operational before initiating an off-protocol claim or escalation.* 1. **`fetch-trust-insurance-stats`** — Retrieve current pool balance, contributor count, and total payouts to assess vault solvency. 2. **`fetch-trust-dispute-stats`** — Check filed vs. resolved dispute counts and total stake at risk to gauge system load and contract health. 3. **`fetch-trust-bridge-status`** — Verify the cross-chain bridge is not paused and relayers are active if the claim involves a non-Base chain identity. ## Skill reference ### `verify-email-trust-lane` **Email Verify Trust Lane** — Verifies a sender's wallet address or VNS name against bond, payment, and x402 headers, returning an inbox/review/spam routing recommendation and signed receipt envelope. *Use when:* Use when an agent needs to classify an inbound email sender as trusted or untrusted by checking their on-chain bond, x402 payment proof, and sender identity before deciding whether to route the message to inbox, review queue, or spam. *Not for:* Do not use for bulk email list validation or general email deliverability checks; this verifier is specific to x402-bonded sender trust scoring on the LoopBreaker protocol. **Inputs:** - `from` (string, required) — Sender wallet address (0x...) or VNS name to verify. - `messageId` (string) — Optional inbound email Message-ID to associate with this verification request. - `paymentTx` (string) — Optional x402 payment transaction hash to validate against the sender's payment proof. **Returns:** Returns verified boolean, a recommendation of inbox/review/spam, sender/bond/payment detail objects (nullable fields when unverified), reasons array, claimUrl, specUrl, and _x402 paid metadata confirming $0.01 USDC settlement. **Example:** `{"from": "0xAbC1234567890abcdef1234567890abcdef123456", "messageId": "", "paymentTx": "0xdeadbeef1234567890abcdef"}` --- ### `fetch-trust-insurance-stats` **Trust Insurance Stats** — Returns live insurance vault stats for a given chain, including pool balance, contributor count, claim count, and total paid out, along with the vault contract address. *Use when:* Use when an agent needs current on-chain insurance vault metrics such as pool balance, number of contributors, number of claims filed, or total payouts disbursed for the base chain vault. *Not for:* Do not use for executing insurance claims or deposits; this endpoint is read-only and returns stats only. **Returns:** Returns chain='base', the vault contract address, poolStats with balance in atomic units plus contributorCount/claimCount/paidOut, and x402 payment metadata confirming a $0.01 USDC charge. **Example:** `GET https://theloopbreaker.com/api/x402/trust/insurance` --- ### `fetch-trust-dispute-stats` **Trust Disputes Stats** — Returns live dispute resolution statistics for a blockchain network, including filed count, resolved count, and total stake at risk, along with the dispute contract address. *Use when:* Use when an agent needs current on-chain dispute resolution metrics for the Base network, such as monitoring dispute activity, stake exposure, or contract health for a trust/vaultfire service. *Not for:* Do not use for submitting or resolving disputes; this endpoint is read-only and returns aggregate stats only. Not suitable for querying dispute details on chains other than Base. **Returns:** Returns chain name ('base'), dispute contract address, and a disputeStats object with filed, resolved, and totalStake counts, plus an _x402 payment confirmation block. **Example:** `GET https://theloopbreaker.com/api/x402/trust/disputes` --- ### `fetch-trustrank-leaderboard` **TrustRank Leaderboard** — Returns a ranked list of AI agents by trust score from the live ERC-8004 registry, filtered by chain. *Use when:* Use when an agent needs to retrieve the current trust score rankings of registered AI agents on a specific chain, such as to evaluate agent reputation, compare bond counts, or identify top-ranked agents by trustScore. *Not for:* Do not use to look up a single agent's trust score in isolation; this endpoint returns the full leaderboard. Not suitable for non-ERC-8004 registry lookups or cross-chain aggregated rankings. **Inputs:** - `chain` (string) — Chain identifier to filter the leaderboard results. Corresponds to the chainFilter field in the response. - `address` (string) — EVM wallet address, likely used to contextualize or verify the requesting agent against the registry. **Returns:** Returns a leaderboard array of up to N ranked agents with trustScore, bondCount, vnsName, and registeredAt, plus a total count and chainFilter echo. **Example:** `GET https://theloopbreaker.com/api/x402/trust/leaderboard?chain=base&address=0x402Feee072D655B85e08f1751AF9ddbCd249521f` --- ### `fetch-trust-bridge-status` **Trust Bridge Status** — Returns live cross-chain bridge state for a given chain, including message counts, pause status, relayer count, bridge contract address, and synced entity totals. *Use when:* Use when an agent needs to inspect the current operational state of the Trust cross-chain bridge, including whether it is paused, how many relayers are active, and how many messages have been sent or processed. *Not for:* Do not use for executing bridge transactions or initiating cross-chain transfers; this endpoint is read-only status data. **Returns:** Returns chain name, bridge contract address, bridge state (outboundMessages, inboundProcessed, paused, remoteChainId, relayerCount), synced entity totals (agents, partnershipBonds, accountabilityBonds, reputations, validations), and an _x402 payment confirmation object. **Example:** `GET https://theloopbreaker.com/api/x402/trust/bridge` --- ### `fetch-agent-risk-score` **Agent Risk Score** — Returns a composite on-chain risk score (0–100) and risk band for an address on a given chain, broken down by identity, reputation, bonds, vouching, and age components. *Use when:* Use when an agent needs to assess the on-chain trustworthiness of an address before interacting with it, delegating to it, or accepting a vouch from it — particularly when identity registration, bond activity, and slash history matter. *Not for:* Do not use for real-time price feeds, token analytics, or off-chain reputation systems. Not suitable for bulk screening of many addresses in a single call — this is a single-address lookup. **Inputs:** - `chain` (string, required) — Blockchain network to query (e.g. 'ethereum'). - `address` (string, required) — On-chain address of the agent or account to score. **Returns:** Returns riskScore=86, band='high', a components object with weighted sub-scores for identity/reputation/bonds/vouching/age, and a raw inputs object with the underlying on-chain data points. **Example:** `GET https://theloopbreaker.com/api/x402/trust/risk-score?chain=ethereum&address=0x402Feee072D655B85e08f1751AF9ddbCd249521f` --- ### `fetch-vaultfire-trust-contracts` **Vaultfire Trust Contracts** — Returns deployed Vaultfire trust-related smart contract addresses, chain metadata, and per-chain breakdowns across Base, Avalanche, Arbitrum, and Polygon. *Use when:* Use when an agent needs to look up Vaultfire contract addresses (e.g. VaultfireTrustAttestation, MultisigGovernance, ERC8004IdentityRegistry) on a specific supported chain, or needs RPC endpoints and block explorer URLs for integration or on-chain verification. *Not for:* Do not use for real-time contract state or transaction data; use a direct RPC call or block explorer API instead. Not suitable for chains outside Base, Avalanche, Arbitrum, and Polygon. **Returns:** Returns totalContracts (134), a chains array, a chainBreakdown count per chain, and per-chain objects each containing chainId, rpc URL, block explorer URL, and a contracts map of contract name to deployed address. **Example:** `GET https://theloopbreaker.com/api/x402/trust/contracts` --- ### `fetch-trust-protocol-stats` **Trust Protocol Stats** — Returns live protocol-wide trust metrics including total registered agent identities, active bonds, per-chain agent counts, and bonded token value by chain. *Use when:* Use when an agent needs a current snapshot of the trust protocol's aggregate state: total identities, active bond count, chain distribution of agents, and locked bonded value per chain. *Not for:* Do not use for per-agent or per-address trust lookups; this endpoint returns protocol-wide aggregates only, not individual agent trust scores or bond details. **Returns:** Returns totalIdentities (22), activeBonds (36), chainCounts per chain, chainBonded amounts and token tickers per chain, a millisecond timestamp, and an _x402 payment confirmation block. **Example:** `GET https://theloopbreaker.com/api/x402/trust/protocol-stats` ---