E2E Test Suite — Configuration

Environment Variables

The test suite reads configuration from a .env file (loaded via dotenv) or falls back to xchain-hub discovery. All variables are optional if hub discovery is available.

Core Settings

Coin Node

UTXO Tracker

Encoder

Indexer

Regtest Miner

Hub Discovery

Hub Discovery Fallback

When direct environment variables are not set, the bootstrap sequence discovers configuration from xchain-hub:

checkAllEnvironmentalVariables()
    │
    ├── All 17 vars set? → Use direct config
    │
    └── Any missing? → Hub fallback:
        ├── Parse endpoints: HUB_VALIDATORS > HUB_URL+HUB_PORT > localhost:10000
        ├── new XChainHubConnector(endpoints)
        ├── hubConnector.ping()
        ├── hubConnector.getAllConfig() → config[coin][network][service][param]
        └── Extract host/port for: node, database, utxo-tracker, encoder, indexer, regtest-miner

Docker convention: When using hub discovery, all service hostnames are overridden to "localhost" (Docker Compose services are accessed via port mapping, not container hostnames). Database host defaults to "mariadb".

Internal Constants

Docker

Dockerfile

The suite provides a Dockerfile for containerized execution:

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
CMD ["npm", "test"]

Docker Compose

Run with an env file:

docker build -t xchain-e2e-test .
docker run --env-file .env --network host xchain-e2e-test

Or as part of a Docker Compose stack where all services are orchestrated together:

docker-compose up --exit-code-from xchain-e2e-test

Supported Coin/Network Combinations

Copyright © 2025–2026 Dankest, LLC

Based on XChain Platform by Dankest, LLC – https://dankest.llc

Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-or-later) with a commercial license available for proprietary use.

You may use, modify, and distribute this material under the terms of the License. See LICENSE and NOTICE for full terms. See the licensing overview.