dbd517b279
- Update dbis_core, cross-chain-pmm-lps, explorer-monorepo, metamask-integration, pr-workspace/chains - Omit embedded publish git dirs and empty placeholders from index Made-with: Cursor
38 lines
3.6 KiB
Markdown
38 lines
3.6 KiB
Markdown
# XDC Zero + Chain 138 — config templates
|
|
|
|
Templates for pairing **DBIS Chain 138** with **XDC Network mainnet** JSON-RPC (`https://rpc.xinfin.network`, chain id 50) or Apothem/devnet, using the [XDC-Zero](https://github.com/XinFinOrg/XDC-Zero) Endpoint pattern, **without** replacing your existing subnet↔parent XDC-Relayer deployment.
|
|
|
|
## XDC Network (parent) — facts for XDC Zero
|
|
|
|
| Item | Mainnet | Testnet (Apothem) |
|
|
|------|---------|-------------------|
|
|
| Chain ID | **50** (`0x32`) | **51** (`0x33`) |
|
|
| Gas / native currency | **XDC** (not ETH) | **TXDC** (testnet) |
|
|
| Default JSON-RPC (this repo) | `https://rpc.xinfin.network` | `https://rpc.apothem.network` |
|
|
| More RPC URLs | [Chainlist — XDC (50)](https://chainid.network/chain/50/) | [Chainlist — Apothem (51)](https://chainid.network/chain/51/) |
|
|
| Block explorers | [xdcscan.com](https://xdcscan.com), [xdcscan.io](https://xdcscan.io) | Apothem explorers on Chainlist |
|
|
| Project / docs hub | [xinfin.org](https://xinfin.org) | — |
|
|
|
|
`PARENTNET_URL` / `XDC_PARENTNET_URL` must be **XDC-compatible** JSON-RPC. Variables such as `ETHEREUM_MAINNET_RPC` are for other workflows (verification, CCIP) and are **not** substitutes for the XDC parent endpoint.
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| [`xdc-zero-chain138-pair.example.env`](xdc-zero-chain138-pair.example.env) | Env vars for the **second** relayer pair (parent ↔ 138). Includes both operator-only Core RPC guidance and the public RPC values relayer/services should actually use. |
|
|
| [`xdc-relayer.dotenv.example`](xdc-relayer.dotenv.example) | Clone-local `.env` for a manually run **XDC-Relayer** checkout (`node dist/server.js`). |
|
|
| [`xdc-zero-relayer-138-pair.example.defaults`](xdc-zero-relayer-138-pair.example.defaults) | `/etc/default/xdc-zero-relayer-138-pair` example for the **systemd** unit. |
|
|
| [`network.config.xdc-mainnet.example.json`](network.config.xdc-mainnet.example.json) | Example `network.config.json` for XDC-Zero `endpoint/`: **XDC mainnet** `https://rpc.xinfin.network` + LAN Chain 138. Merge or copy keys into your clone. |
|
|
| [`endpointconfig.fragment.chain138.example.json`](endpointconfig.fragment.chain138.example.json) | Top-level **`chain138`** block to **merge** into XDC-Zero `endpointconfig.json`. Also **append** one object to existing `xdcparentnet.registers[]` for peer chain id 138 (see runbook). |
|
|
| [`xdcparentnet-register-chain138.fragment.json`](xdcparentnet-register-chain138.fragment.json) | Single **`registers[]`** entry (chain id **138**) consumed by the merge helper for `xdcparentnet`. Replace zero addresses after CSC/Endpoint deploy. |
|
|
|
|
**Scripts:** [scripts/xdc-zero/README.md](../../scripts/xdc-zero/README.md) — full list; start with `run-xdc-zero-138-operator-sequence.sh`.
|
|
|
|
**Troubleshooting:** [docs/03-deployment/CHAIN138_XDC_ZERO_DEPLOYMENT_TROUBLESHOOTING.md](../../docs/03-deployment/CHAIN138_XDC_ZERO_DEPLOYMENT_TROUBLESHOOTING.md)
|
|
|
|
**systemd (second relayer):** [`../systemd/xdc-zero-relayer-138-pair.example.service`](../systemd/xdc-zero-relayer-138-pair.example.service) + [`xdc-zero-relayer-138-pair.example.defaults`](xdc-zero-relayer-138-pair.example.defaults). Use [`xdc-relayer.dotenv.example`](xdc-relayer.dotenv.example) only for a clone-local relayer `.env`.
|
|
|
|
**Canonical procedure:** [docs/03-deployment/CHAIN138_XDC_ZERO_BRIDGE_RUNBOOK.md](../../docs/03-deployment/CHAIN138_XDC_ZERO_BRIDGE_RUNBOOK.md)
|
|
|
|
**Preflight:** `bash scripts/verify/xdc-zero-chain138-preflight.sh`
|
|
|
|
Upstream repos (clone separately): [XDC-Zero](https://github.com/XinFinOrg/XDC-Zero), [XDC-CSC](https://github.com/XinFinOrg/XDC-CSC), [XDC-Relayer](https://github.com/XinFinOrg/XDC-Relayer).
|