Trac Peer

A peer-to-peer crypto contract network. Interacts with the Main Settlement Bus (MSB) to settle transactions.

Release 1 (R1) must be used alongside Trac Network R1 releases to maintain contract consistency.

Trac Peer is utilizing the Pear Runtime and Holepunch.

Install

``shell
git clone -b trac-peer-r1 --single-branch git@github.com:Trac-Systems/trac-peer.git
`

Usage

Trac Peer must be used in combination the MSB and a Protocol/Contract pair in a unified setup.
Please check our repos for sample setups.

$3

If you already have an MSB network running (same bootstrap + channel), you can start a local MSB node (new store) that joins that network, and run trac-peer on top of it (this runner uses the trac-msb package, so it does not require a local main_settlement_bus repo checkout).

This is currently required because trac-peer needs an in-process MSB instance to:
- broadcast /deploy_subnet + /tx payloads, and
- observe MSB confirmed state to decide when to execute subnet ops locally.

`sh
npm run peer:run -- --msb-bootstrap=<32-byte-hex> --msb-channel=
`

$3

Runs trac-peer using the Pear runtime (similar to trac-msb). You can control stores via flags (recommended); an optional first positional arg can be used as a “store label” fallback if --peer-store-name is omitted.

`sh
npm run peer:pear -- \
--msb-bootstrap=<32-byte-hex> \
--msb-channel= \
--msb-store-name=peer-msb-1 \
--peer-store-name=peer1
`

Example (second node joining an existing subnet):

`sh
npm run peer:pear -- \
--msb-bootstrap=<32-byte-hex> \
--msb-channel= \
--msb-store-name=peer-msb-2 \
--peer-store-name=peer2 \
--subnet-bootstrap=
`

If you prefer multi-line in zsh, use \ line continuations:

`sh
npm run peer:run -- \
--msb-bootstrap <32-byte-hex> \
--msb-channel \
--msb-stores-directory stores \
--msb-store-name peer-msb-client \
--peer-stores-directory stores \
--peer-store-name subnet-peer \
--subnet-channel subnet-1
`

The runner prints the Peer MSB address. Fund that address on MSB (so the node entry exists and fee checks pass), then in the peer console run:
- /deploy_subnet
- /tx --command "ping hello" (dev protocol)
- If you want to use admin-only commands (writer/indexer management, chat moderation), run /add_admin --address "" and verify with /get --key admin --confirmed false.

Notes:
- The subnet bootstrap key is auto-generated the first time and persisted to stores//subnet-bootstrap.hex.
- To start a fresh subnet, delete that file (and optionally the corresponding stores// directory).
- To join an existing subnet explicitly, pass --subnet-bootstrap .

$3

To run another peer on the same machine without clobbering the first one, use a different --peer-store-name (and a different --msb-store-name for the embedded MSB client node):

`sh


peer 1 prints (or stores) its subnet bootstrap in: stores/peer/subnet-bootstrap.hex


npm run peer:run -- \
--msb-bootstrap <32-byte-hex> \
--msb-channel \
--msb-store-name peer-msb-2 \
--peer-store-name peer2 \
--subnet-bootstrap
`

RPC API (HTTP)

You can start an HTTP API alongside the interactive peer.

This RPC is intended for wallet/app connectivity (URL + JSON), not for operating the peer node. Operator/admin actions remain CLI-only.

`sh
npm run peer:run -- \
--msb-bootstrap <32-byte-hex> \
--msb-channel \
--rpc \
--api-tx-exposed \
--rpc-host 127.0.0.1 \
--rpc-port 5001
`

Endpoints (all JSON):
- GET /v1/health
- GET /v1/status
- GET /v1/state?key=&confirmed=true|false
- GET /v1/contract/schema (JSON Schema; contract tx types + Protocol API methods)
- GET /v1/contract/nonce
- POST /v1/contract/tx/prepare body: { "prepared_command": { "type": "...", "value": {} }, "address": "", "nonce": "" }
- POST /v1/contract/tx body: { "tx": "", "prepared_command": { ... }, "address": "", "signature": "", "nonce": "", "sim": true|false }

Notes:
- To allow wallet tx submission, start the peer with --rpc and --api-tx-exposed (or env PEER_API_TX_EXPOSED=1 + PEER_RPC=1).
- RPC request bodies are limited to 1_000_000 bytes by default (override with --rpc-max-body-bytes`).