qr3 docs

What is qr3

A qr3 is a name, qr3.im/yourname, minted as a token on Ethereum and drawn as a 3D object. From the side it is a tree, a rose bush, a hill town or a bouquet of balloons. Look at it from straight above and it is a working QR code: point a phone at it and it opens your page.

Every dark square of the code is part of the object, a clump of leaves, a roof, a floret, and every light square is the open ground between them. That is why no two names grow into quite the same shape.

Minting a name

1. Pick your name. Open the studio and type the name you want after qr3.im/. The studio says whether it is free.
2. Pick its look. Choose what it grows into, the season and the colours. Turn it to see every side and flip it to see its code.
3. Mint it. Connect a wallet, press the shutter and confirm in your wallet. Then add your links: anyone who scans the code lands on your page.

Minting is free: qr3 charges nothing and you pay only the network fee. Each wallet can mint one name.

Names

The code holds the address https://qr3.im/yourname. Names of up to 11 characters fit a code of 25 × 25 squares; names of 12 to 20 take 29 × 29, a little finer. Both scan the same.

Your page

qr3.im/yourname is your page: your object, an avatar, a short bio, your links and pictures. Anyone who scans your code lands there, and a tap on the object there shows its code.

As the holder you edit it at qr3.im/yourname/edit, signing in with the wallet that holds the name. Signing in is a signature, not a transaction, so it costs nothing.

Changing the look

Switch the object, the season and the colours from your editor whenever you like. The code only holds your name, so it stays the same and codes you have already printed keep working.

Renaming

You can rename from your editor. It is a transaction on-chain. The old name is freed at once for anyone to mint, and your code follows the new name.

Selling and sending

A qr3 is an ordinary ERC-721 token, so you can sell it or send it to another wallet. The name and its look go to the new holder; the links and pictures on the page are cleared for them. Resales carry a 7% creator royalty.

Objects and seasons

Fourteen objects, each in spring, summer, autumn and winter with colours of its own: 126 looks in all.

• Tree

  A broadleaf tree. Some of its colours bear fruit: apples, cherries, lemons or pears.

• Pine

  A single conifer, sprays of needles on tiered limbs.

• Bamboo

  One clump of culms with blades at every joint.

• Hydrangea

  A shrub of round mophead flowers.

• Rose

  A rose bush, blooms and leaves along its shoots.

• Tulips

  A bouquet of tulips in a vase.

• Wheat

  A sheaf of wheat bound at the waist.

• Cactus

  A prickly pear grown into a tree, fruit on its top pads.

• Mushroom

  A parasol mushroom.

• Crystal

  Crystal points on a pale boulder.

• Coral

  An upright coral with coloured tips.

• Anemone

  A sea anemone on a rock, with its clownfish.

• Balloons

  A bouquet of balloons tied to a gift.

• Town

  A hill town of houses round a stone church.

How a model reads as a code

1. The code comes first. It is laid out on the board, with a quiet border of three empty squares round it.
2. The object grows on it. Each dark square becomes part of the object and each light square stays open, so from above the parts line up into the code.
3. The view turns it into a code. As the camera rises to look straight down, the colours shift to ones that stand out at least 5.5 to 1 against the light ground, and a clean top lines up on every square.
4. It is checked. The studio draws the code from above and decodes it, and shows whether it scans, for every look you pick.

The code uses error correction level M, so it still reads with about 15% of it covered, by a hand, a glare or a fold.

Styles

Classic draws each model with natural materials: bark, leaves, petals, stone and glass. Clay draws the same model in soft modelling clay. Switch between them in the studio’s Looks panel.

For now the style is a way of looking: what you mint is the object, the season and the colours.

Playing with a model

In the studio a model is there to be played with, in both styles.

Model versions

The engine that draws every qr3 has a version. When it changes, every qr3 is drawn with the new one, on its page, in the studio and on marketplaces, and it is listed here.

1. 1.731 Oct 2026Current

   Codes a phone reads off a screen

   • Seen from above, every code’s colours are darker: each dark square now stands out at least 5.5 to 1 against the light ground, up from 3.4, so a phone camera filming a bright screen still reads it.
   • A shaken tree visibly thins: many more leaves can come off at once, and their places stay bare for 15 to 30 seconds before new leaves bud.
   • Models turn to their code without a stall on phones.
2. 1.631 Oct 2026

   Leaves that fall, flowers that grow up

   • Shaking a tree hard brings real leaves down off its twigs. A while later new ones bud in their place, grow to full size green, then take on the tree’s own colour.
   • A flower held on the board grows up as a plant does: its stem thickens and puts out leaves one above the other, and its head fills out with a second and a third ring of petals.
3. 1.531 Oct 2026

   Trees grown like trees

   • Twigs grow toward the leaves the way real ones grow toward light, and every limb is as thick as the leaves it carries, so wood thins out toward the tips and no branch is thicker than the one it comes from.
   • Every leaf hangs from a twig by its stalk, blossoms included.
   • Fruit trees: summer apple, cherry and lemon, autumn apple and pear. Fruit hangs clear of the wood on wood-coloured stalks.
4. 1.431 Oct 2026

   Models you can touch

   • Hold a limb and shake it and it swings with its leaves, harder the faster you shake; hold the trunk to shake the whole tree. Passing over only rustles the leaves.
   • A tap shakes down what a model grows, each piece in its own shape and size: leaves, petals, florets, grains, confetti. Balloons slip their strings and float away.
   • Tap the board for a flower, hold to grow it. Grass by the corner squares bends under the pointer and springs back.
   • The Clay style: every model in soft modelling clay.
5. 1.331 Oct 2026

   Growth and wind

   • A model can grow in: grass first, a sapling that thickens into a trunk, limbs branching out, then the leaves opening.
   • Wood and leaves sway together in one wind, which calms as the camera rises so the code holds still.
6. 1.230 Oct 2026

   Grown wood and real light

   • Limbs are grown as one piece of wood that bends and swells into the next, with bark that has ridges or plates.
   • Soft sun shadows, a studio light, and smoother edges.
   • Every square of the code is checked to read as one clean colour from above.
7. 1.130 Oct 2026

   Fourteen objects

   • Tree, pine, bamboo, hydrangea, rose, tulips, wheat, cactus, mushroom, crystal, coral, anemone, balloons and a hill town, each in four seasons with colours of its own.
   • Each object is built so that seen from straight above it reads as its code.
8. 1.029 Oct 2026

   The first tree

   • A tree grown from a name’s QR code: from the side a tree, from straight above a code that scans.

What lives on-chain

Only the name lives on-chain, in the token. The look, your page’s links and your pictures are kept by qr3 and served at qr3.im/yourname.

On marketplaces the token’s picture is its flat code, which scans straight from the listing, and its animation is the live 3D model.

What it costs

Gas figures are measured on the contract; what they cost in ETH depends on the network’s gas price at the time.

Contract and network

More questions? See the FAQ.