Xian Documentation

Appearance

Xian NFT ​

xian-nft owns the NFT product: the XSC-0005 checker and reference collection contracts, the PixelSnek marketplace web app, and the bootstrap tooling for installing the product after a Xian chain exists.

  • Owning repo: xian-nft
  • Contract bundle: xian-nft/contract-bundle.json
  • Bootstrap script: xian-nft/scripts/bootstrap_nft.py
  • Web app: PixelSnek marketplace

Lifecycle ​

  • Install phase: post-genesis
  • Included in genesis: no
  • Shipped with node image: no
  • Installer: xian-nft/scripts/bootstrap_nft.py

On-Chain Contracts ​

ContractRole
con_xsc005XSC-0005 interface checker exposed through is_XSC005
con_xsc005_nftreference collection and marketplace contract: minting, listing, buying, royalties, approvals, likes, ownership proofs, chunked content, and PixelGrid support

The reference collection implements the full XSC-0005 standard, including the PixelGrid extension for fully on-chain pixel art with palettes and animation frames. Its marketplace accepts only the seeded chain currency contract for settlement; listings that name arbitrary interface-compatible contracts fail closed before any purchase can occur.

PixelSnek Marketplace ​

The marketplace (Vite + React + TypeScript + Tailwind + daisyUI) covers the full XSC-0005 surface:

  • explore page with hot listings, featured collections, and live activity
  • collection browsing, registration of any XSC-0005 collection by contract address, and auto-discovery of new collections via indexer events
  • token detail with buy, list, cancel, transfer, burn, like, and prove-ownership actions; list and buy settle in native XIAN (currency)
  • minting into any collection you operate, including an in-browser pixel-grid editor with palette and animation-frame support
  • per-token and collection-wide approval management
  • profiles, global activity feed, and operator tools for collection metadata
bash
cd xian-nft
npm install
npm run dev   # http://localhost:5180

The app reads through @xian-tech/client plus the node's indexer endpoints and writes through the injected browser wallet provider. When the configured node does not expose the indexer surface, the app shows an indexer-down banner and degrades gracefully. Collection discovery, token grids, profiles, and activity need indexed events; direct token reads use contract state. The marketplace combines indexed event identifiers with the remaining event data and displays contract timestamps consistently across browser timezones.

Collection verification uses the native VM's read-only dynamic ForeignHash support. Deploy the standard con_xsc005 checker as well as a collection, and use an indexed node for automatic discovery, profiles, and activity.

Installing The NFT Product ​

Validate the hash-pinned bundle with the generic xian-cli helper, then run the repo-owned bootstrap against a healthy node:

bash
uv run --project ../xian-cli xian contract bundle validate contract-bundle.json
uv run --group deploy python scripts/bootstrap_nft.py

The bootstrap validates the entire bundle before connecting to the node and uses the verified source snapshot for deployment. --bundle selects a bundle; its entries determine source paths, deployment order, names, and default chi budgets. --checker-contract, --collection-contract, --checker-chi, and --collection-chi are explicit overrides. --dry-run validates and prints the plan without broadcasting. The deploy dependency group includes the shared CLI validator and Python SDK.