Skip to main content
即刻安装 Cobo WaaS Skill,在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API,显著提升开发效率 🚀
在 WaaS 2.0 中,每笔交易都涉及一个来源和一个目的地。来源表示交易的起始位置,而目的地表示交易的去向,例如钱包地址、签名、合约等。每种交易类型对应一组特定的来源和目的地类型。例如,在提币交易中,来源将是 Cobo Portal 上创建的钱包,而目的地将是钱包地址或交易所钱包。

每种交易类型的来源和目的地

请参阅下表,了解每种交易类型对应的来源和目的地类型。每种来源类型和目的地类型的详细定义可以在表格下方找到。
如果您在 Cobo Portal 上的两个钱包之间转移代币,将记录两笔交易:一笔存入目的地钱包,一笔从来源钱包提取。
交易类型交易来源类型交易目的地类型
Deposit - Cobo Loop 转账DepositFromLoopDepositToAddress
Deposit - 交易所钱包之间转账DepositFromWalletDepositToWallet
Deposit - 其他充币交易DepositFromAddressDepositToAddress
Withdrawal - 交易所钱包之间转账Main
Sub
ExchangeWallet
Withdrawal - 其他提币交易Asset
Web3
Org-Controlled
User-Controlled
Safe{Wallet}
Main
Sub
Address
ContractCallOrg-Controlled
User-Controlled
Safe{Wallet}
Web3
EVM_Contract
SOL_Contract
STELLAR_Contract
TRON_Contract
MessageSignOrg-Controlled
User-Controlled
Web3
EVM_EIP_191_Signature
EVM_EIP_712_Signature
BTC_BIP_137_Signature
BTC_EIP_191_Signature
BTC_BIP_322_Signature
COSMOS_ADR_36_Signature
Raw_Message_Signature
ExternalSafeTxSafe{Wallet}EVM_Contract
StakeOrg-ControlledAddress
UnstakeOrg-ControlledAddress

交易来源类型

交易来源类型如下:
  • Asset:全托管钱包(资产钱包)。
  • Web3:全托管钱包(Web3 钱包)。
  • Org-Controlled:MPC 钱包(机构钱包)。
  • User-Controlled:MPC 钱包(终端用户钱包)。
  • Safe{Wallet}:智能合约钱包(Safe)。
  • Main:交易所钱包(主账户)。
  • Sub:交易所钱包(子账户)。
  • DepositFromAddress:钱包地址。
  • DepositFromWallet:交易所钱包。
  • DepositFromLoop:通过 Cobo Loop 转账网络发送的转账。

addressincluded_utxos 使用说明

本章将说明当 source_typeWeb3Org-ControlledUser-Controlled 时,在不同链与不同交易类型下需要指定哪些 source 属性(addressincluded_utxos),以及在指定这些属性后系统会如何处理。

UTXO 链

  • 普通交易
    • 如果仅指定 included_utxos:交易只会使用这些指定的 UTXO。
    • 如果仅指定 address:系统会只从该地址选择 UTXO。
    • 如果同时指定 addressincluded_utxos:系统会检查这些 UTXO 是否属于该地址,并且只会使用这些 UTXO。
    • 如果既不指定 address 也不指定 included_utxos:系统会自动从 wallet_id 对应钱包下的所有地址选择 UTXO。
  • RBF 交易
    RBF 交易中的 addressincluded_utxos 可以与原交易不同。
    • 如果仅指定 included_utxos:交易只会使用这些指定的 UTXO。
    • 如果仅指定 address:系统会只从该地址选择 UTXO。
    • 如果同时指定 addressincluded_utxos:系统会检查这些 UTXO 是否属于该地址,并且只会使用这些 UTXO。
    • 如果未指定 address 也未指定 included_utxos
      • 如果原交易指定了 included_utxos:交易只会使用原交易的 UTXO。
      • 如果原交易未指定 included_utxos:系统会自动从原交易 wallet_id 对应钱包下的所有地址选择 UTXO。

账户模型链

  • 交易必须指定 address,否则代币转账会失败。
  • 在估算转账手续费时,只提供 wallet_id 即可,address 不是必填项。

交易目的地类型

交易目的地类型如下:
  • Address:钱包地址。
  • ExchangeWallet:交易所钱包。
  • EVM_Contract:EVM 链智能合约。
  • SOL_Contract:Solana 链智能合约。
  • Stellar_Contract: Stellar 链智能合约。
  • TRON_Contract: TRON 链智能合约。
  • EVM_EIP_191_Signature:EVM EIP-191 签名。更多详情,请参阅 签名数据标准
  • EVM_EIP_712_Signature:EVM EIP-712 签名。更多详情,请参阅 类型化结构数据哈希和签名
  • BTC_BIP_137_Signature:BTC BIP-137 签名。更多详情,请参阅 BIP-137
  • BTC_EIP_191_Signature:BTC EIP-191 签名。
  • BTC_BIP_322_Signature:BTC BIP-322 签名。更多详情,请参阅 BIP-322
  • COSMOS_ADR_36_Signature:COSMOS ADR-36 签名。更多详情,请参阅 ADR-36
  • Raw_Message_Signature:原始消息签名。
  • DepositToAddress:钱包地址。
  • DepositToWallet:交易所钱包。