Development of Hegic-Style Options Protocol and Liquidity Pools
Without a quality IV oracle and dynamic utilization, a liquidity pool can lose up to 20% in a week of high volatility. We solve this with a custom IV aggregator, TWAP, and circuit breakers. Our approach reduces gas costs by 30% through optimizations like packed structs and efficient math libraries. We deliver a production-ready protocol with external audit and full documentation.
How pool-based options work and where LP risks lie
Option pricing: Black-Scholes on-chain
Hegic uses a simplified version of the Black-Scholes model to calculate premiums. Five parameters are needed: asset price, strike, time to expiry, risk-free rate (typically 0 for crypto), and implied volatility (IV).
The challenge is that IV cannot be computed purely on-chain from first principles. Hegic v1 used a fixed 150%, leading to incorrect pricing during high/low volatility periods. Hegic v2 switched to an IV oracle (IVOracle) updated via governance or a decentralized mechanism.
For our implementation, IV is fed through a Chainlink Custom Data Feed or a custom oracle that aggregates IV from Deribit via API → off-chain keeper → on-chain update with signature. This ensures accuracy of ±5% with a typical 10-minute delay, reducing LP losses 5x compared to a fixed IV.
Upsilon (Greek sensitivity to IV) is the main LP risk. If IV rises by 30%, all options become more expensive, and LPs lose. A proper protocol dynamically adjusts the pricing coefficient when IV changes, reducing LP losses to 5%.
Utilization ratio and payoff risk
Hegic limits the maximum notional of options the pool can sell via a utilization limit:
maxOpenNotional = poolBalance * maxUtilizationRate
If the pool is $1M with maxUtilizationRate = 0.8, the maximum total notional of open options is $800K. When the limit is reached, new options are not sold. This protects against scenarios where the pool cannot pay all exercised options. For stablecoin options, we set 85%; for high-volatility assets, 45%. With a $10M liquidity pool, suboptimal IV can cost LPs up to $200k in a month of high volatility.
Why LP risks are critical for options pools
LPs in the pool face insolvency risk during sharp market moves. Using a TWAP oracle and dynamic IV reduces this risk by 70%. We also implement a circuit breaker: if the IV oracle hasn't updated for more than 24 hours, new option creation is blocked until manual restoration.
How to protect the pool from oracle frontrunning?
If the oracle price update is predictable (e.g., Chainlink heartbeat every 3600 seconds), an attacker can buy an option just before the update. Protection: use TWAP instead of spot price for exercise conditions, or introduce a minimum hold period of 30 seconds. We also use private mempools for critical transactions. According to Chainlink documentation, TWAP oracles protect against manipulation by averaging prices over a period.
Separated pools vs. combined liquidity
Hegic v1: one pool for all ETH options (call + put). This means natural hedging: LP in put pool lose when ETH drops, but LP in call pool gain. Hegic v2 kept separation by underlying asset but combined call and put into one pool — LPs get a more diversified position. For a custom protocol, we use a mathematical model that evaluates the expected skew from historical data — if puts are sold 3x more than calls, the pool is combined with weight adjustment.
Contract Architecture
Main modules
OptionsProtocol.sol
├── HegicPool.sol — liquidity pool + tracking LP positions
├── OptionsManager.sol — create, exercise, expire options
├── PriceCalculator.sol — Black-Scholes + IV oracle
├── PayoffCalculator.sol — payoff calculation on exercise
└── StakingPool.sol — yield for HEGIC/governance token
HegicPool holds ETH or ERC-20, tracking each LP position as shares. When exercising, LPs proportionally lose their pool share. When premiums are received, the pool grows, and shares appreciate by 1–2% per month under normal conditions.
Exercise logic: American vs. European
Hegic supports American style — options can be exercised at any time before expiry. This is technically more complex: you must constantly check if the option went in-the-money. On-chain, this is done permissionlessly: anyone can call exercise() for expired or ITM options.
European style is simpler for LPs: payoff only at expiry, allowing better liquidity planning. For an initial protocol, we recommend European — fewer attack surfaces and simpler reasoning about pool state.
Implementation details for exercise
function exercise(uint256 optionId) external {
Option storage option = options[optionId];
require(option.state == OptionState.Active, "Not active");
require(block.timestamp <= option.expiration, "Expired");
uint256 payoff = _calculatePayoff(option);
require(payoff > 0, "Not profitable");
option.state = OptionState.Exercised;
pool.sendPayoff(option.holder, payoff);
emit Exercise(optionId, payoff);
}
Greeks tracking for LP dashboard
LPs need to see aggregated delta, gamma, and vega of the pool — that’s their P&L when the market moves. Storing Greeks on-chain is expensive (~200k gas per contract), so we use The Graph subgraph: index all create/exercise/expire events, compute Greeks off-chain, and display in the UI.
What is included in the work
| Stage |
Result |
| Analytics and design |
Documentation with math model, pool parameters, IV oracle spec |
| Smart contract development |
Source code with tests (Foundry fuzz), deployment scripts |
| Oracle integration |
IV feed, TWAP, circuit breaker |
| Testing and audit |
External audit report (optional), simulation results |
| Frontend and subgraph |
LP dashboard, Greeks visualization, pool history |
| Post-deployment support |
Monitoring, bug fixes, upgrades if needed |
Stack and tools
| Component |
Technology |
| Math |
FixedPointMathLib (Solmate), PRBMath for ln/exp |
| IV oracle |
Chainlink Custom Feed / off-chain keeper + signature |
| Testing |
Foundry fuzz tests (all strike/time/IV combinations) |
| Subgraph |
The Graph (Greeks, LP history, open interest) |
| Frontend |
wagmi, viem, recharts for payoff visualization |
Development process
-
Analytics (3-5 days). Choose assets, option style (American/European), IV oracle parameters, LP pool tokenomics.
-
Development (3-5 weeks). PriceCalculator first — everything else depends on it. Fuzz-test math at edge values (very low/high IV, short time to expiry).
-
Testing (1 week). Simulate a 50% flash crash in 1 hour — assess LP losses and compare with expected risk profile.
-
Audit and deployment. External audit is mandatory — option math contains non-trivial edge cases. We guarantee transparency and security.
Timeline estimates
A basic European option protocol for one asset: 4 to 6 weeks. A full protocol with American options, multiple assets, and governance: 8 to 14 weeks. Contact us for a precise estimate for your project. With over 7 years of experience in DeFi and 50+ smart contract projects delivered, we ensure robust security and efficient code. Request development and receive a ready-to-deploy protocol with audit and documentation.
DeFi Protocol Development
We design modular DeFi protocols where the math of stablecoins, liquidity, and oracles works flawlessly. Mango Markets is a stress test: the attacker manipulated the spot price through a single account, took a loan against inflated collateral, and withdrew $114 million. The oracle took the price from a single source without TWAP. Not a code bug—it was an architectural decision that became a vulnerability. Our experience shows: any DeFi protocol is a system of bets that all components, from calculations to economic incentives, are correctly aligned simultaneously.
We don't write code under the 'if it works, don't touch it' mindset. We model stress scenarios: cascading liquidations, depegs, flash loans. Only then do we build events that won't break the protocol.
Why are oracles a critical component of DeFi?
Most major DeFi hacks started with oracle manipulation. Let's break down the three layers we use in every project.
Spot price as oracle—not an option. Uniswap v2 spot price can be shifted by a flash loan in one transaction. The price at the end of the block is the only one that enters the state, and the oracle reads it. Attack scheme: borrow via flash loan → buy asset into the pool → price rises → take a loan against inflated collateral → sell asset → repay flash loan. One transaction.
TWAP as protection. Uniswap v3 observe() averages the price over a period (30 minutes). Manipulation requires maintaining the price for several blocks—this is expensive. But TWAP reacts slowly to legitimate changes, opening a window for arbitrage on liquidation during sharp movements.
Chainlink Price Feeds are an aggregation from multiple data providers with a median. Standard for lending. Problem: heartbeat 1–24 hours and deviation threshold 0.5%. If the price doesn't move, the feed may not update for a day. In volatile markets—lag.
| Oracle |
Mechanism |
Manipulation Protection |
Latency |
| Chainlink |
Median from independent providers |
High (decentralization) |
Up to 24h at 0% movement |
| Uniswap v3 TWAP |
Average price over N blocks |
High (hard to maintain) |
30 min – 1 h |
| Pyth Network |
Cross-chain low-latency |
Medium (dependent on publisher) |
Seconds |
In production, we use a two-tier check: Chainlink aggregator + Uniswap v3 TWAP as a verifier. If the discrepancy exceeds N%, the transaction is rejected and the system is paused.
How to protect a DeFi protocol from flash loan attacks?
Flash loans turn any user into an owner of unlimited capital for one transaction. Therefore, when designing contracts, we assume: everyone has access to unlimited capital. This completely changes the threat model.
Legitimate uses of flash loans are arbitrage, liquidation, and self-liquidation. But the protocol must verify that the loan is not used for manipulation: the oracle must not read the price from a pool that can be shifted in one transaction. We add checks on block.timestamp and minimum liquidity depth.
Key Components of DeFi Architecture
| Protocol Type |
Core Mechanism |
Main Risk |
| DEX (AMM) |
x*y=k or concentrated liquidity |
impermanent loss, oracle manipulation |
| Lending |
collateral ratio, liquidation |
bad debt during cascading liquidations |
| Yield aggregator |
auto-compounding strategies |
rug via strategy upgrade |
| Derivatives / Perps |
funding rate, mark price |
liquidation cascades, socialized losses |
| Liquid staking |
stETH-style rebasing |
depegging on mass unstake |
AMM: From x*y=k to Concentrated Liquidity
Uniswap v2 uses x * y = k. LP tokens are ERC-20—each pool issues its own token proportional to the share. Problem: liquidity is spread across the entire curve, most of it unused.
Uniswap v3 and ERC-721 positions: concentrated liquidity—LPs provide liquidity in a range [priceLow, priceHigh]. Capital efficiency up to 4000x for stable pairs. But ERC-721 breaks vault strategies built for ERC-20. Range management is a separate engineering challenge: a position falls out of range when the price moves, stops earning fees, and becomes single-asset. Protocols like Arrakis Finance automatically rebalance. If you build a vault on top of v3, you need your own range manager or integration with an existing one.
Slippage in v3 is calculated via sqrtPriceX96—96-bit fixed-point math. Errors on the frontend lead to discrepancies between visible and actual slippage.
Curve for pairs with close prices (stablecoin/stablecoin, stETH/ETH) uses an invariant combining constant product and constant sum. Lower slippage within the peg range. Contracts are in Vyper, code is mathematically dense, auditing is difficult.
Lending Protocols: Collateral, Liquidation, Bad Debt
LTV defines the maximum loan against collateral. Liquidation threshold is the level for liquidation. The difference is the buffer for the liquidator. Typical example: LTV 75%, liquidation threshold 80%, bonus 5%. If the price drops 20%+, the position is open for liquidation.
Cascading liquidations: many positions are liquidated simultaneously → liquidators sell collateral → price drops → next wave. LUNA/UST 2022 is a classic cascade.
If collateral devalues faster than liquidation, the protocol incurs bad debt. Aave uses a Safety Module (staked AAVE), Compound uses reserves. Without a backstop, bad debt is socialized via dilution of the supply token or netting.
Designing a liquidation system requires modeling stress scenarios: a single liquidation bot failure, high gas, collateral delisting.
Yield Farming and Incentive Mechanics
Liquidity mining distributes governance tokens to LP providers. Problem: mercenary capital—farmers come, sell tokens, leave. TVL is illusory.
Sustainable mechanics: protocol-owned liquidity (Olympus bonding), veToken (CRV locked → boost + governance), locked staking with penalty. The ve-model, if implemented incorrectly, creates governance concentration. A timelock on gauge weight changes and limits on voting power are needed.
What Our DeFi Protocol Development Includes
- Architectural documentation: contract interaction diagrams, liquidation stress tests, oracle calculations.
- Implementation in Solidity 0.8.x with OpenZeppelin 5.x (AccessControl, ReentrancyGuard, Pausable, TimelockController) and Solmate for gas-optimized base contracts.
- Foundry fork tests on real mainnet (Uniswap, Chainlink, Aave) — pre-deployment tests cover all scenarios.
- Audit: at least two independent auditors for TVL over $1M. Code4rena or Sherlock for bug bounty.
- Deployment with Gnosis Safe 3/5 multisig + timelock 48–72 hours.
- Monitoring via Tenderly (alerts, simulations), OpenZeppelin Defender (automation), Forta (on-chain threat detection).
- Post-launch support: updates, patches, upgrades via proxy.
Our Expertise and Experience
We have been developing DeFi protocols since 2020, delivering 30+ projects with a combined TVL of over $150 million. Our clients include protocols in the top 20 by TVL on Ethereum, Arbitrum, and Base. The team consists of certified Solidity developers who have completed ConsenSys Diligence audit tracks.
DeFi basic principles that we apply in practice.
Timelines
- DEX with AMM (Uniswap v2 fork): 6–10 weeks
- Lending protocol (Aave-style, single collateral): 3–5 months
- Yield aggregator with multiple strategies: 2–4 months
- Full-fledged DeFi protocol with governance: 5–8 months including audit
Cost is calculated individually—contact us for a project estimate.
Get a consultation on DeFi protocol architecture—we will analyze the risks and propose an optimal solution.