> For the complete documentation index, see [llms.txt](https://docs.zetrix.com/zetrix-l2-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zetrix.com/zetrix-l2-documentation/reference/appendix.md). # Appendix ## Glossary | Term | Definition | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Layer 2 (L2) | Scaling layer executing off L1, settling to L1 | | Optimistic (fraud-proof) model | L2 assuming validity, secured by fraud proofs and a challenge window | | AnyTrust | DA model where a committee attests off-chain data, **falling back to L1 calldata** if it can't reach its attestation threshold — Z2's classification (an optimistic rollup with AnyTrust DA, à la Arbitrum Nova) | | DAC (Data Availability Committee) | 5-member committee that attests batch data is stored and retrievable; watchers fetch from it to re-execute | | Calldata fallback | Sequencer posting the **full batch as L1 calldata** when the DAC can't attest — ensures no silent DA loss | | Sequencer Inbox | L1 contract recording the ordered batch sequence; also accepts **force-included** user transactions | | Rollup (contract) | L1 contract holding the chain of state **assertions**; confirms them after the challenge window (`createAssertion`) | | Bridge & Outbox | L1 contracts custodying bridged assets (ZTP-20/ZTP-721); Outbox processes withdrawals via **Merkle proof** | | Commitment | Compact on-L1 reference to a batch whose full data is attested by the DAC (or posted as calldata) | | Batch | Bundle of ordered L2 transactions | | Force-inclusion (escape hatch) | User-initiated inclusion via the L1 Sequencer Inbox if the Sequencer censors | | Fail-closed | Design principle: the pipeline halts on uncertain L1 reads rather than proceeding | | z2-signer | Hardware-backed (HSM) signing service for operator/app keys | | Assertion | On-chain claim of L2 state, proposed by the Proposer and soft-confirmed by the Committee | | Soft confirmation | Fast Committee-backed acknowledgement | | Final confirmation | L1-enforced settlement after challenge window | | Challenge window | Period during which assertions can be disputed | | Fraud proof | Evidence submitted to L1 that an assertion is invalid | | Dispute game | On-chain adjudication of a contested assertion | | Committee | 5 Validator+Reexecutor bundles, **3-of-5** voting, that sign the Proposer's assertion and manage the DAC | | Aggregator | Combines Committee signatures into a compact proof | | Proposer | Proposes assertions to L1 (also runs a Watcher role) | | Watcher | Independent verifier that fetches DAC data, re-executes, and disputes; earns rewards for honest disputes | | Reexecutor | Deterministic replay/verification engine | | Relayer | L1→L2 deposit synchronizer | | Refueler | Auto top-up service for operational EOAs | | wZETRIX | Wrapped Zetrix; ERC-20-style ZETRIX on L2 | | EOA | Externally owned (key-controlled) account | | QBFT | (Q)Byzantine Fault Tolerant consensus | | ZTP-20 / ZTP-721 | Zetrix fungible-token / NFT standards (bridged assets) | | Chain ID | `938748` (current Testnet) | ## Architecture Terms & Abbreviations | Abbreviation | Meaning | | ------------ | -------------------------------- | | L1 / L2 | Layer 1 / Layer 2 | | Z2 | Zetrix Layer 2 | | RPC | Remote Procedure Call (JSON-RPC) | | WS/WSS | WebSocket / Secure WebSocket | | NLB | (AWS) Network Load Balancer | | AZ | Availability Zone | | HA | High Availability | | DR | Disaster Recovery | | RTO/RPO | Recovery Time / Point Objective | | HSM | Hardware Security Module | | KMS | Key Management Service | | MCP | Model Context Protocol | | ZTP20 | Zetrix token standard (fungible) | | EVM | Ethereum Virtual Machine | | BFT | Byzantine Fault Tolerant | | DAC | Data Availability Committee | | DA | Data Availability | ## Component List | Component | Testnet count | Doc section | | ------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------- | | Z2 Node (go-quorum QBFT) | 5 | [Z2 Node](/zetrix-l2-documentation/architecture/system-components.md#z2-node) | | Z2 Sequencer | 3 | [Z2 Sequencer](/zetrix-l2-documentation/architecture/system-components.md#z2-sequencer) | | Z2 Validator | 5 | [Z2 Validator](/zetrix-l2-documentation/architecture/system-components.md#z2-validator) | | Z2 Reexecutor | co-located | [Z2 Reexecutor](/zetrix-l2-documentation/architecture/system-components.md#z2-reexecutor) | | Main Proposer Validator | 1 | [Main Proposer Validator](/zetrix-l2-documentation/architecture/system-components.md#main-proposer-validator) | | Watcher | internal + third-party | [Watcher](/zetrix-l2-documentation/architecture/system-components.md#watcher) | | Z2 Refueler | 1 | [Z2 Refueler](/zetrix-l2-documentation/architecture/system-components.md#z2-refueler) | | Z2 Explorer | shared | [Z2 Explorer](/zetrix-l2-documentation/architecture/system-components.md#z2-explorer) | | Z2 Monitoring | shared | [Z2 Monitoring](/zetrix-l2-documentation/architecture/system-components.md#z2-monitoring) | | Z2 Relayer | shared | [Z2 Relayer](/zetrix-l2-documentation/architecture/system-components.md#z2-relayer) | | Zetrix MCP | npm | [Z2 Zetrix MCP](/zetrix-l2-documentation/integration/zetrix-mcp.md#z2-zetrix-mcp) | | Faucet | shared | [Faucet](/zetrix-l2-documentation/architecture/system-components.md#faucet) | ## Ports (Reference) > \[!NOTE] Ports below are conventional defaults and may differ by deployment. | Service | Port | Protocol | Exposure | | -------------------------------- | ------ | ---------- | ---------------- | | go-quorum JSON-RPC (HTTP) | 8545 | TCP/HTTP | Internal → NLB | | go-quorum WebSocket | 8546 | TCP/WS | Internal → NLB | | go-quorum P2P (devp2p) | 30303 | TCP/UDP | Node ↔ Node | | go-quorum QBFT / consensus | 8547 | TCP | Internal | | Node / Reexecutor (Besu) metrics | 9545 | TCP/HTTP | Monitoring only | | Prometheus | 9090 | TCP/HTTP | Monitoring/admin | | Grafana | 3000 | TCP/HTTP | Admin only | | Alertmanager | 9093 | TCP/HTTP | Admin only | | Explorer web/API | 443/80 | HTTPS/HTTP | Public (read) | | Faucet | 443 | HTTPS | Public (testnet) | | SSH | 22 | TCP | Bastion/VPN only | ## Recommended Firewall Rules | Rule | Source | Destination | Port | Action | | ---------------- | ------------- | ---------------------- | -------------- | ------ | | Public RPC | Internet | NLB | 443 | Allow | | RPC to nodes | NLB | Nodes | 8545/8546 | Allow | | P2P | Node subnet | Node subnet | 30303 | Allow | | Metrics scrape | Monitoring | All services | metrics ports | Allow | | Admin dashboards | VPN/allowlist | Admin host | 3000/9090/9093 | Allow | | SSH | Bastion/VPN | All hosts | 22 | Allow | | Everything else | Any | Consensus/mgmt subnets | \* | Deny | > \[!WARNING] Deny-by-default on consensus and management subnets. Never expose metrics, admin dashboards, or SSH directly to the internet. ## Directory Structure (Reference) ``` /opt/zetrix-l2/ ├── node/ │ ├── config/ # genesis, QBFT config, node keys (ref) │ ├── data/ # chain state DB │ └── logs/ ├── sequencer/ │ ├── config/ │ └── logs/ ├── validator/ │ ├── config/ # signing key ref (HSM/KMS) │ └── logs/ ├── reexecutor/ ├── proposer/ ├── refueler/ │ └── config/ # thresholds, allowlist, source key ref ├── relayer/ ├── explorer/ │ ├── indexer/ │ └── db/ ├── monitoring/ │ ├── prometheus/ │ ├── grafana/ │ └── alertmanager/ └── faucet/ ``` ## Docker Images | Image | Registry | Purpose | | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------- | | `zetrixchain/z2-validator:latest` | [hub.docker.com/r/zetrixchain/z2-validator](https://hub.docker.com/repository/docker/zetrixchain/z2-validator) | Validator (for external Watcher) | | `zetrixchain/z2-reexecutor:latest` | [hub.docker.com/r/zetrixchain/z2-reexecutor](https://hub.docker.com/repository/docker/zetrixchain/z2-reexecutor) | Reexecutor (for external Watcher) | ## NPM Packages | Package | Install | Repository | Purpose | | -------------------------------------------------------------- | ------------------------------ | -------------------------------------------------------------------------------------- | ----------------- | | [`z2-zetrix-mcp`](https://www.npmjs.com/package/z2-zetrix-mcp) | `npm install -g z2-zetrix-mcp` | [github.com/Zetrix-Chain/z2-zetrix-mcp](https://github.com/Zetrix-Chain/z2-zetrix-mcp) | Zetrix MCP server | ## Testnet URL Reference | # | Service | URL | | - | --------------------------------- | -------------------------------------------------------------------- | | 1 | Main Proposer Validator Dashboard | `https://z2-test-validator.zetrix.com/dashboard.html` | | 2 | Z2 Nodes (RPC) | `https://z2-test-node.zetrix.com` | | 3 | Z2 Explorer | `https://z2-test-explorer.zetrix.com` | | 4 | Monitoring Dashboard | `https://z2-test-admin.zetrix.com` | | 5 | Faucet | `https://z2-test-faucet.zetrix.com` | | 6 | NPM (MCP) | `https://www.npmjs.com/package/z2-zetrix-mcp` | | 7 | GitHub (MCP source) | `https://github.com/Zetrix-Chain/z2-zetrix-mcp` | | 8 | Docker (Validator) | `https://hub.docker.com/repository/docker/zetrixchain/z2-validator` | | 9 | Docker (Reexecutor) | `https://hub.docker.com/repository/docker/zetrixchain/z2-reexecutor` | Node host IP (testnet): `124.243.176.118`. ## References * Zetrix documentation portal: `https://docs.zetrix.com` * Zetrix MCP source & design docs: `https://github.com/Zetrix-Chain/z2-zetrix-mcp` * GoQuorum (QBFT) documentation — canonical execution client * Hyperledger Besu documentation — independent replay / Reexecutor client * Optimistic rollup / fraud-proof literature (Ethereum, Arbitrum, Optimism) * Prometheus & Grafana documentation * AWS Network Load Balancer documentation *** ## Document Conventions * **Callouts:** `NOTE` (informational), `IMPORTANT` (must-read), `WARNING` (risk). * **Diagrams:** Mermaid (`flowchart`, `sequenceDiagram`). * **Placeholders:** `<...>` marks a value to be filled in for your deployment. * **Provisional content:** Tokenomics ([Tokenomics](/zetrix-l2-documentation/usage/tokenomics.md#tokenomics)) is under discussion and subject to change. *Last reviewed: 2026-07-15 · Maintainers: Zetrix L2 Platform Team* *** [← API Overview](/zetrix-l2-documentation/reference/api-overview.md) · [Index](/zetrix-l2-documentation/readme.md)