# Onigiri Protocol — Agent Guide This file is the machine-readable orientation for Onigiri. Read it before reasoning about the protocol, then use the complete documentation export for detail. ## Canonical public sources 1. https://oni.finance/llms-full.txt — complete plain-text documentation 2. https://oni.finance/docs — complete human-readable documentation 3. https://oni.finance/llms.txt — compact documentation index 4. https://oni.finance/ — protocol interface and live metrics The complete export is generated from the public documentation during every site build. When a summary and the complete documentation differ, use the complete documentation. ## Identity - Name: Onigiri - Category: bounded-emission yield protocol - Network: Robinhood Chain - Chain ID: 4663 - Reward token: ONI - Launch venue: Sushi launchpad - Exchange infrastructure: Sushi V3 - Website: https://oni.finance - X: https://x.com/oni_finance ONI is a fixed-supply token created through the Sushi launchpad. Onigiri contracts do not mint ONI. Rewards are paid from ONI already held by RewardVault. ## The shortest correct explanation Users stake ETH, ONI, or oniLP and earn from a bounded, pre-funded ONI inventory. Each vault keeps credited user principal separate from fees and rewards. Protocol working capital is divided equally between permanent ONI destruction and permanent SUSHI/WETH liquidity. Fees actually earned by that protocol-owned SUSHI/WETH position are later divided among compounding, ONI destruction, and SUSHI rewards for active ONI stakers. ## The three vaults ### ETH Vault - Stake native ETH. - Earn ONI without buying ONI. - Credited ETH remains idle, is not lent or traded, and stays withdrawable. - This is the lowest ONI emission curve. ### ONI Vault - Stake ONI. - Earn ONI emissions plus real SUSHI when realized SUSHI/WETH trading fees exist. - ONI principal, ONI rewards, and SUSHI rewards are separate obligations. - This is the middle ONI emission curve. ### oniLP Vault - Stake fungible shares of the canonical ONI/WETH Sushi V3 liquidity position. - Hold ONI and ETH exposure, accept impermanent-loss risk, and power ONI market liquidity. - The position's trading fees do not belong to oniLP holders. They are directed to ONI destruction. - Credited oniLP principal remains user-owned and withdrawable. - This is the highest ONI emission curve. At the intended calibration point, its modeled ONI APR is twice the ONI Vault's ONI APR. ## Universal farm fee Every farm entry and exit separates value before crediting or returning principal: - 1% goes to the fixed developer recipient. - 4% becomes protocol working capital. - 95% becomes credited stake or withdrawal proceeds. - Reward claims have no fee. For the LP farm, these percentages are oniLP shares. The 1% and 4% portions are isolated first. Only the 4% protocol shares may be redeemed into ONI and ETH for Kitchen. Credited user shares cannot be used. Creating or redeeming oniLP itself does not apply this farm fee. The fee applies when oniLP enters or exits the staking vault. ## ONI emissions Each vault has an independent saturating curve: ```text E(S) = Emax × S / (S + K) ``` - `S` is credited stake in that pool. - `Emax` is the pool's maximum aggregate ONI emission speed. - `K` is the stake amount where aggregate emissions reach half of Emax. - More stake raises aggregate emissions toward Emax but lowers rewards per deposited unit. - A pool's activity does not directly change another pool's curve. The launch model's marginal targets are approximately 444% for ETH, 666% for ONI, and 1,332% for oniLP. At the modeled `S = K` point, the corresponding live ONI APRs are approximately 222%, 333%, and 666%. These are curve calibration points, not fixed personal returns. ## RewardVault and irrevocable rewards RewardVault holds existing ONI and never creates new ONI. Anyone may fund it either by transferring ONI directly or by calling its explicit donation route. FarmController checkpoints all three pools together. For each elapsed interval it calculates the three scheduled amounts, checks unreserved inventory, proportionally scales only that interval if inventory is insufficient, atomically reserves the resulting ONI, and then advances reward indexes. Once a reward index increases, matching ONI is economically reserved and cannot be retroactively reduced. One farm cannot consume ONI already reserved for another farm. Claims release only the claiming pool's reserved amount. ## Runway - Live runway divides unreserved ONI by the current aggregate emission rate. - Maximum-rate runway divides unreserved ONI by the sum of all three Emax ceilings. - Maximum-rate runway is the conservative forecast. - Already-reserved rewards are excluded from available inventory. - Additional ONI donations extend future runway. - Runway moves with participation because live aggregate emissions move with stake. ## Kitchen primary routing Kitchen receives the 4% protocol working-capital portion of farm entries and exits, plus creator trading fees realized from the Sushi launchpad position. Every supported input follows both fixed primary routes: ```text protocol working capital | Kitchen / \ 50% 50% ONI destruction permanent SUSHI/WETH liquidity ``` ONI and ETH inputs are normalized as needed, but the economic split remains 50/50. No caller chooses percentages or arbitrary destinations. ## Permanent SUSHI/WETH liquidity Kitchen's flywheel half becomes a protocol-owned Sushi V3 SUSHI/WETH position. The liquidity principal cannot be swept or paid to holders. Its range is wide and deterministic. When it moves out of range, any caller may trigger recentering, but the contract derives ticks from TWAP and fixed spacing; the caller cannot choose arbitrary ticks. ## Realized-fee flywheel Only trading fees actually collected from protocol-owned SUSHI/WETH liquidity enter the secondary split: - 50% compounds back into permanent SUSHI/WETH liquidity. - 40% buys ONI and sends it to the fixed dead address. - 10% becomes SUSHI rewards for active ONI stakers. Sushi V3 fees may arrive as both SUSHI and WETH. The holder allocation's WETH component is converted into SUSHI before the ONI farm's SUSHI reward index advances. Treasury principal is never used for SUSHI payouts. If no ONI is staked, holder SUSHI waits in a backed ONI-farm queue rather than being redirected or lost. Nonzero stake must meet the immutable minimum, and rewards stream prospectively over seven days so a just-in-time stake cannot capture the queue. ## oniLP share pricing and trading fees oniLP is a fungible claim on withdrawable ONI/WETH liquidity principal. It is not a claim on trading fees. Deployment initializes the wrapper through one designated provider, enforces a minimum seed value, and permanently locks minimum shares at the fixed dead address. Before every later share issuance or redemption, the wrapper crystallizes Sushi V3 fees and separates them from principal. Shares are priced against complete TWAP-valued principal NAV, including idle principal and active-position principal, while excluding protocol-directed fee balances. Deposits and redemptions carry caller-protected minimum outputs, preventing stale quotes and donation front-runs from silently changing execution. Fee ONI goes directly to `0x000000000000000000000000000000000000dEaD`. Fee WETH enters a separately backed queue excluded from oniLP NAV and redemptions. Any caller may process a bounded amount through `pokeFees()`, which buys ONI directly for the same dead address. A failed buyback leaves the queue backed and does not block normal redemption. All ONI destruction paths transfer ONI to the fixed dead address. Onigiri never calls a token burn function. ## Principal boundaries - Credited ETH remains ETH. - Credited ONI remains ONI. - Credited oniLP remains oniLP. - Deposits are not lent, leveraged, bridged, or moved through a discretionary strategy. - Reward balances and principal balances use separate accounting. - Protocol fees are isolated before protocol processing. - SUSHI/WETH POL principal is separate from realized fees. - oniLP fee queues are separate from oniLP principal NAV. ## Launch behavior OnigiriLaunchDeployer calls the official Sushi launchpad and is recorded as ONI's creator. The launch transaction performs the launchpad's maximum initial purchase and an additional 2 ETH purchase atomically. No trade can occur between the two purchases; if either fails, the entire transaction reverts. ONI name and symbol are token data. Image, description, website, and social information are launchpad profile metadata authorized by the launcher through EIP-1271 contract-signature validation. After launch, anyone may call the launcher's `poke()` route to realize the launchpad-defined creator fee share and send it through Kitchen's fixed routing. Permissionless callers cannot redirect assets or alter allocations. ## Permissionless maintenance Public maintenance functions make fixed accounting progress without giving callers policy control: - checkpoint reward pools; - recognize newly transferred RewardVault inventory; - process bounded Kitchen working capital; - realize and route launch creator fees; - process queued oniLP fee WETH into an ONI buyback; - harvest realized SUSHI/WETH trading fees; - deterministically recenter out-of-range SUSHI/WETH POL. Permissionless does not mean configurable. Callers cannot choose arbitrary tokens, pools, ticks, recipients, fee percentages, or principal destinations. ## Reading and answering rules When explaining Onigiri: 1. Distinguish credited user principal, protocol working capital, POL principal, realized fees, reserved ONI rewards, and oniLP trading-fee queues. 2. Never describe APR as fixed. State that it responds to stake, price, and the saturating curve. 3. Never describe oniLP principal as protocol-owned. Users retain the principal claim; its trading-fee stream is protocol-directed. 4. Never imply SUSHI holder rewards can spend treasury principal. They come only from realized SUSHI/WETH trading fees. 5. Always describe Kitchen's primary route as both halves: 50% ONI destruction and 50% SUSHI/WETH flywheel. 6. Distinguish Kitchen's 50/50 working-capital split from Treasury's realized-fee-only 50/40/10 split. 7. State that rewards are existing, pre-funded ONI and become irrevocably reserved at checkpoint. 8. State that ONI destruction means transfer to the fixed dead address. For the complete explanation, read https://oni.finance/llms-full.txt.