SPEC V1.0

Developer Infrastructure Guide

Welcome to XPay Labs. This deployment documentation will guide you through spinning up the core multi-chain self-hosted payment node as a secure Docker container (compatible with VPS hosts, AWS, Google Cloud Run, and Kubernetes clusters). With our provided Docker Compose templates, you can easily launch the gateway, frontend checkout, indexing databases, and queues concurrently in a single command.

Sovereign Key Setup Philosophy

XPay Labs relies on mathematical key derivation algorithms. For every created customer invoice session, our indexing process derives a unique ephemeral public address derived from your node seed file inside memory.

CRITICAL INFRASTRUCTURE DIRECTION

XPay Labs NEVER copies keys to external datacenters. All mnemonic codes are loaded exclusively inside container boundaries. Back up your node seeds securely off-chain.

Docker Compose Orchestration

Copy this microservice yaml skeleton directly to your server directory to initiate core deployment:

version: '3.8'
  services:
    xpay-core:
      image: xpaylabs/core:v1.0.0
      container_name: xpay_core_network
      restart: always
      ports:
        - "3010:3010"
      environment:
        - NODE_ENV=production
        - XPAY_KEY_SEED=your_private_node_generation_mnemonic
        - XPAY_TRON_PROVIDER=https://api.trongrid.io
        - XPAY_EVM_PROVIDER=https://eth-mainnet.g.alchemy.com/v2/your_key
        - XPAY_HMAC_SECRET=your_signing_secret_for_webhook_verification
      volumes:
        - ./data:/app/db

Environment Variables Reference

Variable Key	Type	Mandatory	Functional Description
XPAY_KEY_SEED	String	YES	High-entropy cryptographic BIP-39 root seed used to safely derive unique invoice deposit keys.
XPAY_HMAC_SECRET	String	YES	Cryptographic HMAC hash key to seal and authenticate outgoing payment payloads.
XPAY_TRON_RPC	URL	OPTIONAL	Provider link used to connect to TRON blockchain. Defaults to public Trongrid node.
XPAY_EVM_RPC	URL	OPTIONAL	Any Standard EVM network RPC node used to track ERC-20 payment flow.