SuperAPI AI 工具集

injective-usdc-integration

智能体与模型

查看项目

更新于 10-15 22:38

技能介绍

用途:在 Injective 应用中加入原生 USDC 支持。原生 USDC 由 Circle 发行,通过 Injective 的 MultiVM Token Standard 暴露,同一代币可在 EVM 合约与 Cosmos bank/exchange 模块间使用,无需单独内部桥。

主要能力:识别集成类型,包括代币元数据与余额(USDC 常量、EVM 地址解析为 Cosmos bank denom、余额展示、6 位小数);交易或抵押(优先原生 USDC 市场与 denom,不再把新永续路由到旧 USDT 市场);浏览器 USDC 支付(存款、充值、手续费、应用充值用 EIP-3009 transferWithAuthorization 配合应用 gas 中继,而非直接 MetaMask ERC-20 转账);CCTP 桥 UI(源链销毁、轮询 Circle attestation、在 Injective EVM 铸造);从 Injective 提现;以及 CCTP 销毁确认但未铸造时的恢复与调试。

必要用法:写代码前先读 references/constants.md。常用主网常量:INJECTIVE_EVM_CHAIN_ID = 1776、INJECTIVE_COSMOS_CHAIN_ID = 'injective-1'、INJECTIVE_CCTP_DOMAIN = 29、INJECTIVE_USDC_EVM_ADDRESS = '0xa00C59fF5a080D2b954d0c75e46E22a0c371235a'、INJECTIVE_USDC_DENOM = erc20:${INJECTIVE_USDC_EVM_ADDRESS.toLowerCase()}、USDC_DECIMALS = 6。EVM 调用用 0xa00C59fF5a080D2b954d0c75e46E22a0c371235a;Cosmos bank、exchange 与 indexer 流程用 erc20:0xa00c59ff5a080d2b954d0c75e46e22a0c371235a;CCTP 按 Circle domain 29 路由,而非 EVM chain ID 1776。浏览器支付建议用 EIP-3009:构造 TransferWithAuthorization 类型数据,用 eth_signTypedData_v4 签名,由应用自有 facilitator/gas 中继提交 transferWithAuthorization(from, to, value, validAfter, validBefore, nonce, v, r, s),并在中继交易回执确认 USDC Transfer 事件后再给用户入账。EIP-712 domain 为 name: 'USDC'、version: '2'、chainId: 1776、verifyingContract: 0xa00C59fF5a080D2b954d0c75e46E22a0c371235a。服务端中继需校验 from 与已认证用户 EVM 地址一致、to 为预期 facilitator/treasury、validBefore 较短(通常 10-20 分钟)、authorizationState(from, nonce) 为 false、balanceOf(from) 足够、verifyTypedData 或恢复签名者等于 from;facilitator 需保留足够原生 INJ 支付中继 gas,若报 sender balance < tx cost,应给 facilitator 的 0x 地址充 INJ 而非 USDC。CCTP V2 流程:校验金额、切换钱包到源 EVM 链、授权 TokenMessengerV2 花费源链原生 USDC、调用 depositForBurn、轮询 https://iris-api.circle.com/v2/messages/{srcDomain}?transactionHash={burnTxHash}、切换钱包到 Injective EVM、调用 MessageTransmitterV2.receiveMessage(message, attestation)。Injective 标准转账参数:destinationCaller = '0x' + '0'.repeat(64)、maxFee = 0n、minFinalityThreshold = 2000;Injective 在 Circle CCTP 中仅支持标准转账,不要假设 Injective 侧可用 Fast Transfer。

适用场景与限制:适用于浏览器应用、交易应用、钱包、桥组件与运维工具。前端需把 CCTP 视为两笔交易流程并展示两个 tx hash;铸造无需许可,标签页关闭后可从 burn hash 恢复;明确源链 gas 与 Injective EVM 上 INJ 的 gas 要求;不要把 USDC.e 或 USDCnb 等桥接变体作为 burnToken;代币计算用 decimal.js、BigInt 或 SDK parse-units,不用浮点;CCTP 源链配置应数据驱动。交易前端余额展示应保守:默认交易金额留空、由 Half/All-In 等显式控件填充、余额截断而非四舍五入、桥接或铸造后可用短期本地余额下限,待权威余额追平或过期后清除。迁移时先加原生 USDC 元数据与 denom 解析,再更新余额展示与子账户存取,优先活跃 /USDC 市场,更新标签,用 CCTP 原生 USDC 引导替换 deBridge USDT 引导,并补充 denom 解析、小数转换、市场过滤与源链选择测试。更新常量请参考 Injective USDC 文档、Circle CCTP EVM 合约地址、Circle USDC 合约地址与 Circle 支持链和 domain 文档。