tana-cli

command-line interface and backend services for the Tana blockchain platform.

overview

tana-cli is the primary developer tool for interacting with Tana. it provides commands for creating and managing blockchain networks, deploying smart contracts, and orchestrating the full suite of backend services.

capabilities

chain management

create new Tana chains with genesis block configuration, manage validator keys, and control network parameters. the CLI handles the complexity of initializing a new blockchain with proper cryptographic setup.

smart contract development

deploy TypeScript smart contracts to the blockchain, invoke contract functions, and query contract state. the CLI integrates with tana-runtime for local contract testing before deployment.

service orchestration

start, stop, and monitor all Tana backend services with a single command. the CLI coordinates Docker containers for infrastructure (PostgreSQL, Redis) and microservices (ledger, identity, mesh, consensus).

transaction management

submit transactions, query balances, and inspect blocks. supports both interactive commands and scriptable JSON output for automation.

architecture

the CLI is built with TypeScript and compiles to standalone binaries for Linux, macOS, and Windows. it bundles platform-specific binaries for tana-runtime and tana-edge to provide a complete development environment.

service coordination

when running tana start, the CLI orchestrates:

docker infrastructure
        |
   +----+----+----+----+
   |    |    |    |    |
postgres redis mesh t4 ledger
                       |
                  +----+----+
                  |    |    |
            identity consensus notifications

command structure

• tana new - create chains, contracts, and validators
• tana start - launch all services
• tana deploy - deploy smart contracts
• tana tx - submit transactions
• tana query - inspect blockchain state
• tana logs - view service logs

integration

the CLI serves as the unified entry point for Tana development. it coordinates all other Tana services and provides a consistent interface regardless of whether you are running a local development network or connecting to a production chain.