btc.sendTransaction

通过 btc 对象发送 BTC 链上的交易。

用法

const result = await Turing.btc.sendTransaction({
  toAddress: "bc1qxyz...",
  amount: "100000", // 100000 satoshis
  broadcastEnabled: true,
});

参数

interface BtcSendTransaction {
  toAddress: string;           // 接收地址
  amount: string;              // 转账金额，字符串格式，单位为 satoshis
  broadcastEnabled?: boolean;  // 是否广播交易，默认为 true
}

字段	类型	必填	说明
toAddress	string	是	接收地址
amount	string	是	转账金额，字符串格式，单位为 satoshis
broadcastEnabled	boolean	否	是否广播交易，默认 true

返回值

interface BtcSendTransactionResponse {
  txid?: string;   // 交易哈希（广播成功时返回）
  txraw?: string;  // 交易原始数据（broadcastEnabled 为 false 时返回）
  error?: string;  // 错误信息
}

字段	类型	说明
txid	string	广播成功时返回的交易哈希
txraw	string	broadcastEnabled 为 false 时返回的交易原始数据
error	string	交易失败时的错误信息

错误处理

const result = await Turing.btc.sendTransaction({
  toAddress: "bc1qxyz...",
  amount: "100000",
});

if (result.error) {
  console.error("交易失败:", result.error);
  return;
}

console.log("交易哈希:", result.txid);

示例

转账 BTC

const result = await Turing.btc.sendTransaction({
  toAddress: "bc1qxyz...",
  amount: "100000", // 100000 satoshis
  broadcastEnabled: true,
});

if (result.txid) {
  console.log("交易哈希:", result.txid);
} else if (result.error) {
  console.error("交易失败:", result.error);
}

不广播，仅返回签名交易

const result = await Turing.btc.sendTransaction({
  toAddress: "bc1qxyz...",
  amount: "100000",
  broadcastEnabled: false,
});

if (result.txraw) {
  console.log("交易原始数据:", result.txraw);
}