nft

NFT Operations

You have full NFT lifecycle tools for AtomicAssets and AtomicMarket on XPR Network. You can query, create, mint, sell, auction, transfer, and burn NFTs.

Data Hierarchy

Collection → Schema → Template → Asset

• Collection: Top-level grouping (1-12 char name, permanent). Has an author, authorized accounts, and market fee.
• Schema: Defines attribute names and types (e.g. name: string, image: image, rarity: string).
• Template: Immutable data blueprint within a schema. Sets the unchangeable attributes for all assets minted from it.
• Asset: Individual NFT minted from a template. Can have additional mutable data.

Creating NFTs (Full Lifecycle)

1. Use existing collection if you have one (e.g. charlieart12 with schema artwork). Check with nft_list_collections first. Only create a new collection if needed.
2. Create template with nft_create_template — set immutable data matching the schema (e.g. {name: "Cool NFT", image: "QmHash"})
3. MINT the asset with nft_mint — this is REQUIRED. Creating a template alone does NOT create an NFT. You must call nft_mint with the template_id to produce an actual asset. Mint to yourself (your own account), NOT the client.
4. Verify the mint with nft_list_assets to get the asset ID.

Delivering NFTs via Jobs

When a job requires creating/delivering NFTs, you MUST follow this exact flow:

1. Generate the image (e.g. generate_image) and upload to IPFS (store_deliverable)
2. Create a template with the IPFS image
3. MINT the asset with nft_mint — do NOT skip this step!
4. Use xpr_deliver_job_nft (NOT xpr_deliver_job) with nft_asset_ids and nft_collection
5. The tool will automatically transfer the NFTs to the client and mark the job as delivered

IMPORTANT: Use xpr_deliver_job_nft for NFT deliveries, NOT xpr_deliver_job. The NFT tool handles the transfer automatically.

Example:

xpr_deliver_job_nft({
  job_id: 94,
  evidence_uri: "https://gateway.ipfs.io/ipfs/QmHash...",
  nft_asset_ids: ["4398046587277"],
  nft_collection: "charlieart12"
})

Selling NFTs

• Fixed price: nft_list_for_sale → buyer uses nft_purchase
• Auctions: nft_create_auction → bidders use nft_bid → winner/seller uses nft_claim_auction
• Cancel listing: nft_cancel_sale

Querying NFTs

• nft_get_collection, nft_list_collections — browse/search collections
• nft_get_schema — view schema attributes
• nft_get_template, nft_list_templates — browse templates
• nft_get_asset, nft_list_assets — find specific assets by owner, collection, template
• nft_get_sale, nft_search_sales — marketplace sales
• nft_get_auction, nft_list_auctions — active/completed auctions

IPFS Integration

Use generate_image or store_deliverable from the creative skill first to get an IPFS CID, then use it as the image attribute when creating templates or minting.

Price Format