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:
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
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