Skip to content

On-Chain Actions ​

Most of the OUROS game can be played without submitting transactions. Claiming snacks, feeding, visiting a habitat, and watching a creature grow all happen on the game server. The picture that wallets show is a stable URL (cdn.ouros.club/<asset>.gif) written once at mint; the file at that URL changes as the creature levels.

A signature is only needed when something must move ADA or mint, burn, or rewrite a token. This page is the list.

Fees below are typical mainnet figures. Your wallet quotes the real fee for the transaction in front of you - it moves with how many inputs you have and with protocol parameters.

The CIP-68 Pair ​

Every creature is two assets under one policy, same name:

TokenCIP-67 labelWhere it livesWhat it is
User token(222)Your walletOwnership. Whoever holds this owns the creature.
Reference NFT(100)A script address the game signs forThe datum: seed, birth record, status, image URL.

The game can rewrite the reference datum without your signature. That is how a hatch, an evolution checkpoint, a stranding, or a tombstone lands on-chain while the (222) stays in whoever's wallet currently holds it. The user token cannot move without a transaction you sign.

The datum does not store level or owner. Level lives in the picture and the API. Owner is whoever holds the (222). Putting those on-chain would force a write every feed and every trade.

Item tokens ​

Items are fungible tokens under their own policy, separate from creatures, signed for by the same game key. Every item of one type is the same asset: all Star Candies are one token.

Each item type has a single (100) reference NFT holding its name, in-game description and art link, so wallets can show them. Your items carry the (333) fungible-token label. Taking an item home mints one; using it burns one.

Policy IDs ​

Mainnet only. Check a token against these before you treat it as OUROS.

Policy ID
Creatures26b36801f09d9c9e162579fb0c415587920dd9f155194b6444c1fa4a
Items6e93b13f5caeda96484c993222cbc1495bd06be828118de157c48145

Creatures are CIP-68 (222) user tokens (with a matching (100) reference). Items are CIP-68 (333) fungibles. Anything else with a similar name is not from this game.

What you sign, and what you don't ​

ActionOn-chain?Typical feeLocked ADANotes
Connect / link a walletNo--A CIP-30 login signature, not a ledger tx.
Claim snacksNo--
Feed / level upNo--Picture updates immediately.
Evolution checkpointQueued rewrite~0.28 ₳, or free if you wait-Optional notarization. Up to four stage jumps (15, 30, 50, 75).
HatchQueued rewriteFree if you wait-Same token; the egg's datum is rewritten. No second mint.
Mint a genesis creatureYes~0.38 ₳~2.86 ₳ + ~1.26 ₳, both refundableOnce per stake key. No game mint price.
Lay an eggYes~0.25 ₳~2.9 ₳, refundableOnce per parent, at level 50. New CIP-68 pair.
Send / tradeNo OUROS txMarketplace fee only-Only when tradeable.
Stranded / tombstoneQueued rewrite--Gameplay flips immediately; the datum rides a later tx.
Kill (burn)Yes~0.4 ₳Refunds both deposits, minus the feeOptional.
Habitat visitNo--
Take a found itemYes~0.2 ₳~1.2 ₳, stays with the item in your walletMints one item token. See items.
Use an itemYes~0.2 ₳Returns the ADA that was with the tokenBurns one item token. The holding wallet signs.
Sponsor / top up a habitatYesNetwork fee on top of 3 ₳ per 30 daysNone - this is a payment, not a depositPlain ADA to the game. Not refunded.

Most creatures need one ledger write in their life: the mint. Items are separate: one transaction to take one home, one to use it. An egg adds a second mint. Everything else is optional, queued, or off-chain.

Deposits ​

Minting (genesis or egg) locks min-ADA under the CIP-68 pair so the UTxOs can exist:

  • The reference deposit sits at the script with the (100). Wallets usually show this as ADA leaving.
  • The user-token deposit stays in your wallet, locked next to the (222).

Killing the creature is meant to return both, minus the burn fee. That is the intended path, not a guarantee - see the disclaimer.

Habitat sponsorship is not a deposit. It is spent.

The pending-update queue ​

When a creature evolves, hatches, is stranded, or is tombstoned, the game queues a datum rewrite instead of making you pay on the spot.

  • The den and the CDN image are already correct. Waiting costs nothing you can see.
  • Paying for a checkpoint only buys immediacy - the same rewrite, sooner, on a transaction you sign. The den offers that as an optional prompt after an evolution or hatch. Skip is fine. If you never sign one, someone else's later OUROS transaction carries it.

Every player-built transaction can take up to six pending rewrites with it:

Carried updatesExtra fee (about)
1~0.013 ₳
6 (the usual cap)~0.08 ₳

That is a rounding error next to a mint deposit. Mint, lay, burn, habitat sponsorship, and a dedicated checkpoint tx all drain the same queue.

Oldest first, so nothing starves. Tombstones and strandings go before optional evolution and hatch checkpoints, so a busy mint day still keeps the trading safeguard honest on-chain.

A queued row whose carrying transaction never lands (you closed the wallet prompt, it failed) is released after a quarter hour and can ride the next tx.

If the queue is slow ​

Low mint volume means slow drain. That is harmless: wallets that fetch the CDN already show the live creature. The on-chain snapshot is behind; the toy is not.

The operator can flush a stalled queue. That is the one structural ADA outflow, and it is not charged to you as a game fee.

Anatomy of a mint ​

A genesis mint (measured from a real mainnet transaction) looks like:

OutputTypical ADAWhat
Reference UTxO~2.86 ₳(100) + inline datum at the script
Your wallet~1.26 ₳(222) user token
ChangeremainderBack to you
Fee~0.38 ₳Network fee; more if the tx also carries queued updates

The two deposits behave differently in a wallet UI. Only the reference UTxO usually shows as ADA spent. Both are meant to come back if you later kill the creature.

Laying an egg is the same shape: a new pair, a new deposit, parent roosts for two epochs.

Hatch vs lay ​

Lay mints. Hatch does not.

The egg is already a full CIP-68 pair. At level 5 the game flips it to a creature in the database and queues hatch on the same reference NFT. The next player transaction (or a checkpoint you choose to pay for) writes that datum. One mint, one deposit, one asset for the whole life.

What a wallet still shows ​

Explorers and wallets cache the GIF hard. ouros.club updates as soon as you feed. A wallet or marketplace can lag hours. That is their cache, not a missing transaction.

A pending evolution checkpoint means the on-chain metadata snapshot has not caught up. The sprite at the CDN already has.