@bsv/sdk 1.3.36 → 1.4.1

package/dist/cjs/src/registry/RegistryClient.js

@@ -0,0 +1,392 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegistryClient = void 0;
+const index_js_1 = require("../wallet/index.js");
+const index_js_2 = require("../primitives/index.js");
+const index_js_3 = require("../transaction/index.js");
+const index_js_4 = require("../overlay-tools/index.js");
+const index_js_5 = require("../script/index.js");
+const REGISTRANT_TOKEN_AMOUNT = 1;
+/**
+ * RegistryClient manages on-chain registry definitions for three types:
+ * - BasketMap (basket-based items)
+ * - ProtoMap (protocol-based items)
+ * - CertMap (certificate-based items)
+ *
+ * It provides methods to:
+ * - Register new definitions using pushdrop-based UTXOs.
+ * - Resolve existing definitions using a overlay lookup service.
+ * - List registry entries associated with the operator's wallet.
+ * - Revoke an existing registry entry by spending its UTXO.
+ *
+ * Registry operators use this client to establish and manage
+ * canonical references for baskets, protocols, and certificates types.
+ */
+class RegistryClient {
+    constructor(wallet = new index_js_1.WalletClient()) {
+        this.wallet = wallet;
+    }
+    /**
+     * Publishes a new on-chain definition for baskets, protocols, or certificates.
+     * The definition data is encoded in a pushdrop-based UTXO.
+     *
+     * Registry operators (i.e., identity key owners) can create these definitions
+     * to establish canonical references for basket IDs, protocol specs, or certificate schemas.
+     *
+     * @param data - The structured information needed to register an item of kind 'basket', 'protocol', or 'certificate'.
+     * @returns A promise with the broadcast result or failure.
+     */
+    async registerDefinition(data) {
+        var _a;
+        const registryOperator = (await this.wallet.getPublicKey({ identityKey: true })).publicKey;
+        const pushdrop = new index_js_5.PushDrop(this.wallet);
+        // Build the array of fields, depending on the definition type
+        const fields = this.buildPushDropFields(data, registryOperator);
+        const protocol = this.getWalletProtocol(data.definitionType);
+        // Lock the fields
+        const lockingScript = await pushdrop.lock(fields, protocol, '1', 'self');
+        // Create a transaction
+        const { tx } = await this.wallet.createAction({
+            description: `Register a new ${data.definitionType} item`,
+            outputs: [
+                {
+                    satoshis: REGISTRANT_TOKEN_AMOUNT,
+                    lockingScript: lockingScript.toHex(),
+                    outputDescription: `New ${data.definitionType} registration token`
+                }
+            ]
+        });
+        if (tx === undefined) {
+            throw new Error(`Failed to create ${data.definitionType} registration transaction!`);
+        }
+        // Broadcast
+        const broadcaster = new index_js_4.TopicBroadcaster([this.getBroadcastTopic(data.definitionType)], {
+            networkPreset: (_a = this.network) !== null && _a !== void 0 ? _a : (this.network = (await (this.wallet.getNetwork({}))).network)
+        });
+        return await broadcaster.broadcast(index_js_3.Transaction.fromAtomicBEEF(tx));
+    }
+    /**
+     * Resolves registrant tokens of a particular type using a lookup service.
+     *
+     * The query object shape depends on the registry type:
+     * - For "basket", the query is of type BasketMapQuery:
+     *   { basketID?: string; name?: string; registryOperators?: string[]; }
+     * - For "protocol", the query is of type ProtoMapQuery:
+     *   { name?: string; registryOperators?: string[]; protocolID?: string; securityLevel?: number; }
+     * - For "certificate", the query is of type CertMapQuery:
+     *   { type?: string; name?: string; registryOperators?: string[]; }
+     *
+     * @param definitionType - The registry type, which can be 'basket', 'protocol', or 'certificate'.
+     * @param query - The query object used to filter registry records, whose shape is determined by the registry type.
+     * @returns A promise that resolves to an array of matching registry records.
+     */
+    async resolve(definitionType, query) {
+        const resolver = new index_js_4.LookupResolver();
+        // The service name depends on the kind
+        const serviceName = this.getServiceName(definitionType);
+        const result = await resolver.query({
+            service: serviceName,
+            query
+        });
+        if (result.type !== 'output-list') {
+            return [];
+        }
+        const parsedRegistryRecords = [];
+        for (const output of result.outputs) {
+            try {
+                const parsedTx = index_js_3.Transaction.fromAtomicBEEF(output.beef);
+                const record = await this.parseLockingScript(definitionType, parsedTx.outputs[output.outputIndex].lockingScript);
+                parsedRegistryRecords.push(record);
+            }
+            catch {
+                // skip
+            }
+        }
+        return parsedRegistryRecords;
+    }
+    /**
+     * Lists the registry operator's published definitions for the given type.
+     *
+     * Returns parsed registry records including transaction details such as txid, outputIndex, satoshis, and the locking script.
+     *
+     * @param definitionType - The type of registry definition to list ('basket', 'protocol', or 'certificate').
+     * @returns A promise that resolves to an array of RegistryRecord objects.
+     */
+    async listOwnRegistryEntries(definitionType) {
+        const relevantBasketName = this.getBasketName(definitionType);
+        const { outputs } = await this.wallet.listOutputs({
+            basket: relevantBasketName,
+            include: 'locking scripts'
+        });
+        const results = [];
+        for (const output of outputs) {
+            if (output.spendable) {
+                continue;
+            }
+            try {
+                const record = await this.parseLockingScript(definitionType, index_js_5.LockingScript.fromHex(output.lockingScript));
+                const [txid, outputIndex] = output.outpoint.split('.');
+                results.push({
+                    ...record,
+                    txid,
+                    outputIndex: Number(outputIndex),
+                    satoshis: output.satoshis,
+                    lockingScript: output.lockingScript
+                });
+            }
+            catch {
+                // ignore parse errors
+            }
+        }
+        return results;
+    }
+    /**
+     * Revokes a registry record by spending its associated UTXO.
+     *
+     * This function creates a transaction that spends the UTXO corresponding to the provided registry record,
+     * revoking the registry entry. It prepares an unlocker using the appropriate wallet protocol,
+     * builds a signable transaction, signs it, and then broadcasts the finalized transaction.
+     *
+     * @param registryRecord - The registry record to revoke. It must include a valid txid, outputIndex, and lockingScript.
+     * @returns A promise that resolves with either a BroadcastResponse upon success or a BroadcastFailure on error.
+     * @throws If required fields are missing or if transaction creation/signing fails.
+     */
+    async revokeOwnRegistryEntry(registryRecord) {
+        var _a;
+        if (registryRecord.txid === undefined || typeof registryRecord.outputIndex === 'undefined' || registryRecord.lockingScript === undefined) {
+            throw new Error('Invalid record. Missing txid, outputIndex, or lockingScript.');
+        }
+        // Prepare the unlocker
+        const pushdrop = new index_js_5.PushDrop(this.wallet);
+        const unlocker = await pushdrop.unlock(this.getWalletProtocol(registryRecord.definitionType), '1', 'anyone');
+        const itemIdentifier = registryRecord.definitionType === 'basket'
+            ? registryRecord.basketID
+            : registryRecord.definitionType === 'protocol'
+                ? registryRecord.name
+                : registryRecord.definitionType === 'certificate'
+                    ? (registryRecord.name !== undefined ? registryRecord.name : registryRecord.type)
+                    : 'unknown';
+        const description = `Revoke ${registryRecord.definitionType} item: ${String(itemIdentifier)}`;
+        // Create a new transaction that spends the UTXO
+        const outpoint = `${registryRecord.txid}.${registryRecord.outputIndex}`;
+        const { signableTransaction } = await this.wallet.createAction({
+            // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
+            description,
+            inputs: [
+                {
+                    outpoint,
+                    unlockingScriptLength: 73,
+                    inputDescription: `Revoking ${registryRecord.definitionType} token`
+                }
+            ]
+        });
+        if (signableTransaction === undefined) {
+            throw new Error('Failed to create signable transaction.');
+        }
+        // Build a transaction object, sign with the unlock script
+        const tx = index_js_3.Transaction.fromBEEF(signableTransaction.tx);
+        const finalUnlockScript = await unlocker.sign(tx, registryRecord.outputIndex);
+        // Complete the signing
+        const { tx: signedTx } = await this.wallet.signAction({
+            reference: signableTransaction.reference,
+            spends: {
+                [registryRecord.outputIndex]: {
+                    unlockingScript: finalUnlockScript.toHex()
+                }
+            }
+        });
+        if (signedTx === undefined) {
+            throw new Error('Failed to finalize the transaction signature.');
+        }
+        // Broadcast
+        const broadcaster = new index_js_4.TopicBroadcaster([this.getBroadcastTopic(registryRecord.definitionType)], {
+            networkPreset: (_a = this.network) !== null && _a !== void 0 ? _a : (this.network = (await (this.wallet.getNetwork({}))).network)
+        });
+        return await broadcaster.broadcast(index_js_3.Transaction.fromAtomicBEEF(signedTx));
+    }
+    // --------------------------------------------------------------------------
+    // INTERNAL HELPER METHODS
+    // --------------------------------------------------------------------------
+    buildPushDropFields(data, registryOperator) {
+        let fields;
+        switch (data.definitionType) {
+            case 'basket':
+                fields = [
+                    data.basketID,
+                    data.name,
+                    data.iconURL,
+                    data.description,
+                    data.documentationURL
+                ];
+                break;
+            case 'protocol':
+                fields = [
+                    data.securityLevel.toString(),
+                    data.protocolID,
+                    data.name,
+                    data.iconURL,
+                    data.description,
+                    data.documentationURL
+                ];
+                break;
+            case 'certificate':
+                fields = [
+                    data.type,
+                    data.name,
+                    data.iconURL,
+                    data.description,
+                    data.documentationURL,
+                    JSON.stringify(data.fields)
+                ];
+                break;
+            default:
+                throw new Error('Invalid registry kind specified');
+        }
+        // Append the registry operator to all cases.
+        fields.push(registryOperator);
+        return fields.map(field => index_js_2.Utils.toArray(field));
+    }
+    /**
+     * Decodes a pushdrop locking script for a given registry kind,
+     * returning a typed record with the appropriate fields.
+     */
+    async parseLockingScript(definitionType, lockingScript) {
+        const decoded = index_js_5.PushDrop.decode(lockingScript);
+        if (decoded.fields.length === 0) {
+            throw new Error('Not a valid registry pushdrop script.');
+        }
+        let registryOperator;
+        let data;
+        switch (definitionType) {
+            case 'basket': {
+                if (decoded.fields.length !== 6) {
+                    throw new Error('Unexpected field count for basket type.');
+                }
+                const [basketID, name, iconURL, description, docURL, operator] = decoded.fields;
+                registryOperator = index_js_2.Utils.toUTF8(operator);
+                data = {
+                    definitionType: 'basket',
+                    basketID: index_js_2.Utils.toUTF8(basketID),
+                    name: index_js_2.Utils.toUTF8(name),
+                    iconURL: index_js_2.Utils.toUTF8(iconURL),
+                    description: index_js_2.Utils.toUTF8(description),
+                    documentationURL: index_js_2.Utils.toUTF8(docURL)
+                };
+                break;
+            }
+            case 'protocol': {
+                if (decoded.fields.length !== 7) {
+                    throw new Error('Unexpected field count for proto type.');
+                }
+                const [securityLevel, protocolID, name, iconURL, description, docURL, operator] = decoded.fields;
+                registryOperator = index_js_2.Utils.toUTF8(operator);
+                data = {
+                    definitionType: 'protocol',
+                    securityLevel: parseInt(index_js_2.Utils.toUTF8(securityLevel), 10),
+                    protocolID: index_js_2.Utils.toUTF8(protocolID),
+                    name: index_js_2.Utils.toUTF8(name),
+                    iconURL: index_js_2.Utils.toUTF8(iconURL),
+                    description: index_js_2.Utils.toUTF8(description),
+                    documentationURL: index_js_2.Utils.toUTF8(docURL)
+                };
+                break;
+            }
+            case 'certificate': {
+                if (decoded.fields.length !== 7) {
+                    throw new Error('Unexpected field count for certificate type.');
+                }
+                const [certType, name, iconURL, description, docURL, fieldsJSON, operator] = decoded.fields;
+                registryOperator = index_js_2.Utils.toUTF8(operator);
+                let parsedFields;
+                try {
+                    parsedFields = JSON.parse(index_js_2.Utils.toUTF8(fieldsJSON));
+                }
+                catch {
+                    parsedFields = {};
+                }
+                data = {
+                    definitionType: 'certificate',
+                    type: index_js_2.Utils.toUTF8(certType),
+                    name: index_js_2.Utils.toUTF8(name),
+                    iconURL: index_js_2.Utils.toUTF8(iconURL),
+                    description: index_js_2.Utils.toUTF8(description),
+                    documentationURL: index_js_2.Utils.toUTF8(docURL),
+                    fields: parsedFields
+                };
+                break;
+            }
+            default:
+                throw new Error('Invalid registry kind for parsing.');
+        }
+        const currentIdentityKey = (await this.wallet.getPublicKey({ identityKey: true })).publicKey;
+        if (registryOperator !== currentIdentityKey) {
+            throw new Error('This registry token does not belong to the current wallet.');
+        }
+        return {
+            ...data,
+            registryOperator
+        };
+    }
+    /**
+     * Returns the (protocolID, keyID) used for pushdrop based on the registry kind.
+     */
+    getWalletProtocol(definitionType) {
+        switch (definitionType) {
+            case 'basket':
+                return [1, 'basketmap'];
+            case 'protocol':
+                return [1, 'protomap'];
+            case 'certificate':
+                return [1, 'certmap'];
+            default:
+                throw new Error(`Unknown registry type: ${definitionType}`);
+        }
+    }
+    /**
+     * Returns the name of the basket used by the wallet
+     */
+    getBasketName(definitionType) {
+        switch (definitionType) {
+            case 'basket':
+                return 'basketmap';
+            case 'protocol':
+                return 'protomap';
+            case 'certificate':
+                return 'certmap';
+            default:
+                throw new Error(`Unknown basket type: ${definitionType}`);
+        }
+    }
+    /**
+     * Returns the broadcast topic to be used with SHIPBroadcaster.
+     */
+    getBroadcastTopic(definitionType) {
+        switch (definitionType) {
+            case 'basket':
+                return 'tm_basketmap';
+            case 'protocol':
+                return 'tm_protomap';
+            case 'certificate':
+                return 'tm_certmap';
+            default:
+                throw new Error(`Unknown topic type: ${definitionType}`);
+        }
+    }
+    /**
+     * Returns the lookup service name to use.
+     */
+    getServiceName(definitionType) {
+        switch (definitionType) {
+            case 'basket':
+                return 'ls_basketmap';
+            case 'protocol':
+                return 'ls_protomap';
+            case 'certificate':
+                return 'ls_certmap';
+            default:
+                throw new Error(`Unknown service type: ${definitionType}`);
+        }
+    }
+}
+exports.RegistryClient = RegistryClient;
+//# sourceMappingURL=RegistryClient.js.map

package/dist/cjs/src/registry/RegistryClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryClient.js","sourceRoot":"","sources":["../../../../src/registry/RegistryClient.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/registry/index.js

@@ -0,0 +1,19 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./RegistryClient.js"), exports);
+__exportStar(require("./types/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/registry/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAmC;AACnC,mDAAgC"}

package/dist/cjs/src/registry/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/registry/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/registry/types/index.ts"],"names":[],"mappings":""}

package/dist/cjs/src/storage/StorageUploader.js

@@ -0,0 +1,93 @@
+"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.StorageUploader = void 0;
+const AuthFetch_js_1 = require("../auth/clients/AuthFetch.js");
+const StorageUtils = __importStar(require("./StorageUtils.js"));
+class StorageUploader {
+    constructor(config) {
+        this.baseURL = config.storageURL;
+        this.authFetch = new AuthFetch_js_1.AuthFetch(config.wallet);
+    }
+    async getUploadInfo(fileSize, retentionPeriod) {
+        const url = `${this.baseURL}/upload`;
+        const body = { fileSize, retentionPeriod };
+        const response = await this.authFetch.fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body)
+        });
+        if (!response.ok) {
+            throw new Error(`Upload info request failed: HTTP ${response.status}`);
+        }
+        const data = await response.json();
+        if (data.status === 'error') {
+            throw new Error('Upload route returned an error.');
+        }
+        return {
+            uploadURL: data.uploadURL,
+            amount: data.amount
+        };
+    }
+    async uploadFile(uploadURL, file) {
+        const body = Uint8Array.from(file.data);
+        const response = await fetch(uploadURL, {
+            method: 'PUT',
+            body,
+            headers: { 'Content-Type': file.type }
+        });
+        if (!response.ok) {
+            throw new Error(`File upload failed: HTTP ${response.status}`);
+        }
+        const uhrpURL = await StorageUtils.getURLForFile(file.data);
+        return {
+            published: true,
+            uhrpURL
+        };
+    }
+    /**
+       * Publishes a file to the storage server with the specified retention period.
+       *
+       * This will:
+       * 1. Request an upload URL from the server.
+       * 2. Perform an HTTP PUT to upload the file’s raw bytes.
+       * 3. Return a UHRP URL referencing the file once published.
+       *
+       * @param params.file - An object describing the file’s data (number[] array of bytes) and mime type.
+       * @param params.retentionPeriod - Number of minutes to keep the file hosted.
+       *
+       * @returns An object indicating whether the file was published successfully and the resulting UHRP URL.
+       *
+       * @throws If either the upload info request or the subsequent file upload request fails (non-OK HTTP status).
+       */
+    async publishFile(params) {
+        const { file, retentionPeriod } = params;
+        const fileSize = file.data.length;
+        const { uploadURL } = await this.getUploadInfo(fileSize, retentionPeriod);
+        return await this.uploadFile(uploadURL, file);
+    }
+}
+exports.StorageUploader = StorageUploader;
+//# sourceMappingURL=StorageUploader.js.map

package/dist/cjs/src/storage/StorageUploader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageUploader.js","sourceRoot":"","sources":["../../../../src/storage/StorageUploader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+DAAwD;AAExD,gEAAiD;AAiBjD,MAAa,eAAe;IAI1B,YAAa,MAAsB;QACjC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAA;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC/C,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,QAAgB,EAChB,eAAuB;QAKvB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,SAAS,CAAA;QACpC,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAA;QAE1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;YAChB,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;SACvE;QACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAI/B,CAAA;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE;YAC3B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;SACnD;QACD,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAA;IACH,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,SAAiB,EACjB,IAAoB;QAEpB,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEvC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;YACtC,MAAM,EAAE,KAAK;YACb,IAAI;YACJ,OAAO,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE;SACvC,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;YAChB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;SAC/D;QAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3D,OAAO;YACL,SAAS,EAAE,IAAI;YACf,OAAO;SACR,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;SAcK;IACE,KAAK,CAAC,WAAW,CAAE,MAGzB;QACC,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,MAAM,CAAA;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAA;QAEjC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAA;QACzE,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC/C,CAAC;CACF;AAxFD,0CAwFC"}

package/dist/cjs/src/storage/StorageUtils.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidURL = exports.getHashFromURL = exports.getURLForFile = exports.getURLForHash = exports.normalizeURL = void 0;
+const Hash_js_1 = require("../primitives/Hash.js");
+const utils_js_1 = require("../primitives/utils.js");
+/**
+ * Takes a UHRP URL and removes any prefixes.
+ * @param {string} URL - The UHRP URL.
+ * @returns {string} - Normalized URL.
+ */
+const normalizeURL = (URL) => {
+    if (URL.toLowerCase().startsWith('uhrp:'))
+        URL = URL.slice(5);
+    if (URL.startsWith('//'))
+        URL = URL.slice(2);
+    return URL;
+};
+exports.normalizeURL = normalizeURL;
+/**
+ * Generates a UHRP URL from a given SHA-256 hash.
+ * @param {number[]} hash - 32-byte SHA-256 hash.
+ * @returns {string} - Base58Check encoded URL.
+ */
+const getURLForHash = (hash) => {
+    if (hash.length !== 32) {
+        throw new Error('Hash length must be 32 bytes (sha256)');
+    }
+    return (0, utils_js_1.toBase58Check)(hash, (0, utils_js_1.toArray)('ce00', 'hex'));
+};
+exports.getURLForHash = getURLForHash;
+/**
+ * Generates a UHRP URL for a given file.
+ * @param {number[] | string} file - File content as number array or string.
+ * @returns {string} - Base58Check encoded URL.
+ */
+const getURLForFile = (file) => {
+    const hash = (0, Hash_js_1.sha256)(file);
+    return (0, exports.getURLForHash)(hash);
+};
+exports.getURLForFile = getURLForFile;
+/**
+ * Extracts the hash from a UHRP URL.
+ * @param {string} URL - UHRP URL.
+ * @returns {number[]} - Extracted SHA-256 hash.
+ */
+const getHashFromURL = (URL) => {
+    URL = (0, exports.normalizeURL)(URL);
+    const { data, prefix } = (0, utils_js_1.fromBase58Check)(URL, undefined, 2);
+    if (data.length !== 32) {
+        throw new Error('Invalid length!');
+    }
+    if ((0, utils_js_1.toHex)(prefix) !== 'ce00') {
+        throw new Error('Bad prefix');
+    }
+    return data;
+};
+exports.getHashFromURL = getHashFromURL;
+/**
+ * Checks if a URL is a valid UHRP URL.
+ * @param {string} URL - The URL to validate.
+ * @returns {boolean} - True if valid, false otherwise.
+ */
+const isValidURL = (URL) => {
+    try {
+        (0, exports.getHashFromURL)(URL);
+        return true;
+    }
+    catch (e) {
+        return false;
+    }
+};
+exports.isValidURL = isValidURL;
+//# sourceMappingURL=StorageUtils.js.map

package/dist/cjs/src/storage/StorageUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageUtils.js","sourceRoot":"","sources":["../../../../src/storage/StorageUtils.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAC9C,qDAAuF;AAEvF;;;;GAIG;AACI,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE;IAClD,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC7D,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC5C,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAJY,QAAA,YAAY,gBAIxB;AAED;;;;GAIG;AACI,MAAM,aAAa,GAAG,CAAC,IAAc,EAAU,EAAE;IACtD,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE;QACtB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;KACzD;IACD,OAAO,IAAA,wBAAa,EAAC,IAAI,EAAE,IAAA,kBAAO,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AACpD,CAAC,CAAA;AALY,QAAA,aAAa,iBAKzB;AAED;;;;GAIG;AACI,MAAM,aAAa,GAAG,CAAC,IAAc,EAAU,EAAE;IACtD,MAAM,IAAI,GAAG,IAAA,gBAAM,EAAC,IAAI,CAAC,CAAA;IACzB,OAAO,IAAA,qBAAa,EAAC,IAAI,CAAC,CAAA;AAC5B,CAAC,CAAA;AAHY,QAAA,aAAa,iBAGzB;AAED;;;;GAIG;AACI,MAAM,cAAc,GAAG,CAAC,GAAW,EAAY,EAAE;IACtD,GAAG,GAAG,IAAA,oBAAY,EAAC,GAAG,CAAC,CAAA;IACvB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAA,0BAAe,EAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;IAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE;QACtB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;KACnC;IACD,IAAI,IAAA,gBAAK,EAAC,MAAkB,CAAC,KAAK,MAAM,EAAE;QACxC,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;KAC9B;IACD,OAAO,IAAgB,CAAA;AACzB,CAAC,CAAA;AAVY,QAAA,cAAc,kBAU1B;AAED;;;;GAIG;AACI,MAAM,UAAU,GAAG,CAAC,GAAW,EAAW,EAAE;IACjD,IAAI;QACF,IAAA,sBAAc,EAAC,GAAG,CAAC,CAAA;QACnB,OAAO,IAAI,CAAA;KACZ;IAAC,OAAO,CAAC,EAAE;QACV,OAAO,KAAK,CAAA;KACb;AACH,CAAC,CAAA;AAPY,QAAA,UAAU,cAOtB"}