Aqua Network / Aquarius

Product Preview

Tours

• 1.1: Soroban-AMM: Bird’s-Eye Tour

• 2.1: Access Control: Overview

• 2.2: Roles & Constants

• 2.3: Storage Layout

• 2.4: Access Checks & Convenience Helpers

• 2.5: Managing Role Addresses

• 2.6: Ownership Transfer Flow

• 2.7: Emergency Mode & System-wide Overrides

• 3.1: Upgrade Module: Overview

• 3.2: Upgrade Storage

• 3.3: Upgrade Constants & Errors

• 3.4: Upgrade Events

• 3.5: UpgradeableContract Trait

• 3.6: Core Logic – commit, apply & revert

• 4.1: Locker Feed: Overview

• 4.2: Initialization & Storage Basics

• 4.3: Privileged Roles & Address Management

• 4.4: Ownership Transfer, Upgrade Path & Emergency Mode

• 4.5: Testing Security Invariants

• 5.1: Fees Collector: Overview

• 5.2: Bootstrapping & Access Control

• 5.3: Upgrade Flow & Emergency Mode

• 5.4: Two-Step Ownership Transfer

• 5.5: Test Utilities & Helper Patterns

• 6.1: Liquidity Pool Plane: Overview

• 6.2: Plane Storage Schema & TTL

• 6.3: Public Interface Trait

• 6.4: Core Plane Logic

• 6.5: Upgrade & Emergency Control

• 6.6: Ownership Transfer Flow

• 6.7: Tests as Living Documentation

• 7.1: Token: Overview

• 7.2: Token Contract API

• 7.3: Admin: Upgrade & Ownership Transfer

• 7.4: Allowance Mechanics

• 7.5: Balance Storage

• 7.6: Metadata & Error Codes

• 7.7: Pool Reward Checkpoint Hooks

• 8.1: Rewards System: Overview

• 8.2: Rewards Storage Layout

• 8.3: Configuring Rewards – Admin Flow

• 8.4: Working Balances & Boost Mechanics

• 8.5: Accruing Rewards over Time

• 8.6: User Checkpoints & Claiming

• 8.7: Aggregated Reward Pages – Data Structure Deep-Dive

• 8.8: Constants, Errors, Events & External Feeds

• 9.1: Standard Liquidity Pool – Overview

• 9.2: State & Failure Basics

• 9.3: Constant-Product Math Helpers

• 9.4: LP-Token Deployment & Safe Transfers

• 9.5: Plane Cache & Public Interfaces

• 9.6: Rewards Glue Points

• 9.7: Core Contract – Initialization, Deposit & Withdraw

• 9.8: Core Contract – Swap Paths & Invariant Enforcement

• 9.9: Admin Controls, Killswitches & Upgrades

• 9.10: Tests & Test Utilities

• 10.1: StableSwap Liquidity Pool: Overview

• 10.2: Core Entry Points & Math (contract.rs)

• 10.3: Persistent State Layout (storage.rs)

• 10.4: Decimal & Precision Handling (normalize.rs)

• 10.5: Rewards Integration (rewards.rs)

• 10.6: Publishing State to the Plane (plane.rs & plane_interface.rs)

• 10.7: LP Token Deployment & Callbacks (token.rs)

• 10.8: Error & Event Definitions

• 10.9: Interfaces & Constants (pool_interface.rs & pool_constants.rs)

• 10.10: Testing Harness & Permissions (test.rs, test_permissions.rs, testutils.rs)

• 11.1: Liquidity Pool Liquidity Calculator: Overview

• 11.2: Admin, Upgrade & Entry Points in contract.rs

• 11.3: Closed-Form Liquidity for Constant Product Pools

• 11.4: Shared Math Helpers & Reserve Normalisation

• 11.5: StableSwap Liquidity Estimation Algorithm

• 11.6: Plane Integration and Local Storage

• 12.1: Liquidity Pool Router: Overview

• 12.2: Router State & Constants

• 12.3: Utility Helpers & Deterministic Salts

• 12.4: Public Interfaces (Traits)

• 12.5: Single-Hop Operations

• 12.6: Pool Creation & Registry Management

• 12.7: Multi-Hop Swap Algorithms

• 12.8: Rewards Configuration & Distribution

• 12.9: Administration, Ownership & Upgrades

• 12.10: Calculator & Plane Integration

• 13.1: Provider Swap Fee Factory: Overview

• 13.2: Factory Contract – Deploy Time & Collector Creation

• 13.3: Factory Contract – Governance, Upgrades, Emergency Mode

• 13.4: Storage Anatomy – DataKey & TTL Bumping

• 13.5: Event Emission – Observability Hooks

• 13.6: End-to-End Usage – Functional Test Walkthrough

• 13.7: Permissions & Safety Nets – Ownership, Upgrades, Emergency Tests

• 14.1: Provider Swap Fee Collector: Overview

• 14.2: Persistent State & Configuration

• 14.3: Constants, Errors & Events

• 14.4: Administrative Functions: Claiming Collected Fees

• 14.5: User-Facing Flow #1 – swap_chained (with provider fee)

• 14.6: User-Facing Flow #2 – swap_chained_strict_receive (target-out, provider fee on top)