On-Chain Crypto Options Pricing System (Black-Scholes)
On-chain option protocols face a problem that traditional derivatives don't: the Black-Scholes model requires floating-point calculations — logarithms, square roots, normal distributions — but the EVM only handles integers. Deribit computes option prices off-chain and centrally. Lyra, Hegic, and Dopex solve this differently. We have developed and deployed several such systems for DeFi protocols. Our experience shows that the optimal architecture combines off-chain precision with on-chain verification. Yet most protocols lose up to 30% of LP profits due to pricing inaccuracies in their chosen model. Our solutions reduce the error to 0.1% and save up to 70% on gas by offloading computations off-chain. This can save hundreds of thousands of dollars in gas costs at scale. In this article, we'll dissect the key problems and present a ready-made solution.
Black-Scholes Math in Integers
The BSM formula for a European call option:
C = S * N(d1) - K * e^(-rT) * N(d2)
where d1 = (ln(S/K) + (r + σ²/2) * T) / (σ * √T)
Every element introduces error when using integer arithmetic.
Logarithm and Exponential via Tables or Approximation
The classic approach is to approximate ln(x) using a Taylor series with fixed-point arithmetic (18 decimals). Solidity has no native ln, but the PRBMath library implements ln, exp, sqrt with precision up to 1e-9 using 59.18-decimal fixed-point. This is production-ready: Uniswap v3 uses similar techniques for sqrtPriceX96.
An alternative is to use lookup tables for the standard normal distribution N(d). A 1000-point table with interpolation provides sufficient accuracy for options and costs less gas than an analytical approximation. Lyra v1 used this approach.
How Is Implied Volatility Computed On-Chain?
The hardest part is not computing the price from known volatility, but finding implied volatility (IV) from the market price. The equation BSM_price(σ) = market_price has no analytical solution. Methods: Newton-Raphson iterations or bisection search.
On-chain Newton-Raphson converges to IV with 0.1% accuracy in 5–7 iterations — costing around 80–150k gas on Ethereum mainnet. Acceptable for L2s, expensive for mainnet. Solution: IV is computed off-chain, submitted on-chain with an oracle signature, and the contract only verifies the signature and uses the value.
Why Stale Volatility Matters and How to Avoid It
Crypto volatility changes rapidly. Bitcoin's IV can rise from 60% to 120% in 24 hours during a sharp market move. If stale IV is stored on-chain, options are mispriced. A buyer of an option with undervalued IV gets an unfair price at the expense of LPs. Lyra v2 solves this via an off-chain oracle updating IV every 15 minutes. Hegic uses the Chainlink volatility oracle. For a custom system — update via a keeper (Gelato or Chainlink Automation) with bounded updates: IV cannot change by more than X% per update.
Pricing System Architecture
Off-Chain Pricing Engine + On-Chain Verification
The optimal architecture for production: a pricing server in TypeScript/Python with full float64 precision, results signed by an operator or multi-party committee, the contract verifies the signature and uses the price. This is not 'centralized' in a negative sense — there is an explicit trust assumption that is documented. For comparison: Deribit is fully centralized, Lyra v1 used a similar oracle scheme.
The on-chain contract stores: spotPrice (from Chainlink), impliedVolatility (from keeper), lastUpdateTimestamp. If data is stale (> maxStaleness), no new positions can be opened.
| Characteristic |
On-Chain Full |
Off-Chain + Verification |
| Gas per pricing |
150–300k |
40–60k (verification only) |
| Precision |
Fixed-point |
Float64 |
| Trust assumption |
None |
Oracle |
| Update speed |
Via keeper |
Instant |
Calculating Greeks for Risk Management
For an LP pool that acts as counterparty for all options, aggregate delta-hedging is critical. The delta of each option is summed to the pool's net delta, and a keeper executes hedging swaps to maintain delta neutrality.
| Greek |
Meaning for the Pool |
Calculation Method |
| Delta |
Exposure to spot price |
N(d1) for calls, N(d1)-1 for puts |
| Gamma |
Rate of delta change |
φ(d1) / (S * σ * √T) |
| Vega |
Exposure to volatility |
S * φ(d1) * √T |
| Theta |
Time decay |
Analytical |
The pool's PnL from Greeks is aggregated into netDelta and netVega. If |netDelta| > hedgeThreshold, the keeper initiates a swap on Uniswap v3 to rebalance.
Supported Option Types
Cash-settled vs physical delivery. Cash-settled is simpler: at expiry, the contract requests the spot price from Chainlink, computes the payoff, and transfers USDC. Physical delivery requires storing the underlying asset in the contract. American vs European — American options require a binomial tree or Monte Carlo for correct valuation, which is impractical on-chain. All on-chain option protocols use European style.
Early exercise via flash loan — theoretically, an attacker could try to exercise an option during an oracle manipulation. Protection: the settlement price is computed as a TWAP over the last hour before expiry, not the spot.
Process of Work
-
Mathematical specification (2–3 days). Formalize: option type, settlement mechanics, data sources for S and σ, fee model, hedging mechanism.
-
Pricing library (2–3 days). Solidity library for BSM using PRBMath. Unit tests compare results with Python scipy.stats reference implementation.
-
Oracle and keeper (2–3 days). Off-chain pricing engine, data signing, Gelato automation for IV updates.
-
Core contracts (3–5 days). OptionPool (LP), OptionToken (ERC-1155), settlement logic.
-
Testing (2–3 days). Fork tests on mainnet with real Chainlink feeds, expiry scenarios.
What's Included in the Pricing System Development
- Mathematical specification and model selection
- Solidity BSM library with PRBMath
- Off-chain pricing engine in TypeScript/Python
- Integration with oracles (Chainlink, Gelato)
- Testing on mainnet fork with real data
- Documentation and team training
- Post-launch support guarantee
Investment in development pays off through reduced gas costs and pricing accuracy.
Timeline Estimates
Pricing system as a library + oracle infrastructure: 3–5 days. Full options protocol with LP pool, hedging, and frontend: 6–10 weeks.
Our team has 10+ years of experience in blockchain development and has built over 20 smart contracts for options protocols. We guarantee pricing accuracy within 0.1% and architectural transparency.
Get a consultation on the architecture — we will help you choose the optimal scheme and implement the system turnkey. Order development of an options pricing system.
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.