@taquito/sapling 24.3.0-rc.1 → 24.3.0-rc.3

package/dist/taquito-sapling.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('bignumber.js'), require('@taquito/taquito'), require('@taquito/utils'), require('@taquito/core'), require('@taquito/sapling-wasm'), require('blakejs'), require('@stablelib/nacl'), require('../saplingOutputParams.js'), require('@taquito/sapling-spend-params'), require('typedarray-to-buffer')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'bignumber.js', '@taquito/taquito', '@taquito/utils', '@taquito/core', '@taquito/sapling-wasm', 'blakejs', '@stablelib/nacl', '../saplingOutputParams', '@taquito/sapling-spend-params', 'typedarray-to-buffer'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.taquitoSapling = {}, global.BigNumber, global.taquito, global.utils, global.core, global.sapling, global.blake, global.nacl, null, global.saplingSpendParams, global.toBuffer));
-})(this, (function (exports, BigNumberJs, taquito, utils, core, saplingWasm, blake, nacl, saplingOutputParams_js, saplingSpendParams, toBuffer) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('bignumber.js'), require('@taquito/taquito'), require('@taquito/utils'), require('@taquito/core'), require('@taquito/sapling-wasm'), require('blakejs'), require('@stablelib/nacl'), require('typedarray-to-buffer')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'bignumber.js', '@taquito/taquito', '@taquito/utils', '@taquito/core', '@taquito/sapling-wasm', 'blakejs', '@stablelib/nacl', 'typedarray-to-buffer'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.taquitoSapling = {}, global.BigNumber, global.taquito, global.utils, global.core, global.sapling, global.blake, global.nacl, global.toBuffer));
+})(this, (function (exports, BigNumberJs, taquito, utils, core, saplingWasm, blake, nacl, toBuffer) { 'use strict';
 
     /******************************************************************************
     Copyright (c) Microsoft Corporation.
@@ -2964,17 +2964,193 @@
         }
     }
 
-    const loadSaplingOutputParams = () => {
-        const saplingOutputParams = globalThis.__taquitoVendoredParams
-            ?.saplingOutputParams;
-        if (!saplingOutputParams) {
-            throw new Error('Vendored sapling output params failed to load');
-        }
-        return saplingOutputParams;
+    var spendParams = {
+    	sha256: "8e48ffd23abb3a5fd9c5589204f32d9c31285a04b78096ba40a79b75677efc13",
+    	taquitoUrl: "https://sapling.taquito.io/params/groth16-mainnet-1/spend.params",
+    	zcashUrl: "https://download.z.cash/downloads/sapling-spend.params"
+    };
+    var outputParams = {
+    	sha256: "2f0ebbcbb9bb0bcffe95a397e7eba89c29eb4dde6191c339db88570e3f3fb0e4",
+    	taquitoUrl: "https://sapling.taquito.io/params/groth16-mainnet-1/output.params",
+    	zcashUrl: "https://download.z.cash/downloads/sapling-output.params"
+    };
+    var saplingParamsManifest = {
+    	spendParams: spendParams,
+    	outputParams: outputParams
     };
-    var saplingOutputParams = loadSaplingOutputParams();
 
-    let cachedParams;
+    const DEFAULT_SAPLING_PARAMS_MANIFEST = saplingParamsManifest;
+    class SaplingParamsError extends Error {
+        constructor(code, message, source, cause) {
+            super(message);
+            this.code = code;
+            this.source = source;
+            this.name = 'SaplingParamsError';
+            this.cause = cause;
+        }
+    }
+    let configuredSaplingParamsSource;
+    let frozenSaplingParamsSource;
+    let loadedSaplingParams;
+    let saplingParamsLoadPromise;
+    let saplingParamsInitPromise;
+    async function initSapling(options = {}) {
+        const nextSource = resolveSaplingParamsSource(options.params);
+        if (frozenSaplingParamsSource || saplingParamsLoadPromise || saplingParamsInitPromise) {
+            return;
+        }
+        configuredSaplingParamsSource = nextSource;
+    }
+    async function preloadSaplingParams() {
+        if (!saplingParamsInitPromise) {
+            saplingParamsInitPromise = initializeSaplingParams().catch((error) => {
+                saplingParamsInitPromise = undefined;
+                throw error;
+            });
+        }
+        return saplingParamsInitPromise;
+    }
+    async function initializeSaplingParams() {
+        const { spend, output } = await loadSaplingParams();
+        await saplingWasm.initParameters(spend, output);
+    }
+    async function loadSaplingParams() {
+        if (loadedSaplingParams) {
+            return loadedSaplingParams;
+        }
+        if (!saplingParamsLoadPromise) {
+            const source = frozenSaplingParamsSource ?? configuredSaplingParamsSource ?? resolveSaplingParamsSource();
+            saplingParamsLoadPromise = loadSaplingParamsFromSource(source)
+                .then((params) => {
+                frozenSaplingParamsSource = source;
+                loadedSaplingParams = params;
+                return params;
+            })
+                .catch((error) => {
+                saplingParamsLoadPromise = undefined;
+                throw error;
+            });
+        }
+        return saplingParamsLoadPromise;
+    }
+    async function loadSaplingParamsFromSource(source) {
+        if (source.kind === 'local') {
+            const [spend, output] = await Promise.all([
+                loadLocalParam(source.spend.path, source.spend.sha256, 'spend', source.source),
+                loadLocalParam(source.output.path, source.output.sha256, 'output', source.source),
+            ]);
+            return { spend, output };
+        }
+        const [spend, output] = await Promise.all([
+            loadRemoteParam(source.spend.url, source.spend.sha256, 'spend', source.source),
+            loadRemoteParam(source.output.url, source.output.sha256, 'output', source.source),
+        ]);
+        return { spend, output };
+    }
+    async function loadRemoteParam(url, expectedSha256, label, source) {
+        let response;
+        try {
+            response = await fetch(url);
+        }
+        catch (error) {
+            throw new SaplingParamsError('SAPLING_PARAMS_FETCH_FAILED', `Failed to fetch Sapling ${label} params from ${url}`, source, error);
+        }
+        if (!response.ok) {
+            throw new SaplingParamsError('SAPLING_PARAMS_FETCH_FAILED', `Failed to fetch Sapling ${label} params from ${url}: ${response.status}`, source);
+        }
+        const bytes = bufferExports.Buffer.from(await response.arrayBuffer());
+        await assertSha256(bytes, expectedSha256, label, source, url);
+        return bytes;
+    }
+    async function loadLocalParam(path, expectedSha256, label, source) {
+        if (!isNodeLikeRuntime()) {
+            throw new SaplingParamsError('SAPLING_PARAMS_UNSUPPORTED_RUNTIME', `Sapling local ${label} params are only supported in Node.js and CI environments`, source);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { readFile } = require(getNodeFsPromisesModuleId());
+        const bytes = bufferExports.Buffer.from(await readFile(path));
+        if (expectedSha256) {
+            await assertSha256(bytes, expectedSha256, label, source, path);
+        }
+        return bytes;
+    }
+    async function assertSha256(bytes, expectedSha256, label, source, location) {
+        const subtle = globalThis.crypto?.subtle;
+        if (!subtle) {
+            throw new SaplingParamsError('SAPLING_PARAMS_UNSUPPORTED_RUNTIME', `Sapling ${label} params verification requires globalThis.crypto.subtle`, source);
+        }
+        const digest = await subtle.digest('SHA-256', Uint8Array.from(bytes));
+        const actualSha256 = bufferExports.Buffer.from(digest).toString('hex');
+        if (actualSha256 !== expectedSha256) {
+            throw new SaplingParamsError('SAPLING_PARAMS_HASH_MISMATCH', `Sapling ${label} params from ${source} failed integrity verification for ${location} (expected SHA-256 ${expectedSha256}, got ${actualSha256})`, source);
+        }
+    }
+    function resolveSaplingParamsSource(params = undefined) {
+        if (!params || typeof params.source !== 'undefined') {
+            const source = params?.source ?? 'taquito';
+            return {
+                kind: 'remote',
+                source,
+                spend: {
+                    url: source === 'zcash'
+                        ? DEFAULT_SAPLING_PARAMS_MANIFEST.spendParams.zcashUrl
+                        : DEFAULT_SAPLING_PARAMS_MANIFEST.spendParams.taquitoUrl,
+                    sha256: DEFAULT_SAPLING_PARAMS_MANIFEST.spendParams.sha256,
+                },
+                output: {
+                    url: source === 'zcash'
+                        ? DEFAULT_SAPLING_PARAMS_MANIFEST.outputParams.zcashUrl
+                        : DEFAULT_SAPLING_PARAMS_MANIFEST.outputParams.taquitoUrl,
+                    sha256: DEFAULT_SAPLING_PARAMS_MANIFEST.outputParams.sha256,
+                },
+            };
+        }
+        if ('spendParamsPath' in params || 'outputParamsPath' in params) {
+            if (!params.spendParamsPath || !params.outputParamsPath) {
+                throw new SaplingParamsError('SAPLING_PARAMS_INVALID_CONFIG', 'Sapling local params configuration requires both spendParamsPath and outputParamsPath', 'local');
+            }
+            return {
+                kind: 'local',
+                source: 'local',
+                spend: {
+                    path: params.spendParamsPath,
+                    sha256: params.spendParamsSha256,
+                },
+                output: {
+                    path: params.outputParamsPath,
+                    sha256: params.outputParamsSha256,
+                },
+            };
+        }
+        if (!params.spendParamsUrl || !params.outputParamsUrl) {
+            throw new SaplingParamsError('SAPLING_PARAMS_INVALID_CONFIG', 'Sapling remote params configuration requires both spendParamsUrl and outputParamsUrl', 'custom');
+        }
+        if (!params.spendParamsSha256 || !params.outputParamsSha256) {
+            throw new SaplingParamsError('SAPLING_PARAMS_INVALID_CONFIG', 'Sapling remote params configuration requires explicit SHA-256 digests', 'custom');
+        }
+        return {
+            kind: 'remote',
+            source: 'custom',
+            spend: {
+                url: params.spendParamsUrl,
+                sha256: params.spendParamsSha256,
+            },
+            output: {
+                url: params.outputParamsUrl,
+                sha256: params.outputParamsSha256,
+            },
+        };
+    }
+    function isNodeLikeRuntime() {
+        const runtimeProcess = globalThis.process;
+        return !!runtimeProcess?.versions?.node;
+    }
+    function getNodeFsPromisesModuleId() {
+        // Keep this module id opaque enough that browser bundlers do not eagerly
+        // try to resolve a Node-only dependency into the browser build.
+        return ['node', 'fs', 'promises'].join(':').replace('fs:promises', 'fs/promises');
+    }
+
     const getRandomValueSource = () => {
         const crypto = globalThis.crypto;
         if (!crypto?.getRandomValues) {
@@ -2984,7 +3160,7 @@
     };
     class SaplingWrapper {
         async withProvingContext(action) {
-            await this.initSaplingParameters();
+            await preloadSaplingParams();
             return saplingWasm.withProvingContext(action);
         }
         getRandomBytes(length) {
@@ -3022,13 +3198,7 @@
             return saplingWasm.createBindingSignature(saplingContext, balance, transactionSigHash);
         }
         async initSaplingParameters() {
-            if (!cachedParams) {
-                cachedParams = {
-                    spend: bufferExports.Buffer.from(saplingSpendParams.saplingSpendParams, 'base64'),
-                    output: bufferExports.Buffer.from(saplingOutputParams.saplingOutputParams, 'base64'),
-                };
-            }
-            return saplingWasm.initParameters(cachedParams.spend, cachedParams.output);
+            return preloadSaplingParams();
         }
     }
 
@@ -4420,8 +4590,11 @@
     exports.InMemoryProvingKey = InMemoryProvingKey;
     exports.InMemorySpendingKey = InMemorySpendingKey;
     exports.InMemoryViewingKey = InMemoryViewingKey;
+    exports.SaplingParamsError = SaplingParamsError;
     exports.SaplingToolkit = SaplingToolkit;
     exports.SaplingTransactionViewer = SaplingTransactionViewer;
+    exports.initSapling = initSapling;
+    exports.preloadSaplingParams = preloadSaplingParams;
 
 }));
 //# sourceMappingURL=taquito-sapling.umd.js.map