Filtered by

cardano logo

Accessing the IELE Faucet

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:

  1. Through Remix (web-based IDE).
  2. Through Mallet (command line wallet).
  3. Using the faucet website.
  4. Through an HTTP request (command line with curl).

Let’s go into each in detail.

Through Remix

To use Remix to request tokens, do the following:

  1. Go to the Remix site.
  2. Select the Run tab.
  3. In the Environment field, select the IELE testnet.

  4. 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.

  5. Make sure the correct account address is selected.
  6. Click [Request from Faucet].

That’s it, now you have tokens that you can use to deploy and test your smart contracts.

Through Mallet (command line wallet)

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.

Using the faucet website

Another option to get test tokens is directly from the faucet website.

  1. First create an account address. It can be done through Remix, or through Mallet (see previous sections).

  2. Copy the address in the faucet site: https://testnet.iohkdev.io/goguen/iele/faucet/.

  3. In 5-10 minutes, your tokens will be available.

Through an HTTP request

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: https://staging.iele.dev-mantis.iohkdev.io:8546/?address=0x00000000000000000000000000000000000001

  • The test tokens are automatically sent to the address specified within the URL string, for example: address=0x00000000000000000000000000000000000001 and will be ready to use for your smart contracts.

Return values

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.

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.

Next navigation arrow