Staking

From Neo Tokyo Citizen Wiki
(Redirected from Yield)

Staking secures a Neo Tokyo Citizen or Outer Citizen in a smart contract for a period of time. In the context of the Neo Tokyo project, staking provides $BYTES yield. Outside of the context of Neo Tokyo, staking is a common practice for NFT projects, cryptocurrency, and blockchain protocols.

How staking works

Staking is handled by the NeoTokyoStaker contract on Ethereum. S1 Citizens, S2 (Outer) Citizens, and $BYTES are staked into asset-specific pools. Each staker accrues points, and each pool distributes its daily $BYTES emission to stakers in proportion to their points, minus a 3% treasury tax.

Staking periods

Citizens are staked for a fixed timelock period. Longer periods multiply the Citizen's points:

Period S1 Citizen boost S2 Citizen boost
1 month 1x (no boost) 1x (no boost)
3 months 1.25x 1.25x
6 months 1.5x 1.5x
1 year 2x 1.75x
2 years 3x 2x

The Citizen cannot be unstaked until the chosen period ends. Any Vault and $BYTES staked with the Citizen are locked for the same period — Citizen, Vault, and $BYTES all unlock together, and none can be removed early.

Points

A staker's share of a pool's daily emission equals their points divided by the pool's total points. Points per Citizen:

  • S1 Citizen with Vault: credit yield points × Vault multiplier × period boost + $BYTES points
  • S1 Citizen without Vault: credit yield points × period boost + $BYTES points
  • S2 Citizen: allocation yield × period boost + $BYTES bonus points

Staking $BYTES with a Citizen adds 100 points per 200 $BYTES staked (partial points count — staking 250 $BYTES adds 125 points). $BYTES can be added to an already-staked Citizen at any time; this increases the Citizen's points going forward without extending the staking period. Maximum $BYTES per Citizen: 200 $BYTES without a Vault (S2 Citizens: 200 $BYTES), 2,000 $BYTES with a Vault.

Emissions

Each pool's daily $BYTES emission steps up through tiers as more of the supply participates, and is then split among stakers in proportion to points. The tier values below are starting maximums — emissions decay exponentially over time, halving roughly every 52 weeks. Current tiers as of October 2026 are noted; they change as participation changes.

S1 Citizen pool — by % of S1 Citizen supply locked (current: 70% tier):

Supply locked $BYTES per day
0–49% 1,500
50% 2,000
60% 2,500
70% 3,000
80% 3,500
90%+ 4,000

S2 Citizen pool — by % of S2 Citizen supply locked (current: 50% tier):

Supply locked $BYTES per day
0–49% 375
50% 500
60% 625
70% 750
80% 875
90%+ 1,000

Vault / $BYTES pool — by % of total $BYTES supply staked (current: 45% tier):

Supply staked $BYTES per day
0–29% 2,250
30% 3,000
35% 3,750
40% 4,500
45% 5,250
50%+ 6,000

Example S1 yields

The figures below are measured on-chain as of October 14, 2026 — not projections. On that date the S1 pool emitted 593.7 $BYTES per day across 1,498,050 total points, or about 0.000384 $BYTES per point per day after the 3% treasury tax. Your own daily yield ≈ your points × 0.000384.

Example position Points $BYTES/day $BYTES/month
S1, 12-month lock, no added $BYTES ~300 ~0.12 ~3.5
S1, 12-month lock + 1,000 $BYTES ~800 ~0.31 ~9.2
S1, 12-month lock + 2,000 $BYTES (cap) ~1,300 ~0.50 ~15.0
S1, 24-month lock + 2,000 $BYTES (cap) ~1,450 ~0.56 ~16.7

Base points (~300) assume a typical Identity and Vault on a 12-month lock; actual base points vary by Citizen. Yields drift down as emissions decay and shift as stakers enter or exit the pool.

Claiming $BYTES yield

$BYTES yield can be claimed as often as desired — claiming is not blocked by the staking period.

Soulbound Citizen Token

As staking necessitates locking the Citizen in a staking contract, you will receive a soulbound token (SBT) representing your staked Citizen. The SBT mirrors the appearance of your staked Citizen and bears the Bank of Neo Tokyo seal. It is not transferrable or available for sale. When you unstake, the SBT is burned and your Citizen is returned to your wallet.

A soulbound Citizen token.

Vaults

An S1 Citizen can have a Vault attached at staking time: if the Citizen does not already have a Vault, an unattached Vault may be selected to stake alongside it for the same period. Vaults multiply the Citizen's points according to the Vault's credit multiplier. A Citizen that already has a Vault attached cannot have a different Vault attached — Vault overriding is not possible.

Hand of the Citadel bonus

S1 Citizens whose identity class is "Hand of Citadel" can claim the Hand of the Citadel bonus when staking, which grants the "?" Vault multiplier instead of the default. The bonus is claimed via a flag at staking time; attempting to claim it with a Citizen that does not have the Hand of Citadel identity fails.

LP staking

LP token staking is built into the staking contract but is not currently enabled. The NT team may enable it at some point.

Benefits of Staking

Passive Income

Staking Citizens and $BYTES enables individuals to earn a passive income or yield that would not be possible if their tokens were left idle in their wallets. This yield accumulates and can be claimed at any frequency.

Increased Earnings

The staking system rewards participants who stake for longer durations and with increased Bytes yield. Staking offers the potential for enhanced earnings, particularly for those committed to long-term holding.

Community Benefits

Staking in Neo Tokyo incentivizes community engagement. As more Citizens and $BYTES are staked, pools can step up into higher emission tiers (see Emissions above) — though each staker's share is proportional to their points out of the pool's total points.

It is crucial to remember that while staking offers significant rewards, it is not without risks, including potential losses if token values decline. As with any investment, individuals should assess their risk tolerance and investment objectives.

How to Stake a Citizen and Bytes

Migration Requirement

Before engaging in staking, ensure that you have migrated your citizens by following these steps:

  1. Visit the website: https://neotokyo.codes/.
  2. Locate the white vertical bar on the left labeled 'Mint/Upload' and click on it.
  3. Choose 'CODES_MIGRATION.EXE'.
  4. Connect your wallet.
  5. Provide approval for the NT NFT Collection(s).
  6. Click on 'Migrate' to complete the process.

Staking via the Official Site

Now that you have completed the migration, let's proceed with staking your Citizen by following these simple steps. The flow is the same for S1 Citizens and S2 (Outer) Citizens.

1. Return to https://neotokyo.codes/ and connect your wallet using the option in the top right corner.

2. Once your wallet is connected (indicated by a green glow), click on it.

3. Choose your Citizen and approve them for staking.

Select a Citizen for staking.


4. Decide the desired staking duration for your Citizen, selecting from the available options: 1 month, 3 months, 6 months, 1 year, or 2 years. Keep in mind that longer staking periods yield greater rewards, but the Citizen cannot be unstaked until the chosen period concludes.

5. If your S1 Citizen does not have a vault already attached, you are able to select an unattached vault to stake with your Citizen for the same staking period.

6. When ready, click on the "stake" button (depicted by a steak icon ).

Select a duration for staking and click the "stake" button.


Staking $BYTES to Increase Yield

Once your staking is complete, there is an optional step remaining:

Determine the amount of $BYTES you wish to stake with each Citizen. Every 200 $BYTES staked adds 1 point to the Citizen's yield weighting (see Points above), up to the per-Citizen cap.

Scroll down the page, select the desired Citizen, and determine how many Bytes will be staked with the Citizen.

Determine how many Bytes will be staked with the Citizen.


For more information on Bytes, read the Bytes 2.0 tokenomics paper here: https://docs.google.com/document/d/1XJjFP350JSSEhdbiLUp3A9fKPIDvIbZEM38KLF4p5Ww/edit

Troubleshooting

If you are having issues staking, try the following to resolve…

  • If staking, ensure that you migrate your assets to the new contracts first.
  • Update your hardware wallet.
  • Update your browser.
  • Use Google Chrome.
  • Use a desktop or laptop.
  • You may need to approve additional transactions. Most processes require at least two approvals.
  • Disconnect your wallet from the site, clear your cache, and reconnect.
  • Metamask: Make sure you're connected to the Ethereum network.
  • Metamask: Ensure the NFT is listed in the “NFT” tab in Metamask and not in the “Token” tab.
  • Bytes and Metamask: When staking Bytes, Metamask requires a custom spending cap on the amount of Bytes tokens to be used in the staking contract. If you can't stake Bytes, your token cap may be too low.

Contract Addresses

NeoTokyoStaker (staking and $BYTES 2.0 reward claims): `0x67e1ecfa9232e27eaf3133b968a33a9a0dca9e16` — Etherscan

Neo Tokyo Staked Citizen (CTZN, soulbound token issued to staked Citizens): `0xd37ea75dd3c499eda76304f538cbf356ed9e7ed9` — Etherscan

See Also

External Links

Neo Tokyo (official website)
Neo Tokyo Staked Citizen OpenSea collection
$BYTES 2.0 Tokenomics Google doc