DOCS

Bitmap encoding

A Normie is a monochrome bitmap at 1 bit per pixel, most significant bit first: bit 7 of the first byte is the top-left pixel. At mint every Normie is 40x40, 200 bytes for 1,600 pixels. After an enlargement a canvas is 50, 60, 70 or 80 per side (313, 450, 613 or 800 bytes), with the original art centred.

Pixel data is stored with SSTORE2, which writes data as contract bytecode rather than storage slots. Each token maps to a single SSTORE2 pointer.

SVG rendering

The renderer contract reads the bitmap and builds the SVG on chain. It scans each row and merges consecutive filled pixels into one run, which keeps the SVG small. The result is #48494b (off-black) on #e3e5e4 (off-white). Each Normie also has an animation_url that draws it on an HTML canvas, crisp at any size.

Minting

Encryption

Image data and traits were XOR-encrypted with a keccak256-derived keystream before being written to NormiesStorage, keyed by a secret revealHash and each token ID. Once the reveal hash was set, the storage contract decrypts on every read.

Signatures

Minting required a backend-signed message over (imageData, traits, minter, maxMints, deadline), an EIP-191 personal signature the minter contract verified on chain, so only pre-approved image data could be stored.

Cold wallets and phases

Both minters accepted delegate.xyz delegation from a cold wallet to a hot one (V2 reads both registries). Minting ran in three time-gated phases: Guaranteed, FCFS and Public, each with per-wallet limits.

Storage

Original bitmaps live in NormiesStorage, encrypted from the blind mint. Edit layers live separately, unencrypted, in NormiesCanvasStorageV2, which also holds wallet and per-Normie pixel balances. Keeping them apart preserves the original art untouched; writing plaintext layers into the encrypted storage would break its decryption.

Compositing

The image is the base bitmap XOR the edit layer:

• A set bit in the layer flips that pixel: filled becomes empty, empty becomes filled.
• Setting the same bit again restores the original pixel.
• For a Zombie the base is the Zombie art, not the human original. For a blank canvas there is no base: every set bit is a painted pixel.

The on-chain SVG is always monochrome. The green and grey in the editor are a frontend reading aid.

Commit and reveal

• Commit: commitBurn(tokenIds, receiverTokenId) burns the tokens at once and records their pixel counts; the caller must own the receiver. commitBurnToWallet(tokenIds) does the same with the wallet as the receiver.
• Wait: 5 blocks, about a minute, for a future block hash to serve as entropy.
• Reveal: revealBurn(commitId) rolls a percentage for each burned token and credits the pixels to the receiver Normie or the wallet.

The EVM keeps only 256 block hashes, so after about 261 blocks (about 50 minutes) the roll is gone and the minimum tier is paid instead. The reward is never lost, only the roll.

Painting

setTransformBitmap(tokenId, bitmap) takes a full layer sized to the Normie’s canvas. The contract checks that the number of set bits does not exceed the pixels on the Normie and never deducts them: pixels are a ceiling, not a currency.

Delegation

An owner can set one Canvas delegate per token, an address allowed to call setTransformBitmap. A delegation is tied to the owner who set it (delegateSetBy): it lapses when the token is transferred and works again if the token returns. A delegate.xyz delegate gets the same painting right. Neither can move or spend pixels; that takes the owner or an ERC20-style allowance on the storage contract.

Renderer traits

The current renderer adds Canvas traits to every token: Customized, Pixel Count (from the original art, unchanged by edits), Action Points (the on-chain name for the pixels on the Normie), Level, Canvas Size and Blank Canvas.

API

api.normies.art serves everything on chain, read straight from Ethereum mainnet. Token IDs run from 0 to 9,999. The full reference is on the API page, and an llms.txt is there for LLM integrations.

Rate limit: 60 requests per minute per IP (sliding window).

Contract addresses