Skip to main content
Glama
TONresistor

@tonresistor/zkresistor-cli

by TONresistor
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

zkresistor-cli

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

Related MCP server: zkproofport-ai

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • zkproofport-ai

    zkproofport
    A
    license
    A
    quality
    B
    maintenance
    Zero-knowledge proof generation MCP server. AI agents can prove identity claims (Coinbase KYC, Country, Google OIDC, Google Workspace, Microsoft 365) without revealing personal data. Runs in AWS Nitro Enclave TEE with x402 USDC payments.
    8
    MIT

  • Telegram Agent for Codex

    Frejixxx
    A
    license
    Not graded
    quality
    D
    maintenance
    Privacy-first Telegram MCP server enabling maintainers to triage chats, inspect context, search messages, draft replies, and send authorized messages locally without a cloud relay.
    32 npm
    1
    MIT

  • @just-jelly/mcp-server

    juSt-jeLLy
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for Zama's fhEVM that provides tools to scaffold, compile, deploy, test, and analyze confidential smart contracts, with support for encryption, ACL, and error decoding.
    7,036 npm
    MIT