sage-nft

name	sage-nft
description	Sage NFT operations. List NFTs and collections, mint NFTs, transfer, add URIs, assign to DIDs, manage visibility.

Sage NFTs

NFT operations for Chia NFT1 standard.

Endpoints

Query NFTs

Endpoint	Payload	Description
get_nfts	See below	List NFTs with filters
get_nft	{"nft_id": "nft1..."}	Get NFT details
get_nft_icon	{"nft_id": "nft1..."}	Get icon (base64)
get_nft_thumbnail	{"nft_id": "nft1..."}	Get thumbnail (base64)
get_nft_data	{"nft_id": "nft1..."}	Get raw data

get_nfts Payload

{
  "collection_id": null,
  "minter_did_id": null,
  "owner_did_id": null,
  "name": null,
  "offset": 0,
  "limit": 50,
  "sort_mode": "recent",
  "include_hidden": false
}

Sort modes: "name", "recent"

Collections

Endpoint	Payload	Description
get_nft_collections	{"offset": 0, "limit": 50, "include_hidden": false}	List collections
get_nft_collection	{"collection_id": "col1..."}	Get collection
update_nft_collection	{"collection_id": "col1...", "visible": true}	Update visibility

Mint NFTs

{
  "mints": [
    {
      "address": null,
      "edition_number": 1,
      "edition_total": 100,
      "data_hash": "0x...",
      "data_uris": ["https://..."],
      "metadata_hash": "0x...",
      "metadata_uris": ["https://..."],
      "license_hash": null,
      "license_uris": [],
      "royalty_address": "xch1...",
      "royalty_ten_thousandths": 300
    }
  ],
   
   
   

Response includes nft_ids array.

Transfer & Manage

Endpoint	Payload	Description
transfer_nfts	{"nft_ids": [...], "address": "xch1...", "fee": "...", "auto_submit": true}	Transfer
add_nft_uri	{"nft_id": "...", "uri": "https://...", "kind": "data", "fee": "..."}	Add URI
assign_nfts_to_did	{"nft_ids": [...], "did_id": "did:chia:...", "fee": "..."}	Assign to DID
update_nft	{"nft_id": "...", "visible": true}	Update visibility
redownload_nft	{"nft_id": "..."}	Re-fetch data

URI kinds: "data", "metadata", "license"

NFT Record Structure

{
  "nft_id": "nft1...",
  "launcher_id": "0x...",
  "collection_id": "col1...",
  "owner_did_id": "did:chia:...",
  "minter_did_id": "did:chia:...",
  "name": "My NFT",
  "description": "...",
  "data_uris": ["https://..."],
  "metadata_uris": ["https://..."],
  "royalty_address": "xch1...",
  "royalty_ten_thousandths": 300,
  "visible": true
}

Examples

# List NFTs
sage_rpc get_nfts '{"limit": 20, "sort_mode": "recent"}'

# Mint NFT
sage_rpc bulk_mint_nfts '{
  "mints": [{
    "data_uris": ["ipfs://Qm..."],
    "data_hash": "0xabc...",
    "metadata_uris": ["ipfs://Qm..."],
    "metadata_hash": "0xdef...",
    "royalty_ten_thousandths": 500
  }],
  "did_id": "did:chia:1abc...",
  "fee": "100000000",
  "auto_submit": true
}'

# Transfer NFT
sage_rpc transfer_nfts '{
  "nft_ids": ["nft1abc..."],
  "address": "xch1recipient...",
  "fee": "100000000",
  "auto_submit": true
}'

Notes

• Royalty is in ten-thousandths: 300 = 3%, 500 = 5%
• did_id: null in assign_nfts_to_did unassigns from DID
• Minting requires a DID for provenance