@cowprotocol/sdk-weiroll

中文文档
0.2.15发布于 2026/11/04MITTypeScriptESM + CJS构建来源已验证近 30 天下载 3.9万

牛协议 Weirol 包

中文使用文档
文档目录5 节
  1. 测试覆盖率
  2. 软件包来源
  3. 安装
  4. 使用量
  5. 特征

SDK威罗

测试覆盖率

发言分支职能行数
StatementsBranchesFunctionsLines

这个软件包为CoW协议SDK提供适配器-不可知威洛功能. Weirol是一个强大的脚本语言,用于在Ethereum上执行复杂的多步交易.

软件包来源

此软件包代表原作的重构版本 维罗尔.js 图书馆。 最初的库被紧密地与ethers.js v5结合了,但这个版本已经完全被重构为:

  • 删除醚 v5 依赖性 - 与任何支持的块链库合作
  • 支持多个适配器 - 与乙醚v5、乙醚v6和viem相容
  • 保持 API 兼容性 - 100%与原始 Weirol.js API兼容
  • 启用 SDK 集成 - 与《生物圈议定书》SDK生态系统无缝结合

安装

npm install @cowprotocol/sdk-weiroll
or
pnpm add @cowprotocol/sdk-weiroll
or
yarn add @cowprotocol/sdk-weiroll

使用量

import {
  WeirollPlanner,
  createWeirollContract,
  createWeirollDelegateCall,
  WeirollCommandFlags,
} from '@cowprotocol/sdk-weiroll'
import { EthersV6Adapter } from '@cowprotocol/sdk-ethers-v6-adapter'
import { JsonRpcProvider, Wallet } from 'ethers'

// Configure the adapter
const provider = new JsonRpcProvider('YOUR_RPC_URL')
const wallet = new Wallet('YOUR_PRIVATE_KEY', provider)
const adapter = new EthersV6Adapter({ provider, signer: wallet })

// Create weiroll contract wrapper
const contract = adapter.getContract(contractAddress, abi)
const weirollContract = createWeirollContract(contract, WeirollCommandFlags.CALL)

// Plan weiroll transaction
const planner = new WeirollPlanner()
planner.add(weirollContract.someFunction(param1, param2))

// Generate delegate call
const evmCall = createWeirollDelegateCall((planner) => {
  planner.add(weirollContract.someFunction(param1, param2))
})

特征

  • 多步骤交易 - 规划和执行复杂的交易序列
  • 气体优化 - 通过代表电话高效执行
  • 返回价值链 - 将一个呼叫的产出用作另一个呼叫的投入
  • 适应者不可知论 - 与乙醚v5、v6和viem合作
  • 类型安全 - 全部类型脚本支持

说明: 此软件包与 Weirol.js 原始库保持了100%的API相容性,同时增加了对多块链适配器的支持.

版本与发布记录

@cowprotocol/sdk-weiroll 共发布 62 个版本,首次发布于 2025/08/02;过去 12 个月发布了 45 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.15latest2026/11/046 天前
0.2.142026/11/037 天前
0.2.132026/10/2615 天前
0.2.122026/10/1328 天前
0.2.112026/10/091 个月前
0.2.102026/10/071 个月前

其他发布通道:next → 0.2.0-beta.0。

关于 @cowprotocol/sdk-weiroll 的常见问题

@cowprotocol/sdk-weiroll 是什么?

牛协议 Weirol 包

如何安装 @cowprotocol/sdk-weiroll?

在项目目录运行 npm install @cowprotocol/sdk-weiroll,或使用 pnpm add / yarn add / bun add。

@cowprotocol/sdk-weiroll 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@cowprotocol/sdk-weiroll 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@cowprotocol/sdk-weiroll 可以商用吗?

@cowprotocol/sdk-weiroll 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@cowprotocol/sdk-weiroll 的下载量有多少?

根据 npm 官方下载统计,@cowprotocol/sdk-weiroll 在 2026/10/11 – 2026/11/09 这 30 天内被下载 39,191 次,日均约 1,306 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cowprotocol/sdk-weiroll 还在维护吗?

最新版本 0.2.15 发布于 2026/11/04(6 天前);至今共发布 62 个版本,其中过去 12 个月发布了 45 个;首次发布于 2025/08/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。