Features

The Stardust protocol introduced multiple new output features that allow you to add metadata, a sender (or issuer in the case of NFTs) or tag them by adding some small indexation data to the output.

Client in Wallet

If you are using a wallet you can always get the client by calling the client()/getClient()/get_client() method

Output Features

Different outputs can have different features. This table shows you which output has which features. You can find the output specs in TIP-018

Output	Sender	Metadata	Immutable Metadata	Tag	Immutable Issuer
Basic	x	x		x
Alias	x	x	x		x
Foundry		x	x
NFT	x	x	x	x	x

Example Code

Rust

1. Create multiple NFT outputs using the NftOutputBuilder and use the NftOutputBuilder.add_feature function to add the following features:

• SenderFeature.

sdk/examples/how_tos/outputs/features.rs

loading...

See full example on GitHub

• MetadataFeature.

sdk/examples/how_tos/outputs/features.rs

loading...

See full example on GitHub

• TagFeature.

sdk/examples/how_tos/outputs/features.rs

loading...

See full example on GitHub

2. Add the following immutable features:

• IssuerFeature as an immutable feature.

sdk/examples/how_tos/outputs/features.rs

loading...

See full example on GitHub

• MetadataFeatureas an immutable feature.

sdk/examples/how_tos/outputs/features.rs

loading...

See full example on GitHub

Typescript (Node.js)

1. Create multiple NFT outputs with all possible features using the Client.buildNftOutput() function and add the following features:

• SenderFeature.

bindings/nodejs/examples/how_tos/outputs/features.ts

loading...

See full example on GitHub

• MetadataFeature.

bindings/nodejs/examples/how_tos/outputs/features.ts

loading...

See full example on GitHub

• TagFeature.

bindings/nodejs/examples/how_tos/outputs/features.ts

loading...

See full example on GitHub

2. Add the following immutable features:

• IssuerFeature.

bindings/nodejs/examples/how_tos/outputs/features.ts

loading...

See full example on GitHub

• MetadataFeature.

bindings/nodejs/examples/how_tos/outputs/features.ts

loading...

See full example on GitHub

Python

1. Create multiple NFT outputs using the Client.build_nft_output() function and add the following features:

• SenderFeature.

bindings/python/examples/how_tos/outputs/features.py

loading...

See full example on GitHub

• MetadataFeature.

bindings/python/examples/how_tos/outputs/features.py

loading...

See full example on GitHub

• TagFeature.

bindings/python/examples/how_tos/outputs/features.py

loading...

See full example on GitHub

2. Add the following immutable features:

• IssuerFeature.

bindings/python/examples/how_tos/outputs/features.py

loading...

See full example on GitHub

• MetadataFeature.

bindings/python/examples/how_tos/outputs/features.py

loading...

See full example on GitHub

Full Example Code

Rust

sdk/examples/how_tos/outputs/features.rs

loading...

See full example on GitHub

Typescript (Node.js)

bindings/nodejs/examples/how_tos/outputs/features.ts

loading...

See full example on GitHub

Python

bindings/python/examples/how_tos/outputs/features.py

loading...

See full example on GitHub

Expected Output

[
  {
    "type": 6,
    "amount": "49300",
    "nftId": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "unlockConditions": [
      {
        "type": 0,
        "address": {
          "type": 0,
          "pubKeyHash": "0x7ffec9e1233204d9c6dce6812b1539ee96af691ca2e4d9065daa85907d33e5d3"
        }
      }
    ],
    "features": [
      {
        "type": 0,
        "address": {
          "type": 0,
          "pubKeyHash": "0x7ffec9e1233204d9c6dce6812b1539ee96af691ca2e4d9065daa85907d33e5d3"
        }
      }
    ]
  },
  {
    "type": 6,
    "amount": "49300",
    "nftId": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "unlockConditions": [
      {
        "type": 0,
        "address": {
          "type": 0,
          "pubKeyHash": "0x7ffec9e1233204d9c6dce6812b1539ee96af691ca2e4d9065daa85907d33e5d3"
        }
      }
    ],
    "immutableFeatures": [
      {
        "type": 1,
        "address": {
          "type": 0,
          "pubKeyHash": "0x7ffec9e1233204d9c6dce6812b1539ee96af691ca2e4d9065daa85907d33e5d3"
        }
      }
    ]
  },
  {
    "type": 6,
    "amount": "47500",
    "nftId": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "unlockConditions": [
      {
        "type": 0,
        "address": {
          "type": 0,
          "pubKeyHash": "0x7ffec9e1233204d9c6dce6812b1539ee96af691ca2e4d9065daa85907d33e5d3"
        }
      }
    ],
    "features": [
      {
        "type": 2,
        "data": "0x48656c6c6f2c20576f726c6421"
      }
    ]
  },
  {
    "type": 6,
    "amount": "47500",
    "nftId": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "unlockConditions": [
      {
        "type": 0,
        "address": {
          "type": 0,
          "pubKeyHash": "0x7ffec9e1233204d9c6dce6812b1539ee96af691ca2e4d9065daa85907d33e5d3"
        }
      }
    ],
    "immutableFeatures": [
      {
        "type": 2,
        "data": "0x48656c6c6f2c20576f726c6421"
      }
    ]
  },
  {
    "type": 6,
    "amount": "47400",
    "nftId": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "unlockConditions": [
      {
        "type": 0,
        "address": {
          "type": 0,
          "pubKeyHash": "0x7ffec9e1233204d9c6dce6812b1539ee96af691ca2e4d9065daa85907d33e5d3"
        }
      }
    ],
    "features": [
      {
        "type": 3,
        "tag": "0x48656c6c6f2c20576f726c6421"
      }
    ]
  }
]