Aurora Engine

Aurora Engine 在 NEAR 协议上实现了 Ethereum 虚拟机 (EVM)。有关更多信息，请参阅 doc.aurora.dev。

部署

开发

先决条件

• Node.js (v14+)
• cargo-make

cargo install --force cargo-make

开发先决条件

• Node.js (v14+)
• Docker
• cargo-make

开发

分支

• master 是当前稳定分支。它必须始终准备就绪，以便随时部署到链上。

• develop 是我们的前沿开发分支。通常，请将所有拉取请求 targeting 至此分支。

构建和制作命令

所有带有 cargo make 的任务都必须有一个 --profile 参数。

当前可用的 profile 有

• mainnet：适用于主网。
• mainnet-silo：适用于主网的 silo 合约。
• testnet：适用于测试网。
• testnet-silo：适用于测试网的 silo 合约。
• local：适用于本地开发。
• custom：适用于自定义环境，见以下说明。

在某些情况下，您可能需要一个自定义环境。这可以在与其它 .env 文件相同的结构下，在 .env 文件夹中创建 custom.env。更多详情请见 bin/local-custom.env。

每次 make 调用都必须遵循以下模式，尽管在某些情况下（如清理）不需要指定 --profile。

cargo make [--profile <profile>] <task>

构建引擎和合约

有几个命令可以用于构建二进制文件。以下列出了目前对 task 字段支持的一些参数

• default：默认值，不需要指定，运行 build。需要 --profile 参数。
• build：构建所有引擎智能合约，并在 bin 文件夹中生成 aurora-<profile>-test.wasm。需要 build-contracts。需要 --profile 参数。
• build-test：使用测试功能构建所有内容。需要 --profile 参数。
• build-contracts：构建所有 ETH 合约。
• build-docker：使用 docker 构建环境在 bin 文件夹中构建 aurora-<profile>-test.wasm。此任务的目的在于生成可重复的二进制文件。

例如，以下命令将构建主网调试二进制文件

cargo make --profile mainnet build

验证二进制哈希

为了验证部署的二进制文件与源代码匹配，您可能需要可重复构建它，然后验证 SHA256 哈希与已部署的二进制文件的哈希匹配。这样做是为了防止恶意代码被部署。

运行以下命令以生成二进制哈希

cargo make --profile <profile> build-docker
shasum -a 256 bin/aurora-<profile>.wasm

运行单元测试和集成测试

要运行测试，我们可以运行一些 cargo make 任务

• test：测试整个 cargo 工作空间和 ETH 合约。需要 --profile 参数。
• test-workspace：仅测试 cargo 工作空间。
• test-contracts：仅测试合约。
• test：测试整个 cargo 工作空间、ETH 合约并运行 modexp 基准测试。需要 --profile 参数。
• test-flow：测试整个 cargo 工作空间和 ETH 合约。需要 --profile 参数。
• bench-modexp：运行 modexp 基准测试。需要 --profile 参数。

例如，以下命令将测试整个工作空间和 ETH 合约

cargo make --profile mainnet test 

运行检查和 lint

以下任务是可用于运行 lint 和检查的

• check：检查格式、clippy 和 ETH 合约。
• check-contracts 对 ETH 合约运行 yarn lints。
• check-fmt：仅检查工作空间 Rust 格式。
• clippy：仅使用 clippy 检查 Rust 工作空间。

例如，以下命令将运行检查。这里不需要 profile

cargo make check

清理

以下任务是可用于清理工作空间的

• clean：清理所有构建的二进制文件和 ETH 合约。
• clean-cargo：使用 cargo 进行清理。
• clean-contracts：清理 ETH 合约。
• clean-bin：清理二进制文件。

此外，还有但未包含在 clean 任务中

• sweep：清除 ENV 中的指定天数，默认为 30 天。

例如，以下命令将清除所有内容。 profile 不是必需的

cargo make clean

许可协议

aurora-engine 有多个许可协议

• 除了 engine-test 之外的所有 crates 都有 CCO-1.0 许可协议
• engine-test 有 GPL-v3 许可协议