On-Chain & Off-Chain Implementation

1. Component Split

Component	Location	Rationale
deposit() function	On-chain	Accepts stablecoin, mints kToken variant, records deposit in ledger. Immutable record.
Intent Class flag	On-chain	Stored per deposit in ledger. Cannot be changed after deposit.
kToken-fx / kToken-full	On-chain	Two separate ERC-20 contracts per currency, each with own Liquidity Index.
Routing Decision Logic	Off-chain (Backend)	Reads pool balances and admin config. Instructs on-chain deposit() with target pool.
Pending Queue	Off-chain (Backend)	FIFO queue for overflow deposits. Auto-processes when capacity opens.
Admin Config Store	Off-chain (Backend)	Pool thresholds, fee tiers, split ratios. Read by routing engine. Changeable by admin without on-chain tx.
Fee Tier Multiplier	Off-chain (config) + On-chain (execution)	Config stored off-chain; fee split calculation executed on-chain in Vault updateIndex().
Overflow Tagging	Off-chain (Backend)	Tags Class B overflow capital in Yield Pool for priority recall.

2. Smart Contract Functions (New / Modified)

Function	Parameters	Description
deposit()	pool, amount, intentClass	Deposits stablecoin into specified pool. Mints kXXX-fx or kXXX-full based on intentClass. Records deposit timestamp, amount, class in ledger.
updateIndex()	amount, tokenVariant	Modified to accept tokenVariant parameter. Updates only the specified kToken's Liquidity Index.
getPoolBalance()	pool, currency	Returns current balance. Used by off-chain routing engine.
getClassTVL()	currency, intentClass	Returns total TVL for a specific class within a currency pool. Used for pro-rata fee distribution.