How to Set Up an XRPL Project Profile

Published: July 29, 2026·Updated: July 29, 2026

A clear public identity helps users recognize your XRPL project, find its official account, and distinguish it from impersonators. This guide connects your account, project name, website, and public information on XRP Ledger.

It is intended for wallets, exchanges, NFT platforms, infrastructure providers, applications, communities, non-profits, and other projects using the XRP Ledger. You do not need to issue a token.

Before you start: choose the public project account

Choose the XRPL account that should represent the project publicly. Use the same account throughout the steps below.

• Use an account intended to be publicly associated with the project.
• Make sure the project retains secure signing access before changing on-ledger settings.
• Use the same official name, domain, logo, and social accounts across your website and profiles.

1. Register a username

A username gives the project account a memorable public name and makes it easier to find on XRP Ledger and services using Bithomp data.

Choose a name that matches the project’s official branding. The registration must be signed by the account owner.

2. Register the project or service

Submit the project’s public details to Bithomp so we can make its account recognizable on our explorers and provide the profile through the Bithomp API.

Provide the official service name, description, website, logo, contact email, and social accounts. We store and publish this information, so submit only public project details and keep them consistent with your website.

3. Publish xrp-ledger.toml

Serve the file over HTTPS at this exact location:

https://{DOMAIN}/.well-known/xrp-ledger.toml

For a project profile without a token, focus on the organization and its public accounts:

• [[PRINCIPALS]] — describes the entity or people operating the project.
• [[ACCOUNTS]] — lists the XRPL accounts officially controlled by the project.

You do not need a [[TOKENS]] section unless the project also issues a token. Generate the file, publish it on your domain, and validate the live URL.

4. Set the domain on the XRPL account

The account’s Domain field is an on-ledger claim that the account belongs to your website. Sign in with the chosen project account and set its official domain.

Enter only the domain name, without a path. For example: example.com.

5. Verify the domain

Verification requires a two-way link. Setting only the account Domain field or publishing only the TOML file is not enough.

1. The domain claims the account by listing its address under [[ACCOUNTS]] in xrp-ledger.toml.
2. The XRPL account claims the same domain in its on-ledger Domain field.

6. Review the public project profile

Open the project account on XRP Ledger and review it as a user would see it.

• The username and service name identify the correct project.
• The domain is correct and shows as verified after both claims are detected.
• The website, logo, and social links lead to official resources.
• The displayed XRPL address is the account you intend to publish.

Keep the profile current

Update the submitted service information and TOML file when the project changes its name, website, logo, social accounts, or public XRPL addresses. Remove obsolete accounts and links.

Never publish secret keys, seeds, recovery phrases, validator tokens, private contact information, or internal infrastructure credentials.

Project profile checklist

• Username registered for the public project account
• Project or service information submitted
• xrp-ledger.toml published and validated
• Official domain set on the XRPL account
• Two-way domain verification completed
• Public account page reviewed for accuracy