如何安装 Linera 工具链并配置 Rust、Wasm 目标与 Protoc 依赖【免费下载链接】linera-protocolMain repository for the Linera protocol项目地址: https://gitcode.com/GitHub_Trending/li/linera-protocol如果你准备在本地开发 Linera 应用第一步是把 Linera 开发工具链装起来。工具链由 linera-service 提供的linera主客户端、linera-storage-service本地验证节点存储以及linera-sdk编程库组成。安装本身依赖三个前置组件Rust 工具链、Wasm 编译目标wasm32-unknown-unknown以及 ProtocProtocol Buffers 编译器。本文给出一条完整的操作路径先装前置依赖再安装 Linera 二进制最后用本地网络和一个 Wasm 示例工程验证整条链路可用。官方支持矩阵如下见 installation.mdLinux x86 64-bitMac OS (M1 / M2)Mac OS (x86)Windows✓ Main platform✓ Working✓ WorkingUntested也就是说 Linux x86-64 是主平台Windows 未经验证INSTALL.md 要求 Windows 用户使用 WSL 并按 Linux 步骤操作。安装前置依赖Rust、Wasm 目标与 Protoc以 Linux 为主路径来源installation.md。安装 Rust 并添加 Wasm 编译目标curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh rustup target add wasm32-unknown-unknown安装 Protoc。文档给出的是 v21.11 的官方发布二进制包下载后解压到$HOME/.localcurl -LO https://github.com/protocolbuffers/protobuf/releases/download/v21.11/protoc-21.11-linux-x86_64.zip unzip protoc-21.11-linux-x86_64.zip -d $HOME/.local如果~/.local不在你的PATH里需要补上export PATH$HOME/.local/bin:$PATH注意解压这一步会把bin/、include/等目录写入$HOME/.local如果你已经在该目录放过其他工具请先确认不会覆盖。此外文档提醒部分 Linux 发行版还需要安装开发包例如g、libclang-dev和libssl-dev。Rust 版本有一个明确约束文档声明该手册在仓库 rust-toolchain.toml 所固定的工具链上测试通过[toolchain] channel 1.95.0 components [ clippy, rustfmt, rust-src ] targets [ wasm32-unknown-unknown ] profile minimal在仓库目录内工作时 rustup 会自动应用这份钉选如果单独在仓库外编译建议同样使用 Rust 1.95.0。macOS 前置依赖可选分支macOSIntel / M1 / M2的前置依赖来自 INSTALL.md与 Linux 不同xcode-select --install brew install rustup-init rustup target add wasm32-unknown-unknown brew install llvm18 brew install protobuf其中 Clang/LLVM 安装后需要按提示更新PATH。如果还要跑 Linera 协议本身的测试文档要求额外安装jqbrew install jq、cargo-rdme、taplo-cli、cargo-all-features、cargo-machete均为cargo install以及 Docker DesktopLinux 侧对应的是sudo apt-get install jq和 Docker Engine。这些只与测试工具链有关与本文主任务无关按需求取舍。Nix 环境可选分支仓库附带 Nix flakeflake.nix支持 Linux含 WSL与 macOS。装好 Nix 后在仓库根目录运行nix develop即可进入开发环境再按常规执行cargo build或cargo install。如果你装了 direnv则不需要手动运行nix develop进入项目目录后执行direnv allow会自动切入构建环境。安装 Linera 工具链前置依赖就绪后安装两条路径任选其一。从 crates.io 安装默认主路径cargo install --locked linera-storage-service0.16.0 cargo install --locked linera-service0.16.0版本号0.16.0对应当前 Testnet 的版本仓库 docs/RELEASE_VERSION文档说明其小版本可能经常变化但不应引入破坏性变更。如果之后要开发 Linera Wasm 应用linera-sdk作为库引入版本保持一致cargo add linera-sdk0.16.0从源码安装可选路径也可以克隆 linera-protocol 仓库后从源码安装切到当前发布分支testnet_conwaygit clone https://gitcode.com/GitHub_Trending/li/linera-protocol.git cd linera-protocol git checkout -t origin/testnet_conway # Current release branch然后cargo install --locked --path linera-storage-service cargo install --locked --path linera-service文档还给出一个用于开发调试的替代方式不执行cargo install而是把 debug 产物直接加入PATHexport PATH$PWD/target/debug:$PATH验证安装验证分两步先确认linera客户端与本地网络能交互再确认 Wasm 目标真正可用。步骤来自 hello_linera.md。第一步启动一个带 faucet 的本地开发网络linera net up --with-faucet --faucet-port 8080该命令会启动一个默认分片数的验证节点和一个 faucet。然后在另一个 shell 窗口里初始化开发者钱包并申请一条 microchainlinera wallet init --faucet http://localhost:8080 linera wallet request-chain --faucet http://localhost:8080注意文档的限制说明钱包只在其所在网络的生命周期内有效每次重启本地网络后钱包需要删除并重新创建。第二步同步链并查询余额来确认网络工作正常linera sync linera query-balance成功时的文档示例输出是一个数字例如10。第三步验证 Wasm 编译链路。在仓库的examples/counter目录下构建示例应用cd examples/counter cargo build --release --target wasm32-unknown-unknown能编译出target/wasm32-unknown-unknown/release/counter_{contract,service}.wasm说明 Rust、wasm32-unknown-unknown目标与工具链三者配置正确。已知限制与下一步Windows 未经验证需走 WSL 并按 Linux 流程操作INSTALL.md。本地网络重启后必须重建钱包这是钱包与网络生命周期绑定的限制不是安装问题。若与 Testnet 交互时报错文档要求检查工具链版本是否兼容当前 Testnet即回到从 crates.io 安装一节核对版本号。安装失败时文档建议的联系渠道是社区Discord或在仓库中创建 issue见 installation.md 的 Getting help 一节。工具链装好并验证通过后下一站是按 hello_linera.md 发布 counter 应用linera publish-and-create并通过linera service --port 8080启动的 GraphiQL 界面查询它这属于应用部署范畴超出本文安装任务的范围。【免费下载链接】linera-protocolMain repository for the Linera protocol项目地址: https://gitcode.com/GitHub_Trending/li/linera-protocol创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考