Now that we have a RollApp deployed, we can list it on the Dymension Portal. This will allow other users to discover and interact with the RollApp.
Only developers with the
RollApp-fam discord role are eligible for listing their RollApp on the portal.
Interacting with the RollApp
- RollApp RPC Endpoint (default port
- Rest Endpoint (default port
- JSON RPC Endpoint (default port
8545. Only relevant for EVM RollApps)
If you are using a self-signed certificate for https, please add it to your browser's trusted certificates.
List Your RollApp
The following steps are required for listing a RollApp on the Portal:
Make sure to have successfully deployed and are running a RollApp instance.
Fund the Faucet and test the IBC connection by submitting an IBC transfer of your RollApp token to the Dymension Hub faucet with the following command:
roller tx fund-faucet
Subsequently, check the balance of the RollApp token on the Dymension Hub faucet which should arrive within 15 minutes:
$balance dym1g8sf7w4cz5gtupa6y62h3q6a4gjv37pgefnpt5 <RollApp-ID>
Fork the RollApp-registry repo into your GitHub account:
Clone it by running the following command:
git clone https://github.com/<your-github-username>/rollapp-registry
CD into the cloned repo:
Retrieve your generated rollapp id with
roller config showand save it as an environment variable:
Create the appropraite folders and files:
mkdir -p $ROLLAPP_ID/logos
cd $ROLLAPP_ID && touch $ROLLAPP_ID.json
This should create a folder for your RollApp logo and config information.
Add your RollApp logo to the
logosfolder. Logo file name:
<RollApp-ID>.<format>. This can be SVG, PNG, or JPG format.
Please make sure the file doesn't exceed 50KB.
Export the RollApps configuration JSON by running:
roller config export
Copy paste the JSON output to the
<RollApp-ID>.jsonand fill in the following fields:
"http://<your-ip-or-domain>:<port>" (default port 26657)
"http://<your-ip-or-domain>:<port>" (default port 1317)
c. EVM RPC *(ONLY FOR EVM ROLLAPPS):
"http://<your-ip-or-domain>:<port>" (default port 8545)
d. Logo path:
e. chainName: switch
<RollApp-ID>to your RollApp's name as it will appear on the Portal
f. description: add
"<Your RollApp description>",to be displayed on the portal
g. website: add
"<your-RollApp's-url>",to be displayed on the portal
Add and commit your changes:
git add .
git commit -m "added RollApp"
git push -u origin main
- Create a PR to https://github.com/dymensionXYZ/rollapp-registry.
- Pair the RollApp on the Discord channel by entering the following command:
In the following command replace
<RollApp-ID> with your customized RollApp ID.
A community moderator will then begin a conversation with you in Discord. Please follow attentively to get the listing process fulfilled quickly.
If you have any question please feel free to reach out to the coreteam and community on Discord. We're here for you!