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

Architecture

Whalehub is composed of three main layers: smart contracts on Stellar (Soroban), a backend automation server, and a React frontend.

System Diagram

Admin / Manager Split

The contract separates two roles for security:

Role
Wallet
Purpose
Security

Admin

Multisig (2-of-3)

Contract upgrades, config changes

Cold wallet, requires co-signer

Manager

blub-issuer-v2

Daily operations: rewards, compounding, ICE

Hot wallet, used by backend

Backend Services

Service
Schedule
Function

StakingRewardService

Every 30 min

Claims pool rewards, swaps to BLUB, distributes to stakers

VaultCompoundService

4x daily

Claims and auto-compounds vault LP for pools 1+

IceLockingService

Every 4 hours

Locks AQUA into ICE governance on classic Stellar

PolDepositService

Event-driven

Deposits new AQUA+BLUB into liquidity pools

Tech Stack

Layer
Technology

Smart contract

Rust + soroban-sdk 21.7.0 → WASM

Blockchain

Stellar mainnet (Soroban)

Frontend

React 18 + TypeScript + Redux Toolkit

Styling

Tailwind CSS

Backend

NestJS (TypeScript)

Hosting

Digital Ocean App Platform

Wallet SDK

@creit.tech/stellar-wallets-kit

Stellar SDK

@stellar/stellar-sdk 12.2

Last updated