Yield Basis 백서

Yield Basis

원문

bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 24쪽 중 1쪽

Skip to main content ## /user/introduction On this page YieldBasis is a decentralized protocol that lets liquidity providers earn trading fees on volatile-asset pairs without the impermanent loss a normal LP suffers. Built on Ethereum and powered by Curve Cryptoswap pools, YieldBasis maintains a 2× leveraged position that tracks the underlying asset one-to-one. A yb-LP share moves with BTC or ETH, keeping full price exposure in both directions, while collecting fees that a normal LP would forfeit to impermanent loss. Currently live Markets: cbBTC, WBTC, tBTC, WETH . See Contract Addresses for the full list. Where to start ​ If you are new to YieldBasis, read these in order: How YieldBasis Works — overview on the mechanism. yb-LP Tokens — what your shares mean and the staked vs unstaked split. Risk Disclaimer — what you are accepting before you deposit. Provide Liquidity — your first deposit, step by step. Pick your yield ​ Two ways to earn from a yb-LP position. Pick before you read the deep mechanics. Unstaked yb-LP Staked yb-LP How you earn Trading fees, visible as Fundamental Value growth YB emissions, paid by the gauge Best for Passive holders with no YB token exposure Those seeking exposure to YB Learn more yb-LP Tokens Staked vs Unstaked Economics Find your section ​ If you are... Start here A new liquidity provider The "Where to start" path above Already an LP, choosing staked vs unstaked Pick your yield above and Staked vs Unstaked Economics Holding YB or veYB veYB , Tokenomics , and Vote for Gauges Building or integrating on top Developer overview Evaluating risks before depositing Risk Disclaimer and Audits Where to start Pick your yield Find your section ## /dev/overview On this page Each market on YieldBasis provides 2× leverage exposure to a Curve Cryptoswap LP position while cancelling impermanent loss at the depositor level. Markets are deployed by a central Factory and consist of a fixed set of contracts that interact through well-defined interfaces. This page orients integrators, arb / MEV builders, and protocol-curious developers. System architecture ​ ┌─────────────────────────────────────────────────────────────────────────────┐ │ FACTORY │ │ (Central Market Registry & Deployer) │ └─────────────────────────────────────────────────────────────────────────────┘ │ │ ▼ ▼ ┌──────────────────────────────────────┐ ┌──────────────────────────────────────┐ │ MARKET 0 (WBTC) │ │ MARKET 1 (cbBTC) │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ LT │ │ LEVAMM │ │ Oracle │ │ │ │ LT │ │ LEVAMM │ │ Oracle │ │ │ └─────────┘ └─────────┘ └─────────┘ │ │ └─────────┘ └─────────┘ └─────────┘ │ │ ┌─────────┐ ┌───────────────┐ │ │ ┌─────────┐ ┌───────────────┐ │ │ │ Virtual │ │ LiquidityGauge│ │ │ │ Virtual │ │ LiquidityGauge│ │ │ │ Pool │ │ (staker) │ │ │ │ Pool │ │ (staker) │ │ │ └─────────┘ └───────────────┘ │ │ └─────────┘ └───────────────┘ │ └──────────────────────────────────────┘ └──────────────────────────────────────┘ The system supports multiple independent markets (cbBTC, WBTC, tBTC, WETH…), each with its own contract instances. Markets are fully isolated from each other. A governance layer ( YB , VotingEscrow , GaugeController , FeeDistributor ) sits above the markets and controls emissions and fee routing. A separate HybridVaultFactory deploys per-user HybridVault proxies for multi-market holders. Core technical concepts ​ 2× leverage mechanism ​ Each market maintains a constant 2× compounding leverage ratio via the AMM contract's invariant. The invariant is tied to an external oracle price; when oracle and Cryptoswap spot disagree, arbitrageurs trading through VirtualPool profit by moving state back toward L = 2 L = 2 L = 2 . Rebalancing is continuous and keeper-free. Market isolation ​ Independent state. Each market maintains separate collateral, debt, and fee balances. Risk separation. Issues in one market do not affect others. Custom parameters. Each market can have tailored fee rates and debt-ceiling allocations (subject to Factory constraints). Implementations are set per-market at deploy. Future markets can use upgraded blueprints without retroactively changing existing markets. Fee flow ​ Trading fees collected by AMM grow the AMM's internal x0 (LEVAMM trading fees) or flow into LP virtual_price growth (Cryptoswap trading fees, split inside the pool by the governance-set reserved_profit_fraction ). Borrower interest is distinct: it is swept to LT and donated back to the Cryptoswap pool as rebalance reserve (not LP yield). See Fee Mechanics . Curve dependency ​ YieldBasis markets sit on Curve Cryptoswap pools (asset / crvUSD pairs). The integration touches a focused set of pool features: Pool state read by CryptopoolLPOracle — virtual_price and price_scale , combined into the local LP-price formula 2 · virtual_price · √price_scale . The oracle does not call POOL.lp_price() . Pool balances accessed by LT and AMM — balances(i) for collateral valuation. LP token mint and burn — LT and VirtualPool add and remove liquidity via add_liquidity and remove_liquidity_one_coin . The arb path mints LP from a flash-loaned crvUSD leg, swaps inside LEVAMM, and burns LP to repay. Donation channel — LT.distribute_borrower_fees calls add_liquidity(amounts, min_amount, empty(address), donation=True) so borrower interest flows into the pool's rebalance reserve without minting LP shares to a user. The pool releases donations over its configured window rather than in one block. Pool rebalancing — the pool internally rebalances price_scale toward the external price as fees accumulate. YB does not call this; it relies on the pool's own profit-aware logic for the speed of price_scale tracking. Trading fees — split inside the pool by reserved_profit_fraction (governance-set per pool; the reserved share grows LP virtual_price, the rest funds the rebalance reserve — read the pool for live values). YieldBasis relies on the public surface above ( virtual_price , price_scale , balances , add_liquidity , remove_liquidity_one_coin , the donation flag, and the internal rebalancing being profit-aware). Integration code should rely on these interfaces, not on assumptions about pool internals. See User: Oracle Design for the user-level oracle explainer. Contract architecture ​ Each market consists of five core contracts. Click through for the full reference. Factory.vy — market registry and deployment ​ Deploys new markets from blueprint contracts. Manages contract implementations (set per-deploy; future markets only). Controls per-address stablecoin allocations and debt ceilings. Registry of all deployed markets via markets(i) . Full reference: Core: Factory . LT.vy — market-specific vault ​ ERC-20 vault share (e.g. yb-WBTC , yb-cbBTC , yb-tBTC , yb-WETH ). ERC-4626-like but not strict — emits ERC-4626 Deposit / Withdraw events and exposes preview_deposit / preview_withdraw , but does not implement convertToAssets / mint / redeem . Strict ERC-4626 lives on LiquidityGauge . Manages staked / unstaked bucket accounting ( liquidity struct) and admin-fee split. Handles interest-to-donation refueling via distribute_borrower_fees . Full reference: Core: LT . AMM.vy (LEVAMM) — constant-leverage AMM ​ Holds Curve LP tokens as collateral and crvUSD as debt. Maintains 2× leverage via an oracle-informed invariant ( x_0 quadratic). Fees captured in the invariant itself; no separate fee bucket. Interest accrues continuously via rate_mul . Full reference: Core: AMM . VirtualPool.vy — flash-loan-powered arb path ​ Wraps AMM + Cryptoswap + flash loan to expose direct crvUSD ↔ asset swaps. The arb path — LEVAMM does not trade directly against users. Quotes via get_dy(i, j, in_amount) , executes via exchange(...) . Full reference: Core: VirtualPool . CryptopoolLPOracle.vy — price feed ​ LP price formula: 2 × virtual_price × √price_scale × p_agg (computed locally from virtual_price and price_scale ; does not call POOL.lp_price() ). Sandwich-resistant via EMA-smoothed price_scale and a crvUSD aggregator. The ( 0.90 , 1.10 ) (0.90, 1.10) ( 0.90 , 1.10 ) aggregator safety band is enforced by Factory._validate_agg at deploy and on set_agg , not by this oracle. Full reference: Core: CryptopoolLPOracle . LiquidityGauge.vy — staker (ERC-4626) ​ Strict ERC-4626 wrapper over yb-LP. Distributes YB emissions and up to 8 custom reward tokens. Full reference: DAO: LiquidityGauge . Terminology map ​ User-facing docs and on-chain symbols use different names for the same concept. When reading code, map back via this table. User doc term On-chain symbol Location yb-LP ERC-20 share of LT (ERC-4626-like but not strict) LT.vy LEVAMM AMM AMM.vy Vault LT LT.vy Virtual pool VirtualPool VirtualPool.vy Watermark ideal_staked (in LT.liquidity ) LT.vy Recovery Mode state: staked < ideal_staked LT.vy TRD observed: preview_withdraw(1e18) / pricePerShare() − 1 (signed; negative during a discount) no variable PPS (fundamental value) pricePerShare() — oracle-priced, sandwich-resistant LT.vy Redemption value preview_withdraw(shares) — live Cryptoswap unwind via calc_withdraw_fixed_out LT.vy ERC-4626 staker LiquidityGauge wraps LT shares with strict ERC-4626 LiquidityGauge.vy Gauge voting GaugeController.vote_for_gauge_weights — votes instant, 10-day cooldown per gauge GaugeController.vy veYB ERC-721 NFT minted by VotingEscrow.create_lock VotingEscrow.vy Core invariants ​ Integration code should assume and never violate these: L = 2 L = 2 L = 2 — immutable per Factory deployment. Not a DAO-mutable parameter. Safe-debt bounds — MIN_SAFE_DEBT ≤ debt / collateral_value ≤ MAX_SAFE_DEBT . At L = 2 L = 2 L = 2 , roughly [1/16, 8.5/16] of collateral value. Trades pushing outside the band and away from equilibrium revert. Watermark monotonicity — staked ≤ ideal_staked always. ideal_staked rises on stake, does not fall on loss. TRD sign convention — TRD = preview_withdraw(1e18) / pricePerShare() − 1 . Negative (discount) is the common case; positive (premium) is possible when live Cryptoswap state is rich relative to the oracle. This is an economic regularity, not a contract-enforced invariant — preview_withdraw has no clamp ( LT.vy:443-455 ). Oracle clamp band — crvUSD oracle value inside ( 0.90 , 1.10 ) (0.90, 1.10) ( 0.90 , 1.10 ) , strictly open at both ends. Outside the band, Factory-init and set_agg revert — never silently return stale data. Mathematical foundation ​ The LEVAMM invariant solves a quadratic for x 0 ( p o ) x_0(p_o) x 0 ​ ( p o ​ ) : x₀ = (coll_value + √(coll_value² − 4 × coll_value × LEV_RATIO × debt)) / (2 × LEV_RATIO) where LEV_RATIO = L² / (2L − 1)² . At L = 2 L = 2 L = 2 , LEV_RATIO = 4/9 . See AMM.vy::get_x0 (lines 142–157) for implementation. Full derivation — including flash-loan sizing and the admin-fee curve — lives in Math Primer §3 . Other pages (compounding-leverage, fee-mechanics, yb-LP-value-derivation) link to specific equation numbers rather than restating the math. Where to start ​ If you want to… Start at Understand the math Math Primer , Compounding Leverage Integrate YB pools for routing Quickstart → Quote & Route Run arb / MEV Arbitrage Recipe , Core: VirtualPool Deposit / withdraw flows Integration: Deposit & Withdraw Enumerate deployed markets Quickstart §1 , Contract Addresses Read all events Event Catalog Debug a revert Error Codes Tech stack ​ Vyper 0.4.3 — all production contracts. Titanoboa — testing framework. Hypothesis — property-based stateful tests. Poetry / Hardhat — dependency and deployment config. Source ​ yield-basis/yb-core — full contract source. Referenced by line number throughout these docs. Related ​ User: Contract Addresses — canonical mainnet address list. User: Glossary — full terminology reference. User: Risk Disclaimer — risks integrators should surface to their users. System architecture Core technical concepts 2× leverage mechanism Market isolation Fee flow Curve dependency Contract architecture Factory.vy — market registry and deployment LT.vy — market-specific vault AMM.vy (LEVAMM) — constant-leverage AMM VirtualPool.vy — flash-loan-powered arb path CryptopoolLPOracle.vy — price feed LiquidityGauge.vy — staker (ERC-4626) Terminology map Core invariants Mathematical foundation Where to start Tech stack Source Related ## /pdf/mica-whitepaper.pdf MiCA · European Union White Paper OT (Other Token) Last updated August 25th, 2025 Issuer BasisYield AG EU White Paper Summary Risk Factors Offeror or Person Seeking Admission to Trading Issuer Information Operator of Trading Platform Information about the crypto-asset project Public Offer or Admission to Trading Information about the crypto-assets Rights and Obligations Underlying Technology Sustainability Indicators Basis Yield AG 3 5 10 12 13 14 17 23 26 28 30 1 EU White Paper Basis Yield AG 2 This crypto-asset white paper has not been approved by any competent authority in any Member State of the European Union. The offeror of the crypto-asset is solely responsible for the content of this crypto-asset white paper. Where relevant in accordance with Article 6(3), second subparagraph of Regulation (EU) 2023/1114, reference shall be made to ‘person seeking admission to trading’ or to ‘operator of the trading platform’ instead of ‘offeror’. This crypto-asset white paper complies with Title II of Regulation (EU) 2023/1114 and, to the best of the knowledge of the management body, the information presented in the crypto- asset white paper is fair, clear and not misleading and the crypto-asset white paper makes no omission likely to affect its import. The crypto-asset may lose its value in part or in full, may not always be transferable and may not be liquid. The crypto-asset is not covered by the investor compensation schemes under Directive 97/9/EC of the European Parliament and of the Council. The crypto-asset is not covered by the deposit guarantee schemes under Directive 2014/49/EU of the European Parliament and of the Council. Summary EU White Paper Basis Yield AG 3 Summary The YB token distribution on Ethereum is structured as follows from public launch of YieldBasis and YB issuance (i.e. TGE):\ Investors - 12% (6 month cliff, 24 months linear vesting) Team - 25% (6 month cliff, 24 months linear vesting) Incentives - 30% (distributed via algorithmic emission schedule) Protocol development - 7.5% (1 year cliff, 12 months vesting) Ecosystem - 12.5% (2 years vesting with 5% initial unlock) Curve Licensing - 7.5% (distributed via smart-contract using dynamic emission function) Initial liquidity and early incentives - 3% (subject to different distribution schedules) The summary should be read as an introduction to the crypto-asset white paper. The prospective holder should base any decision to purchase the asset-refenced token on the content of the crypto-asset white paper as a whole and not on the summary alone. The offer to the public of the crypto-asset does not constitute an offer or solicitation to purchase financial instruments and any such offer or solicitation can be made only by means of a prospectus or other offer documents pursuant to the applicable national law. The crypto- asset white paper does not constitute a prospectus as referred to in Regulation (EU) 2017/1129 of the European Parliament and of the Council (36) or any other offer document pursuant to Union or national law. YB is the native governance token of the YieldBasis protocol, issued by Basis Yield AG. YB holders may lock tokens to create veYB, which represents a vote-escrowed version with associated voting rights and participation in protocol revenue distribution. The extent of voting power and revenue sharing is determined by the quantity of YB locked and the lock duration. For a particular token holder's veYB position voting power and share of distributed revenue corresponds to the holder's veYB share in the overall number of veYB. Any modification of the characteristics of YB characteristics is subject to on-chain governance procedures as outlined by the protocol. YB operates as an ERC-20 token on the Ethereum blockchain and the total YB supply (fully diluted) amounts to 1 billion tokens. Provide a brief description of the characteristics of the token Provide the key information about the offer to the public or admission to trading of the token Summary EU White Paper Basis Yield AG 4 Public offering - 2.5% (full unlock)\ \ At the conclusion of the public offering, which will coincide with the YB TGE, Kraken intends on listing the YB token, and in compliance with MiCA, make the crypto-asset available for trading to its European clients. More information about the public offer and admission to trading can be found in Part E below. Risk Factors EU White Paper Basis Yield AG 5 Risk Factors Provide a detailed description of all issuer-related risks Describe the risks related to the offer to the public or its admission to trading &#x20; Concentration risk: It is possible that the distribution of tokens will not result in the intended broad dissemination of YB tokens across a diverse group of holders (for example, as a result of low levels of participation in the offering), which may impact the adoption, operations, and success of the YieldBasis network. Financialstabilityrisk: The financial condition of the issuer, including challenges in cash flow or profitability, may influence the project’s ability to meet its objectives. If financial difficulties arise, they could impact the operations or sustainability of the issuer.\ Operational and management risk: YieldBasis AG is a recently established private Swiss company with a relatively small team. The success of the YB token and its issuance The success of YB depends on the continued performance and integrity of the issuer’s management and developers. If one or more founders or core team members were to leave the project or fail to adequately perform their roles, the development and adoption of the YieldBasis network could be adversely affected.\ Reputational risk: The reputation of the issuer and its co-founders are important to the success of the YB public offering and launch of the YieldBasis network. There is a risk of negative public perception of the issuer through negative publicity, which may reduce confidence in the YB token and launch of the YieldBasis protocol as well as impact the success of the YB token issuance.\ Counterparty risks: The issuer's reliance on on third-party service providers, such as code auditors, custodians, trading platforms, wallet providers, liquidity providers, and systems integrators, introduces risk related to the non-fulfillment of obligations that may negatively affect functionality of the YB token, YieldBasis protocol, or overall ecosystem stability. Conflicts of Interest: Misalignment of interests between the Issuer and Token holders may lead to governance decisions that are not in the best interests of the community, potentially affecting the value of the Token or damaging the credibility of the project. Legal and regulatory risks: The issuer must comply with complex legal requirements (including data privacy, encryption export controls, and financial regulations) in multiple jurisdictions. Uncertainties in legal frameworks, regulatory changes, potential lawsuits, or adverse legal rulings could pose significant risks, affecting the legality, usability, or value of YB.\ &#x20; Risk Factors EU White Paper Basis Yield AG 6 DeFi risk: The advancement of strategies like the re-leverage algorithm introduces risks pertaining to algorithmic adjustments to market conditions, where any miscalculated leverage might diminish expected returns. Further risks emerge from potential discrepancies in the l
프로젝트로 돌아가기