Stylus 环境配置

Rust 与 Cargo Stylus 配置

安装 Rust 工具链及 WASM 目标平台：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup target add wasm32-unknown-unknown

安装 Cargo Stylus CLI：

cargo install --force cargo-stylus

创建一个新的 Stylus 项目：

cargo stylus new my_project

需使用 Rust Nightly 工具链。项目中应包含 rust-toolchain.toml 文件，明确指定所用的 nightly 渠道、rust-src 组件以及 wasm32-unknown-unknown 目标平台。请参考 rust-contracts-stylus 仓库获取当前推荐的 nightly 版本日期。

添加 OpenZeppelin 依赖项

在添加前，请先前往 crates.io/crates/openzeppelin-stylus 查询最新版本号。将以下内容添加至 Cargo.toml：

[dependencies]
openzeppelin-stylus = "="

启用 export-abi 功能标志以生成 ABI：

[features]
export-abi = ["openzeppelin-stylus/export-abi"]

该 crate 必须同时以库（library）和 cdylib 类型进行编译：

[lib]
crate-type = ["lib", "cdylib"]

导入约定

导入时使用 openzeppelin_stylus（下划线命名）作为 crate 根名称：

use openzeppelin_stylus::token::erc20::{Erc20, IErc20};
use openzeppelin_stylus::access::ownable::{Ownable, IOwnable};
use openzeppelin_stylus::utils::pausable::{Pausable, IPausable};
use openzeppelin_stylus::utils::introspection::erc165::IErc165;

合约主结构体需标注 #[storage] 和 #[entrypoint]，并将 OpenZeppelin 组件作为字段嵌入：

#[entrypoint]
#[storage]
struct MyToken {
    erc20: Erc20,
    ownable: Ownable,
}

公有方法通过 #[public] 和 #[implements(...)] 暴露。标准模式为：使用空实现块完成分发注册，并另行定义各 trait 的具体实现块：

#[public]
#[implements(IErc20, IOwnable)]
impl MyToken {}

#[public]
impl IErc20 for MyToken {
    type Error = erc20::Error;
    // 委托调用 self.erc20 ...
}

顶层模块包括：access、finance、proxy、token、utils。

构建与部署基础操作

验证合约能否成功编译为合法的 Stylus WASM：

cargo stylus check

导出 Solidity ABI 文件：

cargo stylus export-abi

部署至 Arbitrum Stylus 节点：

cargo stylus deploy --endpoint="" --private-key-path=""

私钥安全提示：切勿在命令行中使用 --private-key 参数直接传入明文私钥——该密钥将暴露于 Shell 历史记录与进程列表中。务必使用 --private-key-path 指向权限受限的密钥文件（建议执行 chmod 600），或使用硬件钱包 / 密钥库进行管理。