30 个版本 (破坏性更新)

0.37.0 2024年5月28日
0.35.3 2024年4月11日
0.35.0 2024年3月21日
0.33.0 2023年12月7日
0.15.0 2021年11月8日

13 in #parity

Download history 5258/week @ 2024-05-02 5242/week @ 2024-05-09 5411/week @ 2024-05-16 4513/week @ 2024-05-23 6243/week @ 2024-05-30 4959/week @ 2024-06-06 4721/week @ 2024-06-13 5664/week @ 2024-06-20 5517/week @ 2024-06-27 5445/week @ 2024-07-04 6837/week @ 2024-07-11 6657/week @ 2024-07-18 6407/week @ 2024-07-25 8077/week @ 2024-08-01 7102/week @ 2024-08-08 6729/week @ 2024-08-15

29,609 个月下载量
用于 61 个crate(42 个直接使用)

Apache-2.0 OR GPL-3.0 以及可能 GPL-3.0-or-later…

1MB
16K SLoC

subxt · build 最新版本 Documentation

Subxt 是一个用于与基于 Substrate 的节点在 Rust 和 WebAssembly 中交互的库。它可以

  • 提交外部交易(这个名字由此而来)。
  • 订阅区块,从中读取外部交易和相关事件。
  • 读取并遍历存储值。
  • 从元数据中读取常量和自定义值。
  • 调用运行时 API,返回结果。
  • 通过安全、静态类型接口或当需要灵活性时通过动态接口执行上述所有操作。
  • 编译为 WASM 并在浏览器中完全运行。
  • 通过 subxt-core crate 在 #[no_std] 环境中执行大量操作。
  • 使用内置的轻量级客户端(smoldot)与链交互。

用法

请查看 示例 文件夹或 示例 文件夹,其中包含了各种大小不同的 subxt 使用示例,或者阅读指南 了解更多。

从 Substrate 节点下载元数据

使用 subxt-cli 工具从节点下载目标运行时的元数据。

  1. 安装
cargo install subxt-cli
  1. 将编码后的元数据保存到文件
subxt metadata -f bytes > metadata.scale

默认情况下,查询默认 https://127.0.0.1:9933/ 上本地运行的节点的元数据。如果查询不同的节点,则 metadata 命令接受 --url 参数。

Subxt 文档

有关使用 subxt 的更多详细信息,请访问 文档

集成测试

大多数测试都需要一个运行的 substrate 节点来通信。这是通过为每个测试实例启动一个 substrate 节点来完成的。它要求在您的路径上有一个最新的 substrate 可执行文件。

这可以通过 cargo 从源安装

cargo install --git https://github.com/paritytech/polkadot-sdk staging-node-cli --force

实际应用

请通过 PR 将您的项目添加到这个列表中。

  • cargo-contract CLI 用于与 Wasm 智能合约交互。
  • xcm-cli CLI 用于提交 XCM 消息。
  • phala-pherry Phala 区块链和链下安全工作者之间的中继。
  • crunch CLI 用于在 substrate 基础链上批量声明每个 Era 或 X 小时的质押奖励。
  • interbtc-clients interBTC 虚拟链的客户端实现;特别是保险库/中继和预言机。
  • tidext Tidechain 客户端,带有 Stronghold 签名者。
  • staking-miner-v2 提交 NPos 选举方案并获得奖励。
  • polkadot-introspector 用于监控 Polkadot 节点的工具。
  • ink! 智能合约语言,它使用 subxt 允许开发者进行他们的合约的 端到端测试
  • Chainflip 一个用于原生跨链交换的去中心化交易所。

替代方案

substrate-api-client 提供类似的功能。

许可证

此存储库中的全部代码均受 GPL-3.0Apache-2.0 许可证的许可。有关详细信息,请参阅 LICENSE 文件。

如果您对我们产品的许可有任何疑问,请联系我们

依赖关系

~18–36MB
~603K SLoC