AI Ingestion
Runtime Configuration
The Parallel Ledger is distributed as a single, immutable release binary.
To ensure auditability and consistent behavior across diverse environments, the software remains identical for all clients from entry-level implementations to sovereign-tier deployments.
System behavior is governed by a Dual-Key Configuration model:
1. The License Manifest
A signed cryptographic file that defines Product Capabilities. It unlocks specific protocol features, throughput tiers, and identity parameters dictated by your engagement level.
2. Environment Variables
Evaluated at system boot to define Contextual Parameters. These allow the binary to adapt to local infrastructure (database strings, ports, and storage paths) without mutating the core logic.
Licensing & Identity
The Ledger requires a signed cryptographic manifest (license.lic) to initialize the core state machine. This file establishes your Client Identity and hardware-specific performance tiers.
Verification: The system verifies the manifest signature against an embedded public key during boot. If the file is missing or the signature is invalid, the process will halt to prevent inconsistent state transitions.
Note: Ensure the application user has read-access (e.g., chmod 400) to the manifest path.
Environment Variables
| Variable | Example / Default | Description |
|---|---|---|
| PHX_HOST | example.com | Necessary environment variable |
| TPL_DATABASE_NAME | the_parallel_ledger | PostgreSQL database name |
| TPL_DATABASE_USERNAME | web | PostgreSQL database username |
| TPL_DATABASE_PASSWORD | postgres | PostgreSQL database password |
| TPL_DATABASE_HOSTNAME | 127.0.0.1 | PostgreSQL database hostname |
| TPL_DATABASE_PORT | 5432 | PostgreSQL database port |
| TPL_LICENSE_PATH | /etc/the_parallel_ledger/license.lic | Path to the signed cryptographic manifest. |
| TPL_TRUTH_NODE_RELAY_CONFIG_PATH | /home/web/the_parallel_ledger/truth_node_relay_config.json | Path to the client configuration for truth node relays. |
| TPL_WEB_PORT | 4000 | Listen port for the Web GUI and Admin API. |
| TPL_POOL_SIZE | 10 | Database connection pool. Recommended: (CPU Cores × 3). |
Feature Flags (GUI)
The following toggles control visibility within the Administrative Web Interface. These do not affect the underlying protocol or API capabilities.
| Variable | Default | Context |
|---|---|---|
| TPL_SHOW_DEMONSTRATION_UI | "FALSE" | Enables UI tools for sandbox data manipulation. |
| TPL_SHOW_CONTEXT_DELETE_UI | "FALSE" | Enables UI options for context-level removal. |
Runtime Configuration
The Parallel Ledger is distributed as a single, immutable release binary.
To ensure auditability and consistent behavior across diverse environments, the software remains identical for all clients from entry-level implementations to sovereign-tier deployments.
System behavior is governed by a Dual-Key Configuration model:
1. The License Manifest
A signed cryptographic file that defines Product Capabilities. It unlocks specific protocol features, throughput tiers, and identity parameters dictated by your engagement level.
2. Environment Variables
Evaluated at system boot to define Contextual Parameters. These allow the binary to adapt to local infrastructure (database strings, ports, and storage paths) without mutating the core logic.
Licensing & Identity
The Ledger requires a signed cryptographic manifest (license.lic) to initialize the core state machine. This file establishes your Client Identity and hardware-specific performance tiers.
Verification: The system verifies the manifest signature against an embedded public key during boot. If the file is missing or the signature is invalid, the process will halt to prevent inconsistent state transitions.
Note: Ensure the application user has read-access (e.g., chmod 400) to the manifest path.
Environment Variables
| Variable | Example / Default | Description |
|---|---|---|
| PHX_HOST | example.com | Necessary environment variable |
| TPL_DATABASE_NAME | the_parallel_ledger | PostgreSQL database name |
| TPL_DATABASE_USERNAME | web | PostgreSQL database username |
| TPL_DATABASE_PASSWORD | postgres | PostgreSQL database password |
| TPL_DATABASE_HOSTNAME | 127.0.0.1 | PostgreSQL database hostname |
| TPL_DATABASE_PORT | 5432 | PostgreSQL database port |
| TPL_LICENSE_PATH | /etc/the_parallel_ledger/license.lic | Path to the signed cryptographic manifest. |
| TPL_TRUTH_NODE_RELAY_CONFIG_PATH | /home/web/the_parallel_ledger/truth_node_relay_config.json | Path to the client configuration for truth node relays. |
| TPL_WEB_PORT | 4000 | Listen port for the Web GUI and Admin API. |
| TPL_POOL_SIZE | 10 | Database connection pool. Recommended: (CPU Cores × 3). |
Feature Flags (GUI)
The following toggles control visibility within the Administrative Web Interface. These do not affect the underlying protocol or API capabilities.
| Variable | Default | Context |
|---|---|---|
| TPL_SHOW_DEMONSTRATION_UI | "FALSE" | Enables UI tools for sandbox data manipulation. |
| TPL_SHOW_CONTEXT_DELETE_UI | "FALSE" | Enables UI options for context-level removal. |