lightnode CLI

Bundled in lightnode-sdk. Read-only commands run inline below; the rest run from your terminal. Five add scaffolders patch an existing project.

How to run these in your terminal

The npm package is lightnode-sdk but the bundled binary is named lightnode, which clashes with another package on npm. Three reliable invocations:

# One-shot (explicit package):
npx --package=lightnode-sdk -- lightnode wallet new

# Install in your project, then npx finds it:
npm install lightnode-sdk
npx lightnode wallet new

# Global install for everyday use:
npm install -g lightnode-sdk
lightnode wallet new

Try a command (no install)

Pick a read-only command on the left, hit Run, see real JSON. Same output the CLI would print.

interactiveRun a CLI command from the browser

Network summary: totals, active workers, jobs, earnings, model count.

lightnode network --net mainnet

Click Run. The output appears below; it's the same JSON the CLI would print.

add (writes files in your project)

lightnode add inferenceEncrypted inference route or script. Next.js: app/api/inference/route.ts. Hono / Node: lightchain-inference.ts.
lightnode add chatChat UI with conversation history. Next.js: app/chat/page.tsx. Node: terminal REPL with rolling memory.
lightnode add agentScheduled / loop inference. Next.js: Vercel Cron route + vercel.json. Node: long-running setInterval daemon.
lightnode add analytics-dashboardRead-only network + worker analytics page. No wallet, no fees. Next.js: SSR page; Node: CLI script.
lightnode add nft-mint-with-inferenceAI-generated NFT metadata with on-chain provenance. Mint flow that anchors the answer to a content hash.

All add commands accept --template auto|nextjs-api|hono|node, --net testnet|mainnet, and --force.

Inferences + wallet (need PRIVATE_KEY)

lightnode chat <prompt>One-shot encrypted inference. Streams answer to stdout, JSON receipt to stderr. Supports stdin too.
lightnode batch <prompts.json>Parallel inference. Reads JSON array or {prompts, system?, model?}; one JSON line per result to stdout. Supports - for stdin and --concurrency 4. (0.6.x)
lightnode agent <task>ReAct-style agent with built-in add + now tools. Streams the step trace to stderr, final answer to stdout. Cap with --max-iter 4. (0.6.x)
lightnode wallet new|address|balanceGenerate a key, read the address of your env key, check balance on mainnet/testnet.
lightnode worker preflightSubmits ONE real test inference and prints a verdict. Useful as a CI gate.
lightnode worker watch <addr>Polls a worker, emits JSON line on state change (no key required).
lightnode bridge addressesPrint the LCAI bridge route (Ethereum <-> LightChain).
lightnode dao addresses|configLCAI Governor addresses + live voting delay/period/threshold.

# One-shot (explicit package): npx --package=lightnode-sdk -- lightnode wallet new # Install in your project, then npx finds it: npm install lightnode-sdk npx lightnode wallet new # Global install for everyday use: npm install -g lightnode-sdk lightnode wallet new