Skip to main content
即刻安装 Cobo WaaS Skill,在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API,显著提升开发效率 🚀
本更新日志详细记录了 WaaS 2.0 API 的所有新增和变更内容。您可以从 GitHub 下载 WaaS 2.0 API 规范。 有关支付相关操作的变更,请参阅支付解决方案的发布历史

v1.31.0

此版本于 2026 年 2 月 4 日发布。

兼容性变更

新功能

  • 增强了 转账代币调用智能合约 接口,新增 pre_check 请求参数,允许你控制交易的预检查/校验逻辑。
    • 目前仅支持 TRON

v1.30.0

此版本于 2026 年 1 月 22 日发布。

兼容性变更

新功能

  • 增强 Get transaction informationList all transactions 操作,以便更好地识别由 WalletConnect 发起的交易。
    • cobo_category 字段中新增 WalletConnect 枚举值。
    • extra_type=TransactionWalletConnectInfo 时,在 extra 字段中新增 JSON 数据,用于提供 WalletConnect 交易的更多详情。

优化

  • List swap activities 操作中新增 request_id 查询参数,支持按指定 request_id 过滤 swap activities。

v1.29.0

本版本于 2025 年 12 月 30 日发布。

新功能

v1.28.0

本版本于 2025 年 12 月 17 日发布。

兼容性变更

  • TransactionRawTxInfo 模型中,为 used_nonce 字段新增了 int64 格式。

新功能

改进

v1.27.0

本版本于 2025 年 11 月 26 日发布。

改进

v1.26.0

本版本于 2025 年 11 月 12 日发布。

新功能

改进

  • TokenizationTokenInfo 模型中新增 archivedtoken_standard 属性。
  • 列出代币化支持的链 操作中新增 token_standard 查询参数,用于根据代币标准进行筛选。
  • 废弃重新发送交易操作,对于失败交易,请重新发起新的交易。
  • 废弃估算 Fee Station 交易费用操作。请改用检查 Fee Station 可用性操作。
  • 优化检查 Fee Station 可用性操作:
    • amounttoken_id 请求参数不再为必填参数。
    • 新增 fee_token_id 请求参数,用于指定支付 gas 费用的代币。
    • 新增 sponsored_token_id 响应字段,用于标识代付交易所使用的代币。
  • 新增 DisableAutoFuel 选项,可用于代币转账调用智能合约操作的 auto_fuel 配置中。
  • 扩展 cobo_category 枚举,新增以下用于 Fee Station、Tokenization 与签名相关场景的枚举值:
    • GasFeeSponsor
    • GasFeeSponsorRefund
    • Tokenization
    • TokenizationGasSponsor
    • TokenSwap
    • NonceAccountSign
    • FeePayerSign

v1.25.0

本版本于 2025 年 10 月 15 日发布。

新功能

改进

  • 新增 Webhook 事件类型 以支持 KYT 扫描状态更新通知:compliance.kyt.screenings.status.updated

v.1.24.0

本版本于 2025 年 10 月 15 日发布。

新功能

改进

  • Sign Message 操作中移除了 BTC_EIP_191_SignatureRaw_Message_Signature 模型。
  • Call smart contract 操作中新增 STELLAR_Contract模型,用于管理 Stellar 网络上的 trustline。
  • 新增 SolContractCallAddressLookupTableAccount 模型,以支持使用 Solana Address Lookup Tables。
  • FuelingInfo 模型中添加了 main_transaction_id 属性,用于指示主交易。

v.1.23.0

本版本于 2025 年 9 月 17 日发布。

重大变更

  • 更新了 列出审批详情 操作的响应模式,添加和修改了多个字段。
  • 更新了 列出地址簿条目 操作的行为:
    • 当同时提供 addresslabel 时,结果现在仅在两个条件都匹配时返回(之前只要一个条件匹配就返回)。
    • chain_id 参数已从必填改为选填。

新功能

改进

  • 添加了 chain_identifier 属性到 chain 模型,用于按执行逻辑对链进行分组。例如,ETH 用于所有 EVM 兼容的链(以太坊、BNB Smart Chain、Polygon)。
  • 添加了 biz_org_id 属性到 获取团队信息 操作的响应模式,用于提供给 Cobo 客户支持帮助快速定位团队。
  • 新增 Webhook 事件类型 以支持合规处置状态更新通知:compliance.disposition.status.updated

v1.22.0

本版本于 2025 年 8 月 27 日发布。

新功能

改进

  • 您可以在使用创建钱包 操作时通过设置 enable_auto_sweep 参数为 true 来启用 MPC 钱包和全托管钱包(Web3 钱包)的自动代币归集功能。

v1.21.0

本版本于 2025 年 8 月 13 日发布。

新功能

改进

  • TransactionCoboCategory 模型中新增了合规相关的枚举值:
    • ScreenAppRefund
    • ScreenAppIsolate
    • ComplianceRefund
    • ComplianceIsolate

v1.20.0

本版本于 2025 年 7 月 30 日发布。

改进

  • Fee Station 交易的 AutoFuelType 枚举新增了 UsePortalPreference 选项。此选项允许您使用在 Cobo Portal 上设置的支付偏好,而无需在每个 API 调用中指定某种交易费用支付模式。
  • EstimateContractCallFeeParams 模型中,将 destination 参数设为可选。
  • Call smart contract 操作(EVM 合约调用)新增了 calldata 字段的最大长度限制,为 65,000 字符。

v1.19.1

本版本于 2025 年 7 月 17 日发布。

改进

  • 增加了当创建交易和获取交易信息时对 Solana 和 Filecoin 费用模型的支持,详情请参阅 费用模型
  • 引入了新的 webhook event types 用于 token 或 chain 状态变化
    • wallet.token.disabled
    • wallet.chain.disabled
    • token.suspended.deposit
    • token.suspended.withdraw
  • 添加了新的 交易子状态RejectedByCobo,用于指示交易因未满足合规要求而被拒绝。

v1.18.0

本版本于 2025 年 7 月 2 日发布。

新功能

改进

  • 优化了 List enabled tokens 操作,支持按 token ID 进行过滤。
  • 引入了新的 webhook event types 以支持更精细的余额更新通知:
    • wallets.mpc.balance.updated
    • wallets.web3.balance.updated

v1.17.0

本版本于 2025 年 6 月 18 日发布。

新功能

改进

  • Transfer token 操作新增支持使用钱包 ID 进行全托管钱包(资产钱包)转账。该功能需要白名单访问权限。您需要联系 [email protected] 申请白名单。实现该功能可能需要更新您现有的交易历史记录数据处理。

v1.16.0

本版本于 2025 年 5 月 28 日发布。

新功能

改进

  • 添加了估算交易费用操作,允许您通过添加 replaced_transaction_id 属性到请求负载来估算替换交易的费用。
  • 添加了 TransactionCoboCategory Schema 的新值,以支持更多使用场景。
  • 添加了 coinbase_maturity 属性到 ChainInfo Schema,用于指示 coinbase 成熟所需的确认数量。
  • 添加了两个 交易子状态PendingCoboKYTCheckRejectedByCoboKYT
  • 添加了 is_frozen 属性到 列出 UTXOs 操作的响应,用于指示每个 UTXO 是否当前被冻结且不可用于交易。

v1.15.0

本版本于 2025 年 5 月 14 日发布。

改进

  • 添加了以下交易子状态以支持更精细的交易审查场景:
    • PendingCoboCheck
    • RejectedTransactionPolicy
    • RejectedByScreeningApp
    • PendingScreeningAppCheck
  • 添加了 estimated_fee_used 属性到 TransactionEvmEip1559FeeTransactionEvmLegacyFeeTransactionUtxoFeeTransactionFixedFee Schema,用于指示 MPC 钱包和全托管钱包(Web3 钱包)交易信息检索时的估计交易费用。
  • 添加了 wallet_typewallet_subtype 查询参数到 列出所有交易 操作,允许您按钱包类型和子类型过滤交易。
  • 添加了 wallet_subtypeencoding 属性到 列出地址簿条目 操作的响应,提供更详细的地址使用背景。
  • 添加了 TSS 请求事件和回调负载的数据结构。

v1.14.0

本版本于 2025 年 4 月 23 日发布。

新功能

改进

  • 新增了 Webhook 事件类型,支持更多实时更新:
    • wallets.token_listing.failed
    • wallets.token_listing.succeeded
    • payment.transaction.created
    • payment.transaction.late
    • payment.transaction.held
    • payment.status.updated
    • payment.refund.status.updated
    • payment.settlement.status.updated
  • 新增了 wallet_typewallet_sub_type 字段到 wallet.token.enabledwallet.chain.enabled Webhook 事件,用于指明支持的钱包类型和子类型。
  • 优化了列出 Fee Station 代币余额操作,添加了 chain_id 字段到响应。
  • 优化了列出所有交易操作。现在,如果未指定 min_created_timestampmax_created_timestamp,它将默认返回过去 90 天内的交易。

v1.13.0

本版本于 2025 年 4 月 9 日发布。

重大变更

  • 更新钱包 接口中,name 属性现在为必填项。
  • AddressEncoding 字段现在返回 ENCODING_DEFAULT 而不是空字符串("")作为默认值。

改进

  • 新增了 CustodialWeb3TransferSource Schema,以支持来自全托管钱包(Web3 钱包)的 Replace-By-Fee(RBF)交易。现在你可以通过撤销交易加速交易 接口从全托管钱包(Web3 钱包)发起 RBF 交易。
  • 新增了以下交易 子状态,用于更精细地追踪交易进度和状态变化:
    • PendingSignerApproval
    • PendingSignerProcessing
    • RejectedBySigner
    • FailedSignerTimeout
    • InsufficientBalance
    • InsufficientBalanceFundLocked
    • PendingSystemProcessing
    • SystemProcessingOngoing
    • ReOrged
  • 新增了以下消息签名相关的 Schema:TransactionBIP137DestinationTransactionBIP322DestinationTransactionCosmosAdr36DestinationTransactionMessageSignBTCEIP191Destination。现在你可以使用这些类型 签署消息,并通过这些目标类型 查看交易记录
  • AddressEncoding Schema 中新增了枚举值:ENCODING_ADA_BYRONENCODING_ADA_SHELLEYENCODING_DEFAULT,以支持更多地址编码格式。
  • Transaction Schema 中引入了新的 extra 字段,用于承载结构化、可扩展的业务相关信息。该字段以 JSON 字符串形式返回,代表某一种具体的数据结构类型。
  • BabylonStakingActivityDetailExtra Schema 中移除了字段:param_versionwithdraw_from_typeslash_from_typestake_amount

v1.12.0

此版本于 2025 年 3 月 27 日发布。

新功能

现在您可以使用以下操作查询 Fee Station 信息: 此外,我们还引入了一个新的 Operation 来更新钱包余额:

改进

  • 在关键交易操作中添加了对全托管钱包(Web3 钱包)的支持。
  • 添加了新的 Webhook 事件类型 wallet.token.enabledwallet.chain.enabled,以及新的数据类型 TokensChains。有关更多详细信息,请参阅 Webhook 事件类型和数据类型
  • 扩展了以下 Schema:
    • TransactionMessageSignEIP712Destination:添加了 safe_tx_extra_dataraw_structured_data,以增强 Safe 交易上下文信息
    • BabylonStakingActivityDetailExtra:添加了 withdraw_from_typeslash_from_type,以改进 Babylon 质押活动信息
    • Transaction:添加了 cobo_category,用于 Cobo 定义的交易分类
    • TransactionSelectedUtxo:添加了 redeem_scriptrevealed_script,以提供详细的 UTXO 交易信息
  • 优化了 TransactionUtxoFee Schema,将 fee_rate 设为可选字段
  • List all transactions 操作现在支持按方向排序。

v1.11.0

此版本发布于 2025 年 3 月 12 日。

改进

  • 调用智能合约 操作中添加了对 Solana (SOL) 合约的支持。
  • 估算交易费用 操作的响应中添加了 reserved_fee 属性,用于表示提交交易 calldata 到 L1(Layer 1)的估计费用。

v1.10.0

此版本发布于 2025 年 3 月 3 日。

新功能

现在,您可以通过以下操作启动并跟踪 Babylon 空投和 Babylon 第二阶段的注册:

改进

  • TransactionRawTxInfo 模型中添加了 utxo_change 属性,包含 UTXO 变更信息。
  • StakingPoolType 模型中添加了 3 个枚举值 BitHiveBERABeaconBeraChainBGT
  • StakingPoolId 模型中添加了 6 个枚举值 bithive_signetbithivebeacon_berabeacon_bera_testnetberachain_bgtberachain_bgt_testnet
  • AddressesEventData 模型中添加了 wallet_id 属性。
  • MpcContractCallSourceMpcMessageSignSourceMpcTransferSource 模型中添加了 mpc_used_key_share_holder_group 属性,以表明此交易使用的私钥分片持有者组。

v1.9.0

此版本发布于 2025 年 2 月 19 日。

新功能

改进

  • 增强了列出 UTXO 操作,新增 tx_hash 查询参数,支持通过交易哈希查找 UTXO。
  • 增强了签署消息操作,以支持原始消息和BTC EIP-191签名。
  • 增强了在钱包中创建地址操作,以支持生成调整后的地址。
  • 增强了代币转账操作,在 AddressTransferDestination 模型中添加了新的 change_output_type 属性。
  • TransactionDepositToAddressDestination 模型中添加了 tx_info 属性,包括 vout_n 索引信息。

v1.8.0

此版本发布于 2025 年 1 月 8 日。

新功能

改进

  • 新增 webhook 事件类型 wallets.addresses.createdwallets.createdmpc_vaults.created,以及新的事件数据类型 AddressesWalletInfoMPCVault,以优化 webhook 事件的处理。
  • 对质押操作进行了多项改进:
    • 新增 BabylonStakingActivityDetailExtraEthStakingActivityDetailExtraCoreStakingActivityDetailExtra 模型,用于表示各质押协议的额外详细信息。
    • 列出质押活动 操作中新增 request_id 查询参数,用于根据特定请求 ID 筛选活动。
    • CreateStakeActivity 模型中将 extra 属性设为可选。
  • AddressInfo 模型中新增 root_pubkey 属性,用于表示地址的根扩展公钥。
  • 新增 TransactionSelectedUtxo 模型,用于表示交易中已选择的 UTXO 信息。

v1.7.0

此版本于 2024 年 12 月 19 日发布。

重大变更

  • MPCProject 模型中将 create_timestamp 重命名为 created_timestamp,以提高命名一致性。

新功能

改进

  • BabylonValidator 模型中将多个字段设为可选。
  • 通过在 EthStakingExtra 模型中添加 beacon_validators 属性来扩展 ETH 质押功能,以表示验证者信息列表。
  • 通过将 StakingPoolId 模型改为枚举类型来改进。
  • 扩展了 ActivityAction 模型,添加了更多枚举以涵盖质押活动中可能发生的更多操作。
  • 弃用了”估算质押费用”操作的原始版本。

v1.6.0

此版本于 2024 年 11 月 13 日发布。

重大变更

  • 移除了”获取地址信息”操作。
  • AddressTransferDestination 模型中将 amount 设为必需属性。

新功能

改进

  • 通过在 TransactionStatusTransactionSubStatus 模型中添加和移除某些状态和子状态来改进交易跟踪。
  • TSSRequestStatus 模型中添加了 MPCProcessing 状态,以表示 TSS 请求批准正在等待启动。
  • 移除了 MpcContractCallSource 模型中的 nonce 属性。

v1.5.0

此版本于 2024 年 10 月 24 日发布。

重大变更

在此版本中,以下参数名称在 Python SDK 中已更新:
  • ORG_MINUS_CONTROLLEDORG_CONTROLLED
  • USER_MINUS_CONTROLLEDUSER_CONTROLLED
  • SAFE_LEFT_CURLY_BRACKET_WALLET_RIGHT_CURLY_BRACKETSAFE_WALLET
请更新您的代码以反映这些更改,因为以前的参数名称不再受支持。

新功能

改进

  • 获取代币信息 操作的响应中添加了 asset_model_type 属性,用于指示代币是否使用帐户模型或 UTXO 模型。
  • TransactionEvmContractDestination 模型中添加了 calldata_info 属性,用于提供智能合约 calldata 的更详细表示。
  • 添加了 TransactionRawMessageSignDestination 模型,并在 destination_type 枚举中添加了 Raw_Message_Signature 值,用于表示原始消息签名的交易目的地。
  • 列出所有交易 操作中添加了 StakeUnstake 作为 types 查询参数的新可能值。
  • exchange_id 枚举中添加了 bitmartbitfinex 作为新可能值。
  • TransactionSmartContractSafeWalletSource 模型中,delegate 属性不再是必需属性。

v1.4.0

此版本于 2024 年 9 月 25 日发布。

改进

  • 通过在 TransactionStatusTransactionSubStatus 模型中添加和移除某些状态和子状态来改进交易跟踪。
  • TSSRequestStatus 模型中添加了 MPCProcessing 状态,以表示 TSS 请求批准正在等待启动。
  • 移除了 MpcContractCallSource 模型中的 nonce 属性。

v1.3.0

此版本于 2024 年 9 月 12 日发布。

新功能

改进

  • 检查 Cobo Loop 转账 操作的路径从 /wallets/check_loop_transfers 更改为 /transactions/check_loop_transfers
  • TokenInfo 模型中添加了 dust_thresholdcustodial_minimum_deposit_threshold 属性,用于指示托管钱包的最小提币和充币金额。
  • ChainInfo 模型中添加了 confirming_threshold 属性,用于指示每个链上交易所需的确认数量。

Bug 修复

  • 修复了使用 WaaS SDK 执行与智能合约调用或消息签名相关操作时出现的问题。

v1.2.0

此版本于 2024 年 8 月 21 日发布。

新功能

改进

  • sub_wallet_id 属性重命名为 trading_account_type。受影响的模型包括:
    • ExchangeTransferSource
    • ExchangeTransferDestination
    • TransactionTransferToWalletDestination
    • TransactionExchangeWalletSource
    • TransactionDepositFromWalletSource
    • TransactionDepositToWalletDestination
  • TransactionSubStatus 枚举中添加了 PendingApprovalStart 值,用于指示需要用户特定操作才能继续交易的状态。
  • MPCWalletInfo 模型中添加了 project_namevault_name 属性,用于指示项目名称和 Vault 名称。
  • TSSRequest 模型中添加了 descriptioncreated_timestamp 属性,用于指示 TSS 请求的描述和创建时间。
  • KeyShareHolder 模型中添加了 account_id 属性,用于指示钥匙份额持有者的 Cobo Portal 帐户 ID。
  • TransactionMPCWalletSource 模型中添加了 signer_key_share_holder_group_id 属性,用于指示交易签名者的钥匙份额持有者组 ID。
  • 创建 TSS 请求 操作的请求包体中添加了 description 属性,用于指示 TSS 请求的描述。

v1.1.0

此版本于 2024 年 8 月 7 日发布。

新功能

添加了 OAuth 操作,用于 Cobo Portal Apps 开发者:

改进

  • 列出 webhook 事件日志 的响应中,data.response_body 的数据类型从对象更新为字符串。
  • 在以下模型中添加了 signer 属性,用于指示钥匙份额持有者的 TSS Node 是否是指定的交易签名者:
    • CreateKeyShareHolder
    • KeyShareHolder
  • node_count 属性重命名为 participants,用于以下模型:
  • pubkey 属性重命名为 root_pubkey,用于 RootPubkey 模型。
  • TSSGroups 模型中添加了 root_pubkey 属性,用于指示 Vault 的根扩展公钥。
  • 将多个与时间戳相关的属性重命名为使用“_timestamp”后缀。受影响的模型包括:
    • Transaction
    • TransactionBlockInfo
    • TransactionTimeline
    • KeyShareHolderGroup
    • MPCVault

v1.0.0

这是 Cobo WaaS 2.0 API 的第一个版本。 此版本包括对 托管钱包MPC 钱包 的支持,包括以下类别的操作: