Smart Contracts

Every contract in the system by area — core, clearing, system, token and locking, access control — and what the Full and Lite deployments each carry.

All contracts are written in Solidity 0.8.23, use OpenZeppelin v5 upgradeable proxies, and follow the TransparentUpgradeableProxy pattern (each proxy has its own ProxyAdmin).

Core Contracts#

Contract	Description
`LendingPoolManager.sol`	Entry point for all lending pool interactions (deposits, withdrawals, clearing, configuration)
`LendingPoolFactory.sol`	Creates new lending pools using the beacon proxy pattern
`LendingPool.sol`	Ledger of pool balances. Also an ERC-20 token representing total pool value relative to USDC
`PendingPool.sol`	ERC-721 contract managing pending deposit/withdrawal requests (D-NFTs and W-NFTs)
`LendingPoolTranche.sol`	ERC-4626 vault for tranche shares. Also handles ERC-1155 unrealized loss tokens
`LendingPoolTrancheLoss.sol`	Handles loss reporting, ERC-1155 loss token minting, and loss recovery claims
`FixedTermDeposit.sol`	Manages fixed-duration deposits with guaranteed interest rates

Clearing Contracts#

Contract	Description
`ClearingCoordinator.sol`	Orchestrates the 5-step clearing process for all lending pools
`ClearingSteps.sol`	Abstract contract extended by PendingPool for clearing execution
`PendingRequestsPriorityCalculation.sol`	Step 2: Calculates request priority by loyalty level
`AcceptedRequestsCalculation.sol`	Step 3: Calculates accepted deposit/withdrawal amounts
`AcceptedRequestsExecution.sol`	Step 4: Executes accepted requests

System Contracts#

Contract	Description
`SystemVariables.sol`	Global configuration: epoch timing, KSU price, performance fee, loyalty thresholds, fee rates
`UserManager.sol`	Calculates user loyalty levels based on rKSU-to-deposit ratio
`UserLoyaltyRewards.sol`	KSU token rewards for LPs based on active liquidity and loyalty level
`FeeManager.sol`	Collects and distributes performance fees (ecosystem fees to rKSU holders, protocol fees to claimers)
`KasuAllowList.sol`	KYC verification via TxAuthData signatures, manual allowlisting, and blocklisting
`KasuKycSigner.sol`	ERC-1271 signer configured on each allow list; holds the address derived from Kasu's KMS signing key
`KsuPrice.sol`	Fetches KSU token price from the Chainsight oracle
`Swapper.sol`	Manages an allowlist of approved exchange addresses for token swaps
`KasuPoolExternalTVL.sol`	ERC-1155 contract for tracking off-chain TVL per lending pool

Token & Locking Contracts#

Contract	Description
`KSU.sol`	ERC-20 KSU token with permit and burn (symbol: KSU, supply: 1B)
`rKSU.sol`	Non-transferable receipt token for locked KSU
`KSULocking.sol`	KSU token locking with proportional fee distribution, extends rKSU
`KSULockBonus.sol`	Holds and distributes bonus KSU tokens for the locking program

Access Control#

Contract	Description
`KasuController.sol`	System administration, role management, pause/unpause
`Roles.sol`	Role constant definitions

Deployment Modes#

Mode	Networks	Token Contracts	Locking	Loyalty
Full	Base	All contracts	Active	Active
Lite	XDC (AUDD), XDC (USDC)	Lite variants (`*Lite.sol`)	Disabled	Disabled

Lite deployments use override contracts (KsuPriceLite, UserManagerLite, UserLoyaltyRewardsLite, ProtocolFeeManagerLite, KSULockingLite) that disable token-dependent functionality while maintaining the same interface for KYC, deposits, and clearing.