Skip to content
ARRANGEDocumentation
Browse documentation
On this page

DocumentationArchitecture

Architecture Design Goals

Principles for a legible structured equity-yield mechanism.

#Design goals

GoalMeaning
Minimal user actionsCompress execution without hiding strike, expiry, premium or risk
Transparent payoffDerive terminal economics from public position terms
Deterministic accountingIdentical finalized inputs produce identical entitlements within explicit rounding
Canonical asset identityBind Stock Token chain, contract, uid and multiplier context
Clear settlementSpecify source, time, unit, finality and exceptional-state behavior
Risk isolationKeep one asset or dependency failure from contaminating unrelated positions
Auditable stateExpose enough data to reconstruct position history and payoff

#Design tensions

Goals conflict. Composability broadens dependency risk. Gas optimization can reduce readability. Upgrade authority can repair defects while increasing trust. Oracle minimization can increase reliance on arbitrage and liquidity. Architecture should make each tradeoff explicit.

#Payoff before components

ARRANGE economic component boundariesPOSITION ACCOUNTINGEXPOSURE ADAPTERPRICING / DATAMARKET FACTORYSETTLEMENTFEE ACCOUNTINGFINAL USER CLAIMEconomic model
ARRANGE Documentation