Smart ContractArchitecture & Technical Specs 🔬

A comprehensive technical breakdown of the autonomous casino hook: hook lifecycle hooks, delayed settlement queue, blockhash-seeded PRNG, anti-MEV architecture, and verified smart contracts.

Deployments

Verified Contract Addresses

Network: Base (8453)
ContractRole / DescriptionAddressActions
LUCK Token
ERC-20 Fixed Supply Token

Capped at 1,000,000,000 🍀 with native burn functionality and zero inflation.

0x9A03...6Ea6
LuckHook (V4 Hook)
Uniswap V4 Autonomous Casino Engine

Implements beforeSwap & afterSwap hooks, holds House Reserve, executes delayed PRNG lottery.

0xBAa3...D0Cc
PoolManager
Uniswap V4 Core Singleton

Canonical Uniswap V4 PoolManager singleton on Base containing pool state & accounting.

0x4985...2b2b
LuckRouter
Atomic Router & Entrypoint

Streamlines single-tx ETH & ERC-20 swaps directly through the V4 PoolManager unlock pipeline.

0xC925...29B3
WETH on Base
Wrapped Ether

Canonical Base Wrapped Ether address paired with LUCK in the V4 pool.

0x4200...0006
StateView
Uniswap V4 Peripheral Reader

Peripheral contract for non-modifying slot0 price, liquidity, and tick data lookups.

0xa3c0...7a71
Chainlink ETH / USD Feed
Decentralized Oracle

Base mainnet price aggregator providing live USD asset valuation.

0xa425...36Ed
Flow Diagrams

System Architecture & Execution Pipeline

Uniswap V4 Hook Swap Lifecycle

Step-by-step transaction routing and settlement through the V4 PoolManager singleton.

Rendering Architecture Diagram...

Anti-MEV Architecture: Delayed Resolution Sequence

Why instant on-chain PRNG fails on Ethereum/L2 and how LuckHook V2 achieves complete MEV resistance.

Rendering Architecture Diagram...
Public Resolution API

Trustless Keeper & Self-Resolution

Any user, bot, or keeper can trigger pending swap resolution at any time. Swaps are also automatically settled whenever any new swap executes via internal _resolveUpTo(3) piggybacking.

Batch Resolution (Keeper)
function resolve(uint256 count) external;

Resolves up to count pending items from the queue.

Self-Resolution (User Instant Payout)
function resolveOne(uint256 index) external;

Allows an individual user to immediately settle their specific pending index once block > swapBlock.

Disclaimers & Risk Warning

Experimental Smart Contract Mechanics: LUCK operates on custom Uniswap V4 hooks. While audited for internal logic, DeFi interactions carry inherent smart contract, volatility, and economic risks.

Entertainment & Educational Experiment: LUCK is designed as an autonomous game theory and AMM experiment. It is not an investment, security, or profit vehicle. Never trade or spin more than you are willing to lose.

May the odds be ever in your favor. 🍀