turing-wallet-provider 1.5.3 → 1.5.4

package/README.md

@@ -65,6 +65,71 @@ const {name,platform,version} = await wallet.getInfo();
 {Turing,android,1.0.0}//示例的返回值
 ```
 
+## getNetwork
+
+获取已连接账户当前激活的网络。
+
+### 用法
+
+```ts
+const wallet = useTuringWallet();
+const network = await wallet.getNetwork();
+```
+
+### 参数
+
+该方法不接受任何参数。
+
+### 返回值
+
+```ts
+interface GetNetworkResponse {
+  network: "tbc" | "btc" | "eth" | "bnb" | "all";
+  type: "mainnet" | "testnet";
+}
+```
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `network` | `"tbc" \| "btc" \| "eth" \| "bnb" \| "all"` | 当前激活的链。`"all"` 表示用户处于钱包的"所有网络"视图，未选择具体的链。 |
+| `type` | `"mainnet" \| "testnet"` | 主网 / 测试网。仅 `tbc` 可能为 `"testnet"`，其余链恒为 `"mainnet"`。 |
+
+### 错误处理
+
+| 错误 | 原因 |
+| --- | --- |
+| `User not connected` | 尚未调用 `wallet.connect()`，或用户已断开连接。 |
+
+```ts
+const wallet = useTuringWallet();
+
+try {
+  const info = await wallet.getNetwork();
+  console.log(info);
+} catch (error) {
+  console.error("Failed to get network:", error);
+}
+```
+
+### 订阅变化
+
+钱包内切换网络时，dapp 会收到 `TuringNetworkChanged` 事件并附带新的网络信息，无需轮询 `getNetwork()`。
+
+```ts
+window.addEventListener("TuringNetworkChanged", (event) => {
+  const { network } = event.detail;
+  // `network` 与 wallet.getNetwork() 的返回值同结构
+});
+```
+
+```ts
+interface TuringNetworkChangedDetail {
+  network: GetNetworkResponse;
+}
+```
+
+仅在 dapp 已连接期间触发，且只推送 `connect()` 之后的变化（初始网络可通过 `wallet.getNetwork()` 获取）。
+
 ## signMessage
 
 ```ts

package/dist/types/providerTypes.d.ts

@@ -17,6 +17,15 @@ export type Info = {
   version: string;
 };
 
+export type GetNetworkResponse = {
+  network: "tbc" | "btc" | "eth" | "bnb" | "all";
+  type: "mainnet" | "testnet";
+};
+
+export type TuringNetworkChangedDetail = {
+  network: GetNetworkResponse;
+};
+
 export type TransactionFlag =
   | "P2PKH"
   | "COLLECTION_CREATE"
@@ -241,6 +250,7 @@ export type TuringProviderType = {
   getPubKey: () => Promise<PubKey | undefined>;
   getAddress: () => Promise<Address | undefined>;
   getInfo: () => Promise<Info | undefined>;
+  getNetwork: () => Promise<GetNetworkResponse | undefined>;
   sendTransaction: (
     params: SendTransaction[]
   ) => Promise<SendTransactionResponse | undefined>;

package/package.json

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