Whitepaper · v1.0.0 · Public Architecture Specification

The Wolf's Head ($WOLF)

// The Outlaw Asset-Vacuum on the Robinhood Chain
Abstract

Converting Speculation into Hard Equity

Traditional Real-World Asset (RWA) protocols suffer from poor retail retention, stagnant yields, and passive TVL. The Wolf's Head ($WOLF) introduces a novel asset-accumulation protocol engineered natively for the Robinhood Chain. By combining an automated Uniswap v4 Hook Tax, programmatic target-rebalancing equities acquisition, and Lighter Protocol market-making yield integration, WOLF converts speculative retail trading volume into hard corporate equities (NVDA, AAPL, SPY).

To protect the protocol from farm-and-dump mechanics, yield emissions are distributed exclusively in non-transferable escrowed tokens (esWOLF) governed by a 10:1 Reserved Capital Lockup Constraint.

Section 01

System Architecture

The Wolf's Head ecosystem comprises five modular smart contracts that function as an automated financial engine:

┌──────────────────────────────┐ Uniswap v4 Trading Pool └──────────────┬───────────────┘(5% Hook Tax)┌──────────────────────────────┐ WolfHook.sol └──────────────┬───────────────┘(USDG Cash)┌──────────────────────────────┐ StockTreasury.sol └──────────────┬───────────────┘(Deployed to Lighter Engine)┌───────────────────┐ (Yields) ┌──────────────────────────────┐ User $WOLF Stake ├─────────►│ TheDen.sol └───────────────────┘ └──────────────┬───────────────┘(Emits $esWOLF)┌───────────────────┐ ┌──────────────────────────────┐ Liquid Unlocks │◄─────────┤ VestingPortal.sol └───────────────────┘ (10:1) & esWolfToken.sol └──────────────────────────────┘
Fig. 1 — Protocol value flow

1.1 Core Contracts Stack

ContractArchitectural RoleCore Execution
WolfToken.solCore ERC-20 AssetManages the hard-capped genesis supply of 100,000,000 $WOLF and core token transfers.
WolfHook.solUniswap v4 HookIntercepts DEX swaps at afterSwap, extracts a flat 5% tax, converts it to USDG, and routes it to the Treasury.
StockTreasury.solAsset AccumulatorReads Chainlink oracles, executes automated stock token purchases, and deploys capital into Lighter Protocol.
TheDen.solMaster Staking EngineManages user deposits in The Vanguard Territory and The Apex Territory, tracking reward balances.
VestingPortal.solEscrow & Lockup GateManages esWOLF vesting streams and enforces the 10:1 Reserved Capital Lockup rule.
Section 02

The Flywheel & Treasury Engine

2.1 The 5% Hook Tax Extraction

Every buy and sell transaction on Uniswap v4 triggers the WolfHook.sol contract post-execution.

Tax Extracted = Swap Volume × 0.05
  • The 5% fee is swapped instantly into native stablecoin collateral (USDG) within the pool.
  • USDG is pushed to StockTreasury.sol.
  • The treasury updates its rebalancing matrix to evaluate portfolio deficits.

2.2 Rebalancing Matrix & Chainlink Execution

The treasury maintains target asset matrices across two dedicated territories:

🦅 The Apex Territory

ProfileHigh-Beta Growth
Matrix40% NVDA · 30% AAPL · 20% TSLA · 10% AMD

🛡️ The Vanguard Territory

ProfileIndex Anchor
Matrix50% SPY · 50% QQQ

Buy-the-Underweight Algorithm. Instead of liquidating winning assets, the protocol executes a Buy-the-Underweight routine:

  • Every 24 hours (or when pooled USDG exceeds $5,000), executeHunt() is triggered.
  • The contract queries Chainlink Price Feeds to measure the live USD value of current treasury holdings.
  • Incoming USDG is routed entirely toward the assets trailing below their target percentages, systematically buying blue-chip assets at relative discounts.

2.3 Yield Amplification via Lighter Protocol

Purchased stock tokens are not left idle in the contract. StockTreasury.sol routes equity inventory directly into Lighter Protocol's order book engines, where it:

  • Captures automated trading fees and maker rebates.
  • Captures perpetual funding rates.
  • Generates a continuous share of ecosystem incentive rewards.
Section 03

The Den: Hunting Grounds

Users lock their liquid $WOLF inside The Den (TheDen.sol) across two thematic territories.

🛡️ The Vanguard Territory

Target APY30% – 40% (Stable)
BackingS&P 500 / Nasdaq Indices
RiskLow-Volatility Anchor

🦅 The Apex Territory

Target APY20% – 80% (Dynamic)
BackingNVDA, AAPL, TSLA, AMD
RiskHigh-Beta Growth Capture

3.1 Yield Distribution Mechanics

All yields generated across both territories are paid out exclusively in non-transferable esWOLF tokens minted from a fixed, hard-capped community emission pool.

  • Zero Direct Emission Inflation: High APYs (up to 80%) do not introduce immediate liquid sell pressure on open markets.
  • Escrow Wrapper: esWOLF cannot be transferred, traded on DEXs, or moved between wallets.
Section 04

Escrow Tokenomics & the Vesting Gate

To convert synthetic esWOLF rewards into liquid, sellable WOLF, users interact with VestingPortal.sol — "The Alpha's Cut."

User Requests Vest: 100 $esWOLF │ ▼ Check 10:1 Capital Rule Need: 1,000 $WOLF in The Den │ ┌────────┴────────┐ │ │ [PASSED] [FAILED] │ │ Freeze Collateral Reject Transaction Start Linear Vest
Fig. 2 — Vesting gate validation flow

4.1 The 10:1 Reserved Capital Lockup Rule

To eliminate mercenary yield farming (e.g., farming large rewards, unstaking core capital, and vesting with a dust balance), the contract enforces a strict collateral requirement:

Required Reserved $WOLF = Amount of $esWOLF to Vest × 10
  • To vest 100 esWOLF, the user must keep 1,000 WOLF frozen in TheDen.sol for the entire vesting duration.
  • Users choose between a 1-Week Hyper-Loop or a 1-Month Linear Stream.

4.2 Early Exit Penalty & Slash Mechanics

If a user attempts to unstake their reserved core WOLF capital prior to vest completion:

  • The active vesting stream is instantly cancelled.
  • Unvested esWOLF rewards are slashed and permanently burned (or returned to the treasury pool).
  • The user reclaims their core WOLF collateral plus any rewards that completed vesting prior to cancellation.
Section 05

Tokenomics & the Deflationary Loop

WOLF operates under a strict, non-inflationary token model backed by real cash flow and supply reductions. Genesis supply is hard-capped at 100,000,000 $WOLF.

5.1 Token Supply Allocation

40%
Initial DEX Liquidity Pool (Uniswap v4)
30%
Community Emission Reserve (esWOLF)
15%
Ecosystem Treasury & Reserve
10%
Core Dev (24-Mo Cliff)
5%
Partnerships & Audits

5.2 Deflationary Pressures Summary

  • Hard Supply Cap: Fixed at genesis; no mint() function exists on WolfToken.sol.
  • Treasury Buyback & Burn: Real cash yield harvested from Lighter Protocol is used to buy back WOLF on the open market and send it to the dead address (0x000…burn).
  • Vesting Slash Destroy: Forfeited esWOLF from early-exiting users is removed from circulation.
  • Supply Squeeze: The 10:1 reservation rule locks substantial portions of circulating WOLF in smart contracts during active vesting phases.
Section 06

Security & Governance Matrix

6.1 Contract Security Guardrails

  • Non-Custodial Architecture: Users retain ownership of their staked assets via audited smart contract logic.
  • Emergency Circuit Breaker: In the event of upstream oracle failure or external protocol instability, a multisig admin key can trigger pauseVault(), halting deposits and protecting user balances.
  • Reentrancy Protection: All transfer and vesting state changes utilize OpenZeppelin ReentrancyGuard contracts.

6.2 Transition to DAO Governance

At launch, protocol parameters (such as target portfolio weights) are managed via a 3-of-5 developer multisig. Following the 12-month stabilization phase, admin rights will be transferred to The Den DAO, enabling WOLF holders to vote on rebalancing matrices, yield parameters, and treasury integrations.

"Wall Street closes at 4 PM.
The Pack hunts 24/7."
— The Pack Law · Welcome to the Den
⚠ This document describes intended protocol architecture. Contracts are not yet deployed; all parameters are subject to change until audited and published with a verified contract address. Nothing herein constitutes financial advice.