Skip to content

🚧 Development docs — they may describe unreleased work. For the installed package, see the stable docs.

degenbot documentation

degenbot documentation

Getting started

Getting started
API reference
degenbot

Architecture

Active Block Window — pump-owned block promotion (QMSTSV)
Adding a strategy family — the landed-seam runbook
Balancer V2 — Contract Reference
The block-epoch pipeline
Design note: per-block state machine for the pump’s block clock
BotRunner Extraction — architecture record for epic 5TSYKN
Curve StableSwap — Implementation Reference
Evaluation: hand-rolled scanner vs ast walk for the Python env-read gate
Executor command grammar
Executor grammar — usage guide
Executor facts-driven Plan walker — spike spec (v3_v4_v3)
Golden on-chain parity tests
Hull-edge seed evaluation (no-op verdict)
I/O-Free Pool Architecture
LFJ LBPair storage layout — UNVERIFIED-PENDING
Evaluation: combinatorial ending-range enumeration in the Möbius V3/CL solver
Operator Add-Path-At-Any-Time Surface (NWTUM3)
Evaluation: PyO3 abi3t feature for wheel distribution
RevM Inspector-native simulation diagnostics — implementation spec
Rust-Owned Settlement-Arbitrage Bot Architecture
Rust settlement-bot consumer parity ledger
Semantic Matching for Aave V3 Event Processing
Session object registry — design note
Simulation-revert diagnostics pipeline
StateView mechanism feasibility — block-epoch pipeline
Strategy seams — the substrate map and how to add a strategy
V2-as-degenerate-CL swap-step parity probe
V4 PoolManager storage layout — on-chain-truth verification slots
The role-switching worker fleet (degenbot-workers)

ADRs

Architecture Decision Records

Command line

Overview
Background: Pool Architecture
Commands
Supported Exchanges
Fee Structure
Pool Discovery Events
Liquidity Update Processing
Mock Pool Helpers
Data Model Updates
Algorithm Details
Configuration
Dependencies
Database CLI Commands
Aave CLI Commands

Operations

Controlling logging, tracing, and telemetry
Failure bucket configuration
Your execution strategy, not degenbot’s
Latency telemetry playbook
degenbot alerts (T5, epic RMH23E)
Aave V3 Protocol Documentation
Borrow Flow
Collateral Management Flow
Eliminate Asset Deficit Flow
E-Mode Management Flow
Flash Loan Flow
Flash Loan Simple Flow
GHO Borrowing Flow
GHO Discount Flow
Liquidation Flow
Position Manager Flow
Repay Flow
Repay With aTokens Flow
Repay With Permit Flow
Rewards Claiming Flow
stkAAVE Slashing Flow
stkAAVE Staking Flow
stkAAVE Unstaking Flow
Supply Flow
Supply With Permit Flow
Withdraw Flow
Amount Transformations Reference

Working notes

CL cache-lab sweep & rebuild matrix (S0-S7)
UYSAXS — Hotpath verification
CoW Protocol Rust Survey — Auction Mechanics, Solvers, and Chain Interaction
Rayon Solver-Parallelism Lab Report
mimalloc purge-delay decision (epic AZZDBI, tasks XXJR3A + T3/T4)
RATR5A + CXRHW3 closure census (pair-review requirement, landed 2026-09-04)
detached solve cycle decision (epic SRQEK5, tasks WV62TX + 4QKZE3 + SF3QLP)

degenbot.balancer.libraries.scaling_helpers¶

Balancer V2 token amount scaling and rate normalization.

degenbot.balancer.math

degenbot.balancer.libraries.constants

Copyright © 2026, degenbot contributors

Made with Sphinx and @pradyunsg's Furo