Txtx

Txtx is a developer tooling platform that applies infrastructure-as-code principles to smart contract deployment and operations. The project positions itself as what HashiCorp Terraform is to cloud infrastructure — a declarative, stateful framework for managing on-chain programs across Solana, EVM-compatible networks, and Bitcoin.

The Problem

Deploying and managing smart contracts typically relies on fragmented shell scripts, ad hoc key-management practices, and manual steps that are difficult to audit or reproduce. As Txtx co-founder Ludo Galabru noted at Solana Accelerate 2025, "Web3 infrastructure management is significantly behind" the DevOps tooling standard that cloud engineers take for granted. The result is deployment processes that are error-prone and hard to verify — a serious risk when on-chain programs govern real economic value.

Smart Contract Runbooks

The core product is the Smart Contract Runbook: a declarative blueprint written in a non-Turing complete subset of HCL (HashiCorp Configuration Language) that describes a deployment workflow end to end. A runbook specifies which programs to deploy, in which order, with which parameters, and what signing authority to use at each step. Txtx's stateful runtime tracks what was executed in previous runs, so re-running a runbook only applies the updates that differ from current on-chain state — analogous to how Terraform calculates and applies a plan.

Three components compose the platform:

Declarative language. HCL-inspired syntax describes deployments and operations without imperative scripting. Files live in source control, so the deployment definition is versioned and reviewable like any other infrastructure change.

Stateful runtime. A deterministic execution engine reads previous state and reconciles it against the current runbook, avoiding redundant or duplicate transactions. Pre- and post-conditions allow runbook actions to assert on-chain state before and after each step, providing a structured checkpoint that manual scripts rarely enforce.

Web UI supervisor. An optional browser-based interface that guides teams through runbook execution. The supervisor handles wallet connections, prompts for interactive signatures at the appropriate steps, automates wallet provisioning, and coordinates distributed multisig ceremonies — removing the need for a trusted party to hold a deployment key offline.

Security Model

A recurring design theme is eliminating private key exposure. Traditional deployment flows often require a hot wallet to sign dozens of transactions, creating a single point of compromise. Txtx's approach moves signing into the browser: the runtime surfaces each signature request to the practitioner at execution time, leaving the key in the hardware wallet or web wallet rather than baked into an automated script. The supervisor also integrates with Squads multisig, so programs controlled by a committee can be deployed and upgraded without requiring any individual to hold unilateral authority.

Surfpool: Local Testing Against Mainnet Data

Beyond the core runbook framework, Txtx also ships Surfpool, a local development environment designed to close the gap between localnet and mainnet. The tool uses a copy-on-read strategy: rather than replicating the full chain state, Surfpool pulls mainnet accounts on demand as tests reference them, letting developers run realistic integration tests against current data without maintaining a full archive node.

Surfpool auto-detects Anchor and Node.js project layouts and generates deployment scaffolding. A built-in dashboard supports rapid iteration with automatic redeployment on source changes. The environment can generate subgraph specifications for data indexing and produce GraphQL APIs with documentation derived automatically from Rust source. Surfpool won first prize at the Colosseum hackathon in the infrastructure track.

Solana Ecosystem Fit

Txtx supports Solana and SVM-compatible chains including Eclipse, alongside EVM networks and Bitcoin. Development activity through mid-2026 has focused on SVM compatibility: adding support for Solana instruction format 3.4, integrating LiteSVM for local simulation, and adding token deployment features. The team also maintains forks of core Solana developer tooling — Anchor, Shank, and LiteSVM — within their GitHub organization, reflecting sustained investment in the Solana builder stack.

The repository holds 1,318 commits across multiple contributors, an Apache 2.0 license, and commit activity through July 2026. The project is in beta.

Milestones

The most concrete production signal in the public record is the first mainnet runbook execution, which handled a transaction moving $2.5M in value on the Bitcoin/Stacks network — cited in the project's own documentation as evidence the framework is production-viable. Ludo Galabru presented Txtx and Surfpool at Solana Accelerate 2025, framing infrastructure-as-code as a necessary maturation step for teams moving from hackathon prototypes to long-running mainnet programs.

Txtx is installable via Homebrew on macOS (brew install txtx/taps/txtx). Source, examples, and documentation are available at docs.txtx.sh and github.com/txtx/txtx.