# @cowprotocol/sdk-common 中文文档

规范地址：https://npmcn.com/package/%40cowprotocol/sdk-common/

版本：0\.14\.8
npm 元数据更新时间：2026-11-04T11:30:55.540Z
中文译文更新时间：2026-11-10T21:08:04.367Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cowprotocol/sdk-common
原文对照：https://npmcn.com/package/%40cowprotocol/sdk-common/?lang=original
源码仓库：https://github.com/cowprotocol/cow-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：122 kB，6 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2025-08-01T17:45:09.727Z
- 最新版本发布：2026-11-04T11:30:55.070Z
- 近 30 天下载量：107020（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：51（近 12 个月 38 个）

## 中文简介

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

## 安装

```sh
npm install @cowprotocol/sdk-common
```

也可以使用：`pnpm add @cowprotocol/sdk-common`、`yarn add @cowprotocol/sdk-common`、`bun add @cowprotocol/sdk-common`

## README

![](https://github.com/cowprotocol/cow-sdk/raw/main/docs/images/CoW.png)

# SDK 常见

## 测试覆盖率

| 发言 | 分支 | 职能 | 行数 |
| --- | --- | --- | --- |
| ![Statements](https://img.shields.io/badge/statements-36%25-red.svg?style=flat) | ![Branches](https://img.shields.io/badge/branches-36.52%25-red.svg?style=flat) | ![Functions](https://img.shields.io/badge/functions-20.48%25-red.svg?style=flat) | ![Lines](https://img.shields.io/badge/lines-35.44%25-red.svg?style=flat) |

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

## 包括什么

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

## 安装

```bash
npm install @cowprotocol/sdk-common
```

## 使用量

```typescript
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时,这些通用的公用设施自动可用:

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

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

## 常见问题

### @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 和提交记录判断。