v1.31.0
此版本于 2026 年 2 月 4 日发布。兼容性变更
- 增强了 EOA 钱包余额模型,新增
frozen字段,用于表示冻结金额。受影响的接口:
新功能
v1.30.0
此版本于 2026 年 1 月 22 日发布。兼容性变更
- 增强 List supported chains、Get chain information、List enabled chains 和 List supported tokens 操作,以支持单次请求返回更多条目。
- 将
limit的最大值提升至 500。 - 将
chain_ids和token_ids单次请求支持的最大条目数提升至 500。
- 将
新功能
- 增强 Get transaction information 和 List 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 日发布。新功能
- 新增用于 KYA 地址扫描和查询的操作:
v1.28.0
本版本于 2025 年 12 月 17 日发布。兼容性变更
- 在
TransactionRawTxInfo模型中,为used_nonce字段新增了int64格式。
新功能
- 新增用于支持 Babylon BTC 质押扩展至下一阶段的操作:
改进
- 在 调用智能合约 操作中新增对 Cosmos 链智能合约的支持。
v1.27.0
本版本于 2025 年 11 月 26 日发布。改进
v1.26.0
本版本于 2025 年 11 月 12 日发布。新功能
改进
-
在
TokenizationTokenInfo模型中新增archived和token_standard属性。 -
在 列出代币化支持的链 操作中新增
token_standard查询参数,用于根据代币标准进行筛选。 - 废弃重新发送交易操作,对于失败交易,请重新发起新的交易。
- 废弃估算 Fee Station 交易费用操作。请改用检查 Fee Station 可用性操作。
-
优化检查 Fee Station 可用性操作:
amount和token_id请求参数不再为必填参数。- 新增
fee_token_id请求参数,用于指定支付 gas 费用的代币。 - 新增
sponsored_token_id响应字段,用于标识代付交易所使用的代币。
-
新增
DisableAutoFuel选项,可用于代币转账 和 调用智能合约操作的auto_fuel配置中。 -
扩展
cobo_category枚举,新增以下用于 Fee Station、Tokenization 与签名相关场景的枚举值:GasFeeSponsorGasFeeSponsorRefundTokenizationTokenizationGasSponsorTokenSwapNonceAccountSignFeePayerSign
v1.25.0
本版本于 2025 年 10 月 15 日发布。新功能
- 新增合规相关操作:
改进
- 新增 Webhook 事件类型 以支持 KYT 扫描状态更新通知:
compliance.kyt.screenings.status.updated。
v.1.24.0
本版本于 2025 年 10 月 15 日发布。新功能
- 您现在可以使用 Check Fee Station usage 操作来检查 Fee Station 对于某笔交易是否适用。
改进
-
从 Sign Message 操作中移除了
BTC_EIP_191_Signature和Raw_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 日发布。重大变更
- 更新了 列出审批详情 操作的响应模式,添加和修改了多个字段。
- 更新了 列出地址簿条目 操作的行为:
- 当同时提供
address和label时,结果现在仅在两个条件都匹配时返回(之前只要一个条件匹配就返回)。 chain_id参数已从必填改为选填。
- 当同时提供
新功能
- 您现在可以使用 WaaS 2.0 API 对交易进行合规处置,相关操作包括:
- 您现在可以使用 WaaS 2.0 API 管理地址簿条目,相关操作包括:
改进
- 添加了
chain_identifier属性到chain模型,用于按执行逻辑对链进行分组。例如,ETH用于所有 EVM 兼容的链(以太坊、BNB Smart Chain、Polygon)。 - 添加了
biz_org_id属性到 获取团队信息 操作的响应模式,用于提供给 Cobo 客户支持帮助快速定位团队。 - 新增 Webhook 事件类型 以支持合规处置状态更新通知:
compliance.disposition.status.updated。
v1.22.0
本版本于 2025 年 8 月 27 日发布。新功能
- 您现在可以使用 WaaS 2.0 API 发行和管理您的自定义代币,相关操作包括:
- 添加了以下用于创建和管理自动归集任务和配置归集地址的操作:
- 添加了以下用于跟踪交易审批信息和获取审批模板的操作:
改进
- 您可以在使用创建钱包 操作时通过设置
enable_auto_sweep参数为true来启用 MPC 钱包和全托管钱包(Web3 钱包)的自动代币归集功能。
v1.21.0
本版本于 2025 年 8 月 13 日发布。新功能
- 添加了 Estimate maximum transferable value 操作,用于估算基于指定费用设置的最大可转账值。我们推荐使用此新操作取代 Get maximum transferable value,因为未来该操作将被废弃。
改进
- 在
TransactionCoboCategory模型中新增了合规相关的枚举值:ScreenAppRefundScreenAppIsolateComplianceRefundComplianceIsolate
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.disabledwallet.chain.disabledtoken.suspended.deposittoken.suspended.withdraw
-
添加了新的 交易子状态,
RejectedByCobo,用于指示交易因未满足合规要求而被拒绝。
v1.18.0
本版本于 2025 年 7 月 2 日发布。新功能
- 添加了以下支付者和充值地址管理操作:
- 添加了 Get organization information 操作,用于获取与当前 API Key 关联的团队的详细信息。
改进
- 优化了 List enabled tokens 操作,支持按 token ID 进行过滤。
- 引入了新的 webhook event types 以支持更精细的余额更新通知:
wallets.mpc.balance.updatedwallets.web3.balance.updated
v1.17.0
本版本于 2025 年 6 月 18 日发布。新功能
- Create settlement request 接口新增支持加密货币提现,实现直接结算到加密货币地址。同时,新增了 List crypto addresses 操作,用于查看所有已注册的提现地址。
- 在 Create refund order 操作中支持指定开发者费用。
- 增加了用于 Checkout SDK 认证的 OAuth 操作:
- Get Access Token:获取初始 Access Token 和 Refresh Token。
- Refresh Access Token:更新 Access Token。
改进
- Transfer token 操作新增支持使用钱包 ID 进行全托管钱包(资产钱包)转账。该功能需要白名单访问权限。您需要联系 [email protected] 申请白名单。实现该功能可能需要更新您现有的交易历史记录数据处理。
v1.16.0
本版本于 2025 年 5 月 28 日发布。新功能
- 添加了以下用于管理应用流程的操作:
- 添加了批量检查 UTXOs操作,允许您验证指定钱包和代币的未花费交易输出(UTXOs)的存在性和详细信息。此操作支持 MPC 钱包和全托管钱包(Web3 钱包)。
改进
- 添加了估算交易费用操作,允许您通过添加
replaced_transaction_id属性到请求负载来估算替换交易的费用。 - 添加了
TransactionCoboCategorySchema 的新值,以支持更多使用场景。 - 添加了
coinbase_maturity属性到ChainInfoSchema,用于指示 coinbase 成熟所需的确认数量。 - 添加了两个 交易子状态:
PendingCoboKYTCheck和RejectedByCoboKYT。 - 添加了
is_frozen属性到 列出 UTXOs 操作的响应,用于指示每个 UTXO 是否当前被冻结且不可用于交易。
v1.15.0
本版本于 2025 年 5 月 14 日发布。改进
- 添加了以下交易子状态以支持更精细的交易审查场景:
PendingCoboCheckRejectedTransactionPolicyRejectedByScreeningAppPendingScreeningAppCheck
- 添加了
estimated_fee_used属性到TransactionEvmEip1559Fee、TransactionEvmLegacyFee、TransactionUtxoFee和TransactionFixedFeeSchema,用于指示 MPC 钱包和全托管钱包(Web3 钱包)交易信息检索时的估计交易费用。 - 添加了
wallet_type和wallet_subtype查询参数到 列出所有交易 操作,允许您按钱包类型和子类型过滤交易。 - 添加了
wallet_subtype和encoding属性到 列出地址簿条目 操作的响应,提供更详细的地址使用背景。 - 添加了 TSS 请求事件和回调负载的数据结构。
v1.14.0
本版本于 2025 年 4 月 23 日发布。新功能
- 添加了支付场景的一系列操作,包括支付订单、退款、结算、商户、银行账户和汇率,以支持完整的支付流程。
- 添加了估算 Fee Station 交易费用 操作,用于估算 Fee Station 发起的充值交易的 Gas 费。
- 添加了以下操作以支持通过自助提交上币请求:
改进
-
新增了 Webhook 事件类型,支持更多实时更新:
wallets.token_listing.failedwallets.token_listing.succeededpayment.transaction.createdpayment.transaction.latepayment.transaction.heldpayment.status.updatedpayment.refund.status.updatedpayment.settlement.status.updated
-
新增了
wallet_type和wallet_sub_type字段到wallet.token.enabled和wallet.chain.enabledWebhook 事件,用于指明支持的钱包类型和子类型。 -
优化了列出 Fee Station 代币余额操作,添加了
chain_id字段到响应。 -
优化了列出所有交易操作。现在,如果未指定
min_created_timestamp和max_created_timestamp,它将默认返回过去 90 天内的交易。
v1.13.0
本版本于 2025 年 4 月 9 日发布。重大变更
- 在 更新钱包 接口中,
name属性现在为必填项。 AddressEncoding字段现在返回ENCODING_DEFAULT而不是空字符串("")作为默认值。
改进
-
新增了
CustodialWeb3TransferSourceSchema,以支持来自全托管钱包(Web3 钱包)的 Replace-By-Fee(RBF)交易。现在你可以通过撤销交易和加速交易 接口从全托管钱包(Web3 钱包)发起 RBF 交易。 -
新增了以下交易 子状态,用于更精细地追踪交易进度和状态变化:
PendingSignerApprovalPendingSignerProcessingRejectedBySignerFailedSignerTimeoutInsufficientBalanceInsufficientBalanceFundLockedPendingSystemProcessingSystemProcessingOngoingReOrged
-
新增了以下消息签名相关的 Schema:
TransactionBIP137Destination、TransactionBIP322Destination、TransactionCosmosAdr36Destination和TransactionMessageSignBTCEIP191Destination。现在你可以使用这些类型 签署消息,并通过这些目标类型 查看交易记录。 -
在
AddressEncodingSchema 中新增了枚举值:ENCODING_ADA_BYRON、ENCODING_ADA_SHELLEY和ENCODING_DEFAULT,以支持更多地址编码格式。 -
在
TransactionSchema 中引入了新的extra字段,用于承载结构化、可扩展的业务相关信息。该字段以 JSON 字符串形式返回,代表某一种具体的数据结构类型。 -
从
BabylonStakingActivityDetailExtraSchema 中移除了字段:param_version、withdraw_from_type、slash_from_type和stake_amount。
v1.12.0
此版本于 2025 年 3 月 27 日发布。新功能
现在您可以使用以下操作查询 Fee Station 信息:- Get Fee Station transaction information
- List all Fee Station transactions
- List Fee Station addresses
- List Fee Station token balances
改进
-
在关键交易操作中添加了对全托管钱包(Web3 钱包)的支持。
-
您可以在以下操作中将
Web3设置为交易来源: -
您还可以在以下查询操作中查询源自
Web3交易来源的交易:
-
您可以在以下操作中将
-
添加了新的 Webhook 事件类型
wallet.token.enabled和wallet.chain.enabled,以及新的数据类型Tokens和Chains。有关更多详细信息,请参阅 Webhook 事件类型和数据类型。 -
扩展了以下 Schema:
TransactionMessageSignEIP712Destination:添加了safe_tx_extra_data和raw_structured_data,以增强 Safe 交易上下文信息BabylonStakingActivityDetailExtra:添加了withdraw_from_type和slash_from_type,以改进 Babylon 质押活动信息Transaction:添加了cobo_category,用于 Cobo 定义的交易分类TransactionSelectedUtxo:添加了redeem_script和revealed_script,以提供详细的 UTXO 交易信息
-
优化了
TransactionUtxoFeeSchema,将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 第二阶段的注册:- 列出 Babylon 空投的合格钱包
- 注册 Babylon 空投
- 列出所有 Babylon 空投注册
- 获取 Babylon 空投注册详情
- 列出 Babylon 第二阶段的合格抵押头寸
- 注册 Babylon 第二阶段
- 列出所有 Babylon 第二阶段注册
- 获取 Babylon 第二阶段注册详情
改进
- 在
TransactionRawTxInfo模型中添加了utxo_change属性,包含 UTXO 变更信息。 - 在
StakingPoolType模型中添加了 3 个枚举值BitHive、BERABeacon和BeraChainBGT。 - 在
StakingPoolId模型中添加了 6 个枚举值bithive_signet、bithive、beacon_bera、beacon_bera_testnet、berachain_bgt和berachain_bgt_testnet。 - 在
AddressesEventData模型中添加了wallet_id属性。 - 在
MpcContractCallSource、MpcMessageSignSource和MpcTransferSource模型中添加了mpc_used_key_share_holder_group属性,以表明此交易使用的私钥分片持有者组。
v1.9.0
此版本发布于 2025 年 2 月 19 日。新功能
- 为 MPC 钱包添加了按代币列出地址余额操作,以检索多个地址的代币余额。
- 增强了 MPC 钱包私钥分片持有者管理,新增操作:
- 获取私钥分片持有者信息:检索特定私钥分片持有者的详细信息。
- 列出所有私钥分片持有者:获取所有私钥分片持有者的综合列表。
- 添加了签署并广播交易操作,以及
Transaction模型中的raw_tx_info对象中的Built交易子状态和unsigned_raw_tx属性,以手动签署和广播未自动执行的构建交易。
改进
- 增强了列出 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.created、wallets.created和mpc_vaults.created,以及新的事件数据类型Addresses、WalletInfo和MPCVault,以优化 webhook 事件的处理。 - 对质押操作进行了多项改进:
- 新增
BabylonStakingActivityDetailExtra、EthStakingActivityDetailExtra和CoreStakingActivityDetailExtra模型,用于表示各质押协议的额外详细信息。 - 在 列出质押活动 操作中新增
request_id查询参数,用于根据特定请求 ID 筛选活动。 - 在
CreateStakeActivity模型中将extra属性设为可选。
- 新增
- 在
AddressInfo模型中新增root_pubkey属性,用于表示地址的根扩展公钥。 - 新增
TransactionSelectedUtxo模型,用于表示交易中已选择的 UTXO 信息。
v1.7.0
此版本于 2024 年 12 月 19 日发布。重大变更
- 在
MPCProject模型中将create_timestamp重命名为created_timestamp,以提高命名一致性。
新功能
- 添加了创建领取活动操作,用于领取质押奖励。
- 添加了估算质押费用操作的新版本,功能得到改进。
- 添加了对 CORE 协议质押的支持。
- 在以下操作的请求负载中添加了
auto_fuel属性,以启用Fee station进行自动交易费用支付:
改进
- 在
BabylonValidator模型中将多个字段设为可选。 - 通过在
EthStakingExtra模型中添加beacon_validators属性来扩展 ETH 质押功能,以表示验证者信息列表。 - 通过将
StakingPoolId模型改为枚举类型来改进。 - 扩展了
ActivityAction模型,添加了更多枚举以涵盖质押活动中可能发生的更多操作。 - 弃用了”估算质押费用”操作的原始版本。
v1.6.0
此版本于 2024 年 11 月 13 日发布。重大变更
- 移除了”获取地址信息”操作。
- 在
AddressTransferDestination模型中将amount设为必需属性。
新功能
- 添加了以下新操作:
- 获取 API Key信息:检索 API Key的详细信息。
- 检查多链地址有效性:验证多个链上的地址。
- 添加了对以太坊质押的支持。
改进
- 通过在
TransactionStatus和TransactionSubStatus模型中添加和移除某些状态和子状态来改进交易跟踪。 - 在
TSSRequestStatus模型中添加了MPCProcessing状态,以表示 TSS 请求批准正在等待启动。 - 移除了
MpcContractCallSource模型中的nonce属性。
v1.5.0
此版本于 2024 年 10 月 24 日发布。重大变更
在此版本中,以下参数名称在 Python SDK 中已更新:ORG_MINUS_CONTROLLED→ORG_CONTROLLEDUSER_MINUS_CONTROLLED→USER_CONTROLLEDSAFE_LEFT_CURLY_BRACKET_WALLET_RIGHT_CURLY_BRACKET→SAFE_WALLET
新功能
改进
- 在 获取代币信息 操作的响应中添加了
asset_model_type属性,用于指示代币是否使用帐户模型或 UTXO 模型。 - 在
TransactionEvmContractDestination模型中添加了calldata_info属性,用于提供智能合约 calldata 的更详细表示。 - 添加了
TransactionRawMessageSignDestination模型,并在destination_type枚举中添加了Raw_Message_Signature值,用于表示原始消息签名的交易目的地。 - 在 列出所有交易 操作中添加了
Stake和Unstake作为types查询参数的新可能值。 - 在
exchange_id枚举中添加了bitmart和bitfinex作为新可能值。 - 在
TransactionSmartContractSafeWalletSource模型中,delegate属性不再是必需属性。
v1.4.0
此版本于 2024 年 9 月 25 日发布。改进
- 通过在
TransactionStatus和TransactionSubStatus模型中添加和移除某些状态和子状态来改进交易跟踪。 - 在
TSSRequestStatus模型中添加了MPCProcessing状态,以表示 TSS 请求批准正在等待启动。 - 移除了
MpcContractCallSource模型中的nonce属性。
v1.3.0
此版本于 2024 年 9 月 12 日发布。新功能
- 您现在可以使用 WaaS 2.0 API 进行代币质押。质押操作包括:
- 添加了 广播已签名交易 操作,用于广播已签名交易。
改进
- 将 检查 Cobo Loop 转账 操作的路径从
/wallets/check_loop_transfers更改为/transactions/check_loop_transfers。 - 在
TokenInfo模型中添加了dust_threshold和custodial_minimum_deposit_threshold属性,用于指示托管钱包的最小提币和充币金额。 - 在
ChainInfo模型中添加了confirming_threshold属性,用于指示每个链上交易所需的确认数量。
Bug 修复
- 修复了使用 WaaS SDK 执行与智能合约调用或消息签名相关操作时出现的问题。
v1.2.0
此版本于 2024 年 8 月 21 日发布。新功能
- 添加了对 交易所钱包 和 智能合约钱包 的支持。添加了以下操作,用于交易所钱包:
- 添加了以下操作,用于批量支付:
- 您现在可以订阅与 TSS 请求相关的事件类型,以用于 webhook 端点。有关 TSS 请求相关事件类型的更多信息,请参阅 Webhook 事件类型和数据类型。
改进
- 将
sub_wallet_id属性重命名为trading_account_type。受影响的模型包括:ExchangeTransferSourceExchangeTransferDestinationTransactionTransferToWalletDestinationTransactionExchangeWalletSourceTransactionDepositFromWalletSourceTransactionDepositToWalletDestination
- 在
TransactionSubStatus枚举中添加了PendingApprovalStart值,用于指示需要用户特定操作才能继续交易的状态。 - 在
MPCWalletInfo模型中添加了project_name和vault_name属性,用于指示项目名称和 Vault 名称。 - 在
TSSRequest模型中添加了description和created_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 是否是指定的交易签名者:CreateKeyShareHolderKeyShareHolder
- 将
node_count属性重命名为participants,用于以下模型:- 创建项目 的请求包体
- 创建钥匙份额持有者组 的请求包体
KeyShareHolderGroup模型MPCProject模型
- 将
pubkey属性重命名为root_pubkey,用于RootPubkey模型。 - 在
TSSGroups模型中添加了root_pubkey属性,用于指示 Vault 的根扩展公钥。 - 将多个与时间戳相关的属性重命名为使用“_timestamp”后缀。受影响的模型包括:
TransactionTransactionBlockInfoTransactionTimelineKeyShareHolderGroupMPCVault
