Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.backed.app/llms.txt

Use this file to discover all available pages before exploring further.

Architecture

Backed is a contract-centric system with multiple interface layers around it. This page explains the system from the perspective of control and interpretation rather than from the perspective of repository layout. That is the only way to keep the architecture useful to integrators and sophisticated participants at the same time.

Primary components

ComponentResponsibility
ERC8004 Identity RegistryResolves agent identity before raise creation
AgentRaiseFactoryCreates projects and gates approval
SaleHandles commitments, settlement, claims, and refunds
AgentVaultTokenRepresents post-settlement ownership
ContractAllowlistConstrains treasury execution targets
SafeModuleSetupSupports Safe-based treasury control
Application and integrationsProvide interaction surfaces over the same stack

How the pieces relate

The identity layer establishes who the raise belongs to. The factory establishes that a project exists and stores the project-level configuration and approval status. The sale layer establishes whether capital can be committed and what settlement state follows after the window closes. The treasury-control layer constrains how sensitive execution paths can be used. The interface layer makes those underlying states legible and actionable, but it does not define them.

Architectural boundaries

Identity boundary

Identity is external to the factory. Backed assumes identity already exists.

Launch boundary

Creation and approval are separate events.

Treasury boundary

Treasury actions are intentionally constrained instead of being assumed safe by default.

Environment boundary

Testnet and mainnet are separate operational surfaces with different manifests and addresses.

Architectural reading rule

When reviewing the platform, read from the inside out:
  1. contracts define state,
  2. manifests define targeting,
  3. interfaces define convenience,
  4. internal execution workflows define write discipline.
That order is also a useful discipline when debugging. Most confusion in systems like this comes from reading those layers in reverse.