@cowprotocol/sdk-common

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

COW 协议SDK的通用公用事业和类型

中文使用文档
文档目录5 节
  1. 测试覆盖率
  2. 包括什么
  3. 安装
  4. 使用量
  5. 使用 CoW SDK 软件

SDK 常见

测试覆盖率

发言分支职能行数
StatementsBranchesFunctionsLines

这个包是核心CoW协议SDK的一部分. 它没有显著的独立功能,而是提供所有SDK软件包共享的重要类型,接口和公用设备的接入.

包括什么

  • 抽象提供者适配器 - 区块链相互作用的基本类别
  • 共享类型 - 整个SDK通用接口和类型
  • 公用事业 - 辅助功能和公用设施
  • 全球背景 - 软件包之间共享适配器上下文

安装

npm install @cowprotocol/sdk-common

使用量

import {
  AbstractProviderAdapter,
  AdapterTypes,
  Block,
  TransactionParams,
  PrivateKey,
  CowError,
  GenericContract,
  setGlobalAdapter,
} from '@cowprotocol/sdk-common'
import { ViemAdapter } from '@cowprotocol/sdk-viem-adapter'
import { createPublicClient, http, privateKeyToAccount } from 'viem'
import { sepolia } from 'viem/chains'

// Create and configure adapter
// There are EthersV5Adapter and EthersV6Adapter as well
// @cowprotocol/sdk-ethers-v5-adapter, @cowprotocol/sdk-ethers-v6-adapter
const adapter = new ViemAdapter({
  provider: createPublicClient({
    chain: sepolia,
    transport: http('YOUR_RPC_URL')
  }),
  // You also can set `walletClient` instead of `signer` using `useWalletClient` from wagmi
  signer: privateKeyToAccount('YOUR_PRIVATE_KEY' as `0x${string}`)
})

// Set up global adapter
setGlobalAdapter(adapter)

// Use shared types and utilities
const txParams: TransactionParams = {
  to: '0x...',
  data: '0x...',
  value: '0',
}

使用 CoW SDK 软件

在使用COW SDK时,这些通用的公用设施自动可用:

import {
  CowSdk,
  AbstractProviderAdapter,
  AdapterTypes,
  Block,
  TransactionParams,
  PrivateKey,
  CowError,
  GenericContract,
} from '@cowprotocol/cow-sdk'

说明: 这个软件包主要被设计为其他SDK软件包的依赖性,而不是直接被终端用户所使用. 大多数开发者应该使用 @cowprotocol/cow-sdk 软件包或特定特性软件包 @cowprotocol/sdk-trading。 。 。 .

版本与发布记录

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

版本发布日期距今
0.14.8latest2026/11/046 天前
0.14.72026/11/037 天前
0.14.62026/10/2615 天前
0.14.52026/10/1328 天前
0.14.42026/10/091 个月前
0.14.32026/10/071 个月前

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

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

@cowprotocol/sdk-common 是什么?

COW 协议SDK的通用公用事业和类型

如何安装 @cowprotocol/sdk-common?

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

@cowprotocol/sdk-common 支持 TypeScript 吗?

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

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

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

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

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

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

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

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

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