How Alpha Homora V2 works: mechanics of the protocol

The core contract and the lending pools

Everything in Alpha Homora V2 revolves around a contract called HomoraBank. It is simultaneously a money market and a position manager. On the money-market side it holds one lending pool per supported asset; lenders deposit into a pool and receive an ibToken that appreciates as interest accrues. Interest rates follow a utilisation curve: the more of the pool is borrowed, the higher the rate, which pulls new deposits in and pushes marginal borrowers out.

On the position-management side, HomoraBank records the collateral and debt of every open position, values them through oracles, and refuses any action that would leave a position unhealthy. This dual role is the key architectural idea. Because the same contract lends the money and controls where it goes, it can allow leverage that a general-purpose lender could never extend against the same collateral.

Opening a position step by step

A farmer begins by choosing a target pool — for example a stablecoin pair on a supported AMM — and supplying collateral in one or both of the pair's assets. They then select a leverage multiplier, which determines how much the protocol will borrow on their behalf. HomoraBank transfers the borrowed assets not to the user but to a spell contract, a whitelisted helper that knows exactly how to interact with that specific external protocol.

The spell rebalances the supplied and borrowed assets into the correct ratio, adds liquidity to the AMM, receives LP tokens and, where applicable, stakes them in the corresponding reward gauge. The LP tokens are returned to HomoraBank as the position's collateral, and a position NFT records ownership. From the user's perspective a single transaction produced a leveraged farming position; under the hood a swap, a deposit, a stake and a debt entry were all created atomically.

Because the entire flow is atomic and constrained by the spell, funds cannot be diverted. This is why Alpha Homora V2 could offer high multiples on stable pairs while a conventional lending market would demand heavy over-collateralisation. The trade-off is that the protocol's safety now depends on every spell being correct — one of the themes of the risks guide.

Debt ratio, health and liquidation

Once open, a position is monitored by a single number. The debt ratio compares the current value of what the position owes to the liquidation-adjusted value of what it holds. Both sides move continuously: debt grows with accrued interest, and collateral value moves with the price of the two pooled assets, the trading fees the pool earns and the reward tokens harvested.

When the debt ratio reaches the threshold, the position becomes liquidatable. Any external actor may repay part of the debt and receive collateral at a discount, the liquidation bonus. That bonus is deducted from the farmer's equity, which is why liquidation is expensive even when the price later recovers. Two positions with identical leverage can have very different liquidation distances depending on whether the pair is correlated, so a 5x stable position and a 5x volatile position are not comparable risks.

Crucially, the collateral is an LP token, not a single asset. As the price of one side moves, the AMM automatically rebalances the position toward the falling asset, which softens the collateral drawdown compared to holding but introduces impermanent loss. The interaction between that rebalancing and leverage is worked through numerically in leveraged yield farming explained.

Oracles, spells and the safety perimeter

Pricing LP tokens correctly is harder than pricing plain assets, because a naive valuation based on current reserves can be manipulated inside a single transaction using a flash loan. Alpha Homora V2 addressed this with fair-price LP oracles derived from external price feeds and invariant maths rather than instantaneous reserves, plus aggregation across multiple sources so no single feed could dictate a valuation.

The spell system defines the perimeter of what any position may do. Each supported integration has its own spell, each spell is audited and whitelisted by governance, and a position can only ever call the functions those spells expose. This dramatically narrows the attack surface compared with allowing arbitrary calls, but it also means the protocol's security is only as strong as its weakest whitelisted integration — precisely the lesson of the February 2021 exploit.

Closing, harvesting and managing a position

Closing reverses the opening flow. The spell unstakes the LP tokens, removes liquidity, swaps as needed to obtain the borrowed asset, repays the debt plus accrued interest to HomoraBank, and returns whatever remains to the owner. Partial actions are supported too: a farmer can add collateral to reduce the debt ratio, repay part of the debt, or harvest accumulated rewards without unwinding.

Active management matters more than most farmers expect. Reward tokens that are not harvested and sold can lose value faster than the yield accrues; interest rates can spike when utilisation jumps, silently turning a profitable position negative; and a debt ratio that was comfortable at open can drift toward the threshold over weeks purely from interest. Sensible practice is to define, before opening, the price level at which you will add collateral and the level at which you will exit.