Stellar Namespace - Chains

Author Gleb Pitsevich
Status Draft
Type Standard
Created 2021-02-17
Updated 2022-03-27
Requires CAIP-2
Withdrawal reason CAIP-28


For context, see the CAIP-2 specification.


The namespace stellar refers to the wider Stellar ecosystem, including private networks.

Each Stellar network has its own unique passphrase, which is to sign the genesis block but also used when validating signatures on a given transaction to ensure it was intended for that chain. The current passphrases for the Stellar public main-net and public testnet, commonly referred to as pubnet and testnet respectively, are:

  • Pubnet: Public Global Stellar Network ; September 2015
  • Testnet: Test SDF Network ; September 2015


The reference relies on Stellar’s current designation of addresses belonging to test or main networks by prefixing them with testnet or pubnet correspondingly. As these are the only two documented public Stellar networks, the only known chain IDs are testnet and pubnet.

Resolution Method

To resolve a blockchain reference for the Stellar namespace, make a REST GET request to the Stellar Horizon node with endpoint / or REST GET request to the Stellar Core node with endpoint /info, for example:

// Request
curl -X GET "" -H "accept: application/json"
// Response
  "_links": {"...": "..."},
  "horizon_version": "2.0.0-rc-89ef5f86ac784d35e29845496e8e1bceac31298a",
  "core_version": "stellar-core 15.2.0 (54b03f755ae5d5aa12a799c8f1ee4d87fc9d1a1d)",
  "ingest_latest_ledger": 34073932,
  "history_latest_ledger": 34073932,
  "history_latest_ledger_closed_at": "2021-02-19T15:50:02Z",
  "history_elder_ledger": 2,
  "core_latest_ledger": 34073932,
  "network_passphrase": "Public Global Stellar Network ; September 2015",
  "current_protocol_version": 15,
  "core_supported_protocol_version": 15

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

The blockchain reference can be retrieved from network_passphrase response of Horizon or from the network response of Stellar Core.

Backwards Compatibility

Not applicable

Test Cases

This is a list of manually composed examples

# Testnet (Test SDF Network ; September 2015)
# Pubnet (Public Global Stellar Network ; September 2015)


Copyright and related rights waived via CC0.


Please cite this document as:

Gleb Pitsevich, "namespaces/stellar: Stellar Namespace - Chains [DRAFT]," Chain Agnostic Namespaces, stellar, February 2021 / March 2022. [Online serial]. Available: