ton-blockchain/acton 来源：https://github.com/ton-blockchain/acton

Acton

Acton 是一个用 Rust 编写的一站式 TON 智能合约开发工具包。它将项目脚手架、构建、测试、脚本编写、钱包与网络操作、验证、代码检查、格式化、调试以及底层 VM 工具整合在同一个 CLI 中。

文档：https://ton-blockchain.github.io/acton/docs/welcome

为什么选择 Acton

• 用于完整合约生命周期的单一 CLI：创建、构建、测试、调试、部署、验证。
• 原生速度（基于 Rust 的工具链和测试运行时）。
• Tolk 优先的工作流，内置包装器、测试工具和脚本。
• 通过项目模板和自动生成的 TypeScript 包装器，为 dApp 开发做好准备。
• 快速测试运行器，支持分叉模式、Gas 快照、覆盖率、变异测试、模糊测试以及友好的用户界面。
• 浏览器测试 UI，用于查看失败测试、调用追踪、日志和覆盖率检查。

安装

目前安装 Acton 的推荐方式是运行最新的公开安装程序：

curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh

如果你更喜欢手动下载，请使用最新的公开版本：

解压归档文件后，请确保 acton 在你的 PATH 中，并验证安装：

acton --version

如果你更喜欢容器化的工作流，请使用发布的 Docker 镜像：

docker run --rm ghcr.io/ton-blockchain/acton:latest --version

要在 Docker 中针对当前项目运行 Acton：

docker run --rm \
  -v "$PWD":/workspace \
  -w /workspace \
  ghcr.io/ton-blockchain/acton:latest \
  build

更多安装详情，请参阅安装指南 (https://ton-blockchain.github.io/acton/docs/installation)。

支持政策

Acton 在最新的带编号的 GitHub 发行版上是稳定的。主要支持的平台矩阵包括 macOS（ARM64、x86_64）以及 Linux GNU（x86_64、ARM64）。对于 Linux，文档规定的基线版本为 Ubuntu 20.04 或更高版本。目前不支持原生 Windows。如果你使用 Windows，请在运行 Ubuntu 20.04 或更高版本的 WSL 中运行 Acton，并遵循 Linux 安装路径。

通过 acton up --trunk 安装的 trunk 版本、WSL 安装以及其他从源码构建的目标目前属于测试版/尽力而为的支持范围。完整政策请参阅支持政策文档 (https://ton-blockchain.github.io/acton/docs/installation#support-policy)。

从零开始到测试网

# 从内置计数器模板创建新项目
acton new first_counter --template counter
cd first_counter

# 本地构建和测试
acton build
acton test

# 创建并资助本地测试网钱包
acton wallet new --name deployer --local --airdrop --version v5r1

# 部署到 TON 测试网
acton script scripts/deploy.tolk --net testnet

如需逐步操作指南，请参阅快速入门指南 (https://ton-blockchain.github.io/acton/docs/quickstart)。

如果你已有仓库而不是从模板开始？现有项目路径如下：

cd your-repo
acton init
acton build
acton test

更多详情，请参阅项目管理指南 (https://ton-blockchain.github.io/acton/docs/projects)。

从源码构建

源码构建旨在供贡献者和本地开发使用。请参阅 CONTRIBUTING.md 中的 从源码构建。

贡献

贡献者设置、测试工作流、UI 构建步骤以及文档工作流均在 CONTRIBUTING.md 中说明。

许可证

Acton 采用以下任一许可证授权：

• Apache License, Version 2.0, (LICENSE-APACHE 或 https://www.apache.org/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT 或 https://opensource.org/licenses/MIT)

由你选择。除非你明确声明其他情况，否则你有意提交并纳入 Acton 的任何贡献（根据 Apache-2.0 许可证定义）都将以上述双重许可证授权，且无任何额外条款或条件。