turing-wallet-provider 1.4.13 → 1.4.15

package/README.md

@@ -18,21 +18,25 @@ root.render(
 import { useTuringWallet } from "turing-wallet-provider";
 
 const wallet = useTuringWallet();
-await wallet.connect();
+const addresses = await wallet.connect(); 
+// 返回地址对象,根据账户类型不同返回不同字段:
+// BVM账户: { tbcAddress, btcAddress }
+// EVM账户: { ethAddress, bnbAddress }
+// 全部账户: { tbcAddress, btcAddress, ethAddress, bnbAddress }
 ```
 
 ## disconnect
 
 ```ts
 const wallet = useTuringWallet();
-await wallet.disconnect();
+const result = await wallet.disconnect(); // 返回 true/false
 ```
 
 ## isConnected
 
 ```ts
 const wallet = useTuringWallet();
-const ture/false = await wallet.isConnected();
+const result = await wallet.isConnected(); // 返回 true/false
 ```
 
 ## getPubKey
@@ -46,7 +50,11 @@ const { tbcPubKey } = await wallet.getPubKey(); //tbcPubKey为string类型
 
 ```ts
 const wallet = useTuringWallet();
-const { tbcAddress } = await wallet.getAddress(); //tbcAddress为string类型
+const addresses = await wallet.getAddress(); 
+// 返回地址对象,根据账户类型不同返回不同字段:
+// BVM账户: { tbcAddress, btcAddress }
+// EVM账户: { ethAddress, bnbAddress }
+// 全部账户: { tbcAddress, btcAddress, ethAddress, bnbAddress }
 ```
 
 ## getInfo
@@ -719,3 +727,316 @@ const mixedOperations = [
 
 const results = await wallet.sendBatchRequest(mixedOperations);
 ```
+
+## evm.sendTransaction
+
+通过 `evm` 对象发送 EVM 链上的交易,支持原生币和 ERC20 标准代币转账。
+
+> **当前支持范围:**
+>
+> - 支持链: 以太坊主网(ETH)、BSC 主网(BNB)
+> - 支持代币: USDT、USDC
+
+### 参数说明
+
+```ts
+interface EvmSendTransaction {
+  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; // 错误信息
+}
+```
+
+### 支持的链和代币
+
+| 链         | chainId | 原生币 | USDT 合约地址                              | USDC 合约地址                              |
+| ---------- | ------- | ------ | ------------------------------------------ | ------------------------------------------ |
+| 以太坊主网 | 1       | ETH    | 0xdAC17F958D2ee523a2206206994597C13D831ec7 | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
+| BSC 主网   | 56      | BNB    | 0x55d398326f99059fF775485246999027B3197955 | 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d |
+
+### 使用示例
+
+#### 转账原生币
+
+```ts
+const wallet = useTuringWallet();
+
+// 以太坊转账 ETH
+const result = await wallet.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 代币
+
+```ts
+const wallet = useTuringWallet();
+
+// BSC 上转账 USDT
+const result = await wallet.evm.sendTransaction({
+  chainId: 56,
+  contractAddress: "0x55d398326f99059fF775485246999027B3197955", // BSC USDT 合约
+  toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+  amount: "1000000000000000000", // 1 USDT (18位小数)
+  broadcastEnabled: true,
+});
+
+// 以太坊主网转账 USDC
+const result2 = await wallet.evm.sendTransaction({
+  chainId: 1,
+  contractAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // ETH USDC 合约
+  toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+  amount: "1000000", // 1 USDC (6位小数)
+  broadcastEnabled: true,
+});
+
+if (result.txid) {
+  console.log("交易哈希:", result.txid);
+} else if (result.error) {
+  console.error("交易失败:", result.error);
+}
+```
+
+#### 不广播,仅返回签名交易
+
+```ts
+const wallet = useTuringWallet();
+
+const result = await wallet.evm.sendTransaction({
+  chainId: 1,
+  toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+  amount: "1000000000000000000",
+  broadcastEnabled: false, // 不广播
+});
+
+if (result.txraw) {
+  console.log("交易原始数据:", result.txraw);
+  // 可以自行广播这个交易
+}
+```
+
+## btc.sendTransaction
+
+通过 `btc` 对象发送 BTC 链上的交易。
+
+### 参数说明
+
+```ts
+interface BtcSendTransaction {
+  toAddress: string; // 接收地址
+  amount: string; // 转账金额,字符串格式,单位为 satoshis
+  broadcastEnabled?: boolean; // 是否广播交易,默认为 true
+}
+
+interface BtcSendTransactionResponse {
+  txid?: string; // 交易哈希(广播成功时返回)
+  txraw?: string; // 交易原始数据(broadcastEnabled为false时返回)
+  error?: string; // 错误信息
+}
+```
+
+### 使用示例
+
+#### 转账 BTC
+
+```ts
+const wallet = useTuringWallet();
+
+const result = await wallet.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);
+}
+```
+
+#### 不广播,仅返回签名交易
+
+```ts
+const wallet = useTuringWallet();
+
+const result = await wallet.btc.sendTransaction({
+  toAddress: "bc1qxyz...",
+  amount: "100000",
+  broadcastEnabled: false,
+});
+
+if (result.txraw) {
+  console.log("交易原始数据:", result.txraw);
+}
+```
+
+## btc.signTransaction
+
+通过 `btc` 对象对单个 BTC 裸交易进行签名,支持 legacy、segwit_v0、taproot 三种签名类型。taproot 类型下通过 `leafHashesHex` 区分 key path 和 script path:对应输入为 `undefined` 则走 key path,有值则走 script path。
+
+### 参数说明
+
+```ts
+type BtcSigHashType = "legacy" | "segwit_v0" | "taproot";
+
+interface BtcSignTransaction {
+  txHex: string; // 裸交易 hex
+  type: BtcSigHashType; // 签名哈希类型
+  prevOutScriptsHex: string[]; // 每个输入对应的前置输出脚本 hex
+  values?: number[]; // 每个输入对应的金额(satoshis),segwit_v0/taproot 必填
+  leafHashesHex?: (string | undefined)[]; // 每个输入对应的叶子哈希,仅 taproot 类型使用,undefined 表示 key path,有值表示 script path
+}
+
+interface BtcSignTransactionResponse {
+  sigs?: string[]; // 每个输入对应的签名 hex
+  error?: string; // 错误信息
+}
+```
+
+### 使用示例
+
+#### Legacy (P2PKH) 签名
+
+```ts
+const wallet = useTuringWallet();
+
+const result = await wallet.btc.signTransaction({
+  txHex: "0200000001...",
+  type: "legacy",
+  prevOutScriptsHex: ["76a914...88ac"],
+});
+
+if (result.sigs) {
+  console.log("签名列表:", result.sigs);
+} else if (result.error) {
+  console.error("签名失败:", result.error);
+}
+```
+
+#### SegWit V0 (P2WPKH) 签名
+
+```ts
+const wallet = useTuringWallet();
+
+const result = await wallet.btc.signTransaction({
+  txHex: "0200000001...",
+  type: "segwit_v0",
+  prevOutScriptsHex: ["76a914...88ac"],
+  values: [100000],
+});
+
+if (result.sigs) {
+  console.log("签名列表:", result.sigs);
+}
+```
+
+#### Taproot Key Path 签名
+
+```ts
+const wallet = useTuringWallet();
+
+const result = await wallet.btc.signTransaction({
+  txHex: "0200000001...",
+  type: "taproot",
+  prevOutScriptsHex: ["5120..."],
+  values: [100000],
+  // leafHashesHex 不传或对应位置为 undefined,走 key path
+});
+
+if (result.sigs) {
+  console.log("签名列表:", result.sigs);
+}
+```
+
+#### Taproot Script Path 签名
+
+```ts
+const wallet = useTuringWallet();
+
+const result = await wallet.btc.signTransaction({
+  txHex: "0200000001...",
+  type: "taproot",
+  prevOutScriptsHex: ["5120..."],
+  values: [100000],
+  leafHashesHex: ["ab12cd34..."], // 对应输入有 leafHash,走 script path
+});
+
+if (result.sigs) {
+  console.log("签名列表:", result.sigs);
+}
+```
+
+## btc.sendBatchRequest
+
+通过 `btc` 对象批量提交 BTC 相关请求,每个请求独立执行,一个失败不影响其他请求。
+
+### 支持的方法
+
+- `sendTransaction` - 发送交易
+- `signTransaction` - 签名交易
+
+### 参数说明
+
+```ts
+type BtcBatchRequestMethod = "sendTransaction" | "signTransaction";
+
+interface BtcBatchRequest {
+  method: BtcBatchRequestMethod;
+  params: BtcSendTransaction | BtcSignTransaction;
+}
+
+type BtcBatchResponse = Array<BtcSendTransactionResponse | BtcSignTransactionResponse>;
+```
+
+### 使用示例
+
+```ts
+const wallet = useTuringWallet();
+
+const requests = [
+  {
+    method: "sendTransaction",
+    params: {
+      toAddress: "bc1qxyz...",
+      amount: "100000",
+      broadcastEnabled: true,
+    },
+  },
+  {
+    method: "signTransaction",
+    params: {
+      txHex: "0200000001...",
+      type: "legacy",
+      prevOutScriptsHex: ["76a914...88ac"],
+    },
+  },
+];
+
+const results = await wallet.btc.sendBatchRequest(requests);
+
+results.forEach((result, index) => {
+  if (result.error) {
+    console.error(`Request ${index + 1} failed:`, result.error);
+  } else {
+    console.log(`Request ${index + 1} success:`, result);
+  }
+});
+```

package/dist/types/providerTypes.d.ts

@@ -3,9 +3,14 @@ export type PubKey = {
 };
 
 export type Address = {
-  tbcAddress: string;
+  tbcAddress?: string;
+  btcAddress?: string;
+  ethAddress?: string;
+  bnbAddress?: string;
 };
 
+export type ConnectResponse = Address;
+
 export type Info = {
   name: string;
   platform: string;
@@ -156,9 +161,71 @@ export type BatchResponse = Array<
   | DecryptResponse
 >;
 
+export type EvmSendTransaction = {
+  chainId: number;
+  contractAddress?: string;
+  toAddress: string;
+  amount: string;
+  broadcastEnabled?: boolean;
+};
+
+export type EvmSendTransactionResponse = {
+  txid?: string;
+  txraw?: string;
+  error?: string;
+};
+
+export type EvmProvider = {
+  sendTransaction: (params: EvmSendTransaction) => Promise<EvmSendTransactionResponse | undefined>;
+};
+
+export type BtcSendTransaction = {
+  toAddress: string;
+  amount: string;
+  broadcastEnabled?: boolean;
+};
+
+export type BtcSendTransactionResponse = {
+  txid?: string;
+  txraw?: string;
+  error?: string;
+};
+
+export type BtcSigHashType = "legacy" | "segwit_v0" | "taproot";
+
+export type BtcSignTransaction = {
+  txHex: string;
+  type: BtcSigHashType;
+  prevOutScriptsHex: string[];
+  values?: number[];
+  leafHashesHex?: (string | undefined)[];
+};
+
+export type BtcSignTransactionResponse = {
+  sigs?: string[];
+  error?: string;
+};
+
+export type BtcBatchRequestMethod = "sendTransaction" | "signTransaction";
+
+export type BtcBatchRequest = {
+  method: BtcBatchRequestMethod;
+  params: BtcSendTransaction | BtcSignTransaction;
+};
+
+export type BtcBatchResponse = Array<
+  BtcSendTransactionResponse | BtcSignTransactionResponse
+>;
+
+export type BtcProvider = {
+  sendTransaction: (params: BtcSendTransaction) => Promise<BtcSendTransactionResponse | undefined>;
+  signTransaction: (params: BtcSignTransaction) => Promise<BtcSignTransactionResponse | undefined>;
+  sendBatchRequest: (requests: BtcBatchRequest[]) => Promise<BtcBatchResponse | undefined>;
+};
+
 export type TuringProviderType = {
   isReady: boolean;
-  connect: () => Promise<string | undefined>;
+  connect: () => Promise<ConnectResponse | undefined>;
   disconnect: () => Promise<boolean>;
   isConnected: () => Promise<boolean>;
   getPubKey: () => Promise<PubKey | undefined>;
@@ -179,4 +246,6 @@ export type TuringProviderType = {
     params: SignAssociatedTransaction
   ) => Promise<SignAssociatedTransactionResponse | undefined>;
   sendBatchRequest: (requests: BatchRequest[]) => Promise<BatchResponse | undefined>;
+  evm: EvmProvider;
+  btc: BtcProvider;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "turing-wallet-provider",
-  "version": "1.4.13",
+  "version": "1.4.15",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [