Skip to content

Ritual

Seven steps to a neighbor

From an empty wallet to a resident of Hollow Lane. One transaction, one block, and the art lives in Ethereum itself: no IPFS, no servers.

The ritual

Seven steps. Only step 4 is a transaction.

  • Get a wallet + ETH

    Any Ethereum wallet works: a browser extension or a phone wallet. Fund it with the price plus a little gas.

    Ethereum0.0006 ETH each + gas

    Ethereum mainnet: real ETH. Keep a little extra for gas.

  • Connect

    Press Connect. Installed wallets appear with their own icons; on a phone, open this site inside your wallet app. Wrong network? One click switches it.

     

  • Choose knocks

    One knock, one neighbor. Pick 1 to 10 per transaction. Each wallet has a public-mint limit.

    3 × 0.0006 = 0.0018 ETH

    Max 10 per knock · 10 per wallet

  • Knock

    Sign one transaction that pays exactly price × knocks. No approvals, no second signature, no reveal transaction.

    Go knock

    Preview only: the real door is on the Knock page.

  • Wait one block. The door opens

    Your neighbors arrive behind an unopened door. Their looks come from the hash of the block your knock landed in, which nobody can know before that block exists. One block later, the door opens.

    Block N
    N + 1
    Block …~12s per block
  • Your neighbor lives on-chain

    The contract draws the art every time it is read, so it follows Ethereum: the moon phase from the block time, fog from the current basefee, and cobwebs that grow while you hold.

    Moon
    …
    Fog
    …
    Night
    …
    Residency
    Newcomer → Ancient
  • Visit the Porch

    Holders can haunt another home, ward their own, add a nameplate, and seal their knock forever.

    • Haunt

      A 3-day ghost visit

    • Ward

      Block hauntings

    • Name

      24-char nameplate

    • Seal

      Freeze the seed

    Open the Porch

How it works

Everything below runs inside the contracts. The website only reads the chain.

Fully on-chain

Art

HyakkiArt keeps one packed blob (palette, trait tables, 4-bit sprites) in contract bytecode. HyakkiPainter layers the 32×32 sprites into an SVG, one path per color, animated with CSS keyframes (transform and opacity only). HyakkiRenderer wraps it in base64 JSON. No IPFS, no server, no off-chain metadata.

The shading is computed too: every color comes in five tones, and the painter lights the top-left edges, deepens the far ones, darkens the rows under jaws and brims, and drops a 1-pixel shadow on the backdrop. Neighbors face right, hats sit on each species' own anchor, and the 9 weapons share one upright carry at the shoulder.

  1. Seed
  2. Traits
  3. Sprite blob
  4. SVG + CSS
  5. tokenURI

image is the animated SVG; animation_url is a script-free HTML wrapper for marketplaces that freeze SVGs into stills.

Knock & Reveal

Fair

Seed = keccak(hash of the mint block, mint entropy, first token id). That hash does not exist when you sign, so nobody can simulate a knock, revert bad pulls or snipe rare traits.

Predict it?
No one, until block N exists.
Undo a bad pull?
No: the knock is final once mined.
Bias it?
Only that block’s proposer, by throwing the block away.

Seeds that last

Seal

The seed is read live from BLOCKHASH (last 256 blocks), then from the EIP-2935 history contract (last 8191 blocks). Sealing writes it into storage for good: every mint seals up to 3 older knocks, transfers seal their own knock, a keeper seals anything older than ~600 blocks in quiet hours, and anyone can call seal or sealPending. A knock left unsealed past 8191 blocks would switch to a fallback seed, which is why nobody waits that long.

  1. NKnockdoor
  2. N+1Revealedlive seed
  3. ≤256BLOCKHASHopcode
  4. ≤8191EIP-2935~27 hours
  5. ∞Sealedin storage

Moon clock

Moon

The lunar phase, computed from block.timestamp with the mean lunar cycle (8 phases, 29.53 days), within about a day of the real sky. Night scenes show the moon. Full moon: beasts (Lycan, Batling and Familiar) turn blood-eyed. Halloween (Oct 31 UTC): a mini pumpkin joins neighbors without a companion. Witching Hour (00:00 to 00:59 UTC) and new moon: eye glows burn brighter, with a pulsing halo. The traits stay put: these moments show in the art and in their own live attributes (Moon, Form, Night).

Moon now

…

 

Basefee fog

Gas

Fog follows block.basefee at the moment the art is read: under 0.08 gwei clear, under 0.2 mist, under 1 fog, 1 gwei and up pea soup. Most nodes report a basefee of 0 inside eth_call, so the contract remembers the last basefee a transaction saw and draws that instead.

Fog now

…

 

Residency

Time

Counted from the moment the current owner received the token. Cobwebs grow while you hold; a sale resets it, and every transfer tells marketplaces to refresh (ERC-4906).

  1. Newcomer0d
  2. Settled7d
  3. Old Soul30d
  4. Ancient100d

Hauntings

Ghosts

haunt(yours, target) sends a ghost tinted with your neighbor's eye color into another holder's art for 3 days. One haunting per neighbor per day, never your own homes. Owners can exorcise the visitor, or setWard to keep ghosts out.

Nameplates

Names

Up to 24 characters (A-Z a-z 0-9 space . - _ ! ?), checked on-chain and shown in the metadata. Clear it with an empty name.

Contract safety

Safety
  • Revenue is withdraw-only

    ETH enters only through mint and leaves only through withdraw / withdrawTo (owner only, reentrancy-locked). No receive, no prize pool, and renouncing ownership is disabled so the funds can never be stranded.

  • Exact payment

    msg.value must equal price × knocks. Overpaying reverts instead of being kept.

  • No tx.origin checks

    Smart wallets and EIP-7702 accounts mint like anyone else. Limits are per address.

  • Two-step ownership

    A new owner must accept the transfer, so one typo cannot hand the contract to nobody.

  • View-only renderer

    Art is read with STATICCALL: the renderer cannot change state or move ETH. It must be real contract code (no empty address, no EIP-7702 delegated account), the owner can lock it forever, lock the supply, and royalties are capped at 10%.

  • No mint callbacks

    Mints use _mint (no receiver hooks), so nothing external runs in the middle of a knock.

Contracts

Read the source on Etherscan. Don't trust, verify.

FAQ

Short answers. The contracts are the long ones.

Your neighbor’s looks come from the hash of the block your knock landed in. That hash exists only once the block is mined, so the art appears from the next block, about 12 seconds later.