Skip to main content

Create a Native Token

This guide will show you how you can efficiently mint new tokens and register them for use as ERC20 tokens with the createNativeTokenFoundry function in one seamless operation. It will create a foundry on L1 and register it as an ERC20 on L2. This method ensures that only the foundry owner can mint tokens, maintaining security and control over the token creation process.

About Foundries​

The Stardust update allows you to create your own native tokens. Native tokens are minted by a Foundry. The Foundry lets you specify your native token's maximum supply once and change the circulating supply.

Example Code​

Ownership

You might want to look into making the function ownable with, for example, OpenZeppelin so only owners of the contract can call certain functionalities of your contract.

1. Check the Storage Deposit​

Check if the amount paid to the contract is the same as the required storage deposit and set the allowance.

require(msg.value == _storageDeposit*(10**12), "Please send exact funds to pay for storage deposit");
ISCAssets memory allowance;
allowance.baseTokens = _storageDeposit;
Payable

Instead of making the function payable, you could let the contract pay for the storage deposit. If so, you will need to change the require statement to check if the contract's balance has enough funds:

require(address(this).balance > _storageDeposit);

2. Define the Token Scheme​

Define the NativeTokenScheme by specifying the maximumSupply.

NativeTokenScheme memory nativeTokenScheme = NativeTokenScheme({
    mintedTokens: 0,
    meltedTokens: 0,
    maximumSupply: _maximumSupply
});

3. Mint and Register Native Token​

Minting native tokens and registering them as ERC20 tokens using createNativeTokenFoundry method

uint32 foundrySN = ISC.accounts.createNativeTokenFoundry(
    _tokenName, 
    _tokenSymbol, 
    _tokenDecimals, 
    nativeTokenScheme, 
    allowance
);

Full Example Code​

pragma solidity ^0.8.0;

import "@iota/iscmagic/ISC.sol";

contract MyToken {
  event MintedToken(uint32 foundrySN); 

  constructor(
          string memory _tokenName, 
          string memory _tokenSymbol, 
          uint8 _tokenDecimals, 
          uint256 _maximumSupply,
          uint64 _storageDeposit
      ) payable {
          require(msg.value == _storageDeposit * (10**12), "Please send exact funds to pay for storage deposit");
          ISCAssets memory allowance;
          allowance.baseTokens = _storageDeposit;

          NativeTokenScheme memory nativeTokenScheme = NativeTokenScheme({
              mintedTokens: 0,
              meltedTokens: 0,
              maximumSupply: _maximumSupply
          });

          uint32 foundrySN = ISC.accounts.createNativeTokenFoundry(
              _tokenName, 
              _tokenSymbol, 
              _tokenDecimals, 
              nativeTokenScheme, 
              allowance
          );
          emit MintedToken(foundrySN);
      }
}