System Architecture

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

Value flow

Core contracts stack

Contract	Architectural Role	Core Execution
`WolfToken.sol`	Core ERC-20 Asset	Manages the hard-capped genesis supply of 100,000,000 $WOLF and core token transfers.
`WolfHook.sol`	Uniswap v4 Hook	Intercepts DEX swaps at `afterSwap`, extracts a flat 5% tax, converts it to USDG, and routes it to the Treasury.
`StockTreasury.sol`	Asset Accumulator	Reads Chainlink oracles, executes automated stock token purchases, and deploys capital into Lighter Protocol.
`TheDen.sol`	Master Staking Engine	Manages user deposits in The Vanguard Territory and The Apex Territory, tracking reward balances.
`VestingPortal.sol`	Escrow & Lockup Gate	Manages esWOLF vesting streams and enforces the 10:1 Reserved Capital Lockup rule.

Each contract is single-purpose by design: the hook only taxes, the treasury only accumulates and deploys, The Den only tracks stakes, and the Vesting Portal only gates exits. No contract holds more authority than its role requires.

Introduction The Flywheel

⌘I

Overview

Protocol Mechanics

Economics & Security

Value flow

Core contracts stack

​Value flow

​Core contracts stack

Value flow

Core contracts stack