- Get started
The faucet provides test tokens so you can run smart contracts on the IELE testnet.
By using the faucet, you can request test tokens. These are supplied automatically.
Note: Please do not try to use real cryptocurrency on the testnets. You should take care to ensure that you only use test tokens when running your smart contracts, and these are obtained through the faucet. Instructions on how to receive test tokens are below.
There are four ways to get test tokens from the faucet:
Let’s go into each in detail.
To use Remix to request tokens, do the following:
In the Environment field, select the IELE testnet.
If it’s your first time requesting tokens, you will need to create an account. if not, you will import an existing account.
a) Create an account In the Account field, press plus sign or click the [Create account] button. Enter a password and your account will be created
b) Import an existing account. Click the [Import account] button. Type the password and your account will be made available.
That’s it, now you have tokens that you can use to deploy and test your smart contracts.
Mallet is the minimum wallet and runs on the command line. It is a new project and it only works for the IELE and KEVM testnets. Once you have it installed, using Mallet to request tokens from the faucet is easy:
#executes the Mallet wallet $ mallet https://iele-testnet.iohkdev.io:8546 #creates a new account and returns an address mallet> newAccount() #address created in the previous step mallet> selectAccount(<account address>) mallet> requestFunds() #verify you have received tokens mallet> getBalance()
Now that you have tokens, you can deploy your smart contracts.
You can see the above commands live in the video tutorial for Mallet.
Another option to get test tokens is directly from the faucet website.
First create an account address. It can be done through Remix, or through Mallet (see previous sections).
Copy the address in the faucet site: https://testnet.iohkdev.io/goguen/iele/faucet/.
In 5-10 minutes, your tokens will be available.
You can also get tokens directly using an HTTP request.
To access the faucet, simply:
Send a POST HTTP request to the faucet URL, for example:
The test tokens are automatically sent to the address specified within the URL string, for example:
and will be ready to use for your smart contracts.
The following outcomes are possible:
A success response is returned with the transaction ID and tokens are routed to the account. The status of the transaction can be monitored using the blockchain explorer.
An error message of type 429 is returned if you have exceeded the number of requests allowed from a single IP address. You will have to wait for a short time before trying again.
An error message of type 500 is returned if there is a problem with the faucet server.
There is a configurable limit on the rate of requests from a single IP address. This limit is defined by the min-request-interval field in the faucet.conf file. It should be set to a minute (one request from a given IP address per minute).
Tip: If your smart contract is large, you might need to access the faucet several times to make sure you have enough tokens for your testing.