@Tonresistor/Zkresistor Cli

БесплатноНе проверен

Self-hosted CLI and MCP interface for ZKResistor privacy pools on TON, enabling local Groth16 proof generation and pool operations.

автор: TONresistor

GitHub Embed

Описание

Self-hosted CLI and MCP interface for ZKResistor privacy pools on TON, enabling local Groth16 proof generation and pool operations.

README

Self-hosted CLI and MCP interface for ZKResistor privacy pools on TON.

Version 2.0.1 reconstructs pool state and generates Groth16 proofs locally. Public TON infrastructure supplies chain data only. No private bridge, indexer, or public relayer daemon is required.

Install

Requires Node.js 22 or newer.

npm install -g zkresistor-cli
zkr

Run once without installing globally with npx zkresistor-cli.

The default mainnet Factory is:

EQB8W1W276GWiQpK88Sx46K20rsMrCKIezOpwFGJ4dhjWz58

Usage

Open the interactive CLI:

zkr

Browse Pools lists every active Pool. Filter by GRAM or Jettons, or select Search Pool to search by token, denomination, or address. Selecting a Pool carries its full address into deposit, withdraw, and inspection flows.

Commands remain available for scripts and automation:

zkr wallet new --name main
zkr pools list
zkr pools list --compact
zkr deposit --pool EQ_pool --wallet main
zkr deposits recover --wallet main
zkr withdraw --note 'zkresistor:...' --to EQ_recipient --wallet main

Command	Purpose
`wallet new/import/list/show/remove/export-mnemonic/sign`	Encrypted local wallets
`pools list` / `pools info`	List full Pool addresses and inspect state
`pool create` / `create-ton` / `activate`	Create and activate pools
`deposit`	Synchronize, prove, and deposit
`withdraw`	Synchronize, prove, and withdraw
`mcp serve`	Local stdio MCP server

Use --json for structured output and --yes to skip write confirmations.

Security

A deposit note is the only way to withdraw. Store it before broadcasting.
Notes and deposit metadata are journaled under ~/.config/zkresistor/pending-deposits/ before a deposit send. New journals encrypt the note with the local wallet; recover it with zkr deposits recover.
Wallet mnemonics are encrypted locally with AES-256-GCM and scrypt.
Verified pool state is stored under ~/.config/zkresistor/state/.
Withdrawals bind the complete recipient address and reject incompatible pool code before proving.
Final ceremony artifacts are packaged under artifacts/circuits/ and checked against pinned sizes and SHA-256 hashes before use.

The depth-20 tree has 1,048,576 slots. The bundled in-memory state provider is a reference implementation, not a full-capacity database benchmark.

Configuration

Common variables are ZKR_NET, ZKR_FACTORY_ADDRESS, ZKR_RPC_ENDPOINT, ZKR_RPC_API_KEY, ZKR_PASSPHRASE, and ZKR_STATE_DIR. Non-secret defaults may also live in ./zkresistor.config.json or ~/.config/zkresistor/config.json.

Development

npm ci
npm run check
bash scripts/smoke.sh

MIT License. See LICENSE.

from github.com/TONresistor/zk-resistor-cli

Установить @Tonresistor/Zkresistor Cli в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install tonresistor-zkresistor-cli

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add tonresistor-zkresistor-cli -- npx -y zkresistor-cli

FAQ