v0.1.3-alpha

Author: qinglongcn

.npm-cache/_update-notifier-last-checked

@@ -14,6 +14,15 @@
 
 ---
 
+## [0.1.3-alpha] - 2025-12-31
+
+### 改进
+
+- 与 WES v0.1.0 版本对齐
+- 更新依赖和文档
+
+---
+
 ## [0.1.2-alpha] - 2025-11-26
 
 ### 修复

CHANGELOG.md

@@ -73,7 +73,7 @@ import { Client, TokenService, Wallet } from '@weisyn/client-sdk-js';
 
 // 1. 初始化客户端
 const client = new Client({
-  endpoint: 'http://localhost:8545',
+  endpoint: 'http://localhost:28680',
   protocol: 'http',
 });
 
@@ -107,7 +107,7 @@ console.log(`转账成功！交易哈希: ${result.txHash}`);
     const { Client, TokenService, Wallet } = WESClientSDK;
     
     const client = new Client({
-      endpoint: 'http://localhost:8545',
+      endpoint: 'http://localhost:28680',
       protocol: 'http',
     });
     
@@ -151,7 +151,7 @@ import { WESClient } from '@weisyn/client-sdk-js';
 
 // 初始化 WESClient
 const wesClient = new WESClient({
-  endpoint: 'http://localhost:8545',
+  endpoint: 'http://localhost:28680',
   protocol: 'http',
 });
 
@@ -247,9 +247,9 @@ graph TB
     
     subgraph API_GATEWAY["🌐 API 网关层"]
         direction LR
-        JSONRPC["JSON-RPC 2.0<br/>:8545"]
+        JSONRPC["JSON-RPC 2.0<br/>:28680"]
         HTTP["HTTP REST<br/>/api/v1/*"]
-        WS["WebSocket<br/>:8081"]
+        WS["WebSocket<br/>:28681"]
     end
     
     subgraph BIZ_LAYER["💼 业务服务层"]

README.md

@@ -47,7 +47,7 @@ import { Client, TokenService, Wallet } from '@weisyn/client-sdk-js';
 
 // 1. 初始化客户端
 const client = new Client({
-  endpoint: 'http://localhost:8545',
+  endpoint: 'http://localhost:28680',
   protocol: 'http',
 });
 
@@ -81,7 +81,7 @@ console.log(`转账成功！交易哈希: ${result.txHash}`);
     const { Client, TokenService, Wallet } = WESClientSDK;
     
     const client = new Client({
-      endpoint: 'http://localhost:8545',
+      endpoint: 'http://localhost:28680',
       protocol: 'http',
     });
     
@@ -102,14 +102,14 @@ SDK 支持两种传输协议（浏览器环境不支持 gRPC）：
 ```typescript
 // HTTP 客户端（最常用）
 const client = new Client({
-  endpoint: 'http://localhost:8545',
+  endpoint: 'http://localhost:28680',
   protocol: 'http',
   timeout: 30000,
 });
 
 // WebSocket 客户端（用于事件订阅）
 const wsClient = new Client({
-  endpoint: 'ws://localhost:8081',
+  endpoint: 'ws://localhost:28681',
   protocol: 'websocket',
 });
 ```
@@ -123,7 +123,7 @@ import { WESClient } from '@weisyn/client-sdk-js';
 
 // 创建 WESClient
 const wesClient = new WESClient({
-  endpoint: 'http://localhost:8545',
+  endpoint: 'http://localhost:28680',
   protocol: 'http',
 });
 
@@ -215,18 +215,18 @@ sequenceDiagram
 ```typescript
 // 单客户端模式
 const client = new Client({
-  endpoint: 'http://localhost:8545',
+  endpoint: 'http://localhost:28680',
   protocol: 'http',
 });
 
 // 多客户端模式（HTTP + WebSocket）
 const httpClient = new Client({
-  endpoint: 'http://localhost:8545',
+  endpoint: 'http://localhost:28680',
   protocol: 'http',
 });
 
 const wsClient = new Client({
-  endpoint: 'ws://localhost:8081',
+  endpoint: 'ws://localhost:28681',
   protocol: 'websocket',
 });
 ```
@@ -300,7 +300,7 @@ try {
 ```typescript
 // 使用 WebSocket 客户端订阅事件
 const wsClient = new WESClient({
-  endpoint: 'ws://localhost:8081',
+  endpoint: 'ws://localhost:28681',
   protocol: 'websocket',
 });
 
@@ -468,7 +468,7 @@ const result = await resourceService.deployContract({
 ```typescript
 // 创建 WebSocket 客户端
 const wsClient = new WESClient({
-  endpoint: 'ws://localhost:8081',
+  endpoint: 'ws://localhost:28681',
   protocol: 'websocket',
 });
 
@@ -524,7 +524,7 @@ type WESClientErrorCode =
 ```typescript
 // HTTP 客户端自动管理连接
 const client = new Client({
-  endpoint: 'http://localhost:8545',
+  endpoint: 'http://localhost:28680',
   protocol: 'http',
   timeout: 30000,
 });
@@ -550,7 +550,7 @@ import { Client, TokenService, Wallet, WESClient } from '@weisyn/client-sdk-js';
 
 // 类型安全
 const client: Client = new Client({
-  endpoint: 'http://localhost:8545',
+  endpoint: 'http://localhost:28680',
   protocol: 'http',
 });
 
@@ -578,7 +578,7 @@ if (typeof window !== 'undefined') {
 ```typescript
 // 确保节点 API 支持 CORS
 const client = new Client({
-  endpoint: 'https://api.example.com:8545', // 使用 HTTPS
+  endpoint: 'https://api.example.com:28680', // 使用 HTTPS
   protocol: 'http',
 });
 ```

docs/DEVELOPER_GUIDE.md

@@ -109,7 +109,7 @@ import { Client, TokenService, Wallet } from '@weisyn/client-sdk-js';
 
 // 类型安全
 const client: Client = new Client({
-  endpoint: 'http://localhost:8545',
+  endpoint: 'http://localhost:28680',
   protocol: 'http',
 });
 

docs/LANGUAGE_AND_ENV_LIMITATIONS.md

@@ -89,9 +89,9 @@ graph TB
     
     subgraph API_GATEWAY["🌐 API 网关层"]
         direction LR
-        JSONRPC["JSON-RPC 2.0<br/>:8545"]
+        JSONRPC["JSON-RPC 2.0<br/>:28680"]
         HTTP["HTTP REST<br/>/api/v1/*"]
-        WS["WebSocket<br/>:8081"]
+        WS["WebSocket<br/>:28681"]
     end
     
     subgraph BIZ_LAYER["💼 业务服务层"]

docs/SCENARIOS_VISUAL_GUIDE.md

@@ -20,7 +20,7 @@ import { Client, TokenService, Wallet } from '@weisyn/client-sdk-js';
 async function main() {
   // 1. 初始化客户端
   const client = new Client({
-    endpoint: 'http://localhost:8545',
+    endpoint: 'http://localhost:28680',
     protocol: 'http',
   });
 

examples/simple-transfer/README.md

@@ -16,7 +16,7 @@ async function main() {
     // 1. 初始化客户端
     console.log('1️⃣ 初始化客户端...');
     const client = new Client({
-      endpoint: 'http://localhost:8545',
+      endpoint: 'http://localhost:28680',
       protocol: 'http',
       debug: true, // 启用调试日志
     });

examples/simple-transfer/index.ts

@@ -21,6 +21,13 @@ import type {
   Transaction,
   SubmitTxResult,
   EventSubscription,
+  BlockInfo,
+  TransactionReceipt,
+  FeeEstimate,
+  SyncStatus,
+  TokenBalance,
+  AIModelCallRequest,
+  AIModelCallResult,
 } from '../src/client/wesclient-types';
 
 /**
@@ -328,6 +335,103 @@ export class WESClientMock implements WESClient {
     };
   }
 
+  // ========== 新增 API 方法（用于满足最新 WESClient 接口） ==========
+
+  async getBlockByHeight(_height: number, _fullTx: boolean = false): Promise<BlockInfo | null> {
+    await this.delay();
+    if (this.errors.has('getBlockByHeight')) throw this.errors.get('getBlockByHeight')!;
+    if (this.responses.has('getBlockByHeight')) return this.responses.get('getBlockByHeight') as BlockInfo | null;
+    return null;
+  }
+
+  async getBlockByHash(_hash: Uint8Array, _fullTx: boolean = false): Promise<BlockInfo | null> {
+    await this.delay();
+    if (this.errors.has('getBlockByHash')) throw this.errors.get('getBlockByHash')!;
+    if (this.responses.has('getBlockByHash')) return this.responses.get('getBlockByHash') as BlockInfo | null;
+    return null;
+  }
+
+  async getTransactionReceipt(_txHash: string): Promise<TransactionReceipt | null> {
+    await this.delay();
+    if (this.errors.has('getTransactionReceipt')) throw this.errors.get('getTransactionReceipt')!;
+    if (this.responses.has('getTransactionReceipt')) {
+      return this.responses.get('getTransactionReceipt') as TransactionReceipt | null;
+    }
+    return null;
+  }
+
+  async estimateFee(_tx: Transaction): Promise<FeeEstimate> {
+    await this.delay();
+    if (this.errors.has('estimateFee')) throw this.errors.get('estimateFee')!;
+    if (this.responses.has('estimateFee')) return this.responses.get('estimateFee') as FeeEstimate;
+    return {
+      estimatedFee: 0n,
+      feeRate: '',
+      numInputs: 0,
+      numOutputs: 0,
+    };
+  }
+
+  async getSyncStatus(): Promise<SyncStatus> {
+    await this.delay();
+    if (this.errors.has('getSyncStatus')) throw this.errors.get('getSyncStatus')!;
+    if (this.responses.has('getSyncStatus')) return this.responses.get('getSyncStatus') as SyncStatus;
+    return {
+      syncing: false,
+      currentHeight: 0,
+      highestHeight: 0,
+      startingBlock: 0,
+      progress: 1,
+    };
+  }
+
+  async contractCall(
+    _contractHash: Uint8Array,
+    _method: string,
+    _params?: number[],
+    _payload?: Uint8Array
+  ): Promise<Uint8Array> {
+    await this.delay();
+    if (this.errors.has('contractCall')) throw this.errors.get('contractCall')!;
+    if (this.responses.has('contractCall')) return this.responses.get('contractCall') as Uint8Array;
+    return new Uint8Array(0);
+  }
+
+  async unsubscribe(_subscriptionId: string): Promise<boolean> {
+    await this.delay();
+    if (this.errors.has('unsubscribe')) throw this.errors.get('unsubscribe')!;
+    if (this.responses.has('unsubscribe')) return this.responses.get('unsubscribe') as boolean;
+    return true;
+  }
+
+  async getContractTokenBalance(
+    _address: Uint8Array,
+    _contractHash: Uint8Array,
+    _tokenId?: string
+  ): Promise<TokenBalance> {
+    await this.delay();
+    if (this.errors.has('getContractTokenBalance')) throw this.errors.get('getContractTokenBalance')!;
+    if (this.responses.has('getContractTokenBalance')) {
+      return this.responses.get('getContractTokenBalance') as TokenBalance;
+    }
+    return {
+      address: '',
+      contractHash: '',
+      contractAddress: '',
+      tokenId: _tokenId || 'default',
+      balance: '0',
+      utxoCount: 0,
+      height: 0,
+    };
+  }
+
+  async callAIModel(_request: AIModelCallRequest): Promise<AIModelCallResult> {
+    await this.delay();
+    if (this.errors.has('callAIModel')) throw this.errors.get('callAIModel')!;
+    if (this.responses.has('callAIModel')) return this.responses.get('callAIModel') as AIModelCallResult;
+    return { success: true };
+  }
+
 
   async batchGetResources(resourceIds: Uint8Array[]): Promise<ResourceInfo[]> {
     return Promise.all(resourceIds.map((id) => this.getResource(id)));