Prepare Your Development Environment

To run the code in this tutorial, you will need the following:

• Node.js 16.

• The @iota/iota.js library

• The iota.js auxiliary libraries:

  • @iota/crypto.js
  • @iota/util.js.
  • @iota/pow-neon.js to run Proof of Work (PoW). Alternatively, you can spin up your own node to run the PoW remotely.

• Access to a Stardust Node (Hornet 2.0.0). You can use the Shimmer testnet Nodes at https://api.testnet.shimmer.network.

• (Optional) A TypeScript compiler and related packages

(optional) Download the Code

You can download the tutorials codebase to follow while you read the next sections.

Running Code Examples

If you plan on using the provided code example, please read the article How To Run Code Examples.

Shimmer Addresses and Outputs

The tutorial's codebase uses several predefined Shimmer addresses and outputs. If you are going to use other addresses, you will need to update the code accordingly. Likewise, the tutorial codebase assumes a particular state of the addresses and Outputs. Before executing the code, please ensure your addresses and Outputs are in the expected state.

Available Commands

Mint Native Tokens

You can run the mint-native-tokens script by running the following command from the example's directory:

npm run mint-native-tokens

Transfer Native Tokens

You can run the native-tokens-transaction script by running the following command from the example's directory:

npm run native-tokens-transaction

Melt Native Tokens

You can run the melt-native-tokens script by running the following command from the example's directory:

npm run melt-native-tokens

Create Your package.json File

You can create your package.json file from the example below and place it in your projects base directory:

{
  "name": "tutorial",
  "type": "module",
  "version": "1.0.0",
  "scripts": {
    "dist": "tsc",
    "mint-tokens": "node dist/mint-tokens",
    "native-tokens-transaction": "node dist/native-tokens-transaction",
    "melt-tokens": "node dist/melt-tokens"
  },
  "dependencies": {
    "@iota/crypto.js": "2.0.0-rc.1",
    "@iota/iota.js": "2.0.0-rc.2",
    "@iota/util.js": "2.0.0-rc.1",
    "@iota/pow-neon.js": "2.0.0-rc.2"
  },
  "devDependencies": {
    "typescript": "^4.4.3",
    "@types/node": "18.7.23"
  }
}

After you have created the package.json file, you can install all the necessary dependencies by running the following command from the same directory:

npm install

Troubleshooting

If you are getting any errors during the installation process please make sure your system is using Node.js 16. You can check your node version by running the following command:

node -v