@thesiolab/node

The Thesio testnet node CLI for decentralized arbitration and optional A2A relay operation.

Install

npm install --global @thesiolab/node@testnet
thesio-node start --network testnet

The first start creates a protected local data directory, generates an encrypted node identity, loads the bundled testnet manifest, and starts the node daemon. Starting does not silently register the wallet or spend gas.

Everyday commands

thesio-node status
thesio-node dashboard
thesio-node logs --follow
thesio-node cases
thesio-node stop
thesio-node update --check

Use --json for automation and --foreground under a process manager.

Registration

The default role is arbitrator. Fund the generated address with testnet gas, register deliberately, and wait for testnet governance approval:

thesio-node register --allow-empty-metadata
thesio-node status

Relay is optional:

thesio-node config set --roles arbitrator,relay

Do not expose an unauthenticated relay listener. Follow the @thesiolab/a2a-relay security guidance before enabling a public endpoint.

Identity storage

The default data directory is ~/.thesio/node/testnet/. The node key is encrypted with scrypt and AES-256-GCM. Hardened operators should supply THESIO_NODE_KEY_PASSWORD from a secret manager. Import keys only through protected environment injection during init; command-line private-key and password flags are rejected.

Arbitration safety

Inspect the complete case, verify evidence hashes and contract state, and use --dry-run before a resolution. A final resolution is an on-chain action and cannot be treated like a local acknowledgement. Never use a production wallet or mainnet asset with this testnet release.

The verifier role is reserved until its assignment and attestation workload is implemented. Gateway, indexer, and resolver are hosted application infrastructure, not node roles.

Licensed under MIT.