Run a node

Pick a role

Every node carries a single role, signed by the verifier you delegated to. The role is encoded in your attestation key and the chain enforces the capability set — there is no way to act outside it.

• Originator. Introduce new physical assets into the network. Requires sensor or oracle attestation.
• Vector. Preserve custody through transit. Requires logistics or customs attestation.
• Liquidity. Settle capital atomically on STATE_VERIFIED. Requires regulated FI accreditation.
• Logic. Derive parametric decisions from verified state. Requires audited model registry.
• Observer. Read-only access to state + flows. No attestation required — operate freely.

Hardware

AXK nodes are CPU + network bound, not compute. A minimum-viable liquidity node runs comfortably on:

• 4 vCPU · 8 GB RAM · 200 GB SSD
• 1 Gbps symmetric · < 25 ms latency to a regional XRPL validator
• Optional HSM for attestation key storage (required for liquidity + logic)

Identity & attestation

Provision an attestation key from the operator console at app.axk.org. The key is signed by your delegating verifier — typically a regulated institution, a sensor network, or a legal counterparty. The chain proves who said what, when.

Deploy

Reference deployment uses Docker Compose. The container is stateless outside the volume; nodes can be rebooted, migrated, or scaled horizontally without losing consensus state.

1# docker-compose.yml — a single liquidity node
2services:
3  axk-node:
4    image: axknetwork/node:2.4.0
5    environment:
6      AXK_NETWORK: mainnet
7      AXK_ROLE: liquidity
8      AXK_ATTESTATION_KEY: ${AXK_ATTESTATION_KEY}
9    ports:
10      - "8080:8080"          # ops + metrics
11    volumes:
12      - axk-data:/var/lib/axk
13volumes:
14  axk-data:

Monitor

The node ships a Prometheus endpoint at :8080/metrics. Key SLIs to watch:

• axk_event_ttf_ms — time-to-finality histogram
• axk_attestation_failures_total — counter, should be flat
• axk_peer_latency_ms — histogram, alert above 50ms
• axk_settled_total — counter, for liquidity-role accounting