@dignetwork/dig-sdk 0.0.1-alpha.18 → 0.0.1-alpha.181

package/dist/utils/NconfManager.js

@@ -6,23 +6,32 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NconfManager = void 0;
 const nconf_1 = __importDefault(require("nconf"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
+const async_mutex_1 = require("async-mutex");
 const path_1 = __importDefault(require("path"));
 const config_1 = require("./config");
-const CONF_FOLDER_PATH = process.env.DIG_FOLDER_PATH || config_1.USER_DIR_PATH;
+const Environment_1 = require("./Environment");
+const CONF_FOLDER_PATH = Environment_1.Environment.DIG_FOLDER_PATH || config_1.USER_DIR_PATH;
+const fileMutex = new async_mutex_1.Mutex();
 class NconfManager {
     constructor(relativePath) {
         this.configFilePath = path_1.default.join(CONF_FOLDER_PATH, relativePath);
         this.initializeConfig();
     }
     async initializeConfig() {
+        const release = await fileMutex.acquire();
         const directory = path_1.default.dirname(this.configFilePath);
-        if (!(await fs_extra_1.default.pathExists(directory))) {
-            await fs_extra_1.default.mkdirp(directory);
-            console.log("Directory created:", directory);
+        try {
+            if (!(await fs_extra_1.default.pathExists(directory))) {
+                await fs_extra_1.default.mkdirp(directory);
+                console.log("Directory created:", directory);
+            }
+            if (!(await fs_extra_1.default.pathExists(this.configFilePath))) {
+                await fs_extra_1.default.writeFile(this.configFilePath, "{}");
+                console.log("Configuration file created:", this.configFilePath);
+            }
         }
-        if (!(await fs_extra_1.default.pathExists(this.configFilePath))) {
-            await fs_extra_1.default.writeFile(this.configFilePath, "{}");
-            console.log("Configuration file created:", this.configFilePath);
+        finally {
+            release();
         }
         nconf_1.default.file({ file: this.configFilePath });
     }

package/dist/utils/PeerRanker.d.ts

@@ -0,0 +1,55 @@
+export interface PeerMetrics {
+    ip: string;
+    latency: number;
+    bandwidth: number;
+}
+/**
+ * Utility class to rank peers based on latency and upload bandwidth using HTTPS with mTLS.
+ */
+export declare class PeerRanker {
+    private ipAddresses;
+    private static certPath;
+    private static keyPath;
+    private timeout;
+    private uploadTestSize;
+    private sortedPeers;
+    private currentIndex;
+    /**
+     * Constructs a PeerRanker instance.
+     * @param ipAddresses - Array of IP addresses to rank.
+     */
+    constructor(ipAddresses: string[], timeout?: number, uploadTestSize?: number);
+    /**
+     * 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.
+     * If the latency is cached, returns the cached value.
+     * @param ip - The IP address of the peer.
+     * @returns Promise resolving to the latency in milliseconds or rejecting if the peer fails.
+     */
+    private measureLatency;
+    /**
+     * Measures the upload bandwidth of a given IP address by sending random data.
+     * If the bandwidth is cached, returns the cached value.
+     * @param ip - The IP address of the peer.
+     * @returns Promise resolving to the upload bandwidth in bytes per second or rejecting if the peer fails.
+     */
+    private measureBandwidth;
+    /**
+     * Ranks the peers based on measured latency and upload bandwidth.
+     * Unresponsive peers are excluded from the final ranking.
+     * @param cooldown - Cooldown time in milliseconds between batches.
+     * @returns Promise resolving to an array of PeerMetrics sorted by latency and bandwidth.
+     */
+    rankPeers(cooldown?: number): 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;
+}
+//# 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":"AAUA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;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,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAG/B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,YAAY,CAAa;IAEjC;;;OAGG;gBACS,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,MAAa,EAAE,cAAc,GAAE,MAAoB;IAW/F;;;;;;OAMG;YACW,cAAc;IAkD5B;;;;;OAKG;YACW,gBAAgB;IA2C9B;;;;;OAKG;IACU,SAAS,CAAC,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmCtE;;;;OAIG;IACI,eAAe,IAAI,WAAW,GAAG,IAAI;IAW5C;;OAEG;IACI,aAAa,IAAI,IAAI;CAG7B"}

package/dist/utils/PeerRanker.js

@@ -0,0 +1,186 @@
+"use strict";
+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");
+const promiseUtils_1 = require("./promiseUtils");
+const node_cache_1 = __importDefault(require("node-cache"));
+// Cache with TTL of 1 day (86400 seconds)
+const peerCache = new node_cache_1.default({ stdTTL: 86400 });
+/**
+ * Utility class to rank peers based on latency and upload bandwidth using HTTPS with mTLS.
+ */
+class PeerRanker {
+    /**
+     * Constructs a PeerRanker instance.
+     * @param ipAddresses - Array of IP addresses to rank.
+     */
+    constructor(ipAddresses, timeout = 5000, uploadTestSize = 1024 * 1024) {
+        // Internal properties for iteration
+        this.sortedPeers = [];
+        this.currentIndex = 0;
+        this.ipAddresses = ipAddresses;
+        this.timeout = timeout; // Allow customizable timeout
+        this.uploadTestSize = uploadTestSize; // Default upload size: 1MB
+        // Fetch the SSL certificates used for mTLS.
+        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.
+     * If the latency is cached, returns the cached value.
+     * @param ip - The IP address of the peer.
+     * @returns Promise resolving to the latency in milliseconds or rejecting if the peer fails.
+     */
+    async measureLatency(ip) {
+        const cachedMetrics = await peerCache.get(ip);
+        if (cachedMetrics && cachedMetrics.latency) {
+            return cachedMetrics.latency;
+        }
+        const url = `https://${ip}:4159/diagnostics/ping`;
+        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,
+            }),
+            timeout: this.timeout,
+            validateStatus: (status) => status < 500,
+        };
+        const startTime = Date.now();
+        try {
+            const response = await (0, axios_1.default)(configHead);
+            if (response.status === 405) {
+                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,
+                    }),
+                    timeout: this.timeout,
+                    headers: {
+                        'Range': 'bytes=0-0',
+                    },
+                    validateStatus: (status) => status < 500,
+                };
+                await (0, axios_1.default)(configGet);
+            }
+            const latency = Date.now() - startTime;
+            // Cache the latency for the IP
+            peerCache.set(ip, { ...cachedMetrics, latency });
+            return latency;
+        }
+        catch (error) {
+            throw new Error(`Latency measurement failed for IP ${ip}`);
+        }
+    }
+    /**
+     * Measures the upload bandwidth of a given IP address by sending random data.
+     * If the bandwidth is cached, returns the cached value.
+     * @param ip - The IP address of the peer.
+     * @returns Promise resolving to the upload bandwidth in bytes per second or rejecting if the peer fails.
+     */
+    async measureBandwidth(ip) {
+        const cachedMetrics = await peerCache.get(ip);
+        if (cachedMetrics && cachedMetrics.bandwidth) {
+            return cachedMetrics.bandwidth;
+        }
+        const url = `https://${ip}:4159/diagnostics/bandwidth`;
+        const randomData = Buffer.alloc(this.uploadTestSize, 'a');
+        const config = {
+            url: url,
+            method: 'POST',
+            data: randomData,
+            headers: {
+                'Content-Type': 'application/octet-stream',
+                'Content-Length': this.uploadTestSize,
+            },
+            httpsAgent: new https_1.default.Agent({
+                cert: fs_1.default.readFileSync(PeerRanker.certPath),
+                key: fs_1.default.readFileSync(PeerRanker.keyPath),
+                rejectUnauthorized: false,
+            }),
+            timeout: this.timeout,
+            maxContentLength: Infinity,
+            maxBodyLength: Infinity,
+        };
+        const startTime = Date.now();
+        try {
+            await (0, axios_1.default)(config);
+            const timeElapsed = (Date.now() - startTime) / 1000;
+            const bandwidth = this.uploadTestSize / timeElapsed;
+            // Cache the bandwidth for the IP
+            peerCache.set(ip, { ...cachedMetrics, bandwidth });
+            return bandwidth;
+        }
+        catch (error) {
+            throw new Error(`Bandwidth measurement failed for IP ${ip}`);
+        }
+    }
+    /**
+     * Ranks the peers based on measured latency and upload bandwidth.
+     * Unresponsive peers are excluded from the final ranking.
+     * @param cooldown - Cooldown time in milliseconds between batches.
+     * @returns Promise resolving to an array of PeerMetrics sorted by latency and bandwidth.
+     */
+    async rankPeers(cooldown = 500) {
+        const limit = 5; // Limit to 5 parallel requests at a time
+        const iteratorFn = async (ip) => {
+            try {
+                const [latency, bandwidth] = await Promise.all([
+                    this.measureLatency(ip),
+                    this.measureBandwidth(ip),
+                ]);
+                return { ip, latency, bandwidth };
+            }
+            catch (error) {
+                // Peer failed, skip it by returning null
+                return null;
+            }
+        };
+        // Process all peers with a concurrency limit and cooldown between batches
+        const peerMetrics = (await (0, promiseUtils_1.asyncPool)(limit, this.ipAddresses, iteratorFn, cooldown)).filter((metrics) => metrics !== null); // Use a type guard
+        // 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
+        });
+        this.sortedPeers = peerMetrics;
+        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/StoreArchiveManager.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Class for managing file archiving, extraction, and working with the 'data' folder.
+ */
+declare class StoreArchiveManager {
+    private archivePath;
+    private outputStream;
+    /**
+     * Constructor that initializes the FileArchiveManager with a given path.
+     * @param archivePath - The path where the archive will be created.
+     */
+    constructor(archivePath: string);
+    /**
+     * Creates the archive at the specified path.
+     * @returns Promise<void>
+     */
+    createArchive(): Promise<void>;
+    /**
+     * Streams a file into the archive.
+     * @param filePath - The file to add to the archive.
+     * @param fileNameInArchive - The name the file should have inside the archive.
+     * @returns Promise<void>
+     */
+    addFileToArchive(filePath: string, fileNameInArchive: string): Promise<void>;
+    /**
+     * Extracts a file from the archive to a specified directory.
+     * @param extractToPath - The path where the file should be extracted.
+     * @returns Promise<void>
+     */
+    extractArchive(extractToPath: string): Promise<void>;
+    /**
+     * Merges another archive into the current one.
+     * Extracts files from the given archive and adds them into the current archive.
+     * @param archiveToMergePath - The path of the archive to be merged.
+     * @returns Promise<void>
+     */
+    mergeArchive(archiveToMergePath: string): Promise<void>;
+    /**
+     * Adds extracted files to the current archive.
+     * @param extractedFolderPath - The path of the folder containing extracted files.
+     * @returns Promise<void>
+     */
+    private addExtractedFilesToArchive;
+}
+export default StoreArchiveManager;
+//# sourceMappingURL=StoreArchiveManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StoreArchiveManager.d.ts","sourceRoot":"","sources":["../../src/utils/StoreArchiveManager.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,cAAM,mBAAmB;IACrB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAwB;IAE5C;;;OAGG;gBACS,WAAW,EAAE,MAAM;IAK/B;;;OAGG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3C;;;;;OAKG;IACU,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzF;;;;OAIG;IACU,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASjE;;;;;OAKG;IACU,YAAY,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCpE;;;;OAIG;YACW,0BAA0B;CAkB3C;AAED,eAAe,mBAAmB,CAAC"}

package/dist/utils/StoreArchiveManager.js

@@ -0,0 +1,153 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const archiver = __importStar(require("archiver"));
+const unzipper = __importStar(require("unzipper"));
+/**
+ * Class for managing file archiving, extraction, and working with the 'data' folder.
+ */
+class StoreArchiveManager {
+    /**
+     * Constructor that initializes the FileArchiveManager with a given path.
+     * @param archivePath - The path where the archive will be created.
+     */
+    constructor(archivePath) {
+        this.archivePath = archivePath;
+        this.outputStream = null;
+    }
+    /**
+     * Creates the archive at the specified path.
+     * @returns Promise<void>
+     */
+    async createArchive() {
+        return new Promise((resolve, reject) => {
+            this.outputStream = fs.createWriteStream(this.archivePath);
+            // @ts-ignore
+            const archive = archiver('zip', {
+                zlib: { level: 9 }
+            });
+            this.outputStream.on('close', () => {
+                console.log(`${archive.pointer()} total bytes`);
+                console.log('Archive has been finalized and output file descriptor has closed.');
+                resolve();
+            });
+            archive.on('error', (err) => {
+                reject(err);
+            });
+            archive.pipe(this.outputStream);
+        });
+    }
+    /**
+     * Streams a file into the archive.
+     * @param filePath - The file to add to the archive.
+     * @param fileNameInArchive - The name the file should have inside the archive.
+     * @returns Promise<void>
+     */
+    async addFileToArchive(filePath, fileNameInArchive) {
+        if (!this.outputStream) {
+            throw new Error('Archive not yet created.');
+        }
+        return new Promise((resolve, reject) => {
+            // @ts-ignore
+            const archive = archiver('zip', { zlib: { level: 9 } });
+            const fileStream = fs.createReadStream(filePath);
+            archive.append(fileStream, { name: fileNameInArchive });
+            archive.finalize();
+            archive.on('finish', resolve);
+            archive.on('error', reject);
+        });
+    }
+    /**
+     * Extracts a file from the archive to a specified directory.
+     * @param extractToPath - The path where the file should be extracted.
+     * @returns Promise<void>
+     */
+    async extractArchive(extractToPath) {
+        return new Promise((resolve, reject) => {
+            fs.createReadStream(this.archivePath)
+                .pipe(unzipper.Extract({ path: extractToPath }))
+                .on('close', resolve)
+                .on('error', reject);
+        });
+    }
+    /**
+     * Merges another archive into the current one.
+     * Extracts files from the given archive and adds them into the current archive.
+     * @param archiveToMergePath - The path of the archive to be merged.
+     * @returns Promise<void>
+     */
+    async mergeArchive(archiveToMergePath) {
+        if (!this.outputStream) {
+            throw new Error('Archive not yet created.');
+        }
+        return new Promise((resolve, reject) => {
+            const tempExtractPath = path.join(__dirname, 'tempExtract');
+            // Ensure the temp directory exists
+            if (!fs.existsSync(tempExtractPath)) {
+                fs.mkdirSync(tempExtractPath);
+            }
+            // Step 1: Extract the contents of the archive to be merged
+            fs.createReadStream(archiveToMergePath)
+                .pipe(unzipper.Extract({ path: tempExtractPath }))
+                .on('close', async () => {
+                try {
+                    // Step 2: Read the extracted files and add them to the current archive
+                    await this.addExtractedFilesToArchive(tempExtractPath);
+                    // Clean up: Delete the temporary directory
+                    fs.rmSync(tempExtractPath, { recursive: true, force: true });
+                    resolve();
+                }
+                catch (error) {
+                    reject(error);
+                }
+            })
+                .on('error', reject);
+        });
+    }
+    /**
+     * Adds extracted files to the current archive.
+     * @param extractedFolderPath - The path of the folder containing extracted files.
+     * @returns Promise<void>
+     */
+    async addExtractedFilesToArchive(extractedFolderPath) {
+        const files = fs.readdirSync(extractedFolderPath);
+        for (const file of files) {
+            const fullFilePath = path.join(extractedFolderPath, file);
+            const stat = fs.statSync(fullFilePath);
+            if (stat.isFile()) {
+                const relativePath = path.relative(extractedFolderPath, fullFilePath);
+                // Add the file into the current archive
+                await this.addFileToArchive(fullFilePath, relativePath);
+            }
+            else if (stat.isDirectory()) {
+                // Recursively add files from nested directories
+                await this.addExtractedFilesToArchive(fullFilePath);
+            }
+        }
+    }
+}
+exports.default = StoreArchiveManager;

package/dist/utils/Udi.d.ts

@@ -0,0 +1,28 @@
+declare class Udi {
+    readonly chainName: string;
+    private readonly _storeId;
+    private readonly _rootHash;
+    readonly resourceKey: string | null;
+    static readonly nid: string;
+    static readonly namespace: string;
+    constructor(chainName: string, storeId: string | Buffer, rootHash?: string | Buffer | null, resourceKey?: string | null);
+    static convertToBuffer(input: string | Buffer): Buffer;
+    static isHex(input: string): boolean;
+    static isBase32(input: string): boolean;
+    static addBase32Padding(input: string): string;
+    withRootHash(rootHash: string | Buffer | null): Udi;
+    withResourceKey(resourceKey: string | null): Udi;
+    static fromUrn(urn: string): Udi;
+    toUrn(encoding?: "hex" | "base32"): string;
+    bufferToString(buffer: Buffer, encoding: "hex" | "base32"): string;
+    equals(other: Udi): boolean;
+    toString(): string;
+    clone(): Udi;
+    hashCode(): string;
+    get storeId(): string;
+    get rootHash(): string | null;
+    get storeIdBase32(): string;
+    get rootHashBase32(): string | null;
+}
+export { Udi };
+//# sourceMappingURL=Udi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Udi.d.ts","sourceRoot":"","sources":["../../src/utils/Udi.ts"],"names":[],"mappings":"AAIA,cAAM,GAAG;IACP,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAS;IACpC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAoB;gBAGnD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,QAAQ,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,EACvC,WAAW,GAAE,MAAM,GAAG,IAAW;IAWnC,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAmBtD,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIpC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIvC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAM9C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,GAAG;IAInD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,GAAG;IAIhD,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IA4BhC,KAAK,CAAC,QAAQ,GAAE,KAAK,GAAG,QAAgB,GAAG,MAAM;IAgBjD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM;IAMlE,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAW3B,QAAQ,IAAI,MAAM;IAIlB,KAAK,IAAI,GAAG;IASZ,QAAQ,IAAI,MAAM;IAMlB,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAIlC;CACF;AAED,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/utils/Udi.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Udi = void 0;
+const urns = __importStar(require("urns"));
+const crypto_1 = require("crypto");
+const hi_base32_1 = require("hi-base32");
+class Udi {
+    constructor(chainName, storeId, rootHash = null, resourceKey = null) {
+        if (!storeId) {
+            throw new Error("storeId cannot be empty");
+        }
+        this.chainName = chainName || "chia";
+        this._storeId = Udi.convertToBuffer(storeId);
+        this._rootHash = rootHash ? Udi.convertToBuffer(rootHash) : null;
+        this.resourceKey = resourceKey;
+    }
+    static convertToBuffer(input) {
+        if (Buffer.isBuffer(input)) {
+            return input;
+        }
+        if (Udi.isHex(input)) {
+            return Buffer.from(input, "hex");
+        }
+        if (Udi.isBase32(input)) {
+            const paddedInput = Udi.addBase32Padding(input.toUpperCase());
+            return Buffer.from((0, hi_base32_1.decode)(paddedInput, false)); // Decode as UTF-8
+        }
+        throw new Error("Invalid input encoding. Must be 32-byte hex or Base32 string.");
+    }
+    static isHex(input) {
+        return /^[a-fA-F0-9]{64}$/.test(input);
+    }
+    static isBase32(input) {
+        return /^[a-z2-7]{52}$/.test(input.toLowerCase());
+    }
+    static addBase32Padding(input) {
+        // Calculate required padding
+        const paddingNeeded = (8 - (input.length % 8)) % 8;
+        return input + "=".repeat(paddingNeeded);
+    }
+    withRootHash(rootHash) {
+        return new Udi(this.chainName, this._storeId, rootHash, this.resourceKey);
+    }
+    withResourceKey(resourceKey) {
+        return new Udi(this.chainName, this._storeId, this._rootHash, resourceKey);
+    }
+    static fromUrn(urn) {
+        const parsedUrn = urns.parseURN(urn);
+        if (parsedUrn.nid.toLowerCase() !== Udi.nid) {
+            throw new Error(`Invalid nid: ${parsedUrn.nid}`);
+        }
+        const parts = parsedUrn.nss.split(":");
+        if (parts.length < 2) {
+            throw new Error(`Invalid UDI format: ${parsedUrn.nss}`);
+        }
+        const chainName = parts[0];
+        const storeId = parts[1].split("/")[0];
+        let rootHash = null;
+        if (parts.length > 2) {
+            rootHash = parts[2].split("/")[0];
+        }
+        const pathParts = parsedUrn.nss.split("/");
+        let resourceKey = null;
+        if (pathParts.length > 1) {
+            resourceKey = pathParts.slice(1).join("/");
+        }
+        return new Udi(chainName, storeId, rootHash, resourceKey);
+    }
+    toUrn(encoding = "hex") {
+        const storeIdStr = this.bufferToString(this._storeId, encoding);
+        let urn = `${Udi.namespace}:${this.chainName}:${storeIdStr}`;
+        if (this._rootHash) {
+            const rootHashStr = this.bufferToString(this._rootHash, encoding);
+            urn += `:${rootHashStr}`;
+        }
+        if (this.resourceKey) {
+            urn += `/${this.resourceKey}`;
+        }
+        return urn;
+    }
+    bufferToString(buffer, encoding) {
+        return encoding === "hex"
+            ? buffer.toString("hex")
+            : (0, hi_base32_1.encode)(buffer).toLowerCase().replace(/=+$/, "");
+    }
+    equals(other) {
+        return (this._storeId.equals(other._storeId) &&
+            this.chainName === other.chainName &&
+            (this._rootHash && other._rootHash
+                ? this._rootHash.equals(other._rootHash)
+                : this._rootHash === other._rootHash) &&
+            this.resourceKey === other.resourceKey);
+    }
+    toString() {
+        return this.toUrn();
+    }
+    clone() {
+        return new Udi(this.chainName, this._storeId, this._rootHash, this.resourceKey);
+    }
+    hashCode() {
+        const hash = (0, crypto_1.createHash)("sha256");
+        hash.update(this.toUrn());
+        return hash.digest("hex");
+    }
+    get storeId() {
+        return this._storeId.toString("hex");
+    }
+    get rootHash() {
+        return this._rootHash ? this._rootHash.toString("hex") : null;
+    }
+    get storeIdBase32() {
+        return this.bufferToString(this._storeId, "base32");
+    }
+    get rootHashBase32() {
+        return this._rootHash
+            ? this.bufferToString(this._rootHash, "base32")
+            : null;
+    }
+}
+exports.Udi = Udi;
+Udi.nid = "dig";
+Udi.namespace = `urn:${Udi.nid}`;