sage-nft

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
    }
  ],
  "did_id": "did:chia:...",
  "fee": "100000000",
  "auto_submit": true
}

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