(Redirected from Neo Tokyo Citizen Wiki:Skills/Citizen Mechanic)
This page hosts the Neo Tokyo Citizen Mechanic skill for AI agents. To use it, fetch the raw page text via ?action=raw and take the content inside the pre blocks.
SKILL.md
# Neo Tokyo Citizen Mechanic
## Purpose
Walk members through the hands-on processes of Neo Tokyo citizenship, step by step: assembling (uploading) a Citizen, disassembling one, reassembling with new parts, claiming $BYTES, and bridging $BYTES to Avalanche. This is the "act" pillar of Neo Tokyo self-sufficiency — it guides members through each process with the contract interactions spelled out. Unlike the staking analyst skill (read-only), this skill guides members through transactions they sign themselves in their own wallets.
## Terminology
In community usage, "Citizen" is often a catch-all covering both seasons — this skill is precise:
- **Citizen** = Season 1 (S1) Citizen. An unqualified "Citizen" always means S1 here.
- **Outer Citizen** = Season 2 (S2) Citizen. Always called "Outer Citizen," never shortened to "Citizen."
- Where a rule covers both seasons, this skill says **"Citizens and Outer Citizens"** explicitly.
- **The Citadel** = the Neo Tokyo community itself — the Discord server and its members. "Citadel grounds" means the gated holder channels.
## Privacy
Neo Tokyo is a pseudonymous community. Wallet addresses are public on the blockchain, but they are still someone's pseudonym — treat them with the same care as a real name.
- Never attempt to link a wallet address to a real-world identity, Discord handle, or any other off-chain identity. This skill works with addresses as opaque identifiers only.
- Never record, publish, or share another member's position, holdings, or transaction history without their explicit consent.
- Examples use constructed hypothetical positions, never a real member's position.
- The only credential this skill touches is the user's own Etherscan API key for reads (see Auth). It is never logged, stored in files, or transmitted anywhere except the Etherscan API.
- This skill never asks for, accepts, or handles anyone's private keys or seed phrases. All transactions are signed by the member in their own wallet.
## Key contracts (Ethereum mainnet, unless noted)
- **S1 Citizen** `0xb9951b43802dcf3ef5b14567cb17adf367ed1c0f` — disassembly happens here (`disassembleCitizen`, Write as Proxy tab).
- **S2 Outer Citizen** `0x4481507cc228fa19d203bd42110d679571f7912e`
- **S1 components:** Identities `0x059174c2fef43f06178d23572fe5556f078f2f99`, Vaults `0x17b2f2b8927a8f11edfd7a27e153be17d68e69c7`, Item Caches `0xe7489ea1847395d7eead33e9c85fe327d513d249`, Land Deeds `0xcfc6a15b2952b6014a993a0c16c9d580d862e21a`
- **NeoTokyoStaker** `0x67e1ecfa9232e27eaf3133b968a33a9a0dca9e16` — staking and $BYTES claims (`claimReward`).
- **$BYTES (Ethereum)** `0xa19f5264f7d7be11c451c093d8f92592820bea86`
- **$BYTES (Avalanche C-Chain)** `0x13af0Fe9eB35e91758B467f95cbc78e16FdD8B6b`
## Tools
- **neotokyo.codes** — Upload dApp (assembly) and Citizen Banking/profile (claims, staking).
- **Etherscan** — Read Contract tab for checks; Write / Write as Proxy tabs for transactions, signed in the member's own wallet.
- **bytestobytes.com** — enter a wallet address to see accumulated claimable $BYTES.
- **Grid Phantoms Citizen Lab** ([gridphantoms.app/citizen/lab](https://gridphantoms.app/citizen/lab)) — look up any Citizen's traits, components, and staking profile; handy before disassembling or reassembling.
- **Citizen Search** (neotokyo.codes/viewCitizens) — look up a Citizen and check its rarity ranking (needed for the Elite role).
## Procedures
### 1. Assembling (uploading) a Citizen
Combining component NFTs into a Citizen ("uploading").
**Requirements (S1):** one of each component — an Identity, a Vault, an Item Cache, and a Land Deed (contract addresses above). Vaults are required for all new S1 assemblies since the 2023 contract migration. (S2 Outer Citizens assemble through the S2 contract with S2-specific components; the process is otherwise the same.)
1. **Record the token IDs** of every component NFT you will use — parts kept from a disassembled Citizen as well as any newly acquired parts.
2. Connect a wallet holding the required NFTs to the Upload page of https://neotokyo.codes.
3. Select the components through the site's interface (the Upload dApp verifies each selection before minting).
4. Write a custom description (upload message).
5. Press *Upload* and confirm each transaction in your wallet.
Uploading mints a **new** Citizen NFT with a **new** token ID and a **new** Citizenship Number — numbers are never reused. Expect a significant gas fee: the transaction carries a lot of data.
### 2. Disassembling a Citizen
Breaking a Citizen back into its component NFTs (e.g. to swap or trade a part).
**Before you start:**
- **Claim your $BYTES first.** Accumulated unclaimed $BYTES survives disassembly, but claim anyway — it is the documented safe order.
- A Citizen **cannot** be disassembled while staked (same for Outer Citizens). Withdraw it from the staker first (the staking timelock must have fully cleared or withdrawal reverts).
- **Record the Citizen's token ID** and the expected component token IDs. Looking up the Citizen's component profile first (e.g. via Citizen Lab) tells you exactly which parts to expect back.
**Steps:**
1. Connect the wallet containing the Citizen to the Citizen contract on Etherscan (S1 Citizen contract for a Citizen, S2 contract for an Outer Citizen).
2. Open the *Write as Proxy* tab.
3. In `8. disassembleCitizen`, enter the Citizen's token ID and click *Write*; confirm in your wallet.
**Result:** the component NFTs return to your wallet — four for a standard S1 Citizen (Identity, Vault, Item Cache, Land Deed), or three for the few S1 Citizens assembled without a vault. The Citizen NFT itself is **burned**; its Citizen number is destroyed and will never be reused.
A community walkthrough with screenshots: [@ktrap's Disassembly & Reassembly Mega Guide](https://x.com/ktrap/status/1932972903567446074) (June 11, 2025).
### 3. Reassembling with new parts
1. Gather the component NFTs: parts returned from a disassembly plus any newly acquired parts.
2. **Record all token IDs** before you start.
3. Upload via the dApp exactly as in procedure 1. The result is a new Citizen with a new token ID and Citizenship Number.
### 4. Claiming $BYTES
Check what is claimable first:
- **Citizen Banking** (neotokyo.codes/profile) with the staking wallet, or
- **bytestobytes.com** — enter the wallet address, or
- **Etherscan:** NeoTokyoStaker → Read Contract → `getPendingPoolReward` (`0` = S1, `1` = S2, then the wallet address).
Claim via Citizen Banking, or on Etherscan via `claimReward(recipient)` on the staker contract. Claiming is **not** blocked by the staking period — claim as often as you like.
### 5. Bridging $BYTES to Avalanche
$BYTES also exists on Avalanche C-Chain (`0x13af0Fe9eB35e91758B467f95cbc78e16FdD8B6b`).
- **Official bridges:** [Transporter](https://app.transporter.io/) and [XSWAP](https://xswap.link/swap?fromChain=1&toChain=43114&fromToken=BYTES&toToken=BYTES) (Ethereum → Avalanche).
- On Avalanche, $BYTES trades on [BlackHole DEX](https://www.blackhole.xyz/swap?token0=0xavax&token1=0x13af0Fe9eB35e91758B467f95cbc78e16FdD8B6b).
- Always verify the token contract address on the destination chain before swapping — never trust an address pasted in chat.
### 6. Joining the community
Owning the NFTs is only half of it — participation happens in the Discord, and announcements go out on X.
**Discord:**
1. Join the server: https://discord.gg/neotokyocitadel
2. Go to **#verify-s1-s2** (direct link: https://discord.com/channels/884204406189490176/916346518053744670) and complete Matrica verification: create a Matrica profile, add the wallet holding your Citizen or Outer Citizen (this grants no one access to your wallet — it only verifies holder status), then use Check Status / Server Roles to gain your holder role.
3. Access follows holdings: S1 Citizens and fully uploaded S2 Outer Citizens unlock different channels and access levels. For example, Angie's Pub requires a fully uploaded S2 Outer Citizen — holding S2 Outer Identities alone does not grant it.
4. Hold a top-500 rarity S1 Elite Citizen? Head to **#verify-elite** and use the ranking bot for your Elite role — check your ranking first with Citizen Search at neotokyo.codes/viewCitizens.
**Community ethos** — founder EllioTrades' charge to the community:
**1) Ask not, citizen, what The Citadel can do for you, but what you can do for The Citadel.**
The true power of this experiment comes from the strength within this community. Only if each and every member of this group is actively engaged, each and every day, creating value for the citadel, shall Neo Tokyo truly be enshrined as Valhalla of the East. Do not rest, do not wait, push forward with restless zeal to bring knowledge, progress, visibility and pride to the Citadel. The future is what YOU make it.
**2) CITIZENS alone determine the value of the Citadel.**
This is an experiment that shall ripple through time, forever changing the path of history. Holders will be enshrined with the benefits of citizenry. Together, each doing their part in accordance to their means, the halls of Neo Tokyo shall play host to the most important community in the world. This is an experiment, that requires 100% dedication from members, 100% focus, and unwavering support. The benefits of membership will be made clear, yet only the worthy shall enter.
**3) Classified Citadel Knowledge is to remain classified.**
The importance of the information shared here is what defines this community. To leak is to betray, and to betray is to face potential exile.
**4) We ONLY win together.**
While some tests have been orchestrated by the Citadel Founders, these are only to establish a strong community. The games are far from over, but what happens next is up for all of us to decide. This is a true experiement in finding the best and most deserving, empowering them with collective think and resources, and fearlessly ripping a hole in the fabric of the internet as a united collective.
**5) No one profits.**
To ensure the sanctity of this experiment, the founders have ensured that they only receive ONE mint that will be held in public wallets and never sold. In order to achieve the engineering required a shadowy super coder was enlisted for the cost of 12 mints and 5% of resale commissions. This is NOT the founders, however a worthy citizen who was necessary to realize the initial phases for Neo Tokyo.
**6) The future is ours.**
The power of web3 communities is just beginning to peak its beautiful head. Neo Tokyo Identities have already delivered immeasurable value to citizens, and the journey has just begun. If the code is respected, there is little doubt in my mind that this will be one of the most important groups ever created.
*Citizens or Outer Citizens, must verify at https://discord.com/channels/884204406189490176/916346518053744670 to be granted access to Citadel grounds. Citizens, behold. The future is truly ours.*
**Official announcements:** follow [@NeoTokyoCode](https://x.com/NeoTokyoCode) on X for updates.
**Privacy note:** verifying links your wallet address to your Discord account inside that server — the association is visible to the server's admins via Matrica. If keeping those separate matters to you, verify with a dedicated wallet and Discord identity.
## Safety rules
- **Record token IDs before every disassembly and every upload.** This is the single most important habit.
- **Claim $BYTES before disassembling.**
- **Verify every contract address** against a trusted source (the wiki's Contracts page) before interacting. Never trust an address pasted in chat or DMs.
- Expect significant gas for uploads and disassemblies — each moves several NFTs in one transaction.
- Disassembly burns the Citizen. The components come back; the Citizen does not.
- A staked Citizen or Outer Citizen must be withdrawn (timelock cleared) before it can be disassembled.
- Never share private keys or seed phrases with anyone, including anyone claiming to help.
## Auth
- **Reads** (checking pending rewards, positions, contract state): the user's own Etherscan API key, free at https://etherscan.io/myapikey. Keep it out of logs, files, and chat.
- **Writes** (upload, disassemble, claim, bridge): the member signs in their own wallet (e.g. MetaMask) through Etherscan or neotokyo.codes. The skill never touches keys and never submits transactions itself.
---
*Origin: Neo Tokyo Citizen Wiki (neotokyowiki.com) · Published 2026-10-14 · Version 1.0*
skill.yaml
name: "neo_tokyo_citizen_mechanic" title: "Neo Tokyo Citizen Mechanic" description: "Walk through Neo Tokyo Citizen processes step by step — assembling, disassembling, reassembling, claiming $BYTES, and bridging $BYTES to Avalanche." category: "Work and knowledge" include_in_prompt: false version: "1.0"