Temporary markets
Market windows can be explicit instead of indefinite.
Uniswap v4 protocol In development
Ephemeral liquidity for autonomous agents.
ShadeHook is an in-development, independent Uniswap v4 protocol for temporary markets with deterministic lifecycles and implemented quote-side fee accounting.
In development — no production deployment.
Initialize
Active
Expire
Lifecycle window07D
Protocol
Temporary-market infrastructure for bounded coordination.
ShadeHook is an independent Uniswap v4 protocol for markets with a defined end. Autonomous systems may need a bounded coordination or execution window; ShadeHook implements the lifecycle and accounting infrastructure for that use case, not a demonstrated autonomous-agent market.
Deterministic lifecycle
Market state follows a defined initialization and expiration path.
Independent core
The architecture remains integration-neutral and does not rely on a platform-specific launch path.
How it works
A market lifecycle with a defined end.
Initialization establishes the canonical market and starts a seven-day lifecycle. Canonical-pool swaps are active while block.timestamp < expiration and reject at and after expiration. Valid beneficiary claims and LP liquidity removal remain available after expiration.
- 01
Canonical initialization
One authenticated initialization binds the canonical market and starts its lifecycle.
- 02
Active market
Canonical-pool swaps are active while block.timestamp < expiration.
- 03
Seven-day lifecycle
Expiration is fixed from the point of initialization.
- 04
Swaps reject
At and after expiration, canonical-pool swaps reject.
- 05
LP exits and claims remain
LP liquidity stays removable and valid beneficiary claims remain available.
Trading expires. Withdrawal does not. Valid beneficiary claims remain available.
Accounting
A fee path that stays in the pool accounting layer.
Fees are denominated in the configured quote currency. Each accrued amount becomes a beneficiary liability backed by PoolManager ERC-6909 claims.
Configured beneficiaries receive PoolManager ERC-6909 claims and transfer them directly to a recipient. Claim execution does not convert those claims into underlying ETH or ERC-20 assets, and this is not presented as a user-facing yield product.
- 01
Quote-side fee
A swap applies the configured fee in the market's quote currency.
- 02
Beneficiary liability
The accrued amount is attributed to the configured beneficiaries.
- 03
ERC-6909 backing
PoolManager ERC-6909 claims back the recorded liabilities.
- 04
Direct claim transfer
A configured beneficiary transfers its PoolManager ERC-6909 claim directly to a recipient.
Temporaryby design,not by accident.
Why ephemeral liquidity
Markets can be bounded on purpose.
Some market opportunities are bounded: an agent-specific window, a fixed coordination period, or a market that should close predictably. Ephemeral liquidity makes the shutdown rule explicit.
Architecture
An independent core, by design.
ShadeHook Core holds the shared lifecycle and accounting behavior. The independent deployment profile stands on its own; any future optional integration belongs outside the core and does not define its architecture.
CoreShadeHookCore
Independent profileIndependent
Extensible boundaryOptional Integration Boundary
Engineering status
Progress stated plainly.
These are repository implementation milestones, not on-chain metrics. Tests and configured invariant campaigns are engineering evidence, not an independent audit. ShadeHook is pre-launch and has no production deployment.
- Lifecycle and liveness
- Implemented and tested
- Pinned PoolManager integration
- Tested
- Fee accounting and ERC-6909 backing
- Four quadrants tested
- Beneficiary claims
- Implemented and tested
- Quote-currency paths
- ERC-20 and native ETH tested
- Token compatibility boundaries
- Atomic failure behavior tested
- Stateful invariant campaigns
- 6 groups · 49,152 configured calls
- Invariant handler outcomes
- 0 reverts/discards in campaigns
- Current protocol test suite
- 137 passing tests
- Production deployment
- Not live
- Independent audit
- Not completed
Coverage includes ERC-20 and native ETH quote-currency paths against the pinned Uniswap v4 PoolManager. Compatibility-boundary tests cover fee-on-transfer, reverting, false-return, no-return, and externally mutable-balance token behaviors. Unsupported and non-standard paths are tested for accounting consistency and atomic rollback where operations reject.
Roadmap
Built in sequence.
The lifecycle, accounting, liveness, and compatibility-boundary milestones below reflect the current implementation. Independent audit and production deployment remain outstanding.
- 01
Lifecycle and Liveness
Complete
- 02
PoolManager Testing
Complete
- 03
Fee Accounting + Backing
Complete
- 04
Beneficiary Claims
Complete
- 05
Stateful Invariants
Complete
- 06
Native Quote Paths
Complete
- 07
Token Boundary Tests
Complete
- 08
Independent Audit
Not completed
- 09
Production Deployment
Not live