For the complete documentation index, see llms.txt. This page is also available as Markdown.

Risks and Mitigations

A frank inventory of the technical risks Brain faces and how the architecture addresses each one.

Source Data Quality

Risk. Bank feeds and emails contain noise and gaps. An invoice arrives in five formats. Counterparty names vary across sources. Reconciliation is genuinely hard.

Mitigation.

Mechanism
How It Helps

Deterministic extractors with confidence scores

Low-confidence records flagged for review, not silently absorbed

Replayable Raw layer

If the extractor improves, every higher layer can be rebuilt from Raw

Human-in-the-loop reconciliation queue

Low-confidence records routed to a human before they affect Wiki

Agent Misbehaviour

Risk. A buggy or malicious agent could attempt unauthorized actions: overspending, paying the wrong counterparty, looping requests.

Mitigation.

Mechanism
How It Helps

EIP-712 ScopeAttestation

Every action requires a tenant-signed scope; outside-scope calls revert inside executeViaSessionKey

Policy bound at grant

The session key carries the policyVersion digest it was authorized under; a stored key can never have a missing binding

BrainSmartAccount enforcement on-chain

Scope + spend caps are enforced inside executeViaSessionKey (bound to the policyVersion at grant time), not just in the backend

Account-level limits (per-tx, per-day)

Hard cap on blast radius regardless of policy

On-chain reputation pointer

BrainReputationRegistry is deployed on Base Sepolia; scoring remains a neutral placeholder until reputation inputs are live

Policy Ambiguity

Risk. Plain-English policies can be ambiguous. "Allow recurring payments to known vendors". What counts as recurring? What counts as known?

Mitigation.

Mechanism
How It Helps

Compiler emits deterministic compiled policy

The signed form is unambiguous JSON, not prose

Compiler also emits an explanation

Tenants see exactly what they are signing in human terms

Tenants sign the compiled form

Eliminates "but I meant..." disputes

ESCALATE is the default for unmatched conditions

Edge cases route to humans, not silent ALLOW or silent DENY

Source API Failures and Rate Limits

Risk. Upstream banks and processors have downtime, rate limits, and silent data loss.

Mitigation.

Mechanism
How It Helps

Idempotent ingestion

Repeated webhooks or pulls produce the same Raw artifact

Retries with exponential backoff

Transient failures recover automatically

Replay from Raw

If an extractor needs to re-run, no need to re-pull from upstream

Poison-record quarantine

One malformed record is retried, then quarantined (never silently dropped) and surfaced via metrics; siblings keep projecting and an operator can replay it after a fix

Smart Contract Risk

Risk. Bugs in BrainSmartAccount or BrainAuditAnchor could compromise execution or audit integrity.

Mitigation.

Mechanism
How It Helps

Minimal on-chain surface

Less code = smaller attack surface

External audit before mainnet

No money-moving contract ships to mainnet without an external audit

Public bug bounty

Continuous post-deployment coverage

Immutable contracts

No upgrade path in MVP; changes ship as audited redeploys

Anchorer key hardening

Current testnet publisher is a single EOA; HSM-backed signing is a pre-mainnet TODO

L2 Finality and Reorgs

Risk. Base, like any L2, can experience reorgs. An audit anchor that vanishes from the chain would be a problem.

Mitigation.

Mechanism
How It Helps

Confirmations tuned per action class

High-value actions wait for deeper confirmation

Audit anchors reference the previous batch

Small reorg windows tolerated automatically

Off-chain log is canonical until anchored

Anchoring is a commitment, not a creation. The audit log exists before it lands on-chain

Privacy of Audit Anchors

Risk. Putting audit data on a public chain could leak tenant information.

Mitigation.

What's On-Chain
What Stays Off-Chain

Merkle roots only

Event payloads

Hashed tenantId

Raw artifacts

Anchor timestamps

Ledger records, Wiki entities, policy text

A counterparty verifying a proof receives only the specific event(s) the tenant chooses to share, plus the Merkle path. Everything else stays private.

Regulatory Variance

Risk. Different jurisdictions have different rules: data residency, payment licensing, sanctions enforcement, AML reporting.

Mitigation.

Mechanism
How It Helps

Jurisdiction-aware policy primitives

Policies can reference counterparty.jurisdiction and gate accordingly

Per-region deployments

Data residency requirements respected at the infrastructure level

Partnerships with regulated counterparties

UAE first via VARA-licensed entities; EU and US to follow

Risk Summary

Risk
Severity Without Mitigation
Severity With Mitigation

Source data quality

High

Medium (always some noise)

Agent misbehaviour

Critical

Low (multiple gates)

Policy ambiguity

High

Low (compiler + signing model)

Source API failures

Medium

Low (idempotent + replay)

Smart contract bugs

Critical

Low (minimal surface + immutable + audits)

L2 reorgs

Medium

Low (confirmations + tolerant anchors)

Audit privacy leaks

High

Negligible (only roots on-chain)

Regulatory variance

High

Medium (handled per-region)

This covers only the technical risks of the threat model. Operational, governance, and business risks are addressed separately in compliance and operational documentation.

What's Next

Security and Compliance

Non-negotiable principles.

Tenant Isolation

How tenants are separated.

Smart Contracts

The on-chain enforcement layer.

Last updated