ton-blockchain/acton

# Acton Acton 是一个用 Rust 编写的全能 TON 智能合约开发工具包。 它将项目脚手架、构建、测试、脚本编写、钱包与网络操作、验证、代码检查、格式化、调试以及底层 VM 工具整合到了一个 CLI 中。 文档：https://ton-blockchain.github.io/acton/docs/welcome
## 为什么选择 Acton - 单一 CLI 涵盖完整的合约生命周期：创建、构建、测试、调试、部署、验证。 - 原生运行速度（基于 Rust 的工具链和测试运行时）。 - Tolk 优先的工作流，内置 wrappers、测试工具和脚本。 - 通过项目模板和自动生成的 TypeScript wrappers，为 dApp 开发做好准备。 - 快速测试运行器，支持 fork 模式、gas 快照、覆盖率、变异测试、模糊测试以及优秀的 UI。 - 浏览器测试 UI，用于查看失败的测试、跟踪信息、日志以及覆盖率。 ## 安装 目前获取 Acton 的推荐方式是运行最新的公开安装程序： ``` curl -LsSf https://github.com/ton-blockchain/acton/releases/latest/download/acton-installer.sh | sh ``` 如果您更倾向于手动下载，请使用最新的公开发布版本： | 平台 | 架构 | 下载 | |----------|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------| | macOS | ARM64 | [acton-aarch64-apple-darwin.tar.gz](https://github.com/ton-blockchain/acton/releases/latest/download/acton-aarch64-apple-darwin.tar.gz) | | macOS | x86_64 | [acton-x86_64-apple-darwin.tar.gz](https://github.com/ton-blockchain/acton/releases/latest/download/acton-x86_64-apple-darwin.tar.gz) | | Linux | x86_64 | [acton-x86_64-unknown-linux-gnu.tar.gz](https://github.com/ton-blockchain/acton/releases/latest/download/acton-x86_64-unknown-linux-gnu.tar.gz) | | Linux | ARM64 | [acton-aarch64-unknown-linux-gnu.tar.gz](https://github.com/ton-blockchain/acton/releases/latest/download/acton-aarch64-unknown-linux-gnu.tar.gz) | 解压归档文件后，请确保 `acton` 位于您的 `PATH` 中，并验证安装： ``` acton --version ``` 如果您倾向于容器化的工作流，请使用已发布的 Docker 镜像： ``` docker run --rm ghcr.io/ton-blockchain/acton: --version ``` 要在 Docker 中针对当前项目运行 Acton： ``` docker run --rm \ -v "$PWD":/workspace \ -w /workspace \ ghcr.io/ton-blockchain/acton: \ build ``` 有关更多安装详情，请参阅[安装指南](https://ton-blockchain.github.io/acton/docs/installation)。 ## 支持政策 Acton 在最新的带有编号的 GitHub release 版本上是稳定的。首要支持的平台矩阵为 macOS (ARM64, x86_64) 以及 Linux GNU (x86_64, ARM64)。对于 Linux，文档记录的基线是 Ubuntu 20.04 或更高版本。目前原生 Windows 不受支持。如果您使用 Windows，请在 WSL 中使用 Ubuntu 20.04 或更高版本运行 Acton，并在其中遵循 Linux 的安装路径。通过 `acton up --trunk` 安装的 `trunk` 构建、WSL 安装以及其他从源码构建的目标平台目前均处于 beta / 尽力而为支持的阶段。完整的政策记录在[支持政策](https://ton-blockchain.github.io/acton/docs/installation#support-policy)中。 ## 从零开始到测试网 ``` # 从内置 counter 模板创建新项目 acton new first_counter --template counter cd first_counter # 本地 Build 和 test acton build acton test # 创建并为本地 testnet wallet 充值 acton wallet new --name deployer --local --airdrop --version v5r1 # 部署到 TON testnet 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 中的[从源码构建](CONTRIBUTING.md#building-from-source)。 ## 贡献 贡献者设置、测试工作流、UI 构建步骤以及文档工作流均位于 [CONTRIBUTING.md](CONTRIBUTING.md) 中。 ## 许可证 Acton 根据以下任一许可证授权： - Apache License, Version 2.0, ([LICENSE-APACHE](./LICENSE-APACHE) 或 https://www.apache.org/licenses/LICENSE-2.0) - MIT license ([LICENSE-MIT](./LICENSE-MIT) 或 https://opensource.org/licenses/MIT) 由您自行选择。 除非您明确声明，否则由您有意提交以包含在 Acton 中的任何贡献，如 Apache-2.0 许可证中所定义，均应按上述方式进行双重许可，无需任何附加条款或条件。

标签：dApp开发, Rust, TON区块链, TypeScript, Web3, 云安全监控, 代码格式化, 代码覆盖率, 代码部署, 区块链, 单元测试, 可视化界面, 安全插件, 开发工具链, 智能合约, 编译器, 网络流量审计, 脚手架, 虚拟机调试, 请求拦截, 通知系统, 静态分析