Core components - SuperEarn Docs

Components

Component	Role	Developer touchpoint
SuperEarnRouter	USDT deposits, share redemption and quotes	User transactions and previews
SuperVault / EarnUSDT	Root investment shares backed by seCDV	Share balance and PPS
CooldownVault / seCDV	Intermediate shares, redemption queue and payout	Asset conversion and request/claim lifecycle
Strategies	Deploy assets into local or remote venues	Published allocations and market observations
OriginVault / RemoteVault	Asynchronous cross-chain asset deployment	Operational topology and state
Runespear agents/adapters	Messages, bridge transfers and in-transit accounting	Cross-chain coordination
Keepers	Harvest, repayment and claim attempts	Automated protocol operations

Asset flow

Stage	Movement	User record
Deposit	USDT → seCDV → EarnUSDT through Router	USDT spent, EarnUSDT received
Investment	Strategies allocate underlying assets	Share value changes
Redemption request	EarnUSDT redemption → seCDV burn → fixed USDT claim	Filled shares and request ID
Waiting	Claim remains outstanding	Nominal pending withdrawal
Claim payment	USDT to receiver	Actual receipt and claim result

Key points

EarnUSDT PPS is denominated in the underlying seCDV token. Apply the seCDV-to-USDT conversion for asset value.
Wallet accounting includes active investment plus supported unpaid claims. See valuation and earnings equations.
Cross-chain operations are asynchronous; preserve observation timestamps and release identity.

Cautions

Count the root investment once when combining nested vault and strategy exposures.
Quoted values, confirmed reporting balances and indexed observations have distinct timestamps.
Funding and FIFO reservations determine claim readiness; cooldown alone provides incomplete evidence.

Integration references

Task	Reference
Build a deposit/withdrawal flow	EarnUSDT quickstart
Pin contracts and ABIs	Transaction integration
Explore deployment addresses	Smart contracts
Read balances and activity	Data API
Understand cross-chain coordination	Runespear