Read Node Operator Flow

backend-operator-flow.md

Boundary

This route preserves legacy markdown access inside the Next.js surface. The raw repository file remains authoritative.

Open raw file

Read Node Operator Flow

Goal

Run a backend read node without changing the trust model of the current app.

Step 1

Set Devnet RPC environment variables in `.env`:

`SOLANA_RPC_URL`
`ALCHEMY_DEVNET_RPC_URL`
`HELIUS_API_KEY`
`QUICKNODE_DEVNET_RPC`
`EXTRA_DEVNET_RPCS`

At least one authenticated RPC is recommended.

Step 2

Start the read node:

cd /home/x-pact/PrivateDAO
npm run start:read-node

Step 3

Verify the read node:

cd /home/x-pact/PrivateDAO
npm run verify:read-node
curl http://127.0.0.1:8787/healthz
curl http://127.0.0.1:8787/api/v1/metrics
curl http://127.0.0.1:8787/api/v1/ops/snapshot

Step 4

Point the static frontend to the backend read path:

?readApi=http://127.0.0.1:8787/api/v1

or deploy both behind the same domain and expose:

/api/v1

Step 5

Confirm in `Diagnostics`:

`READ PATH = Backend Indexer`
`RPC HEALTH = Healthy`
`READ NODE METRICS` shows live request counters
`REFHE BACKEND` shows backend coverage
`350-WALLET PROFILE` shows the staged saturation plan
proposal loading works without repeated browser-side RPC strain

Production notes

keep write signing in the wallet
do not move treasury authority into the read node
keep rate limiting enabled
restrict CORS to the real frontend origin
run the service behind a reverse proxy with TLS