# @circle-fin/provider-fee-v1 中文文档

规范地址：https://npmcn.com/package/%40circle-fin/provider-fee-v1/

版本：0\.4\.1
npm 元数据更新时间：2026-11-05T17:18:19.267Z
中文译文更新时间：2026-11-09T16:36:26.322Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40circle-fin/provider-fee-v1
原文对照：https://npmcn.com/package/%40circle-fin/provider-fee-v1/?lang=original

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

- 包体积（解压后）：637 kB，11 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：6 个
- 首次发布：2026-07-15T18:12:44.338Z
- 最新版本发布：2026-11-05T17:18:19.091Z
- 近 30 天下载量：46879（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

Circle 的引文 API 的客户端,该客户端为预付的 FORWARD 快速存储路径获取已签名的收费报价 CCTP v2 USDC 燃烧.

## 安装

```sh
npm install @circle-fin/provider-fee-v1
```

也可以使用：`pnpm add @circle-fin/provider-fee-v1`、`yarn add @circle-fin/provider-fee-v1`、`bun add @circle-fin/provider-fee-v1`

## README

# @ circle-fin/ 提供者- fee- v1

> \[大 此软件包被发布,供Circle的SDK软件包内使用. 出口 标记 `@internal` 并且目前不支持公共 API 。 他们可能 在没有兼容性保证的情况下,在释放之间更改.
> 
> 应用程序不应直接导入此软件包 .

软件包中包含 Circle 引文 API 集成,统一平衡 Kit 使用 fAST跨链存款,包括签名的收费检索和 审定。 客户端包装 `POST /v2/quote/burn/usdc/{sourceDomain}/{destinationDomain}`。终点是 无权限( 无认证) 和边速率有限制, 并且每 个特性标记 源链( 已禁用链返回) `503 SERVICE_NOT_ENABLED`,表面为 致命的,不可重复的错误).

使用 `@circle-fin/unified-balance-kit` 估计并支付存款:

```typescript
const estimate = await kit.estimateDeposit({
  from,
  amount: '10',
  token: 'USDC',
  to: { chain: 'Arc_Testnet' },
  config: { transferSpeed: 'FAST' },
})

const result = await kit.deposit({
  ...estimate,
  from,
})
```

## 验证已签名的引号

一个签名的引文是短命的 并绑定 准确的链上调用它将是 随同提交。 在你烧了之前, 重新检查它 根据完整的合同呼叫 通过 `POST /v2/quote/validate/usdc/{sourceDomain}`。 。 。 . `validateQuote` 返回时 引用是否还在 `claimable`,则 `failedChecks` 封锁(见 `QUOTE_REJECTION_REASONS`),以及当前权威的过期状态 源链提示.

```typescript
import { validateQuote } from '@circle-fin/provider-fee-v1'

const result = await validateQuote({
  sourceDomain: 3, // Arbitrum CCTP domain
  // The exact function and arguments you will submit on-chain.
  abiSignature:
    'depositForBurnWithHookAndFees(uint256,uint32,bytes32,address,bytes32,bytes,(bytes,address))',
  args: [
    '1000000',
    '26',
    '0x0000000000000000000000001111111111111111111111111111111111111111',
    '0x2222222222222222222222222222222222222222',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    '0x636374702d666f72776172640000000000000000000000000000000000000000',
    ['0x01abcd', '0x3333333333333333333333333333333333333333'],
  ],
  isTestnet: false,
})

if (result.claimable) {
  console.log('safe to submit', result.expiry.secondsRemaining)
} else {
  console.warn('do not submit', result.failedChecks)
}
```

## 页:1

-   `amount` 是一个小符号单位的小数字符串.
-   `feeToken` 默认为零地址( 本地地址); 通过 USDC 地址支付 以USDC计算的费用.
-   引文为短篇`expiry.expiresAt` 或者说 `expiry.expiresAtBlock`(三); 在上线前立即取出新的引号,而不是 夹住它.
-   `signedQuote` 是不透明的字节返回逐字记录;不要解码.
-   客户端进行一次尝试(没有运输重试/后退). 终点 边率有限,所以 `429` 呼叫者应退后再请求 而不是期待客户端重试.

## 常见问题

### @circle-fin/provider-fee-v1 是什么？

Circle 的引文 API 的客户端,该客户端为预付的 FORWARD 快速存储路径获取已签名的收费报价 CCTP v2 USDC 燃烧\.

### 如何安装 @circle-fin/provider-fee-v1？

在项目目录运行 npm install @circle-fin/provider-fee-v1，或使用 pnpm add / yarn add / bun add。

### @circle-fin/provider-fee-v1 支持 TypeScript 吗？

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

### @circle-fin/provider-fee-v1 支持 ESM 还是 CommonJS？

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

### @circle-fin/provider-fee-v1 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @circle-fin/provider-fee-v1 可以商用吗？

@circle-fin/provider-fee-v1 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @circle-fin/provider-fee-v1 的下载量有多少？

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

### @circle-fin/provider-fee-v1 还在维护吗？

最新版本 0\.4\.1 发布于 2026/11/06（3 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/07/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。