Faucets

This page describes how to receive imETH and imua tokens via the faucet.

imETH

imETH is a testnet token used for staking. It has no real value. The way to obtain imETH via our faucet is listed below. You will need some Sepolia ETH to pay for gas, and your Ethereum private key.

This faucet gives out 25 imETH every 24 hours per requesting address.

# script constants
IM_ETH_FAUCET_ADDR=0xfCf79695f63FB9e540a1887A19dA94e10ADF13eB

# user input
ETH_PRIVATE_KEY=0xabcde....
ETHEREUM_RPC_URL=https://rpc.ankr.com/eth_sepolia

cast send --rpc-url $ETHEREUM_RPC_URL \
    $IM_ETH_FAUCET_ADDR \
    "requestTokens()" \
    --private-key $ETH_PRIVATE_KEY

The expected output looks similar to that of any other transaction.

blockHash               0x496b22768c38687dedeaf1f6b3823b0973b25ae90ea961e702f6dd4ba82a980a
blockNumber             6679149

<! -- truncated -->

transactionHash         0x24426c2acf0e6a411961f478bca68a36c12ed0bff3d7206cd1cd7662908d40cf
transactionIndex        84
type                    2
blobGasPrice            
blobGasUsed             
authorizationList       
to                      0x8fc4E764C2C3B0646ba572AEa958fB5724706412

IMUA

IMUA is the native token for Imua, used to pay for gas. It can only be obtained once the network is live (post the bootstrap phase). Use our faucet to obtain this token. The token on testnet has no real value.

FAUCET_URL=https://241009-faucet.exocore-restaking.com/
IM_ADDRESS=$(imuad --home $HOMEDIR keys show -a $ACCOUNT_KEY_NAME)

curl -X POST $FAUCET_URL -H "Content-Type: application/json" \
    -d "{\"address\": \"$IM_ADDRESS\"}"

The response is a json containing the transaction hash, which can be tracked on our explorer

{"txHash":"0x3977c552862fc4c24f6f44792182b61524af3118cf6bad4e1e2aeacdcbe32e74"}

Quick start for non-node runners

For people other than node runners looking to quickly obtain some IMUA tokens for gas, here's the process to follow.

Obtain an im1 address. There are two ways to do this:

  1. Download and install imuad, initialize a folder, and add your own key (or recover it from a mnemonic). This is the recommended method because it will allow you to interact with Imua-specific CLI functions. Post this step, you can follow the method highlighted above for IMUA.

# Download and install imuad
pushd /tmp
VERSION="1.1.3"
wget -O imuad_${VERSION}.tar.gz "https://github.com/imua-xyz/imuachain/releases/download/v${VERSION}/imuachain_${VERSION}_$(uname -s)_$(uname -m | sed 's/x86_64/amd64/' | sed 's/aarch64/arm64/').tar.gz"
tar -xvzf imuad_${VERSION}.tar.gz
# You can choose any location in $PATH
sudo mv bin/imuad /usr/bin/
popd
# Initialize imuad
CHAIN_ID="imuachaintestnet_233-9"
MONIKER="moniker"
# If you leave this value unchanged, you can skip typing out
# `--home $HOMEDIR` with each command.
HOMEDIR="/home/$USER/.imuad"
imuad --home $HOMEDIR init $MONIKER --chain-id $CHAIN_ID
imuad --home $HOMEDIR config chain-id $CHAIN_ID
# Choose the keyring backend as file, which would need a password
# when using any key. For faster testing, you may consider `test` instead of
# `file` which is plaintext.
imuad --home $HOMEDIR config keyring-backend file
# Add your own key. If you have a mnemonic to reuse, pass `--recover`.
# Otherwise, one will be generated for you.
ACCOUNT_KEY_NAME="my_key"
imuad --home $HOMEDIR keys add $ACCOUNT_KEY_NAME
  1. If you'd like to continue using your existing ETH address, you can simply send it to the faucet.

FAUCET_URL=https://241009-faucet.exocore-restaking.com/
ETH_ADDRESS=0x123...

curl -X POST $FAUCET_URL -H "Content-Type: application/json" \
    -d "{\"address\": \"$ETH_ADDRESS\"}"

To convert your ETH address to the im1 address, follow these steps (needs: imuad, jq).

ETH_ADDRESS=0x123...
CAPS_ADDRESS=$(echo "${ETH_ADDRESS}" | sed 's/^0x//' | tr '[:lower:]' '[:upper:]')
IM_ADDRESS=$(imuad keys parse "${CAPS_ADDRESS}" --output json | jq -r '.formats.[0]')
echo $IM_ADDRESS

To convert your im1 address to ETH address, follow these steps (needs: cast, imuad, jq).

IM_ADDRESS=im1...
ETH_ADDRESS=$(imuad keys parse $IM_ADDRESS --output json | jq -r .bytes | cast 2a)
echo $ETH_ADDRESS

When interacting with the network, use our hosted RPC.

IMUA_COS_GRPC_URL=https://api-cosmos-grpc.exocore-restaking.com:443
imuad --node $IMUA_COS_GRPC_URL query ....
imuad --node $IMUA_COS_GRPC_URL tx ....

Last updated