/txtx

Terraform for web3. The ultimate companion for Anchor, Clarinet, Foundry and Hardhat. Assist developers performing reproducible deployments and secure operations.

Primary LanguageRustApache License 2.0Apache-2.0

Txtx

BUILD CONFIDENCE WITH WEB3 RUNBOOKS


Latest News 🔥

  • Added support for deployments of Solana programs - including support for other SVM chains (Eclipse, etc.)
  • Added support for EVM deterministic deployments via CREATE2
  • Added support for Zero Knowledge Proof based transaction flows with Sp1 addon
  • The 1st runbook ever executed on Mainnet moved $2.5M!
  • Added support for distributed multisig ceremonies in Stacks addon.

What is Txtx?

Have you ever tried to deploy some open source Smart contracts on a local devnet, just to get stuck on the first steps of understanding how the deployment should be executed? Have you lost hundreds, thousands or millions of tokens because your master private key got compromised after copy/pasting in your deployment scripts, or missed some contracts initializations making your deployments vulnerable and flawed?

Txtx turns the stress, pain and complexity of Smart Contract Infrastructure management into a secure, reproducible and proficient developer experience.

Txtx introduces Smart Contract Runbooks to assist developers to deploy and operate on their Smart Contracts / Solana Programs / Bitcoin Scripts.

Smart Contract Runbooks are the blueprint for Engineering Excellence, setting the gold standard for Web3 Infrastructures.

Txtx is to Web3 what Hashicorp Terraform is to cloud infrastructure management: thanks to infrastructure as code, developers now have the ability to enhance their Web3 operations by leveling up security, composability, and reproducibility.

With Txtx we're introducing:

  • A declarative language, inspired from Hashicorp Terraform, tailored for describing your Web3 deployments and operations

  • A runtime allowing you to perform stateful executions: the state of your previous executions is used against the current state of your files, allowing to only execute the updates.

  • An optional Web UI running on your machine, guiding you through the execution of your runbooks, facilitating use of web wallets, automating wallet provisionning, distributed multisig ceremonies, etc.

Txtx - Supervisor

Important

Txtx is currently in beta: We’re still testing and refining the platform. Please use it for testing purposes only. Your feedback is welcome! 🙌

Txtx in action: 101 Demos

Txtx - Web3 Runbook - 101 series

Declarative Automation

In a composable context (and Web3 is inherently composable), declarative deployments and operations are essential.

As infrastructure complexity increases, we must be able to test and reproduce deployments in clean, isolated environments. Additionally, we need the capability to update, migrate, add, or remove components without going offline or putting funds, tokens, and assets at risk.

Txtx is purpose-built for blockchain operations, drawing on the best practices that were developed over time in cloud infrastructure management.

Focus on Security

Every year, between $500M and $1B are lost due to compromised private keys. As developers, we often do exactly what we tell our users not to do: leaving our private keys too accessible for easy copying and pasting during deployments and operations.

Txtx is eliminating these risky practices by introducing script execution in the browser, where execution interactively prompts for signatures. These signatures can be securely provided using your web wallet, hardware wallet, or even multisig ceremonies.

In addition to boosting security, the Web Supervisor UI helps developers by identifying common pitfalls and guiding them toward safer practices.

Finally, the declarative nature of Txtx runbooks, combined with a state-aware runtime, ensures that smart contracts are always configured as intended. This class of issues has historically led to some of the largest hacks in Web3 history.

Quick Start

The txtx CLI tool can be installed via our install script or through a manual build.

Install on macOS (Homebrew)

To install txtx on a macOS system using Homebrew, open a terminal and run:

brew tap txtx/txtx
brew install txtx

Other installation options are available and described in our doc website.

Going Further