Learn
Testnet guides
Practical guides for experimenting with ERC-20 tokens, ERC-721 and ERC-1155 NFTs, and on-chain flows on the QANPlatform testnet. This is a non-commercial technical demo — tokens and NFTs created here have no real economic value.
Creating ERC-20 test tokens
qbitmarket includes a PaymentTokenFactory contract that lets anyone deploy a minimal ERC-20 token on QAN TestNet. These tokens can be used as payment in secondary marketplace flows — listings, offers, and auctions.
What is an ERC-20 token?
ERC-20 is the standard interface for fungible tokens on EVM-compatible blockchains. Every unit is identical and interchangeable — like currency. The standard defines a set of functions (transfer, approve, transferFrom, balanceOf) that allow wallets and contracts to interact with the token in a predictable way.
On a testnet, ERC-20 tokens have no real value. They are useful for testing approval flows, payment selector logic, and multi-token marketplace mechanics without real funds at risk.
How to create an ERC-20 on qbitmarket
- Connect a testnet wallet. Switch MetaMask (or your preferred wallet) to QAN TestNet before starting. You will need a small amount of testnet QANX to cover gas.
- Go to Payment Tokens. This page surfaces the PaymentTokenFactory contract, which is the only official way to deploy ERC-20 test tokens through qbitmarket.
- Fill in token parameters. Provide a name (e.g. "My Test Token"), a symbol (e.g. "MTT"), and a supply. The factory mints the full supply to your wallet at deploy time.
- Confirm the transaction in MetaMask. Verify the contract address shown in MetaMask matches the official PaymentTokenFactory address listed in Help and Verification.
- Use the token in marketplace flows. Once deployed, your ERC-20 appears as a user-created token in the payment selector when listing or placing offers. Other wallets can also use it if they acquire a balance.
Token labels explained
User-created
Deployed via PaymentTokenFactory. Available immediately but labeled as a user test token.
Verified
Curated by qbitmarket. Shown as trusted defaults in the payment selector.
External
Not created through the factory. Must be manually approved by qbitmarket before marketplace contracts accept it.
Creating NFT collections on testnet
qbitmarket uses a CollectionFactory contract to deploy ERC-721 and ERC-1155 NFT contracts on QAN TestNet. Each collection is its own smart contract — not just a token inside a shared contract.
ERC-721 vs ERC-1155
ERC-721 — Non-fungible tokens
Each token ID is unique and owned by exactly one address. Best for 1-of-1 items or limited edition drops where every item has a distinct identity. qbitmarket supports fixed-price primary minting with merkle-proof–based set publishing.
ERC-1155 — Semi-fungible tokens
A single contract can hold multiple token IDs, each with its own supply. One wallet can hold n units of token ID 7, for example. Useful for editions, game items, or batch listings. qbitmarket supports lazy minting and bundle secondary listings for ERC-1155.
How to deploy a collection
- Connect a wallet on QAN TestNet. You will need testnet QANX for the deployment gas. The wallet you use becomes the collection owner.
- Go to Create Collection. Fill in collection name, symbol, and choose ERC-721 or ERC-1155.
- Confirm the CollectionFactory transaction. MetaMask will ask you to sign a transaction calling
createCollectionon the official CollectionFactory contract. Verify the address against the official contracts in Help. - Publish a set (ERC-721) or mint items (ERC-1155). For ERC-721, you publish a set of items with metadata URIs and prices. Replacing the set creates a new live version — unminted items from the previous set are no longer available. For ERC-1155, items are lazy-minted individually.
- Your collection appears in Collections. Other wallets can now browse it, mint from it (primary), or pick up secondary listings.
Scheduled drops
Collections can be published with a future date. A scheduled collection appears as an upcoming drop in Upcoming Drops immediately, but Buy & Mint stays closed until the configured publish time. This is useful for testing drop announcement flows without opening minting too early.
Using qbitmarket as a technical demo
qbitmarket is designed as a community playground for developers and community members to exercise the full lifecycle of on-chain NFT flows on QAN TestNet. Here is how to get the most out of it as a technical demo.
Primary flow (minting)
The primary flow covers deploying a collection, publishing a set, and using Buy & Mint from the collection page. This exercises the CollectionFactory and primary marketplace contract together.
- Deploy collection via CollectionFactory
- Publish a set with item URIs, prices, and supply
- Mint from a different wallet using Buy & Mint
- Verify the minted token appears in My NFTs
Secondary flow (resale)
After minting, the token owner can list it on the secondary marketplace. Secondary flows exercise the MarketplaceSecondaryERC721 or MarketplaceSecondaryERC1155 contracts.
- Approve the secondary marketplace as operator
- Create a fixed-price listing or auction
- Buy or bid from a second wallet
- Settle or cancel the listing
Offer flow
Any wallet can place an escrowed offer on a token even before it is listed. The token owner accepts or ignores it. This flow exercises ERC-20 approval, offer creation, and acceptance mechanics.
Contract verification
qbitmarket publishes audit evidence and deployment manifests. The Verification page shows official contract addresses, bytecode hashes, and links to the audit and deployment PDFs. Cross-referencing these before signing MetaMask prompts is a good habit to practice.
About QANPlatform
QANplatform is a Layer-1 blockchain with post-quantum cryptography and EVM compatibility. qbitmarket runs on QAN TestNet — a public testnet with no real economic value. It is a community project and not an official QANplatform product.