@ 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 估计并支付存款:

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),以及当前权威的过期状态 源链提示.

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 呼叫者应退后再请求 而不是期待客户端重试.