eIBC client
eIBC allows anyone to fulfill user withdrawal requests from RollApps based on their own preferences and risk profile. Operators running an eIBC client can choose which RollApps to fulfill orders for, which tokens to fulfill, and what fee to charge for each fulfillment. eIBC client by default also validates the rollapp to reduce fulfillment of potentially malicious transfers. You can read more about eIBC here.
This section outlines the process for setting up and running an eIBC client.
Requirements
This guide assumes you've already setup your environment and initialized your rollapp.
Hardware Requirements
- A Linux or macOS operating system
- At least 4GB of RAM
- At least 10GB of free disk space
- 1 CPU core
- At least 10 Mbps bandwidth
Setup eIBC Client
Validate Docker access
Before starting make sure your user have access to the docker daemon:
docker ps
If you see an error, please re-login to the docker group:
newgrp docker
In case this doesn't work, please go back to the setup environment section and make sure you completed all the steps.
Initialize eIBC client
initializing eIBC client creates a whale account which exists on Dymension and needs to be funded with the appropriate denoms we would like to fulfill.
DYM
funding is mandatory to be able to pay for the transactions fee on chain. Let's start by initializing the eIBC client:
roller eibc init
After successful initialization, you’ll see a whale account address and mnemonic phrase. Save these securely.
Configure eIBC client
Once the whale account is funded with the appropriate denoms we would like to fulfill, we can start whitelisting the rollapps and tokens we would like to operate.
In order to fulfill orders, we must whitelist both the rollapps and the tokens.
Whitelist RollApps
First lets start by whitelisting the rollapp:
roller eibc fulfill rollapps set <rollapp_id> <fee-in-percentage>
Whitelist tokens
Allows user to whitelist certain tokens they would like to fulfill.
In order to get the denom representation of the token on the dymension hub you can head to the token registry and use the Base
column to find the denom.
For a token to appear in the token registry, at least one token must be sent to the Dymension hub and complete a finalization period.
Once you have obtained the denom, you can set the fee for token fulfillment:
roller eibc fulfill denoms set <denom-on-the-token-registry> <fee-in-percentage>
Every configuration change requires a restart of the eIBC client.
Start eIBC client
After configuring the eIBC client, you can start the process by running one of the following commands:
- Foreground
- Background
roller eibc start
Load eIBC services
roller eibc services load
Start eIBC services
roller eibc services start
View balances
To view the balances associated with your eIBC client, you can check:
- The balance of the main 'whale' account
- The balance of individual 'bot' accounts
- An aggregate balance, including all accounts and any pending eIBC rewards
roller eibc funds