Architecture & Modules

CICADA Finance implements a modular smart contract architecture designed to support the full lifecycle of onchain asset management, including asset tokenization, liquidity coordination, yield distribution, security controls, and decentralized governance. Core modules are structured to be composable and upgrade-aware, enabling standardized execution across different asset categories and token structures.

Asset Tokenization Module

The asset tokenization module enables the conversion of real-world assets (RWA) and onchain native assets into Rebase Tokens (RT) under standardized issuance rules. Smart contracts define token properties and lifecycle behaviors to ensure transparency and traceability. During the asset onboarding process, RWAs are mapped onchain and RT units are generated based on defined valuation logic. Oracle and validation components are used to verify relevant asset data inputs, supporting data integrity throughout the issuance and lifecycle management process.

Liquidity Management Module

The liquidity management module governs the issuance, locking, and unlocking logic of Liquidity Tokens (LT). Smart contracts coordinate LT supply and related controls to support market liquidity while maintaining protocol stability. LT issuance and locking behaviors are executed based on predefined rules and configurable parameters, including protocol-level revenue inputs and market design considerations. Unlocking is only permitted under predefined conditions to manage liquidity release in an orderly manner.

Yield Distribution Module

The yield distribution module automates yield allocation, conversion logic, and distribution execution for RT and LT holders. Smart contracts calculate user-level yield distribution based on defined rules and underlying asset income data, and distribute returns programmatically to eligible holders, supporting compounding effects where applicable. Users may convert between RT and LT through protocol-defined conversion pathways to align their positions with liquidity and yield preferences.

Security and Compliance Module

The security and compliance module provides guardrails to enhance the integrity and resilience of protocol operations. It is designed to support structured security controls and auditability through mechanisms such as role-based permissions, validation checks, and upgrade processes. External security assessments, audits, and verification practices are referenced in the Security section of this documentation.

Decentralized Governance Module

The decentralized governance module enables community-driven decision-making through a DAO-oriented framework. Governance processes support protocol upgrades, parameter adjustments, and asset onboarding decisions under transparent and accountable procedures, with execution and outcomes intended to be verifiable through onchain records.