Gearbox Architecture

This repository provides an overview of the Gearbox Protocol codebase.

It maps repositories to their role in the system:

• smart contracts
• backend services
• frontend interfaces
• shared libraries

The goal is to make the system structure explicit and easier to navigate.

---

Smart Contracts

Repo	Description
core-v3	Core contracts of Gearbox Protocol V3 — credit accounts, leverage mechanics, and execution logic
oracles-v3	Oracle and pricing infrastructure for collateral valuation and risk management
permissionless	Permissionless market engine with governance and bytecode verification (BCR)
integrations-v3	Adapters enabling interaction with external DeFi protocols
peripheral-v3	Auxiliary contracts supporting integrations and protocol operations
router-v3	Routing layer for composing and executing multi-step strategies
bots-v3	Infrastructure and interfaces for building automation and bot integrations

Backend Services

Repo	Description
liquidator-v2	Open-source liquidation bot for Gearbox Protocol — anyone can run it to perform liquidations
gearbox-backend	Core backend service indexing protocol state and historical data for APIs and analytics
strategies-apy-lambda	Serverless component for computing strategy-level APY and performance metrics
anvil-manager	Tooling for managing local test environments and pre-deployment testing workflows

---

Monitoring Services

Repo	Description
safe-watcher	Open-source utility for monitoring Safe transactions and detecting suspicious activity
dns-checker	Monitoring bot that tracks DNS changes and triggers alerts on unexpected updates
microservices	Internal services for monitoring accounts, protocol state, and security-related events
optimist	Service for optimistic liquidation checks, detecting accounts that may become liquidatable

Frontend

Site	Repo	Description
gearbox.finance	landing-v3	Landing page
app.gearbox.finance	client-v3	Core app for users
x.gearbox.finance	gearbox-x-interface	Frontend prototype for intent-based lending
safe.gearbox.finance	permissionless-safe	Safe interface for market curators operations
permissionless.gearbox.finance	permissionless-interface	Interface for market curators
bcr.gearbox.finance	bcr-interface	Bytecode verification (BCR) interface
data.gearbox.finance	analytics	Analytics platform (credit accounts, positions, protocol data)
gov.gearbox.finance	gov	Governance portal (proposals, voting, on-chain decisions)

--

Data

Repo	Description
gearbox-revenue-graph	Revenue analytics
gearbox-revenue-swap	Revenue flows
defillama	TVL / metrics adapter
defillama-server	Data ingestion

---

Docs

Repo	Description
docs-knowledge	Internal docs
style-guide	Coding standards

---

Libraries

Libraries provide shared components, SDKs, and assets used across the Gearbox ecosystem.

Repo	Description
sdk	TypeScript SDK for interacting with Gearbox Protocol — typed wrappers around contracts and the main entry point for integrations
ui-kit	Shared UI component library used across all Gearbox interfaces
static	Static asset storage (token icons, metadata, and shared resources) served across services and interfaces

DevOps

Repo	Description
deploy-tools	Deployment scripts
aws	Infra configs
keystore	Key management
latitude	Unknown

---

Branding

Repo	Description
brand-assets	Logos and assets

Legacy

Repo	Description
charts_server	Legacy charts backend supporting historical data visualization
apy-server	Production service for calculating APY, including rewards and incentive programs