@dignetwork/dig-sdk 0.0.1-alpha.142 → 0.0.1-alpha.144

package/dist/DigNetwork/DigNetwork.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DigNetwork.d.ts","sourceRoot":"","sources":["../../src/DigNetwork/DigNetwork.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,MAAM,CAAC,cAAc,CAAmC;gBAEpD,OAAO,EAAE,MAAM;WAOP,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAQhD,aAAa,CAAC,GAAG,EAAE,MAAM;WAIzB,oBAAoB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,EACZ,gBAAgB,GAAE,MAAM,EAAO,GAC9B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;WA0EZ,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;WAOrC,mBAAmB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAcH,kBAAkB,CAC7B,eAAe,CAAC,EAAE,OAAO,EACzB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC;IA8GH,mBAAmB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAUvD"}
+{"version":3,"file":"DigNetwork.d.ts","sourceRoot":"","sources":["../../src/DigNetwork/DigNetwork.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,MAAM,CAAC,cAAc,CAAmC;gBAEpD,OAAO,EAAE,MAAM;WAOP,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAQhD,aAAa,CAAC,GAAG,EAAE,MAAM;WAIzB,oBAAoB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,EACZ,gBAAgB,GAAE,MAAM,EAAO,GAC9B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;WA2EZ,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;WAOrC,mBAAmB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAcH,kBAAkB,CAC7B,eAAe,CAAC,EAAE,OAAO,EACzB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC;IA8GH,mBAAmB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAUvD"}

package/dist/DigNetwork/DigNetwork.js

@@ -50,6 +50,7 @@ class DigNetwork {
     static async findPeerWithStoreKey(storeId, rootHash, key, initialBlackList = []) {
         const peerBlackList = initialBlackList;
         const serverCoin = new blockchain_1.ServerCoin(storeId);
+        const allPeers = await serverCoin.getActiveEpochPeers();
         while (true) {
             try {
                 // Sample 10 peers from the current epoch

package/dist/blockchain/FullNodePeer.js

@@ -426,21 +426,3 @@ FullNodePeer.peerInfos = new Map();
 FullNodePeer.peerIPCache = new node_cache_1.default({ stdTTL: CACHE_DURATION / 1000 });
 // Map to store rate limiters per peer IP
 FullNodePeer.peerLimiters = new Map();
-/**
- * Usage Example
- */
-async function main() {
-    try {
-        // Connect to the best available peer
-        const fullNodePeer = await FullNodePeer.connect();
-        // Example parentCoinInfo buffer (replace with actual data)
-        const parentCoinInfo = Buffer.from("your_parent_coin_info_here", "hex");
-        // Wait for coin confirmation
-        const isConfirmed = await FullNodePeer.waitForConfirmation(parentCoinInfo);
-        console.log(`Coin confirmed: ${isConfirmed}`);
-    }
-    catch (error) {
-        console.error(`Error: ${error.message}`);
-    }
-}
-main();

package/dist/utils/PeerRanker.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Interface representing the metrics of a peer.
+ */
+export interface PeerMetrics {
+    ip: string;
+    latency: number;
+    bandwidth: number;
+}
+/**
+ * Configuration options for the PeerRanker.
+ */
+interface PeerRankerOptions {
+    clientCertPath: string;
+    clientKeyPath: string;
+    bandwidthTestPath: string;
+    pingPath?: string;
+    timeout?: number;
+    bandwidthTestSize?: number;
+}
+/**
+ * Utility class to rank peers based on latency and bandwidth using HTTPS with mTLS.
+ */
+export declare class PeerRanker {
+    private ipAddresses;
+    private static certPath;
+    private static keyPath;
+    private bandwidthTestPath;
+    private pingPath;
+    private timeout;
+    private bandwidthTestSize;
+    private sortedPeers;
+    private currentIndex;
+    /**
+     * Constructs a PeerRanker instance.
+     * @param ipAddresses - Array of IP addresses to rank.
+     * @param options - Configuration options including paths to client certificates.
+     */
+    constructor(ipAddresses: string[], options: PeerRankerOptions);
+    /**
+     * Measures the latency of a given IP address using an HTTPS request.
+     * Tries HEAD first, then falls back to GET if HEAD is not supported.
+     * @param ip - The IP address of the peer.
+     * @returns Promise resolving to the latency in milliseconds.
+     */
+    private measureLatency;
+    /**
+     * Measures the bandwidth of a given IP address by downloading a file and calculating throughput.
+     * @param ip - The IP address of the peer.
+     * @returns Promise resolving to the bandwidth in bytes per second.
+     */
+    private measureBandwidth;
+    /**
+     * Ranks the peers based on measured latency and bandwidth.
+     * @returns Promise resolving to an array of PeerMetrics sorted by latency and bandwidth.
+     */
+    rankPeers(): Promise<PeerMetrics[]>;
+    /**
+     * Returns the next best peer based on the ranking.
+     * Cycles through the list, resetting to the beginning once the end is reached.
+     * @returns The next PeerMetrics object or null if no peers are available.
+     */
+    GetNextBestPeer(): PeerMetrics | null;
+    /**
+     * Resets the internal iterator to start from the beginning of the sorted list.
+     */
+    resetIterator(): void;
+}
+export {};
+//# sourceMappingURL=PeerRanker.d.ts.map

package/dist/utils/PeerRanker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeerRanker.d.ts","sourceRoot":"","sources":["../../src/utils/PeerRanker.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAS;IAC/B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAS;IAGlC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,YAAY,CAAa;IAEjC;;;;OAIG;gBACS,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,iBAAiB;IAY7D;;;;;OAKG;YACW,cAAc;IA8C5B;;;;OAIG;YACW,gBAAgB;IA2C9B;;;OAGG;IACU,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IA4BhD;;;;OAIG;IACI,eAAe,IAAI,WAAW,GAAG,IAAI;IAW5C;;OAEG;IACI,aAAa,IAAI,IAAI;CAG7B"}

package/dist/utils/PeerRanker.js

@@ -0,0 +1,173 @@
+"use strict";
+// src/PeerRanker.ts
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PeerRanker = void 0;
+const axios_1 = __importDefault(require("axios"));
+const fs_1 = __importDefault(require("fs"));
+const https_1 = __importDefault(require("https"));
+const ssl_1 = require("./ssl");
+/**
+ * Utility class to rank peers based on latency and bandwidth using HTTPS with mTLS.
+ */
+class PeerRanker {
+    /**
+     * Constructs a PeerRanker instance.
+     * @param ipAddresses - Array of IP addresses to rank.
+     * @param options - Configuration options including paths to client certificates.
+     */
+    constructor(ipAddresses, options) {
+        // Internal properties for iteration
+        this.sortedPeers = [];
+        this.currentIndex = 0;
+        this.ipAddresses = ipAddresses;
+        this.bandwidthTestPath = options.bandwidthTestPath;
+        this.pingPath = options.pingPath || '/'; // Default to root path if not provided
+        this.timeout = options.timeout || 5000; // Default timeout: 5 seconds
+        this.bandwidthTestSize = options.bandwidthTestSize || 1024 * 1024; // Default: 1MB
+        const { certPath, keyPath } = (0, ssl_1.getOrCreateSSLCerts)();
+        PeerRanker.certPath = certPath;
+        PeerRanker.keyPath = keyPath;
+    }
+    /**
+     * Measures the latency of a given IP address using an HTTPS request.
+     * Tries HEAD first, then falls back to GET if HEAD is not supported.
+     * @param ip - The IP address of the peer.
+     * @returns Promise resolving to the latency in milliseconds.
+     */
+    async measureLatency(ip) {
+        const path = this.pingPath;
+        const url = `https://${ip}${path}`;
+        // Configuration for HEAD request
+        const configHead = {
+            url: url,
+            method: 'HEAD',
+            httpsAgent: new https_1.default.Agent({
+                cert: fs_1.default.readFileSync(PeerRanker.certPath),
+                key: fs_1.default.readFileSync(PeerRanker.keyPath),
+                rejectUnauthorized: false, // Set to true in production
+            }),
+            timeout: this.timeout,
+            validateStatus: (status) => status < 500, // Resolve only if status is less than 500
+        };
+        const startTime = Date.now();
+        try {
+            const response = await (0, axios_1.default)(configHead);
+            if (response.status === 405) { // Method Not Allowed
+                // Fallback to GET with Range header to minimize data transfer
+                const configGet = {
+                    url: url,
+                    method: 'GET',
+                    httpsAgent: new https_1.default.Agent({
+                        cert: fs_1.default.readFileSync(PeerRanker.certPath),
+                        key: fs_1.default.readFileSync(PeerRanker.keyPath),
+                        rejectUnauthorized: false, // Set to true in production
+                    }),
+                    timeout: this.timeout,
+                    headers: {
+                        'Range': 'bytes=0-0', // Request only the first byte
+                    },
+                    validateStatus: (status) => status < 500,
+                };
+                await (0, axios_1.default)(configGet);
+            }
+            const latency = Date.now() - startTime;
+            return latency;
+        }
+        catch (error) {
+            console.error(`Latency measurement failed for IP ${ip}:`, error.message);
+            return Infinity; // Indicate unreachable or unresponsive peer
+        }
+    }
+    /**
+     * Measures the bandwidth of a given IP address by downloading a file and calculating throughput.
+     * @param ip - The IP address of the peer.
+     * @returns Promise resolving to the bandwidth in bytes per second.
+     */
+    async measureBandwidth(ip) {
+        const url = `https://${ip}${this.bandwidthTestPath}`;
+        const config = {
+            url: url,
+            method: 'GET',
+            responseType: 'stream',
+            httpsAgent: new https_1.default.Agent({
+                cert: fs_1.default.readFileSync(PeerRanker.certPath),
+                key: fs_1.default.readFileSync(PeerRanker.keyPath),
+                rejectUnauthorized: false, // Set to true in production
+            }),
+            timeout: this.timeout,
+        };
+        return new Promise((resolve) => {
+            const startTime = Date.now();
+            let bytesReceived = 0;
+            (0, axios_1.default)(config)
+                .then((response) => {
+                response.data.on('data', (chunk) => {
+                    bytesReceived += chunk.length;
+                });
+                response.data.on('end', () => {
+                    const timeElapsed = (Date.now() - startTime) / 1000; // seconds
+                    const bandwidth = bytesReceived / timeElapsed; // bytes per second
+                    resolve(bandwidth);
+                });
+                response.data.on('error', (err) => {
+                    console.error(`Bandwidth measurement error for IP ${ip}:`, err.message);
+                    resolve(0); // Indicate failure in measuring bandwidth
+                });
+            })
+                .catch((error) => {
+                console.error(`Bandwidth measurement failed for IP ${ip}:`, error.message);
+                resolve(0); // Indicate failure in measuring bandwidth
+            });
+        });
+    }
+    /**
+     * Ranks the peers based on measured latency and bandwidth.
+     * @returns Promise resolving to an array of PeerMetrics sorted by latency and bandwidth.
+     */
+    async rankPeers() {
+        const metricsPromises = this.ipAddresses.map(async (ip) => {
+            const [latency, bandwidth] = await Promise.all([
+                this.measureLatency(ip),
+                this.measureBandwidth(ip),
+            ]);
+            return { ip, latency, bandwidth };
+        });
+        const peerMetrics = await Promise.all(metricsPromises);
+        // Sort by lowest latency first, then by highest bandwidth
+        peerMetrics.sort((a, b) => {
+            if (a.latency === b.latency) {
+                return b.bandwidth - a.bandwidth; // Higher bandwidth is better
+            }
+            return a.latency - b.latency; // Lower latency is better
+        });
+        // Update the internal sorted list
+        this.sortedPeers = peerMetrics;
+        // Reset the iterator index
+        this.currentIndex = 0;
+        return peerMetrics;
+    }
+    /**
+     * Returns the next best peer based on the ranking.
+     * Cycles through the list, resetting to the beginning once the end is reached.
+     * @returns The next PeerMetrics object or null if no peers are available.
+     */
+    GetNextBestPeer() {
+        if (this.sortedPeers.length === 0) {
+            console.warn('Peer list is empty. Please run rankPeers() first.');
+            return null;
+        }
+        const peer = this.sortedPeers[this.currentIndex];
+        this.currentIndex = (this.currentIndex + 1) % this.sortedPeers.length;
+        return peer;
+    }
+    /**
+     * Resets the internal iterator to start from the beginning of the sorted list.
+     */
+    resetIterator() {
+        this.currentIndex = 0;
+    }
+}
+exports.PeerRanker = PeerRanker;

package/dist/utils/index.d.ts

@@ -12,4 +12,5 @@ export * from './ssl';
 export * from './validationUtils';
 export * from './Environment';
 export * from './promiseUtils';
+export * from './PeerRanker';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -28,3 +28,4 @@ __exportStar(require("./ssl"), exports);
 __exportStar(require("./validationUtils"), exports);
 __exportStar(require("./Environment"), exports);
 __exportStar(require("./promiseUtils"), exports);
+__exportStar(require("./PeerRanker"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dignetwork/dig-sdk",
-  "version": "0.0.1-alpha.142",
+  "version": "0.0.1-alpha.144",
   "description": "",
   "type": "commonjs",
   "main": "./dist/index.js",