Skip to main content
Version: v1.3

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);
}
}