FAQ
Questions about Crypto Hodlers: the project, the collections, the website, and what comes with holding one of our NFTs. Pick a category, or use a direct link from elsewhere on the site.
General
About the Crypto Hodlers project itself. Start here if you're new, or come back when you need a pointer to something official.
Crypto Hodlers is an NFT-powered community brand founded in July 2021, among the very first generations of generated ERC-721 art. It's a shared vision where members help shape a creative universe that expands into comics, games, and more. Built for people who value ownership, culture, and collaboration.
Since launch we've been through good times and tough ones. Through all of it, we've kept aiming to build more value for the community. And we'll keep doing that as long as we can, and as long as there's someone interested.
Holding a Crypto Hodlers NFT comes with:
- Full ownership of your token, plus a broad commercial license to its art — the full license is in the Terms.
- Community events and activities, holder-only content access, and eligibility for the airdrops we run.
- A share of secondary-market royalties on your token, accumulated per token and claimable through our on-chain distributor — see the Royalty Share section for the mechanics.
- Helping shape the world and story — making choices on plots, characters, and the direction the universe takes.
Three main ERC-721 collections on Ethereum mainnet (Crypto Hodlers, Crypto Todlers, and Soul of Ukraine), plus several smaller airdrop collections we've issued over the years (a mix of ERC-721 and ERC-1155, on Ethereum mainnet and Polygon). The full list with contract addresses and marketplace links is on the Official Links page.
Visit /world on the Website. You'll find:
- Comic series — visual chapters telling the Crypto Hodlers story.
- Character profiles — individual pages for the cast of the universe.
- Articles & stories — long-form lore covering Famas City and the wider world.
The page has anchors for characters and stories, so you can jump straight where you want.
Minting is closed for all of our main collections. To pick one up, buy on a secondary marketplace:
Soul of Ukraine and the airdrop collections are also on OpenSea. All marketplace links are on the Official Links page.
Crypto Hodlers is built by the Hodler Lab team, operating from Lviv, Ukraine. We're software engineers and artists with many years of web2/web3 experience built up well before Crypto Hodlers existed. We launched the project in 2021. Since then we've been building for the community, and along the way we've helped build other known projects in the NFT space.
You can reach us at apxu@hodlerlab.com, on Discord, or on X (all linked from the Official Links page).
Join our Discord or follow us on X (@Hodlers_NFT), both linked from the Official Links page. You don't need to own one of our NFTs to participate; anyone is welcome to chat and follow along. Some Discord roles unlock based on holdings, but everyday conversation doesn't require a token.
Our canonical list of official accounts, marketplaces, and contracts is at /official-links. If an account, link, or contract claims to be from Crypto Hodlers, check it against that page. Anything not listed there isn't ours.
Collections
About the NFT collections that make up the Crypto Hodlers project.
Crypto Hodlers is our first NFT collection. Launched in July 2021, it's an ERC-721 contract on Ethereum mainnet with 10,000 hand-drawn characters, each one a citizen of Famas City. Everything we've built since grew out of this collection.
Each Crypto Hodler comes in two art editions:
- 2021 edition — the original artwork the NFTs were minted with.
- 2026 edition — our updated take on the art, made years later as the project evolved.
Both editions live side by side in each token's metadata. Neither replaces the other, and neither is more authentic or more beneficial than the other. Where the Website supports it (for example, when picking a PFP), you can choose which edition to use.
Bots are 991 of the 10,000 Crypto Hodlers, a small subset whose rarity made them grails of the collection back in 2021. They're often valued more on the market because of it.
Crypto Todlers is our second collection, an ERC-721 contract on Ethereum mainnet. Launched in September 2021, the 1,169 Todlers weren't minted from a pre-defined set. Holders generated them themselves by pairing two Hodlers, and each Todler was created in real time from those two parents. Each one inherits a trait from one of its parents at random, with both parents recorded on-chain.
No. Minting closed on September 7, 2022 and won't reopen. The supply is fixed at 1,169. If you want one, look on the secondary market.
Soul of Ukraine is a charity collection we launched in February 2022 to support Ukraine after russia's full-scale invasion. It's an ERC-721 contract on Ethereum mainnet, and 100% of minting funds (around 21.6 ETH) were transferred to the official Ukrainian donation wallet.
Yes. Every outgoing transaction from the contract is on Etherscan, and they all went to one of the official donation wallets published by Ukraine's Ministry of Digital Transformation. See the contract's internal transactions.
Past airdrops we sent to holders. Some were for holding particular tokens, others as rewards for showing up to events or winning them. Mix of ERC-721 and ERC-1155 on Ethereum and Polygon. Full list on the Official Links page.
No. None of our contracts enforce royalties on-chain; payment depends on each marketplace's policy (see the Royalty Share section for details). Transfers aren't restricted either; the tokens are standard ERC-721 or ERC-1155 and can move freely between wallets.
Depends on the collection. The main collections (Crypto Hodlers, Crypto Todlers, and Soul of Ukraine) use a centralized metadata service we operate. Some of the airdrop collections use IPFS instead. Either way, each token's metadata URI is recorded on-chain.
Website
Everyday questions about the cryptohodlers.io site and how to use it.
Yes. Browsing the Website doesn't require a wallet. You can explore the collections, read individual token pages, dive into the world and story, check the official links, and read these FAQs without connecting anything.
A wallet is only needed for features tied to your on-chain identity. When you reach one, you'll be prompted to connect.
Click Connect in the site header (top-right on desktop, next to the hamburger menu on mobile). A wallet picker opens; choose your wallet (MetaMask, Coinbase Wallet, Rabby, or any WalletConnect-compatible mobile wallet) and approve the connection in the wallet app.
After the wallet is connected, you'll be asked to sign a short challenge message to prove you control it. Signing creates (or signs you back into) your Crypto Hodlers account. Signing is free; it doesn't move funds or call a smart contract.
Signatures are how we confirm you actually control the wallet. Anyone can read a public address, but only the wallet's keyholder can sign a message for it, which keeps someone else from impersonating you by typing in your address.
The Website holds the signature in a short-lived session token that lasts about 24 hours. Once it expires (or if you disconnect, reconnect, or open the site in a fresh browser) you'll be asked to sign a new challenge to refresh your session.
The signature is free and doesn't move funds or call a smart contract. As always, glance at what your wallet shows before approving; it should match what the Website displays.
Yes. The Website works on phones and tablets, and mobile wallet connection runs over WalletConnect. Open the connect dialog, pick your wallet, and approve in the wallet app.
Most flows work the same as on desktop. A few screens are nicer on a wider screen, but they're still usable on a phone.
The Website never receives or stores your private keys or seed phrase. Every signature and transaction is approved inside your own wallet; we only see the result on-chain or the signed message you send back.
What we do ask you to sign is a short challenge message we use to prove you control a wallet. Signing a challenge is free and doesn't authorize any transfer.
A few habits that protect you anywhere in Web3, not just here:
- Always check the URL before connecting. The official one is cryptohodlers.io.
- Read what your wallet shows you before approving a signature or transaction.
- Bookmark the official URL rather than following links from DMs or unverified social posts. Phishing sites for popular NFT projects show up all the time.
Your profile displays the address (and ENS, when available) of your primary wallet. To change what's shown, set a different linked wallet as primary on the account page. Open the menu on the wallet you want and pick Set as Primary.
If the primary wallet doesn't have an ENS, the profile falls back to an ENS from another linked wallet, or the address itself if none of your wallets have one.
Open a token you own from your profile or the collections section. On the token's image, a small profile icon appears in the corner. Click it to set that token as your PFP. For Crypto Hodlers tokens, a quick menu lets you choose between the 2026 Art Edition and the 2021 Art Edition.
Clicking the same icon on your current PFP removes it. If you haven't signed in to your account yet, the action prompts you to sign a quick challenge first.
If you transfer the token you set as PFP to another wallet, the PFP is cleared. Pick a new one from a token you still own.
Open the Crypto Hodlers tab on either the collections page or any profile. In the toolbar you'll see two action icons, E21 and E26. Click to switch between editions.
The Kindergarten game has its own separate edition choice. Open the game's settings menu (the more-options icon in the game UI) and toggle Use 2021 Art Edition to switch. The art edition can change how the game feels to play, so you can keep one edition as your general preference and a different one for gameplay.
Your pick is saved in your browser per surface, so you can keep different defaults on each. It lives in your browser rather than your account.
Open your profile (the My Profile link in the wallet menu) and click the banner area at the top. The banner picker opens; pick a design, and it's saved. If you haven't signed in to your account yet, the action prompts you to sign a quick challenge first.
You don't have to. Socials are optional and the Website works fully without them.
Connecting your X or Discord account does three things:
- Affects what's shown on your profile.
- Counts toward social-activity Memories alongside your on-chain ones.
- For Discord specifically, lets us manage your Crypto Hodlers server roles based on the tokens you hold.
Privacy: the X account you connect is public, displayed on your profile. The Discord account is not public; we only show the fact that one is connected, never the handle or ID. We use Discord internally on our server for role management and activity-derived Memories. Full details on what we collect and how it's used are in the Privacy Policy.
Wallet Linking
Connecting additional wallets to a single Crypto Hodlers account. The basics and the edge cases.
Many holders spread their NFTs across more than one wallet (a hot wallet for everyday use, a cold one for long-term storage, separate wallets for separate collections). Linking those wallets to a single Crypto Hodlers account lets the Website see them together: your profile reflects everything you own, Memories count across all of them, and you can manage them from one place.
Linking doesn't move anything on-chain. Tokens stay in whatever wallet holds them. Linking is just an off-chain association that tells the Website which wallets belong to the same person.
Open your account page, click Add Wallet, and pick the wallet you want to link in the picker that opens. Sign the challenge message that wallet shows you (the same kind of free signature you used to sign in) and the wallet is added to your account.
You can keep linking more wallets the same way.
No. Linking is entirely off-chain. It's just a signature you produce in your wallet, and we save the association on our side. Signing the challenge is free and doesn't broadcast a transaction, so there's no gas, no token approval, and no on-chain footprint.
One of your linked wallets is marked as Primary. It's the wallet your account is displayed by (the address shown on your profile) and the one we treat as the account's representative when something needs to pick a single wallet per holder, like a snapshot or an airdrop that maps to one address.
You can change which wallet is primary at any time from the account page. Open the menu on the wallet you want as primary and pick Set as Primary.
The Website detects it and asks you to confirm before doing anything. If you confirm, the wallet moves to your account and we carry off-chain history along with it where we can (things like leaderboard entries and Memories). If you cancel, nothing happens and the wallet stays where it is.
Wallet linking is decided by signature proof. Whichever account most recently signed for a wallet is the one that holds it. The move isn't reversible from our side, so confirm carefully.
Yes. That's what Manual Linking is for. You sign a challenge in any environment you choose and paste the signature back; the wallet itself never connects to a browser.
On the account page, open the menu next to Add Wallet, pick Advanced: Manual Linking, enter the wallet address, sign the challenge we show you, and paste the signature back.
This flow needs careful attention. Only sign and paste what you generated yourself, against the message we showed you in this session. Never a signature someone else sends you.
No. Delegation services like warm.xyz and delegate.xyz don't fully satisfy what we need, so we don't rely on them for wallet linking. If you want to link a wallet without connecting it to the Website, use the Manual Linking flow above.
Yes. On the account page, open the menu next to the wallet you want to remove, pick Disconnect Wallet, and confirm.
One restriction: you can't unlink the wallet you're currently signed in with; the option is greyed out for it. To remove that wallet, sign in with a different linked wallet first, then unlink it from there.
Unlinking is off-chain only and doesn't affect what's in the wallet; the NFTs stay where they are. But anything the account was showing because of that wallet (its NFTs on your profile, Memories derived from those holdings, and similar) drops off your account once the wallet is gone.
Royalty Share
How holders receive a share of secondary-market royalties from collection trades.
A share of the secondary-market royalties paid on trades of our project collections is set aside for holders of the original Crypto Hodlers collection. The Royalty Share Distributor Contract on Ethereum receives those payments in ETH, splits them between a project share and a holder share, and accumulates the holder share per Crypto Hodlers token. Every Crypto Hodlers NFT has its own ETH balance ready to claim.
Holding a Crypto Hodlers token entitles its owner to that balance. You don't have to do anything to participate; you only act when you want to claim what's accumulated.
Full mechanics and disclaimers are in Section 8 of the Terms.
When any NFT from our project collections trades on a secondary marketplace that pays creator royalties, the royalty payment is sent in ETH to the Royalty Share Distributor Contract on Ethereum. The contract divides that incoming payment between a project share (which the project claims for operations) and a holder share, which is split equally across the Crypto Hodlers collection and added to each Crypto Hodlers token's balance.
Royalties on trades of these collections aren't enforced on-chain at the NFT contract level. They're paid only when a marketplace, aggregator, or seller voluntarily honors them, so the flow of incoming ETH depends on third-party policy and volume, both of which can change.
No. The Royalty Share Distributor Contract is immutable in the parts that matter. Once ETH is allocated to a token, only the wallet that owns that token at the time of the claim can withdraw it. The team can't pull holder allocations, redirect them, or freeze them at the contract level.
In narrow cases (for example, wallets associated with sanctioned persons or illicit activity, as covered in the Terms), we may block a claim from running through the Website interface. The on-chain allocation isn't ours to touch — the block only applies to using the Website to initiate the claim.
The split between the project share and the holder share is the one thing the contract lets us adjust, and only for future incoming royalties. It doesn't touch ETH that's already been allocated.
Claiming sends a transaction to the Royalty Share Distributor Contract that withdraws the accumulated ETH for the tokens you select. The transaction is signed from the wallet that owns those tokens, and the ETH lands in that wallet once the transaction confirms.
The Website batches multiple tokens into a single claim transaction, so you don't pay gas for each token separately. There's a maximum number of tokens per batch; selecting beyond that gets capped automatically.
From the Royalty Share page on the Website. Connect the wallet that owns the tokens you want to claim, select the tokens with non-zero balances, and submit the claim from there.
If you have tokens in linked wallets that also have balances, the page shows them in a separate section, so you can see what's claimable across all your wallets in one view. The actual claim has to be made from the wallet that owns each token (see below).
Two places:
- On the token's detail popup or page, the balance shows as an ETH-icon chip alongside the other token info (tooltip: "Royalty Share Balance"), whether you own the token or not.
- The Royalty Share page lists all the tokens you own with their balances side by side, so you can scan your whole holdings at once.
The contract itself doesn't expire balances. Allocations stay there until the token's owner claims them; there's no rolling window or time after which the on-chain balance disappears.
See Section 8 of the Terms for the full disclaimers.
No. Due to on-chain restrictions, the claim transaction has to be signed by the wallet that actually holds the token on-chain. The Royalty Share page will show you balances across all your linked wallets in one view, but to actually claim each one, you need to connect the wallet that owns those tokens.
Token Naming
Setting a custom on-chain name for an NFT you own.
Tokens in the Crypto Hodlers and Crypto Todlers collections each carry a custom on-chain name set by the owner. Setting or changing the name runs through a small smart contract. The name itself is stored on-chain, so it travels with the token if it's transferred.
The Website handles the flow in a rename modal: you pick a name, confirm the cost in your wallet, sign the transactions, and the new name lands on-chain once they confirm.
Tokens in the Crypto Hodlers and Crypto Todlers collections can be renamed. Tokens in the Soul of Ukraine collection don't have a naming surface in their contract and can't be renamed. In all cases, you can only rename tokens you actually own.
From any token's detail view, reachable from the collections section, the token's own page, or your profile. An edit icon appears next to the token name when the token belongs to your account; click it to open the rename modal. The click only works when you're connected with the wallet that owns the token on-chain.
A few rules apply:
- Up to 25 characters.
- Letters, numbers, and spaces inside the name. No leading or trailing spaces.
- No profanity. We apply a basic filter at submission, and the same filter runs in our metadata service.
- Each name has to be unique within the collection.
Within those rules, the choice is yours. You pick the name and you're responsible for what you pick. Full rules and disclaimers are in Section 9 of the Terms.
The naming contract charges a fixed 200 NCT per rename. On top of that, you pay the usual Ethereum gas for two transactions: an approval that lets the naming contract spend your NCT, and the rename call itself.
The 200 NCT figure is set in the contract and is the same for every rename.
NCT is short for Name Change Token, an ERC-20 token introduced for the Hashmasks project and adopted by Crypto Hodlers as the payment for naming. You can confirm its canonical contract address on the /official-links page.
You can buy NCT on a decentralized exchange. The rename modal includes a Get More NCT button that opens a Uniswap deeplink for the right token, but any DEX or aggregator that lists NCT works.
The name is stored on-chain as soon as the rename transaction confirms, typically within a minute on Ethereum.
Where it shows up after that depends on each service that reads the token. The Website itself updates as soon as the transaction confirms. Marketplaces like OpenSea and most blockchain explorers cache metadata, so the new name there can take anywhere from a few minutes to a few hours, and you may need to trigger a refresh on the listing yourself.
No. Due to on-chain restrictions, the rename transaction has to be signed by the wallet that actually holds the token on-chain. You'll still see the rename option from any account that has that wallet linked, but to actually rename you need to connect the owning wallet directly.