The main Nibbles character holding an acorn
03 / SYSTEM GUIDE

READ THE
FOREST.

A plain-language map of balances, mints, burns, fees, art and the public index.

01

THE MODEL

Nibbles is a balance-gated NFT layer on Robinhood Chain. One billion fixed NIBS divide into exactly 10,000 equal tiers. Every complete 100,000-token tier held by a wallet can support one active Nibble.

1,000,000,000 NIBS÷10,000 DESIGNS=100,000 / NFT

No price oracle or market-cap calculation controls eligibility. The token balance is the rule.

02

NFT LIFECYCLE

  1. BUY OR RECEIVE

    A wallet’s NIBS balance increases.

  2. CROSS 100K

    Each newly completed tier qualifies for one automatic mint.

  3. ASSIGN

    Transaction data draws an unused design from the fixed catalogue.

  4. HOLD

    The Nibble remains active while its corresponding balance tier remains complete.

  5. DROP BELOW

    The associated NFT burns permanently. Its issued design is never recycled.

03

HOOK + FEES

BUY DIRECTION1%
SELL DIRECTION3%

The Uniswap v4 hook identifies swap direction and returns the configured dynamic LP fee. Fees accrue to the liquidity position and are collected by its authorized owner. The hook does not send fees directly to a marketing wallet on every swap.

OPEN NIBBLES-HOOK ON GITHUB ↗
04

ART ENGINE

Nibbles are assembled deterministically from pixel traits. Body colour, background, headwear and a coordinated accessory set produce exactly 10,000 catalogue recipes. Transaction-derived DNA assigns one unused recipe without using image-generation APIs.

RANDOM WITHOUT REPLACEMENT

The controller uses an onchain sparse shuffle. A design can be assigned only once, even if its NFT is later burned.

05

LIVE INDEX

ROBINHOOD RPCONE WORKERPOSTGRESWEBSITE

A dedicated Railway worker reads only new confirmed blocks in small batches. Every event is deduplicated by transaction hash and log index. Metadata and artwork are fetched once, then stored permanently in PostgreSQL. Public page requests read the shared index and never scan Blockscout or replay contract history.

FAIL CLOSED, SERVE LAST GOOD STATE

Rate limits or RPC outages pause the worker without clearing the collection. It resumes from its saved block cursor and the website continues serving confirmed records.

06

LIMITS + TRUST

  • FIXED 1,000,000,000 NIBS SUPPLY
  • FIXED 10,000 LIFETIME DESIGN ASSIGNMENTS
  • FIXED 100,000 NIBS PER ACTIVE NFT TIER
  • PUBLIC HOOK AND COLLECTION SOURCE
  • NOTE CONTRACT RISK REMAINS UNTIL INDEPENDENT AUDIT

The website index is a fast public mirror. The contracts remain the final source of truth for balances, ownership, minting and burning.