VyperLang 智能合约编译指南

VyperLang 智能合约编译指南

vyper Pythonic Smart Contract Language for the EVM 项目地址: https://gitcode.com/gh_mirrors/vy/vyper

前言

Vyper 是一种面向区块链虚拟机(EVM)的 Pythonic 智能合约编程语言，以其简洁性和安全性著称。本文将全面介绍如何使用 Vyper 编译器将合约代码编译为 EVM 字节码。

命令行编译工具

Vyper 提供了两个主要的命令行工具：

1. vyper - 基础编译器
2. vyper-json - 支持 JSON 接口的编译器

基础编译器 vyper

基本编译命令格式：

vyper 合约文件名.vy

输出格式控制

通过 -f 参数可以指定输出格式，支持多种输出类型：

vyper -f abi,bytecode,opcodes 合约文件.vy

常用输出格式选项：

• abi - 合约 ABI 接口
• bytecode - 部署字节码
• opcodes - 操作码列表
• layout - 存储布局
• ast - 抽象语法树

存储布局管理

查看默认存储布局：

vyper -f layout 合约文件.vy

自定义存储布局：

vyper --storage-layout-file 自定义布局.json 合约文件.vy

JSON 接口编译器 vyper-json

支持通过 JSON 格式输入编译参数：

vyper-json 输入文件.json

或将输出重定向到文件：

vyper-json -o 输出文件.json

在线编译环境

Try VyperLang!

这是一个基于 JupyterHub 的在线沙箱环境，适合快速测试和开发 Vyper 合约。

Remix IDE

流行的区块链开发 IDE，支持 Vyper 合约的编译和测试。但需要注意其编译器版本可能稍落后于最新版本。

编译器优化模式

Vyper 支持三种优化模式：

1. gas (默认) - 优化 gas 消耗
2. codesize - 优化合约大小
3. none - 不优化

设置优化模式：

vyper --optimize codesize 合约文件.vy

实验性功能

Venom IR 代码生成

通过 --experimental-codegen 或 --venom 标志启用新的中间表示(IR)后端：

vyper --venom 合约文件.vy

EVM 版本目标

可以指定目标 EVM 版本以启用或禁用特定功能：

通过源码指定

#pragma evm-version cancun

通过命令行指定

vyper --evm-version shanghai 合约文件.vy

支持的 EVM 版本

• london - 基础版本
• paris - 引入 block.prevrandao
• shanghai - 支持 PUSH0 操作码
• cancun (默认) - 支持瞬态存储和 MCOPY 操作码

警告控制

• 忽略所有警告：

vyper -Wnone 合约文件.vy

• 将警告视为错误：

vyper -Werror 合约文件.vy

完整性校验

生成合约完整性哈希：

vyper -f integrity 合约文件.vy

Vyper 归档文件

Vyper 归档(.vyz)是包含完整编译上下文的 ZIP 文件，结构如下：

MANIFEST/
├── cli_settings.txt
├── compilation_targets
├── compiler_version
├── integrity
├── settings.json
├── searchpaths
└── storage_layout.json [可选]

生成归档文件：

vyper -f archive -o 输出文件.vyz 合约文件.vy

JSON 输入输出规范

输入 JSON 示例

{
  "language": "Vyper",
  "sources": {
    "contract.vy": {
      "content": "合约源码内容"
    }
  },
  "settings": {
    "evmVersion": "cancun",
    "optimize": "gas"
  }
}

输出 JSON 示例

{
  "compiler": "vyper-版本号",
  "contracts": {
    "contract.vy": {
      "abi": [],
      "bytecode": "0x..."
    }
  }
}

结语

本文全面介绍了 Vyper 合约的编译流程和各种编译选项。掌握这些编译技巧将帮助开发者更高效地构建和优化 Vyper 智能合约。建议开发者在实际项目中根据需求选择合适的编译选项，并定期检查编译器版本更新带来的新特性。

vyper Pythonic Smart Contract Language for the EVM 项目地址: https://gitcode.com/gh_mirrors/vy/vyper