DOCS

Overview

Ether Block Packs is a Uniswap v4 project. The token, $EBLOX, trades normally on Uniswap - but buying it is also the mint: a v4 hook drops sealed packs into your wallet on every buy. Open packs to reveal blocks(on-chain pixel NFTs across five rarity tiers), then use the editor to merge blocks into builds- pixel creations minted as their own NFT with the blocks locked inside. Sell builds whole, part out rare blocks, or stake either to earn a share of the protocol's real ETH revenue.

Everything is on-chain: block art is generated as on-chain SVG (no IPFS), and the whole loop is enforced by audited-pattern contracts.

The Core Loop

1. BUY - Swap ETH for $EBLOX on Uniswap. Every 0.01 ETH you spend buying drops one sealed pack (cumulative per wallet - small buys add up, nothing is wasted).
2. OPEN - Crack packs on-chain. Each pack reveals 3 blocks, rolled by rarity. Rarity is decided at reveal (commit-reveal), so rares can't be sniped at buy time.
3. BUILD - Arrange your blocks on a canvas in the editor and mint the creation as a Build NFT - the blocks lock inside it.
4. OWN / TRADE / STAKE - Keep it, sell the whole build, part out the rares, or stake blocks/builds for ETH yield.

$EBLOX & The 4% Tax

$EBLOX is a fixed-supply ERC-20 (1,000,000,000). At launch 90% is seeded as single-sided Uniswap v4 liquidity (owned by the hook) and 10%goes to the deployer. No mint, no unlocks. It trades like any token.

Every trade pays a 4% fee, both directions (buys and sells). The ETH side of that fee is split:

• 50% to stakers - distributed to people staking blocks/builds, weighted by rarity.
• 50% to the treasury - always at least half; the staker share is hard-capped at 50% in the contract.

The sell-side tax also discourages buy-and-dump "pack farming." Fees are skimmed by a permissionless collectFees() call.

Packs & Opening

A pack is a sealed ERC-1155. You get one per 0.01 ETH bought. Opening uses commit-reveal so the outcome is provably fair and unsnipeable:

1. Open (commit) - open(amount) burns your packs and binds them to a near-future block.
2. Reveal - reveal(commitId) uses that block's hash as the seed, rolls each pack into 3 blocks, and mints them to you.

If you wait too long (past the ~256-block window) a commit can be re-bound with reRoll(commitId). Randomness lives behind a swappable interface, so it can be upgraded to Chainlink VRF later without touching anything else.

Blocks & Rarity

15 block types across 5 tiers. Each pack yields 3 blocks, each rolled by these odds:

Blocks are ERC-1155 and their art is fully on-chain SVG - no IPFS, no server. They trade natively on any NFT marketplace.

Building

The editor is a pixel canvas. Place the blocks you own, then save. Saving calls mintBuild(placements) - a packed on-chain layout. The contract derives exactly which blocks to escrow from the layout, locks those blocksinside the Build, mints you a Build NFT (ERC-721), and stores the layout on-chain. The art renders as on-chain SVG in tokenURI() - no IPFS, no server.

Your build is one ownable token that contains its blocks. Change your mind? disassemble(tokenId) burns the build and returns the component blocks to your wallet so you can part out the rares.

Marketplace

The native, on-site marketplace is escrow-based and ETH-settled. Two things can be listed:

• Builds - sell a whole creation. The buyer receives the art NFT and all the blocks locked inside, in one purchase.
• Blocks - sell loose blocks (any quantity) to people hunting a specific type.

List (item is escrowed), buy (ETH settles to the seller), or cancel (item returned). A small platform fee (default 2%) goes to the treasury. Because Builds/Blocks are standard ERC-721/1155, they're also tradeable on OpenSea whenever you want.

Royalties

Both Blocks and Builds implement EIP-2981 with a 5% royalty to the treasury. The native marketplace honors it automatically, and so do external marketplaces like OpenSea that respect royalties. So every secondary sale, anywhere, sends 5% back to the protocol treasury.

Staking (Revenue Share)

Staking is the block utility: stake blocks and/or builds to earn real ETH- a share of the 4% trade tax - distributed pro-rata by rarity weight.

• Your share of each reward = yourWeight / totalWeight.
• Staking a build stakes it as a set - its weight is the summed rarity of the blocks locked inside.
• Stakers split up to 50% of the ETH tax; the treasury always keeps at least the other half (hard-capped).
• Claim your accrued ETH anytime with claim(). Unstaking does not forfeit rewards - they auto-settle and stay claimable.

This gives rares genuine, cash-flow-backed value: the more the game is played, the more the treasury earns, the more stakers earn.

Fees Summary

Contracts

The system is a set of focused contracts:

• Eblox - the ERC-20 token ($EBLOX).
• EbloxMintHook - the Uniswap v4 hook: owns the LP, applies the 4% tax, mints packs on buys, splits fees.
• Packs - sealed packs; commit-reveal open/reveal.
• Blocks - the 15 rarity-tiered blocks, on-chain SVG, 5% royalty.
• Builds - build NFTs that lock their component blocks; 5% royalty.
• Marketplace - native list/buy for builds and blocks.
• BlockStaking - rarity-weighted ETH revenue-share staking.

Live addresses are published on launch and baked into the app. Contracts are verified on Etherscan.

FAQ