evm.sendTransaction

通过 evm 对象发送 EVM 链上的交易，支持原生币和 ERC20 标准代币转账。

当前支持范围：

• 支持链：以太坊主网（ETH）、BSC 主网（BNB）
• 支持代币：USDT、USDC

支持的链和代币

链	chainId	原生币	USDT 合约地址	USDC 合约地址
以太坊主网	1	ETH	0xdAC17F958D2ee523a2206206994597C13D831ec7	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
BSC 主网	56	BNB	0x55d398326f99059fF775485246999027B3197955	0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d

用法

const result = await Turing.evm.sendTransaction({
  chainId: 1,
  toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  amount: "1000000000000000000", // 1 ETH（18 位小数）
  broadcastEnabled: true,
});

参数

interface EvmSendTransaction {
  chainId: number;            // EVM 链 ID：1（以太坊主网）或 56（BSC 主网）
  contractAddress?: string;   // ERC20 合约地址，如果为空则转账原生币（ETH/BNB）
  toAddress: string;          // 接收地址
  amount: string;             // 转账金额，字符串格式，单位为 token 的最小单位
  broadcastEnabled?: boolean; // 是否广播交易，默认为 true
}

字段	类型	必填	说明
chainId	number	是	EVM 链 ID：1（以太坊主网）或 56（BSC 主网）
contractAddress	string	否	ERC20 合约地址；为空时转账原生币（ETH/BNB）
toAddress	string	是	接收地址
amount	string	是	转账金额，字符串格式，单位为 token 的最小单位
broadcastEnabled	boolean	否	是否广播交易，默认 true

返回值

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

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

错误处理

const result = await Turing.evm.sendTransaction({
  chainId: 1,
  toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  amount: "1000000000000000000",
});

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

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

示例

转账原生币

// 以太坊转账 ETH
const result = await Turing.evm.sendTransaction({
  chainId: 1,
  toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  amount: "1000000000000000000", // 1 ETH（18 位小数）
  broadcastEnabled: true,
});

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

转账 ERC20 代币

// BSC 上转账 USDT
const result = await Turing.evm.sendTransaction({
  chainId: 56,
  contractAddress: "0x55d398326f99059fF775485246999027B3197955",
  toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  amount: "1000000000000000000", // 1 USDT（18 位小数）
  broadcastEnabled: true,
});

// 以太坊主网转账 USDC
const result2 = await Turing.evm.sendTransaction({
  chainId: 1,
  contractAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  amount: "1000000", // 1 USDC（6 位小数）
  broadcastEnabled: true,
});

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

不广播，仅返回签名交易

const result = await Turing.evm.sendTransaction({
  chainId: 1,
  toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  amount: "1000000000000000000",
  broadcastEnabled: false,
});

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