Skip to content

Quaddlab/vort

Repository files navigation

πŸŒͺ️ Vort Protocol

Table of Contents

  1. Overview
  2. The Core Problem & Solution
  3. Key Features
  4. System Architecture (Standard Diagrams)
  5. Smart Contract Modules
  6. Roadmap

Overview

Vort is a decentralized, autonomous, and gamified yield-stripping protocol built natively on the Stacks blockchain, specifically designed to leverage sBTC.

By depositing sBTC, users engage in a mechanism that splits the underlying asset into Principal Tokens (PT) and Yield Tokens (YT) for a defined period known as an "Epoch". This allows users to trade the time value of sBTC separately from the principal asset.

The Core Problem & Solution

The Problem: In traditional DeFi, when you deposit assets into a yield-bearing vault, your capital is locked, and your yield rate is variable. You cannot hedge against rate drops, nor can you easily cash out your future yield today.

The Solution: Vort splits yield-bearing sBTC into:

  • PT (Principal Token): Guarantees 1:1 redemption for sBTC at maturity. Can be bought at a discount today for a guaranteed fixed yield.
  • YT (Yield Token): Claims all the variable yield generated by the protocol. Can be bought to gain highly leveraged exposure to yield rates without putting up the full capital.

Key Features

  • Zero-Maturity AMM: Swap between PT and sBTC instantly using our bespoke automated market maker, bypassing the need to wait for epoch maturity.
  • Native sBTC Integration: Operates directly with real testnet sBTC (ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.sbtc-token), ensuring full 1:1 mainnet parity.
  • Zest Protocol Yield Sourcing: Deposits are routed to the Zest Protocol (via simulated vault architecture) to generate sustainable real-world yield.
  • Automated Treasury Routing: The protocol automatically directs a 5% fee to the treasury and 5% to reserves, distributing the remaining 90% flawlessly to YT holders.

System Architecture

(Standard Architecture Diagrams)

1. Tokenization Engine

The Tokenization flow is the entry point into the Vort ecosystem. Users supply raw sBTC, and the tokenizer locks it into the yield-generating vault while minting the derivative tokens.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”          1 sBTC           β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚              β”‚ ────────────────────────> β”‚                       β”‚
β”‚    User      β”‚                           β”‚      Tokenizer        β”‚
β”‚   Wallet     β”‚ <──────────────────────── β”‚   (tokenizer-v3.clar) β”‚
β”‚              β”‚    Mints 1 PT + 1 YT      β”‚                       β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜                           β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                                      β”‚
                                                      β”‚  Locks 1 sBTC
                                                      v
                                           β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                                           β”‚                       β”‚
                                           β”‚  Zest Vault Contract  β”‚
                                           β”‚ (mock-zest-vault-v2)  β”‚
                                           β”‚                       β”‚
                                           β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

2. Yield Accrual Network

As Zest Protocol generates yield on the locked sBTC, the Yield Router pulls the new assets and distributes them proportionally. YT Holders can claim their exact share of the available yield pool at any time.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”        Yield Accrues       β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                β”‚ ─────────────────────────> β”‚                       β”‚
β”‚   Zest Vault   β”‚                            β”‚      Yield Router     β”‚
β”‚                β”‚                            β”‚ (yield-router-v3.clar)β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜                            β”‚                       β”‚
                                              β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                                        β”‚
                      β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”             β”‚ (90% distributed
                      β”‚ Treasury Reserve  β”‚ <────────────  based on YT qty)
                      β”‚  (Admin/Owner)    β”‚  (10% fee)  β”‚
                      β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜             v
                                              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                                              β”‚                       β”‚
                                              β”‚      YT Holders       β”‚
                                              β”‚                       β”‚
                                              β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

3. Constant-Product AMM

To provide liquidity before maturity, the pt-amm-v3 contract enables instantaneous swaps between PT and sBTC using the formula k = sBTC * PT.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”           Swap sBTC         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚               β”‚ ──────────────────────────> β”‚                       β”‚
β”‚    Trader     β”‚          (0.3% Fee)         β”‚     Vort PT-AMM       β”‚
β”‚               β”‚ <────────────────────────── β”‚    (pt-amm-v3.clar)   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜        Receives PT          β”‚                       β”‚
                                              β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                                         β”‚
                                               β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                                               β”‚   Liquidity Pool  β”‚
                                               β”‚  [ sBTC ] [ PT ]  β”‚
                                               β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Smart Contract Modules

Vort operates through highly isolated, secure Clarity smart contracts:

  1. tokenizer-v3.clar: The engine. Handles user deposits, mints PT/YT via administrator privileges, stores epoch maturity data, and processes post-maturity 1:1 PT redemptions.
  2. pt-token.clar (SIP-010): Fungible token contract for Principal Tokens.
  3. yt-token.clar (SIP-010): Fungible token contract for Yield Tokens.
  4. yield-router-v3.clar: The distribution hub. Calculates the global yield-per-token-stored rate, handles treasury/reserve splits, and processes user yield claims.
  5. pt-amm-v3.clar: Decentralized liquidity pool facilitating PT <-> sBTC swaps with a configurable 0.3% fee to liquidity providers.

Core Design Principles

  • Capital efficiency: Maximize leverage on yield-bearing positions.
  • Deterministic redemption: 1:1 sBTC peg for Principal Tokens at maturity.
  • Sustainable revenue: Real yield derived from established protocols like Zest.
  • Risk transparency: Immutable on-chain tracking and audits.
  • Protocol-owned stabilization: Subsidized liquidity via treasury bootstrapping.

(Planned for future phases)

  • Multi-epoch liquidity: Continuous markets across multiple maturity time horizons.

Epoch Architecture

Presently, Vort operates on a single active maturity epoch (MVP). In the future, Vort will operate across multiple concurrent maturity buckets (e.g., 30-day, 90-day, 180-day). Each epoch tracks:

  • Start block & Maturity block
  • Total deposits within the epoch
  • Yield index (representing total generated return)
  • PT and YT supply
  • Reserve coverage ratio

Complete User Workflow

  1. Initialization: Wallet connection and state syncing.
  2. Tokenization: Minting sBTC into identical proportions of PT and YT for the active epoch.
  3. Yield Farming: Continuous, per-block yield accrual via the yield-router contract.
  4. Fixed Yield Hedging: Buying PT through the AMM at a discount for guaranteed fixed returns.
  5. Yield Speculation (Planned): Buying YT via decentralized markets to gain leveraged exposure to yield rates.
  6. Contingency Stabilization (Planned): Active Reserve buffer intervention during exceptionally low yield periods.
  7. Trading: Secondary market interactions for continuous liquidity (PT-AMM currently active).
  8. Maturity: 1:1 redemption of PT for sBTC. Auto-roll options are planned for future phases.

Revenue Model & Bootstrap Strategy

Revenue Streams:

  • Swap fees accrued from the PT automated market maker.
  • A fixed 5% percentage of total generated yield allocated to the protocol treasury, and 5% to reserves.
  • Optional minting fees (controlled by governance).

Bootstrap Note: During the first 12 months, 20–30% of treasury revenue is re-allocated to protocol-owned liquidity (POL) and Liquidity Provider (LP) incentives on the PT AMM pairs. This effectively subsidizes early adoption, with heavier weighting targeted toward the most liquid 90-day epoch.

SDK for Builders (Infrastructure Layer)

(Planned for Phase 3 Roadmap) To transform Vort from an application into financial infrastructure, a TypeScript SDK with an indexed data layer will be provided, featuring:

  • Epoch module: List active epochs, base APY, and time-to-maturity.
  • Tokenization module: Programmatic deposits and simulated mints.
  • Trading module: Request swap quotes and model slippage dynamically.
  • Yield module: Calculate claimable yield and theoretical projections.
  • Analytics module: Chart the protocol discount curve and public reserve health.

Enables integrations for third-party dashboards, trading bots, meta-vaults, and DAO treasury strategies.

Risk Model

The protocol is designed with conservative buffers to mitigate DeFi vulnerabilities:

  • Yield source risk: Mitigated by a mandated 5% reserve buffer and eventual diversification across multiple money markets.
  • Liquidity fragmentation: Mitigated by targeted POL incentives and consolidation into 90-day epochs.
  • Oracle & Smart Contract risk: Mitigated by strict internal accounting (no external oracles for PT/sBTC logic) and comprehensive security audits.
  • Integration risk: Mitigated by integrating exclusively with top-tier audited protocols (e.g., Zest), coupled with governance-controlled strategy switching.
  • Yield variability: The reserve buffer targets a 10–15% coverage of expected epoch yield; if depleted, new minting pauses until replenished.
  • sBTC peg risk: Relies on the fully decentralized signer set (70% threshold) of the core Stacks network with Bitcoin finality.

Strategic Positioning

Vort is positioned to be to the Stacks ecosystem what Pendle is to Ethereum: a Bitcoin-native fixed-income layer. It transforms fragmented yield wrappers into highly composed early-stage financial infrastructure entirely secured by Bitcoin.

πŸ—ΊοΈ Roadmap

Phase 1: Core Foundation (MVP) βœ…

  • Core tokenization contracts and Yield Router implementation.
  • Single 30-day epoch deployment.
  • Initial yield strategy integration (Zest Protocol designated as default).

Phase 2: Protocol Expansion

  • Multi-epoch deployment (30, 90, 180-day maturities).
  • Active reserve logic mechanics going live.
  • On-chain Multisig Governance implementations.

Phase 3: Ecosystem Layer

  • Public Developer SDK launch.
  • Advanced Analytics Dashboard and Discount Curve charting.
  • Third-party vault integrations.

Phase 4: Institutional Adoption

  • Institutional-grade tooling.
  • Advanced programmable auto-rolling strategies.
  • Decentralized, multi-protocol yield sourcing network.

Releases

No releases published

Packages

 
 
 

Contributors