How WoolFi works.

Every swap routes through the hook's beforeSwap callback. The hook reads two oracle prices and the pool's current ratio, computes the implied drift from fair value, and returns an asymmetric fee. Swaps that move the pool toward fair are discounted below the base fee; swaps that move it away are surcharged. The result is a market force that pulls the pool back to the implied equilibrium without LPs or stakers having to actively manage anything.

The catalog spans stock/USDG, stock/WETH, stock/stock spread, and crypto pools. A pool is marked pending until its verified oracles and production contracts are ready, then marked live. Actions stay disabled for pending pools.

Liquidity providers deposit token0 and token1, mint non-transferable LP shares against a WoolFiPositionManager, and collect a share of swap fees in both tokens. They do not bear structural-break risk.

URU underwriters deposit URU into a per-pool vault. They may earn a configured cut of swap fees in the pool assets, but bear structural-break risk: a vault drawdown can fund a rebalance and reduce vault positions pro rata. URU is the underwriting asset; it is not presented as a governance voting token.

Hours are configured per pool. When a stock token's underlying market is closed, WoolFi cannot promise that the spread will converge, so the pool changes behavior:

• Swaps stay open, at a flat symmetric fee. The asymmetric mechanic is paused until reopen.
• Deposits are blocked. The in-band check may rely on a stale underlying-market quote while directional fees are paused.
• Withdrawals stay open, the entire time. Existing LPs already committed with a defined risk profile; letting them out is "you can change your mind."
• Structural-break detection is paused. The hard-threshold drawdown only runs when prices are live.

Each stock-token pool resumes its active-market behavior according to its configured schedule. WETH/USDG is always open.

Robinhood Stock Tokens are issued by Robinhood Assets (Jersey) Limited (RHJ). They provide economic exposure to referenced securities but not ownership, voting rights, or other shareholder rights in the underlying securities. Issuer terms and geographic restrictions apply. WoolFi does not determine eligibility; users must confirm they may hold and trade each token.

If the oracle disagrees with the pool by more than a hard threshold (default 15%), the hook caches that fair price, admits only corrective swaps against it, and blocks new deposits. A capped URU vault drawdown can fund the rebalance. Withdrawals stay open.

Network            Robinhood Chain
Architecture       Uniswap v4 multi-pool hook
Catalog            Pending and live pools
Underwriting       URU, configured per pool
Audit              Pending

• PROJECT_SPEC.md·canonical specification
• Source on GitHub·contracts + tests