The Unified Indexer Service (UIS) is our next-generation blockchain indexing technology. Previously only available on our SaaS platform, the UIS is available for on-premises customers from v1.26. It introduces a decomposed, chain-specific adapter architecture that allows Ripple Custody to add new blockchain integrations faster and at scale, while improving resilience, performance, and operational simplicity.
For a complete and up-to-date list of which ledgers are supported, please refer to the Supported blockchain ledgers page.
Ripple Custody supports a wide range of blockchains. Depending on the chain, indexing is handled either by the Unified Indexer Service (UIS) or by a standalone indexer. Upon upgrade to v1.26:
- Solana, TRON and XRPL use the UIS. They do not require any additional configuration.
- Arbitrum, Base and Optimism must be configured to use the UIS to be operable. See Configuration for more detail.
- Ethereum and Stellar continues to use existing standalone indexers unless you explicitly configure them to use UIS. See Configuration for more detail.
These requirements are current as of the v1.26 LTS release in October 2025.
For an on-premises deployment of the UIS, you are responsible for provisioning and maintaining your own blockchain nodes. The service must be able to connect to these nodes to index transactions. Please ensure your nodes meet the following minimum specifications.
| Blockchain | Node type | Minimum version | Connection | Archive requirement | Additional details |
|---|---|---|---|---|---|
| Arbitrum | Geth compatible | v3.7.X | JSON-RPC over HTTP | Non-Archive | Debug mode must be enabled. |
| Base | Geth compatible | v0.14.1 | JSON-RPC over HTTP | Non-Archive | Debug mode must be enabled. |
| Ethereum | Geth | v1.16.4 | JSON-RPC over HTTP | Archive (Required) | Debug APIs must be enabled. High request volume (~1.2k - 300k/hour). |
| Optimism | Geth compatible | v1.101511 | JSON-RPC over HTTP | Non-Archive | Debug mode must be enabled. |
| Solana | Agave | mainnet 2.3.10 / devnet 3.0.0 | JSON-RPC over HTTP | Archive Recommended | Estimated request volume is ~9000/hour. No debug mode needed. |
| Stellar | Horizon | v23.0.0 | HTTP | Archive (Preferred) | Requires application/x-www-form-urlencoded content-type for broadcasting transactions. |
| TRON | FullNode | v4.8.0 | RPC over HTTP | Archive (Preferred) | Estimated request volume is ~150k/day. |
| XRPL | FullNode | 2.6.X | HTTP | Archive Recommended | Request volume is not based on tracked accounts. |
For SaaS customers, no configuration is required.
For on-premises UIS is available upon upgrade to v1.26 or later. When enabled, Solana, XRPL, and TRON use UIS without any additional configuration required. For any other chain, you must specify that they use UIS by navigating to the ledgers section in the helm chart and setting the type parameter to uis for that network's configuration block.
EVM chains like Arbitrum, Base, and Optimism will not work unless configured to use UIS.
Migrating a chain to the Unified Indexer is a one-way process and cannot be rolled back.
Please plan your migration carefully. For any questions about the deployment process, please contact your CPE or our Support team.
The example code below shows the correct structure for enabling the UIS for an Optimism Sepolia testnet.
ledgers:
evm:
networks:
- name: optimism-sepolia
type: "uis"
raw_config: |
tracker.opindexer-sepolia.base-url = "http://api-management-uis"
...
indexer:
...
node:
# URL for your provisioned Optimism Sepolia node.
url: "http://your-optimism-sepolia-node-url"