@dignetwork/dig-sdk 0.0.1-alpha.125 → 0.0.1-alpha.127

package/dist/DigNetwork/DigNetwork.d.ts

@@ -6,6 +6,7 @@ export declare class DigNetwork {
     private peerBlacklist;
     constructor(storeId: string);
     static subscribeToStore(storeId: string): Promise<void>;
+    static getUdiContent(udi: string): Promise<void>;
     static findPeerWithStoreKey(storeId: string, rootHash: string, key?: string, intialBlackList?: string[]): Promise<DigPeer | null>;
     static unsubscribeFromStore(storeId: string): void;
     syncStoreFromPeers(maxRootsToProcess?: number): Promise<void>;

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;AASpC,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAA2B;gBAEpC,OAAO,EAAE,MAAM;WAOP,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAQhD,oBAAoB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,EACZ,eAAe,GAAE,MAAM,EAAO,GAC7B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;WA2DZ,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5C,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiG7D,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;AASpC,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAA2B;gBAEpC,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,eAAe,GAAE,MAAM,EAAO,GAC7B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;WA2DZ,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5C,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiG7D,mBAAmB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAUvD"}

package/dist/DigNetwork/DigNetwork.js

@@ -46,6 +46,9 @@ class DigNetwork {
         const digNetwork = new DigNetwork(storeId);
         await digNetwork.syncStoreFromPeers();
     }
+    static async getUdiContent(udi) {
+        // TODO: Implement this method
+    }
     static async findPeerWithStoreKey(storeId, rootHash, key, intialBlackList = []) {
         const peerBlackList = intialBlackList;
         const serverCoin = new blockchain_1.ServerCoin(storeId);

package/dist/blockchain/DataStore.d.ts

@@ -35,13 +35,11 @@ export declare class DataStore {
     private static calculateFolderSize;
     static getAllStores(): DataStore[];
     /**
-    * Monitors the store indefinitely by syncing it with a peer.
-    * Logs store retrieval and caching operations. If an error occurs, logs the error and restarts the process after a short delay.
-    * Only one monitor can be active per storeId.
-    * @param {string} storeId - The store identifier to monitor.
-    * @returns {Promise<void>} Never resolves; runs indefinitely.
-    */
-    static monitorStoreIndefinitely(storeId: string): Promise<void>;
+     * Fetches the latest coin information using the StoreMonitorRegistry.
+     * Registers the storeId if it's not already registered, retrieves the cached value, and returns it.
+     *
+     * @returns {Promise<{ latestStore: DataStoreDriver; latestHeight: number; latestHash: Buffer }>}
+     */
     fetchCoinInfo(): Promise<{
         latestStore: DataStoreDriver;
         latestHeight: number;

package/dist/blockchain/DataStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataStore.d.ts","sourceRoot":"","sources":["../../src/blockchain/DataStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,SAAS,IAAI,eAAe,EAE5B,iBAAiB,EAIlB,MAAM,8BAA8B,CAAC;AAYtC,OAAO,EAAE,eAAe,EAAW,MAAM,UAAU,CAAC;AAGpD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAgBjD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAmC;gBAEpD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB;IAqB/D,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,IAAI,IAAI,iBAAiB,CAEnC;IAEM,QAAQ,IAAI,MAAM;IAIlB,QAAQ,IAAI,MAAM;IAIlB,SAAS,IAAI,MAAM;WAMN,cAAc,IAAI,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;WAOtD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS;WAK1C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS;WAiBtD,MAAM,CACxB,MAAM,GAAE,qBAA0B,GACjC,OAAO,CAAC,SAAS,CAAC;mBAyCA,IAAI;IA4FzB;;;OAGG;IACU,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAK5C;;;OAGG;WACiB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxD;;;;OAIG;mBACkB,mBAAmB;WAqB1B,YAAY,IAAI,SAAS,EAAE;IAWxC;;;;;;MAME;WACkB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4HhE,aAAa,IAAI,OAAO,CAAC;QACpC,WAAW,EAAE,eAAe,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAyGW,wBAAwB,IAAI,OAAO,CAAC;QAC/C,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAiBW,iBAAiB,IAAI,OAAO,CAAC;QACxC,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;YA0BY,iBAAiB;IAYlB,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA4C/D,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAexD,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAKzC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAM5B,uBAAuB,CAClC,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,OAAO,CAAC;IAkBN,cAAc,CACzB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC;IAgD3B;;;;;OAKG;IACU,qBAAqB,CAChC,QAAQ,EAAE,MAAM,EAChB,kBAAkB,GAAE,OAAe,GAClC,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CA6C7C"}
+{"version":3,"file":"DataStore.d.ts","sourceRoot":"","sources":["../../src/blockchain/DataStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,SAAS,IAAI,eAAe,EAE5B,iBAAiB,EAIlB,MAAM,8BAA8B,CAAC;AAWtC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAcjD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAmC;gBAEpD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB;IAiB/D,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,IAAI,IAAI,iBAAiB,CAEnC;IAEM,QAAQ,IAAI,MAAM;IAIlB,QAAQ,IAAI,MAAM;IAIlB,SAAS,IAAI,MAAM;WAMN,cAAc,IAAI,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;WAOtD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS;WAK1C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS;WAiBtD,MAAM,CACxB,MAAM,GAAE,qBAA0B,GACjC,OAAO,CAAC,SAAS,CAAC;mBAyCA,IAAI;IA4FzB;;;OAGG;IACU,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAK5C;;;OAGG;WACiB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxD;;;;OAIG;mBACkB,mBAAmB;WAqB1B,YAAY,IAAI,SAAS,EAAE;IAWzC;;;;;OAKG;IACU,aAAa,IAAI,OAAO,CAAC;QACpC,WAAW,EAAE,eAAe,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAkCW,wBAAwB,IAAI,OAAO,CAAC;QAC/C,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAiBW,iBAAiB,IAAI,OAAO,CAAC;QACxC,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;YA0BY,iBAAiB;IAYlB,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA4C/D,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAexD,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAKzC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAM5B,uBAAuB,CAClC,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,OAAO,CAAC;IAkBN,cAAc,CACzB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,CAAC;IAgD3B;;;;;OAKG;IACU,qBAAqB,CAChC,QAAQ,EAAE,MAAM,EAChB,kBAAkB,GAAE,OAAe,GAClC,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CA6C7C"}

package/dist/blockchain/DataStore.js

@@ -20,7 +20,7 @@ const FileCache_1 = require("../utils/FileCache");
 const DataStoreSerializer_1 = require("./DataStoreSerializer");
 const node_cache_1 = __importDefault(require("node-cache"));
 const config_2 = require("../utils/config");
-const utils_1 = require("../utils");
+const StoreMonitorRegistry_1 = require("./StoreMonitorRegistry");
 // Initialize the cache with a TTL of 180 seconds (3 minutes)
 const rootHistoryCache = new node_cache_1.default({ stdTTL: 180 });
 const stat = (0, util_1.promisify)(fs_1.default.stat);
@@ -39,9 +39,6 @@ class DataStore {
             };
         }
         this.tree = new DataIntegrityTree_1.DataIntegrityTree(storeId, _options);
-        if (!utils_1.Environment.CLI_MODE) {
-            DataStore.monitorStoreIndefinitely(this.storeId);
-        }
     }
     get StoreId() {
         return this.storeId;
@@ -205,143 +202,36 @@ class DataStore {
         return storIds.map((storeId) => DataStore.from(storeId));
     }
     /**
-    * Monitors the store indefinitely by syncing it with a peer.
-    * Logs store retrieval and caching operations. If an error occurs, logs the error and restarts the process after a short delay.
-    * Only one monitor can be active per storeId.
-    * @param {string} storeId - The store identifier to monitor.
-    * @returns {Promise<void>} Never resolves; runs indefinitely.
-    */
-    static async monitorStoreIndefinitely(storeId) {
-        // Check if a monitor is already running for this storeId
-        if (this.activeMonitors.get(storeId)) {
-            console.log("Monitor:", `Monitor already running for storeId: ${storeId}`);
-            return;
-        }
-        // Set the monitor as active
-        this.activeMonitors.set(storeId, true);
-        const storeCoinCache = new FileCache_1.FileCache(`stores`);
-        // Clear the cache at the start
-        console.log("Monitor:", `Clearing cache for storeId: ${storeId}`);
-        storeCoinCache.delete(storeId);
-        while (true) {
-            try {
-                console.log("Monitor:", `Connecting to peer for storeId: ${storeId}`);
-                const peer = await FullNodePeer_1.FullNodePeer.connect();
-                const cachedInfo = storeCoinCache.get(storeId);
-                if (cachedInfo) {
-                    // Log cached store info retrieval
-                    console.log("Monitor:", `Cached store info found for storeId: ${storeId}, syncing...`);
-                    // Deserialize cached info and wait for the coin to be spent
-                    const previousStore = DataStoreSerializer_1.DataStoreSerializer.deserialize({
-                        latestStore: cachedInfo.latestStore,
-                        latestHeight: cachedInfo.latestHeight.toString(),
-                        latestHash: cachedInfo.latestHash,
-                    });
-                    console.log("Monitor:", `Waiting for coin to be spent for storeId: ${storeId}...`);
-                    const dataStore = DataStore.from(storeId);
-                    const { createdAtHeight, createdAtHash } = await dataStore.getCreationHeight();
-                    await peer.waitForCoinToBeSpent((0, datalayer_driver_1.getCoinId)(previousStore.latestStore.coin), createdAtHeight, createdAtHash);
-                    // Sync store and get updated details
-                    console.log("Monitor:", `Syncing store for storeId: ${storeId}`);
-                    const { latestStore, latestHeight } = await peer.syncStore(previousStore.latestStore, createdAtHeight, createdAtHash, false);
-                    const latestHash = await peer.getHeaderHash(latestHeight);
-                    console.log("Monitor:", `Store synced for storeId: ${storeId}, coin id: ${(0, datalayer_driver_1.getCoinId)(latestStore.coin).toString("hex")}`);
-                    // Serialize and cache the updated store info
-                    const serializedLatestStore = new DataStoreSerializer_1.DataStoreSerializer(latestStore, latestHeight, latestHash).serialize();
-                    console.log("Monitor:", `Caching updated store info for storeId: ${storeId}`);
-                    storeCoinCache.set(storeId, {
-                        latestStore: serializedLatestStore,
-                        latestHeight,
-                        latestHash: latestHash.toString("hex"),
-                    });
-                    continue; // Continue monitoring
-                }
-                // If no cached info exists, log and sync from the creation height
-                console.log("Monitor:", `No cached info found for storeId: ${storeId}. Retrieving creation height.`);
-                const dataStore = DataStore.from(storeId);
-                const { createdAtHeight, createdAtHash } = await dataStore.getCreationHeight();
-                // Sync store from the peer using launcher ID
-                console.log("Monitor:", `Syncing store from launcher ID for storeId: ${storeId}`);
-                const { latestStore, latestHeight } = await peer.syncStoreFromLauncherId(Buffer.from(storeId, "hex"), createdAtHeight, createdAtHash, false);
-                const latestHash = await peer.getHeaderHash(latestHeight);
-                // Serialize and cache the new store info
-                const serializedLatestStore = new DataStoreSerializer_1.DataStoreSerializer(latestStore, latestHeight, latestHash).serialize();
-                console.log("Monitor:", `Caching new store info for storeId: ${storeId}`);
-                storeCoinCache.set(storeId, {
-                    latestStore: serializedLatestStore,
-                    latestHeight,
-                    latestHash: latestHash.toString("hex"),
-                });
-            }
-            catch (error) {
-                console.error("Monitor:", `Error in monitorStoreIndefinitely for storeId: ${storeId} - ${error.message}`);
-                // Delay before restarting to avoid rapid retries
-                await new Promise((resolve) => setTimeout(resolve, 5000));
-            }
-        }
-    }
+     * Fetches the latest coin information using the StoreMonitorRegistry.
+     * Registers the storeId if it's not already registered, retrieves the cached value, and returns it.
+     *
+     * @returns {Promise<{ latestStore: DataStoreDriver; latestHeight: number; latestHash: Buffer }>}
+     */
     async fetchCoinInfo() {
+        const storeMonitor = StoreMonitorRegistry_1.StoreMonitorRegistry.getInstance();
         try {
-            // Initialize the cache for the current storeId's coin info
-            const storeCoinCache = new FileCache_1.FileCache(`stores`);
-            // Try to get cached store info
-            const cachedInfo = storeCoinCache.get(this.storeId);
-            if (cachedInfo) {
-                try {
-                    const { latestStore: serializedStore, latestHeight: previousHeight, latestHash: previousHash, } = cachedInfo;
-                    // Deserialize the stored data using DataStoreSerializer
-                    const { latestStore: previousInfo } = DataStoreSerializer_1.DataStoreSerializer.deserialize({
-                        latestStore: serializedStore,
-                        latestHeight: previousHeight.toString(),
-                        latestHash: previousHash,
-                    });
-                    // Sync with peer if necessary
-                    const peer = await FullNodePeer_1.FullNodePeer.connect();
-                    const { latestStore, latestHeight } = await peer.syncStore(previousInfo, previousHeight, Buffer.from(previousHash, "hex"), false);
-                    const latestHash = await peer.getHeaderHash(latestHeight);
-                    // Serialize the store data for caching
-                    const serializedLatestStore = new DataStoreSerializer_1.DataStoreSerializer(latestStore, latestHeight, latestHash).serialize();
-                    // Cache updated store info
-                    storeCoinCache.set(this.storeId, {
-                        latestStore: serializedLatestStore,
-                        latestHeight,
-                        latestHash: latestHash.toString("hex"),
-                    });
-                    return { latestStore, latestHeight, latestHash };
-                }
-                catch {
-                    // Return cached info if sync fails
-                    const { latestStore, latestHeight, latestHash } = DataStoreSerializer_1.DataStoreSerializer.deserialize({
-                        latestStore: cachedInfo.latestStore,
-                        latestHeight: cachedInfo.latestHeight.toString(),
-                        latestHash: cachedInfo.latestHash,
-                    });
-                    return {
-                        latestStore,
-                        latestHeight,
-                        latestHash: latestHash,
-                    };
-                }
+            // Register the storeId with a no-op callback. If already registered, the registry will handle it.
+            await storeMonitor.registerStore(this.storeId, () => {
+                // No operation callback since we're fetching the cache directly
+            });
+            // Retrieve the latest cached store information
+            const cachedInfo = await storeMonitor.getLatestCache(this.storeId);
+            if (!cachedInfo) {
+                throw new Error(`No cached info found for storeId: ${this.storeId}`);
             }
-            // Use getCreationHeight to retrieve height and hash information
-            const { createdAtHeight, createdAtHash } = await this.getCreationHeight();
-            // Sync store from peer
-            const peer = await FullNodePeer_1.FullNodePeer.connect();
-            const { latestStore, latestHeight } = await peer.syncStoreFromLauncherId(Buffer.from(this.storeId, "hex"), createdAtHeight, createdAtHash, false);
-            const latestHash = await peer.getHeaderHash(latestHeight);
-            // Serialize the latest store info for caching
-            const serializedLatestStore = new DataStoreSerializer_1.DataStoreSerializer(latestStore, latestHeight, latestHash).serialize();
-            // Cache the latest store info
-            storeCoinCache.set(this.storeId, {
-                latestStore: serializedLatestStore,
-                latestHeight,
-                latestHash: latestHash.toString("hex"),
+            const deserializedStore = DataStoreSerializer_1.DataStoreSerializer.deserialize({
+                latestStore: cachedInfo.latestStore,
+                latestHeight: cachedInfo.latestHeight.toString(),
+                latestHash: cachedInfo.latestHash
             });
-            return { latestStore, latestHeight, latestHash };
+            return {
+                latestStore: deserializedStore.latestStore,
+                latestHeight: deserializedStore.latestHeight,
+                latestHash: deserializedStore.latestHash,
+            };
         }
         catch (error) {
-            console.trace("Failed to fetch coin info", error);
-            throw error;
+            throw new Error(`Failed to fetch coin info for storeId ${this.storeId}: ${error.message}`);
         }
     }
     async cacheStoreCreationHeight() {

package/dist/blockchain/FullNodePeer.d.ts

@@ -1,25 +1,109 @@
 import { Peer } from "@dignetwork/datalayer-driver";
+/**
+ * FullNodePeer manages connections to full nodes, prioritizing certain peers and handling reliability.
+ */
 export declare class FullNodePeer {
-    private static cachedPeer;
-    private static memoizedFetchNewPeerIPs;
     private peer;
-    private static deprioritizedIps;
+    private static instance;
+    private static cachedPeer;
+    private static cooldownCache;
+    private static peerWeights;
+    private static prioritizedPeers;
+    private static peerInfos;
+    private static peerIPCache;
     private constructor();
+    /**
+     * Retrieves the singleton instance of FullNodePeer.
+     * @returns {FullNodePeer} The singleton instance.
+     */
+    static getInstance(): FullNodePeer;
+    /**
+     * Initializes the singleton instance by connecting to the best peer.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Connects and returns the best available peer.
+     * Implements singleton behavior.
+     * @returns {Promise<Peer>} The connected Peer instance.
+     */
     static connect(): Promise<Peer>;
+    /**
+     * Checks if a given port on a host is reachable.
+     * @param {string} host - The host IP address.
+     * @param {number} port - The port number.
+     * @param {number} timeout - Connection timeout in milliseconds.
+     * @returns {Promise<boolean>} Whether the port is reachable.
+     */
     private static isPortReachable;
+    /**
+     * Validates an IPv4 address.
+     * @param {string} ip - The IP address to validate.
+     * @returns {boolean} Whether the IP address is valid.
+     */
     private static isValidIpAddress;
     /**
-     * Retrieves the TRUSTED_FULLNODE IP from the environment
-     * and verifies if it is a valid IP address.
-     *
-     * @returns {string | null} The valid IP address or null if invalid
+     * Retrieves the TRUSTED_FULLNODE IP from the environment and verifies its validity.
+     * @returns {string | null} The trusted full node IP or null if invalid.
      */
     private static getTrustedFullNode;
+    /**
+     * Fetches new peer IPs from DNS introducers and prioritized hosts.
+     * Utilizes caching to avoid redundant DNS resolutions.
+     * @returns {Promise<string[]>} An array of reachable peer IPs.
+     */
     private static fetchNewPeerIPs;
+    /**
+     * Shuffles an array using the Fisher-Yates algorithm.
+     * @param {T[]} array - The array to shuffle.
+     * @returns {T[]} The shuffled array.
+     */
+    private static shuffleArray;
+    /**
+     * Initializes the peer weights map.
+     * Assigns higher initial weights to prioritized peers.
+     * @param {string[]} peerIPs - An array of peer IPs.
+     */
+    private static initializePeerWeights;
+    /**
+     * Selects a peer based on weighted random selection.
+     * Prioritized peers have higher weights.
+     * @returns {string} The selected peer IP.
+     */
+    private static selectPeerByWeight;
+    /**
+     * Retrieves all reachable peer IPs, excluding those in cooldown.
+     * @returns {Promise<string[]>} An array of reachable peer IPs.
+     */
     private static getPeerIPs;
-    private static createPeerProxy;
+    /**
+     * Initializes the peer weights based on prioritization and reliability.
+     * @param {string[]} peerIPs - An array of peer IPs.
+     */
+    private static setupPeers;
+    /**
+     * Connects to the best available peer based on weighted selection and reliability.
+     * @returns {Promise<Peer>} The connected Peer instance.
+     */
     private static getBestPeer;
-    getPeer(): Peer;
+    /**
+     * Creates a proxy for the peer to handle errors and implement retries.
+     * @param {Peer} peer - The Peer instance.
+     * @param {string} peerIP - The IP address of the peer.
+     * @param {number} [retryCount=0] - The current retry attempt.
+     * @returns {Peer} The proxied Peer instance.
+     */
+    private static createPeerProxy;
+    /**
+     * Extracts the IP address from a Peer instance.
+     * @param {Peer} peer - The Peer instance.
+     * @returns {string | null} The extracted IP address or null if not found.
+     */
+    private static extractPeerIP;
+    /**
+   * Waits for a coin to be confirmed (spent) on the blockchain.
+   * @param {Buffer} parentCoinInfo - The parent coin information.
+   * @returns {Promise<boolean>} Whether the coin was confirmed.
+   */
     static waitForConfirmation(parentCoinInfo: Buffer): Promise<boolean>;
 }
 //# sourceMappingURL=FullNodePeer.d.ts.map

package/dist/blockchain/FullNodePeer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FullNodePeer.d.ts","sourceRoot":"","sources":["../../src/blockchain/FullNodePeer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAO,MAAM,8BAA8B,CAAC;AAoBzD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAkD;IAC3E,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAA0B;IAChE,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA0B;IAQzD,OAAO;WAIa,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5C,OAAO,CAAC,MAAM,CAAC,eAAe;IAiB9B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAM/B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;mBASZ,eAAe;mBA6Df,UAAU;IA2B/B,OAAO,CAAC,MAAM,CAAC,eAAe;mBAyDT,WAAW;IAsGzB,OAAO,IAAI,IAAI;WAIF,mBAAmB,CACrC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC;CAwBpB"}
+{"version":3,"file":"FullNodePeer.d.ts","sourceRoot":"","sources":["../../src/blockchain/FullNodePeer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAO,MAAM,8BAA8B,CAAC;AAiCzD;;GAEG;AACH,qBAAa,YAAY;IAuBH,OAAO,CAAC,IAAI;IArBhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IAGpD,OAAO,CAAC,MAAM,CAAC,UAAU,CAAkD;IAG3E,OAAO,CAAC,MAAM,CAAC,aAAa,CAAuD;IAGnF,OAAO,CAAC,MAAM,CAAC,WAAW,CAAkC;IAG5D,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAgB;IAG/C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAoC;IAG5D,OAAO,CAAC,MAAM,CAAC,WAAW,CAAoD;IAG9E,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,YAAY;IAOzC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxC;;;;OAIG;WACiB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5C;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAuB9B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAM/B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IASjC;;;;OAIG;mBACkB,eAAe;IAyFpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAS3B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAgBpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAwBjC;;;OAGG;mBACkB,UAAU;IAK/B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB;;;OAGG;mBACkB,WAAW;IAyEhC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAuE9B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAS1B;;;;KAIC;WACmB,mBAAmB,CACrC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC;CAyBtB"}