@dashevo/evo-sdk 2.1.0-dev.8 → 2.1.0-rc.1

package/dist/sdk.d.ts

@@ -23,6 +23,7 @@ export interface ConnectionOptions {
 export interface EvoSDKOptions extends ConnectionOptions {
     network?: 'testnet' | 'mainnet';
     trusted?: boolean;
+    addresses?: string[];
 }
 export declare class EvoSDK {
     private wasmSdk?;
@@ -50,6 +51,21 @@ export declare class EvoSDK {
     static mainnet(options?: ConnectionOptions): EvoSDK;
     static testnetTrusted(options?: ConnectionOptions): EvoSDK;
     static mainnetTrusted(options?: ConnectionOptions): EvoSDK;
+    /**
+     * Create an EvoSDK instance configured with specific masternode addresses.
+     *
+     * @param addresses - Array of HTTPS URLs to masternodes (e.g., ['https://127.0.0.1:1443'])
+     * @param network - Network identifier: 'mainnet', 'testnet' (default: 'testnet')
+     * @param options - Additional connection options
+     * @returns A configured EvoSDK instance (not yet connected - call .connect() to establish connection)
+     *
+     * @example
+     * ```typescript
+     * const sdk = EvoSDK.withAddresses(['https://52.12.176.90:1443'], 'testnet');
+     * await sdk.connect();
+     * ```
+     */
+    static withAddresses(addresses: string[], network?: 'mainnet' | 'testnet', options?: ConnectionOptions): EvoSDK;
 }
 export { DocumentsFacade } from './documents/facade.js';
 export { IdentitiesFacade } from './identities/facade.js';

package/dist/sdk.js

@@ -13,8 +13,8 @@ import { VotingFacade } from './voting/facade.js';
 export class EvoSDK {
     constructor(options = {}) {
         // Apply defaults while preserving any future connection options
-        const { network = 'testnet', trusted = false, ...connection } = options;
-        this.options = { network, trusted, ...connection };
+        const { network = 'testnet', trusted = false, addresses, ...connection } = options;
+        this.options = { network, trusted, addresses, ...connection };
         this.documents = new DocumentsFacade(this);
         this.identities = new IdentitiesFacade(this);
         this.contracts = new ContractsFacade(this);
@@ -42,9 +42,20 @@ export class EvoSDK {
         if (this.wasmSdk)
             return; // idempotent
         await initWasm();
-        const { network, trusted, version, proofs, settings, logs } = this.options;
+        const { network, trusted, version, proofs, settings, logs, addresses } = this.options;
         let builder;
-        if (network === 'mainnet') {
+        // If specific addresses are provided, use them instead of network presets
+        if (addresses && addresses.length > 0) {
+            // Prefetch trusted quorums for the network before creating builder with addresses
+            if (network === 'mainnet') {
+                await wasm.WasmSdk.prefetchTrustedQuorumsMainnet();
+            }
+            else if (network === 'testnet') {
+                await wasm.WasmSdk.prefetchTrustedQuorumsTestnet();
+            }
+            builder = wasm.WasmSdkBuilder.withAddresses(addresses, network);
+        }
+        else if (network === 'mainnet') {
             await wasm.WasmSdk.prefetchTrustedQuorumsMainnet();
             builder = trusted ? wasm.WasmSdkBuilder.mainnetTrusted() : wasm.WasmSdkBuilder.mainnet();
         }
@@ -88,6 +99,23 @@ export class EvoSDK {
     static mainnet(options = {}) { return new EvoSDK({ network: 'mainnet', ...options }); }
     static testnetTrusted(options = {}) { return new EvoSDK({ network: 'testnet', trusted: true, ...options }); }
     static mainnetTrusted(options = {}) { return new EvoSDK({ network: 'mainnet', trusted: true, ...options }); }
+    /**
+     * Create an EvoSDK instance configured with specific masternode addresses.
+     *
+     * @param addresses - Array of HTTPS URLs to masternodes (e.g., ['https://127.0.0.1:1443'])
+     * @param network - Network identifier: 'mainnet', 'testnet' (default: 'testnet')
+     * @param options - Additional connection options
+     * @returns A configured EvoSDK instance (not yet connected - call .connect() to establish connection)
+     *
+     * @example
+     * ```typescript
+     * const sdk = EvoSDK.withAddresses(['https://52.12.176.90:1443'], 'testnet');
+     * await sdk.connect();
+     * ```
+     */
+    static withAddresses(addresses, network = 'testnet', options = {}) {
+        return new EvoSDK({ addresses, network, ...options });
+    }
 }
 export { DocumentsFacade } from './documents/facade.js';
 export { IdentitiesFacade } from './identities/facade.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dashevo/evo-sdk",
-  "version": "2.1.0-dev.8",
+  "version": "2.1.0-rc.1",
   "type": "module",
   "main": "./dist/evo-sdk.module.js",
   "types": "./dist/sdk.d.ts",
@@ -22,7 +22,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@dashevo/wasm-sdk": "2.1.0-dev.8"
+    "@dashevo/wasm-sdk": "2.1.0-rc.1"
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.json && webpack --config webpack.config.cjs",