|
| 1 | +--- |
| 2 | +namespace-identifier: qubic-caip2 |
| 3 | +title: Qubic Namespace - Blockchain ID Specification |
| 4 | +author: ["Aleix (@aleishio)"] |
| 5 | +discussions-to: <URL of PR> |
| 6 | +status: Draft |
| 7 | +type: Standard |
| 8 | +created: 2025-02-20 |
| 9 | +requires: ["CAIP-2"] |
| 10 | +--- |
| 11 | + |
| 12 | +# CAIP-2 |
| 13 | + |
| 14 | +This document is about the details of the Qubic network namespace and reference for CAIP-2. |
| 15 | + |
| 16 | +## Abstract |
| 17 | + |
| 18 | +In [CAIP-2], a general blockchain identification scheme is defined. |
| 19 | +This is the implementation of CAIP-2 for Qubic network. |
| 20 | + |
| 21 | +## Specification |
| 22 | + |
| 23 | +### Namespace |
| 24 | + |
| 25 | +The namespace "qubic" refers to the wider Qubic ecosystem. |
| 26 | + |
| 27 | +### Reference Definition |
| 28 | + |
| 29 | +The reference for the Qubic mainnet is defined as follows: |
| 30 | + |
| 31 | +- `qubic:mainnet` |
| 32 | + |
| 33 | +### Testnet Consideration |
| 34 | + |
| 35 | +As of the creation date of this document, the Qubic blockchain operates solely on its mainnet. |
| 36 | +Should a testnet be introduced in the future, it will be assigned a distinct reference, such as: |
| 37 | + |
| 38 | +qubic:testnet |
| 39 | + |
| 40 | +## Semantics |
| 41 | + |
| 42 | +- **Namespace (`qubic`)**: Identifies the Qubic blockchain. |
| 43 | +- **Reference (`mainnet`)**: Specifies the primary live network of the Qubic blockchain. |
| 44 | + |
| 45 | +## Syntax |
| 46 | + |
| 47 | +The blockchain identifier for Qubic adheres to the following syntax: |
| 48 | + |
| 49 | +qubic:mainnet |
| 50 | + |
| 51 | +This identifier is case-sensitive and must be used exactly as specified. |
| 52 | + |
| 53 | +## Resolution Mechanics |
| 54 | + |
| 55 | +To resolve and interact with the Qubic blockchain using this identifier, clients should direct their requests to the official Qubic RPC endpoint: |
| 56 | + |
| 57 | +https://rpc.qubic.org |
| 58 | + |
| 59 | +This endpoint provides access to network statistics, smart contract interactions, and other blockchain-related data. |
| 60 | +Detailed API documentation is available at [Qubic RPC Documentation][RPC Docs]. |
| 61 | + |
| 62 | +## Backwards Compatibility |
| 63 | + |
| 64 | +This is the initial definition of the Qubic namespace under the CAIP-2 standard. |
| 65 | +There are no previous versions or legacy identifiers associated with this specification. |
| 66 | + |
| 67 | +## Test Cases |
| 68 | + |
| 69 | +To validate the correct implementation of the Qubic blockchain identifier, consider the following examples: |
| 70 | + |
| 71 | +- Valid Identifier: `qubic:mainnet` |
| 72 | +- Invalid Identifier: `Qubic:mainnet` (namespace must be lowercase) |
| 73 | +- Invalid Identifier: `qubic:MAINNET` (reference must be lowercase) |
| 74 | +- Invalid Identifier: `qubic:` (reference is required) |
| 75 | + |
| 76 | +## Additional Considerations |
| 77 | + |
| 78 | +Future updates to the Qubic network, such as the introduction of additional networks (e.g., testnets), will necessitate corresponding updates to this specification to include new references. |
| 79 | + |
| 80 | +## References |
| 81 | + |
| 82 | +- [Qubic RPC Documentation][RPC Docs] |
| 83 | + |
| 84 | +[RPC Docs]: https://qubic.github.io/integration/Partners/qubic-rpc-doc.html?urls.primaryName=Qubic%20RPC%20Archive%20Tree |
| 85 | +[CAIP-2]: https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md |
| 86 | + |
| 87 | +## Copyright |
| 88 | + |
| 89 | +Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/). |
| 90 | + |
0 commit comments