XRP Ledger Namespace - Chains

CAIP-2.

For context, see the CAIP-2 specification.

Rationale

The namespace xrpl refers to the XRP Ledger ecosystem, including its alternative testing and development networks.

The XRP Ledger ecosystem consists of several different blockchains. There is one production network called livenet where all business on the XRP Ledger takes place, a testing network called testnet for stable releases and a development network called devnet for beta releases. There are also some preview networks for particularly large network changes. The networks are identified by a numerical network_id.

An identifier for an XRPL chain consists of the xrpl namespace prefix followed by the chain’s unique network_id, an unsigned integer, i.e. xrpl:{network_id}.

Syntax

A network id in the XRP Ledger ecosystem is defined as an unsigned integer ranging from 0 to 4294967295.

Resolution Method

To resolve a network reference for a XRPL network, POST a RPC request to the XRPL node with endpoint / for example:

// Request
curl --location --request POST "https://xrplcluster.com/" \
--header 'Content-Type: application/json' \
--data-raw '{
    "method": "server_info",
    "params": [ ]
}'
// Response
{
    "result": {
        "info": {
            "build_version": "1.9.4",
            "complete_ledgers": "32570-77992447",
            "hostid": "LEST",
            "initial_sync_duration_us": "328508164",
            "io_latency_ms": 1,
            "jq_trans_overflow": "9048",
            "last_close": {
                "converge_time_s": 3.001,
                "proposers": 34
            },
            "load_factor": 1,
            "network_id": 0,
            "peer_disconnects": "29",
            "peer_disconnects_resources": "0",
            "peers": 23,
            "pubkey_node": "n9KQK8yvTDcZdGyhu2EGdDnFPEBSsY5wEgpU5GgpygTgLFsjQyPt",
            "server_state": "full",
            "server_state_duration_us": "35758622131",
            "state_accounting": {"..."},
            "time": "2023-Feb-23 13:24:41.285216 UTC",
            "uptime": 700794,
            "validated_ledger": {"..."},
            "validation_quorum": 28
        },
        "status": "success"
    }
}

The response will return a JSON object which will include server information.

The network reference can be retrieved from the field response.info.network_id in the response of the server_info RPC request.

Backwards Compatibility

Not applicable

Test Cases

This is a list of manually composed examples

# Livenet
xrpl:0

# Testnet
xrpl:1

# Devnet
xrpl:2

# AMM - Devnet
xrpl:25

References

• XRPL Documentation
• XRPL Networks - Description of the different XRPL networks.
• XRPL Public Nodes - Public nodes for the different XRPL networks.
• XRPL Server Info Request - RPC request to get the network_id.
• XRPL Network ID - The definition of the network_id value.
• CAIP-2

Copyright

Copyright and related rights waived via CC0.

Citation

Please cite this document as:

Anton Dalgren, "namespaces/xrpl-caip2: XRP Ledger Namespace - Chains [DRAFT]," Chain Agnostic Namespaces, xrpl-caip2, February 2023 / . [Online serial]. Available: https://github.com/ChainAgnostic/namespaces/xrpl-caip2.md