@matrix-privacy/wallet 0.0.1

package/dist/services/ethers/ethers-util.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mnemonicTo0xPKey = void 0;
+const engine_1 = require("@matrix-privacy/engine");
+const mnemonicTo0xPKey = (mnemonic, derivationIndex) => {
+    return `0x${engine_1.Mnemonic.to0xPrivateKey(mnemonic, derivationIndex)}`;
+};
+exports.mnemonicTo0xPKey = mnemonicTo0xPKey;
+//# sourceMappingURL=ethers-util.js.map

package/dist/services/ethers/ethers-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethers-util.js","sourceRoot":"","sources":["../../../src/services/ethers/ethers-util.ts"],"names":[],"mappings":";;;AAAA,mDAAkD;AAE3C,MAAM,gBAAgB,GAAG,CAC9B,QAAgB,EAChB,eAAwB,EACxB,EAAE;IACF,OAAO,KAAK,iBAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,CAAC;AACnE,CAAC,CAAC;AALW,QAAA,gBAAgB,oBAK3B","sourcesContent":["import { Mnemonic } from '@matrix-privacy/engine';\n\nexport const mnemonicTo0xPKey = (\n  mnemonic: string,\n  derivationIndex?: number,\n) => {\n  return `0x${Mnemonic.to0xPrivateKey(mnemonic, derivationIndex)}`;\n};\n"]}

package/dist/services/ethers/index.d.ts

@@ -0,0 +1 @@
+export * from './ethers-util';

package/dist/services/ethers/index.js

@@ -0,0 +1,18 @@
+"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("./ethers-util"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/ethers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/ethers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B","sourcesContent":["export * from './ethers-util';\n"]}

package/dist/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from './artifacts';
+export * from './ethers';
+export * from './matrix';
+export * from './transactions';

package/dist/services/index.js

@@ -0,0 +1,21 @@
+"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("./artifacts"), exports);
+__exportStar(require("./ethers"), exports);
+__exportStar(require("./matrix"), exports);
+__exportStar(require("./transactions"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,2CAAyB;AACzB,2CAAyB;AACzB,iDAA+B","sourcesContent":["export * from './artifacts';\nexport * from './ethers';\nexport * from './matrix';\nexport * from './transactions';\n"]}

package/dist/services/matrix/core/__tests__/engine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/matrix/core/__tests__/engine.test.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = __importDefault(require("chai"));
+const chai_as_promised_1 = __importDefault(require("chai-as-promised"));
+const setup_test_1 = require("../../../../tests/setup.test");
+const engine_1 = require("../engine");
+const prover_1 = require("../prover");
+const init_1 = require("../init");
+chai_1.default.use(chai_as_promised_1.default);
+const { expect } = chai_1.default;
+describe('engine', () => {
+    beforeEach(async () => {
+        await (0, setup_test_1.initTestEngine)();
+    });
+    afterEach(async () => {
+        await (0, setup_test_1.closeTestEngine)();
+    });
+    it('Should get active engine instance', () => {
+        expect((0, engine_1.getEngine)()).to.not.be.undefined;
+    });
+    it('Should fail without active engine instance', async () => {
+        await (0, init_1.stopMatrixEngine)();
+        expect(() => (0, engine_1.getEngine)()).to.throw('Matrix Engine not yet initialized.');
+        expect(() => (0, prover_1.getProver)()).to.throw('Matrix Engine not yet initialized.');
+    });
+});
+//# sourceMappingURL=engine.test.js.map

package/dist/services/matrix/core/__tests__/engine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.test.js","sourceRoot":"","sources":["../../../../../src/services/matrix/core/__tests__/engine.test.ts"],"names":[],"mappings":";;;;;AAAA,gDAAwB;AACxB,wEAA8C;AAC9C,6DAA+E;AAC/E,sCAAsC;AACtC,sCAAsC;AACtC,kCAA2C;AAE3C,cAAI,CAAC,GAAG,CAAC,0BAAc,CAAC,CAAC;AACzB,MAAM,EAAE,MAAM,EAAE,GAAG,cAAI,CAAC;AAExB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,IAAA,2BAAc,GAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,IAAA,4BAAe,GAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,IAAA,kBAAS,GAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,IAAA,uBAAgB,GAAE,CAAC;QACzB,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kBAAS,GAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACzE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kBAAS,GAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import chai from 'chai';\nimport chaiAsPromised from 'chai-as-promised';\nimport { closeTestEngine, initTestEngine } from '../../../../tests/setup.test';\nimport { getEngine } from '../engine';\nimport { getProver } from '../prover';\nimport { stopMatrixEngine } from '../init';\n\nchai.use(chaiAsPromised);\nconst { expect } = chai;\n\ndescribe('engine', () => {\n  beforeEach(async () => {\n    await initTestEngine();\n  });\n  afterEach(async () => {\n    await closeTestEngine();\n  });\n\n  it('Should get active engine instance', () => {\n    expect(getEngine()).to.not.be.undefined;\n  });\n\n  it('Should fail without active engine instance', async () => {\n    await stopMatrixEngine();\n    expect(() => getEngine()).to.throw('Matrix Engine not yet initialized.');\n    expect(() => getProver()).to.throw('Matrix Engine not yet initialized.');\n  });\n});\n"]}

package/dist/services/matrix/core/__tests__/providers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/matrix/core/__tests__/providers.test.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = __importDefault(require("chai"));
+const chai_as_promised_1 = __importDefault(require("chai-as-promised"));
+const shared_models_1 = require("@matrix-privacy/shared-models");
+const mocks_test_1 = require("../../../../tests/mocks.test");
+const setup_test_1 = require("../../../../tests/setup.test");
+const providers_1 = require("../providers");
+const load_provider_1 = require("../load-provider");
+const wallets_1 = require("../../wallets/wallets");
+const merkletree_1 = require("../merkletree");
+const engine_1 = require("@matrix-privacy/engine");
+chai_1.default.use(chai_as_promised_1.default);
+const { expect } = chai_1.default;
+const MOCK_MNEMONIC_PROVIDERS_ONLY = 'pause crystal tornado alcohol genre cement fade large song like bag where';
+describe('providers', () => {
+    before(async () => {
+        await (0, setup_test_1.closeTestEngine)();
+        await (0, setup_test_1.initTestEngine)();
+    });
+    after(async () => {
+        await (0, setup_test_1.closeTestEngine)();
+    });
+    it('Should load provider with json, pull fees, and check created objects', async () => {
+        const response = await (0, load_provider_1.loadProvider)(mocks_test_1.MOCK_FALLBACK_PROVIDER_JSON_CONFIG_SEPOLIA, shared_models_1.NetworkName.Hardhat, 10000);
+        expect(response.feesSerialized).to.deep.equal({
+            shieldFee: '25',
+            unshieldFee: '25',
+        });
+        expect((0, providers_1.getFallbackProviderForNetwork)(shared_models_1.NetworkName.Hardhat)).to.not.be
+            .undefined;
+        expect((0, merkletree_1.getUTXOMerkletreeForNetwork)(shared_models_1.NetworkName.Hardhat))
+            .to.not.be.undefined;
+        const { chain } = shared_models_1.NETWORK_CONFIG[shared_models_1.NetworkName.Hardhat];
+        expect(engine_1.MatrixContracts.getShieldApprovalContract(chain)).to.not.be.undefined;
+        // Check that new wallet has merkletree.
+        const matrixWalletInfo = await (0, wallets_1.createMatrixWallet)(mocks_test_1.MOCK_DB_ENCRYPTION_KEY, MOCK_MNEMONIC_PROVIDERS_ONLY, undefined);
+        if (!(0, shared_models_1.isDefined)(matrixWalletInfo)) {
+            throw new Error('Expected matrixWalletInfo.');
+        }
+        const wallet = (0, wallets_1.walletForID)(matrixWalletInfo.id);
+        expect(wallet.getUTXOMerkletree(shared_models_1.NETWORK_CONFIG[shared_models_1.NetworkName.Hardhat].chain)).to.not.be.undefined;
+    }).timeout(15000);
+    it('Should fail with invalid chain ID', async () => {
+        await expect((0, load_provider_1.loadProvider)({ chainId: 55 }, shared_models_1.NetworkName.Hardhat, 10000)).rejectedWith('Invalid chain ID');
+    });
+    it('Should fail with invalid json', async () => {
+        await expect((0, load_provider_1.loadProvider)({ chainId: 31337 }, shared_models_1.NetworkName.Hardhat, 10000)).rejectedWith('Invalid fallback provider config');
+    });
+});
+//# sourceMappingURL=providers.test.js.map

package/dist/services/matrix/core/__tests__/providers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.test.js","sourceRoot":"","sources":["../../../../../src/services/matrix/core/__tests__/providers.test.ts"],"names":[],"mappings":";;;;;AAAA,gDAAwB;AACxB,wEAA8C;AAC9C,iEAKuC;AACvC,6DAGsC;AACtC,6DAA+E;AAC/E,4CAA6D;AAC7D,oDAAgD;AAChD,mDAAwE;AACxE,8CAEuB;AACvB,mDAEgC;AAEhC,cAAI,CAAC,GAAG,CAAC,0BAAc,CAAC,CAAC;AACzB,MAAM,EAAE,MAAM,EAAE,GAAG,cAAI,CAAC;AAExB,MAAM,4BAA4B,GAChC,2EAA2E,CAAC;AAE9E,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,MAAM,CAAC,KAAK,IAAI,EAAE;QAChB,MAAM,IAAA,4BAAe,GAAE,CAAC;QACxB,MAAM,IAAA,2BAAc,GAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,IAAA,4BAAe,GAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,QAAQ,GAAG,MAAM,IAAA,4BAAY,EACjC,uDAA0C,EAC1C,2BAAW,CAAC,OAAO,EACnB,KAAM,CACP,CAAC;QACF,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;YAC5C,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,MAAM,CAAC,IAAA,yCAA6B,EAAC,2BAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE;aACjE,SAAS,CAAC;QAEb,MAAM,CAAC,IAAA,wCAA2B,EAAC,2BAAW,CAAC,OAAO,CAAC,CAAC;aACrD,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC;QAEvB,MAAM,EAAE,KAAK,EAAE,GAAG,8BAAc,CAAC,2BAAW,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,CACJ,wBAAe,CAAC,yBAAyB,CACvC,KAAK,CACN,CACF,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC;QAEtB,wCAAwC;QACxC,MAAM,gBAAgB,GAAG,MAAM,IAAA,4BAAkB,EAC/C,mCAAsB,EACtB,4BAA4B,EAC5B,SAAS,CACV,CAAC;QACF,IAAI,CAAC,IAAA,yBAAS,EAAC,gBAAgB,CAAC,EAAE;YAChC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;SAC/C;QACD,MAAM,MAAM,GAAG,IAAA,qBAAW,EAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,CACJ,MAAM,CAAC,iBAAiB,CACtB,8BAAc,CAAC,2BAAW,CAAC,OAAO,CAAC,CAAC,KAAK,CAC1C,CACF,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC;IACxB,CAAC,CAAC,CAAC,OAAO,CAAC,KAAM,CAAC,CAAC;IAEnB,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,MAAM,CACV,IAAA,4BAAY,EACV,EAAE,OAAO,EAAE,EAAE,EAAgC,EAC7C,2BAAW,CAAC,OAAO,EACnB,KAAK,CACN,CACF,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,MAAM,CACV,IAAA,4BAAY,EACV,EAAE,OAAO,EAAE,KAAK,EAAgC,EAChD,2BAAW,CAAC,OAAO,EACnB,KAAK,CACN,CACF,CAAC,YAAY,CAAC,kCAAkC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import chai from 'chai';\nimport chaiAsPromised from 'chai-as-promised';\nimport {\n  NetworkName,\n  FallbackProviderJsonConfig,\n  isDefined,\n  NETWORK_CONFIG,\n} from '@matrix-privacy/shared-models';\nimport {\n  MOCK_DB_ENCRYPTION_KEY,\n  MOCK_FALLBACK_PROVIDER_JSON_CONFIG_SEPOLIA,\n} from '../../../../tests/mocks.test';\nimport { closeTestEngine, initTestEngine } from '../../../../tests/setup.test';\nimport { getFallbackProviderForNetwork } from '../providers';\nimport { loadProvider } from '../load-provider';\nimport { createMatrixWallet, walletForID } from '../../wallets/wallets';\nimport {\n  getUTXOMerkletreeForNetwork,\n} from '../merkletree';\nimport {\n  MatrixContracts,\n} from '@matrix-privacy/engine';\n\nchai.use(chaiAsPromised);\nconst { expect } = chai;\n\nconst MOCK_MNEMONIC_PROVIDERS_ONLY =\n  'pause crystal tornado alcohol genre cement fade large song like bag where';\n\ndescribe('providers', () => {\n  before(async () => {\n    await closeTestEngine();\n    await initTestEngine();\n  });\n  after(async () => {\n    await closeTestEngine();\n  });\n\n  it('Should load provider with json, pull fees, and check created objects', async () => {\n    const response = await loadProvider(\n      MOCK_FALLBACK_PROVIDER_JSON_CONFIG_SEPOLIA,\n      NetworkName.Hardhat,\n      10_000, // pollingInterval\n    );\n    expect(response.feesSerialized).to.deep.equal({\n      shieldFee: '25',\n      unshieldFee: '25',\n    });\n\n    expect(getFallbackProviderForNetwork(NetworkName.Hardhat)).to.not.be\n      .undefined;\n\n    expect(getUTXOMerkletreeForNetwork(NetworkName.Hardhat))\n      .to.not.be.undefined;\n\n    const { chain } = NETWORK_CONFIG[NetworkName.Hardhat];\n    expect(\n      MatrixContracts.getShieldApprovalContract(\n        chain,\n      ),\n    ).to.not.be.undefined;\n\n    // Check that new wallet has merkletree.\n    const matrixWalletInfo = await createMatrixWallet(\n      MOCK_DB_ENCRYPTION_KEY,\n      MOCK_MNEMONIC_PROVIDERS_ONLY,\n      undefined, // creationBlockNumbers\n    );\n    if (!isDefined(matrixWalletInfo)) {\n      throw new Error('Expected matrixWalletInfo.');\n    }\n    const wallet = walletForID(matrixWalletInfo.id);\n    expect(\n      wallet.getUTXOMerkletree(\n        NETWORK_CONFIG[NetworkName.Hardhat].chain,\n      ),\n    ).to.not.be.undefined;\n  }).timeout(15_000);\n\n  it('Should fail with invalid chain ID', async () => {\n    await expect(\n      loadProvider(\n        { chainId: 55 } as FallbackProviderJsonConfig,\n        NetworkName.Hardhat,\n        10000, // pollingInterval\n      ),\n    ).rejectedWith('Invalid chain ID');\n  });\n\n  it('Should fail with invalid json', async () => {\n    await expect(\n      loadProvider(\n        { chainId: 31337 } as FallbackProviderJsonConfig,\n        NetworkName.Hardhat,\n        10000, // pollingInterval\n      ),\n    ).rejectedWith('Invalid fallback provider config');\n  });\n});\n"]}

package/dist/services/matrix/core/artifacts.d.ts

@@ -0,0 +1,10 @@
+import { ArtifactGetter, PublicInputsMatrix } from '@matrix-privacy/engine';
+import { Artifact } from '@matrix-privacy/shared-models';
+import { ArtifactStore } from '../../artifacts/artifact-store';
+export declare const artifactCache: MapType<Artifact>;
+export declare const setArtifactStore: (store: ArtifactStore) => void;
+export declare const setUseNativeArtifacts: (useNative: boolean) => void;
+export declare const getArtifacts: (inputs: PublicInputsMatrix) => Promise<Artifact>;
+export declare const artifactGetterDownloadJustInTime: ArtifactGetter;
+export declare const overrideArtifact: (artifactVariant: string, artifact: Artifact) => void;
+export declare const clearArtifactCache: () => void;

package/dist/services/matrix/core/artifacts.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearArtifactCache = exports.overrideArtifact = exports.artifactGetterDownloadJustInTime = exports.getArtifacts = exports.setUseNativeArtifacts = exports.setArtifactStore = exports.artifactCache = void 0;
+const shared_models_1 = require("@matrix-privacy/shared-models");
+const artifact_downloader_1 = require("../../artifacts/artifact-downloader");
+const artifact_util_1 = require("../../artifacts/artifact-util");
+let artifactStore;
+let useNativeArtifacts;
+exports.artifactCache = {};
+const setArtifactStore = (store) => {
+    artifactStore = store;
+};
+exports.setArtifactStore = setArtifactStore;
+const setUseNativeArtifacts = (useNative) => {
+    useNativeArtifacts = useNative;
+};
+exports.setUseNativeArtifacts = setUseNativeArtifacts;
+const getArtifacts = async (inputs) => {
+    const nullifiers = inputs.nullifiers.length;
+    const commitments = inputs.commitmentsOut.length;
+    (0, shared_models_1.assertArtifactExists)(nullifiers, commitments);
+    if (useNativeArtifacts) {
+        if (commitments > 3) {
+            // native-prover-small only has INPUTS (1-10) and OUTPUTS (1-3)
+            throw new Error(`Native artifacts (small) only support up to 3 circuit outputs. Cannot get artifacts for circuit: ${nullifiers}x${commitments}.`);
+        }
+    }
+    const artifactVariantString = (0, artifact_util_1.getArtifactVariantString)(nullifiers, commitments);
+    return downloadAndCacheArtifact(artifactVariantString);
+};
+exports.getArtifacts = getArtifacts;
+const downloadAndCacheArtifact = async (artifactVariantString) => {
+    // Use artifact in cache if available.
+    const cachedArtifact = exports.artifactCache[artifactVariantString];
+    if ((0, shared_models_1.isDefined)(cachedArtifact)) {
+        return cachedArtifact;
+    }
+    const downloader = new artifact_downloader_1.ArtifactDownloader(artifactStore, useNativeArtifacts);
+    // Try to pull previously downloaded from storage.
+    try {
+        const downloadedArtifacts = await downloader.getDownloadedArtifacts(artifactVariantString);
+        exports.artifactCache[artifactVariantString] = downloadedArtifacts;
+        return downloadedArtifacts;
+    }
+    catch (err) {
+        // No op. Artifacts not yet downloaded.
+    }
+    // Download anew. Throws upon error.
+    await downloader.downloadArtifacts(artifactVariantString);
+    const downloadedArtifacts = await downloader.getDownloadedArtifacts(artifactVariantString);
+    exports.artifactCache[artifactVariantString] = downloadedArtifacts;
+    return downloadedArtifacts;
+};
+exports.artifactGetterDownloadJustInTime = {
+    assertArtifactExists: shared_models_1.assertArtifactExists,
+    getArtifacts: exports.getArtifacts,
+};
+const overrideArtifact = (artifactVariant, artifact) => {
+    exports.artifactCache[artifactVariant] = artifact;
+};
+exports.overrideArtifact = overrideArtifact;
+const clearArtifactCache = () => {
+    for (const key in exports.artifactCache) {
+        if ((0, shared_models_1.isDefined)(exports.artifactCache[key])) {
+            delete exports.artifactCache[key];
+        }
+    }
+};
+exports.clearArtifactCache = clearArtifactCache;
+//# sourceMappingURL=artifacts.js.map

package/dist/services/matrix/core/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../../../src/services/matrix/core/artifacts.ts"],"names":[],"mappings":";;;AACA,iEAIuC;AACvC,6EAAyE;AAEzE,iEAEuC;AAEvC,IAAI,aAA4B,CAAC;AACjC,IAAI,kBAA2B,CAAC;AAEnB,QAAA,aAAa,GAAsB,EAAE,CAAC;AAE5C,MAAM,gBAAgB,GAAG,CAAC,KAAoB,EAAE,EAAE;IACvD,aAAa,GAAG,KAAK,CAAC;AACxB,CAAC,CAAC;AAFW,QAAA,gBAAgB,oBAE3B;AACK,MAAM,qBAAqB,GAAG,CAAC,SAAkB,EAAE,EAAE;IAC1D,kBAAkB,GAAG,SAAS,CAAC;AACjC,CAAC,CAAC;AAFW,QAAA,qBAAqB,yBAEhC;AAEK,MAAM,YAAY,GAAG,KAAK,EAC/B,MAA0B,EACP,EAAE;IACrB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;IAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC;IACjD,IAAA,oCAAoB,EAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAE9C,IAAI,kBAAkB,EAAE;QACtB,IAAI,WAAW,GAAG,CAAC,EAAE;YACnB,+DAA+D;YAC/D,MAAM,IAAI,KAAK,CACb,oGAAoG,UAAU,IAAI,WAAW,GAAG,CACjI,CAAC;SACH;KACF;IAED,MAAM,qBAAqB,GAAG,IAAA,wCAAwB,EACpD,UAAU,EACV,WAAW,CACZ,CAAC;IAEF,OAAO,wBAAwB,CAAC,qBAAqB,CAAC,CAAC;AACzD,CAAC,CAAC;AAtBW,QAAA,YAAY,gBAsBvB;AAEF,MAAM,wBAAwB,GAAG,KAAK,EACpC,qBAA6B,EACV,EAAE;IACrB,sCAAsC;IACtC,MAAM,cAAc,GAAG,qBAAa,CAAC,qBAAqB,CAAC,CAAC;IAC5D,IAAI,IAAA,yBAAS,EAAC,cAAc,CAAC,EAAE;QAC7B,OAAO,cAAc,CAAC;KACvB;IAED,MAAM,UAAU,GAAG,IAAI,wCAAkB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;IAE7E,kDAAkD;IAClD,IAAI;QACF,MAAM,mBAAmB,GAAG,MAAM,UAAU,CAAC,sBAAsB,CACjE,qBAAqB,CACtB,CAAC;QACF,qBAAa,CAAC,qBAAqB,CAAC,GAAG,mBAAmB,CAAC;QAC3D,OAAO,mBAAmB,CAAC;KAC5B;IAAC,OAAO,GAAG,EAAE;QACZ,uCAAuC;KACxC;IAED,oCAAoC;IACpC,MAAM,UAAU,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;IAC1D,MAAM,mBAAmB,GAAG,MAAM,UAAU,CAAC,sBAAsB,CACjE,qBAAqB,CACtB,CAAC;IACF,qBAAa,CAAC,qBAAqB,CAAC,GAAG,mBAAmB,CAAC;IAC3D,OAAO,mBAAmB,CAAC;AAC7B,CAAC,CAAC;AAEW,QAAA,gCAAgC,GAAmB;IAC9D,oBAAoB,EAApB,oCAAoB;IACpB,YAAY,EAAZ,oBAAY;CACb,CAAC;AAEK,MAAM,gBAAgB,GAAG,CAC9B,eAAuB,EACvB,QAAkB,EAClB,EAAE;IACF,qBAAa,CAAC,eAAe,CAAC,GAAG,QAAQ,CAAC;AAC5C,CAAC,CAAC;AALW,QAAA,gBAAgB,oBAK3B;AAEK,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,KAAK,MAAM,GAAG,IAAI,qBAAa,EAAE;QAC/B,IAAI,IAAA,yBAAS,EAAC,qBAAa,CAAC,GAAG,CAAC,CAAC,EAAE;YACjC,OAAO,qBAAa,CAAC,GAAG,CAAC,CAAC;SAC3B;KACF;AACH,CAAC,CAAC;AANW,QAAA,kBAAkB,sBAM7B","sourcesContent":["import { ArtifactGetter, PublicInputsMatrix } from '@matrix-privacy/engine';\nimport {\n  Artifact,\n  assertArtifactExists,\n  isDefined,\n} from '@matrix-privacy/shared-models';\nimport { ArtifactDownloader } from '../../artifacts/artifact-downloader';\nimport { ArtifactStore } from '../../artifacts/artifact-store';\nimport {\n  getArtifactVariantString,\n} from '../../artifacts/artifact-util';\n\nlet artifactStore: ArtifactStore;\nlet useNativeArtifacts: boolean;\n\nexport const artifactCache: MapType<Artifact> = {};\n\nexport const setArtifactStore = (store: ArtifactStore) => {\n  artifactStore = store;\n};\nexport const setUseNativeArtifacts = (useNative: boolean) => {\n  useNativeArtifacts = useNative;\n};\n\nexport const getArtifacts = async (\n  inputs: PublicInputsMatrix,\n): Promise<Artifact> => {\n  const nullifiers = inputs.nullifiers.length;\n  const commitments = inputs.commitmentsOut.length;\n  assertArtifactExists(nullifiers, commitments);\n\n  if (useNativeArtifacts) {\n    if (commitments > 3) {\n      // native-prover-small only has INPUTS (1-10) and OUTPUTS (1-3)\n      throw new Error(\n        `Native artifacts (small) only support up to 3 circuit outputs. Cannot get artifacts for circuit: ${nullifiers}x${commitments}.`,\n      );\n    }\n  }\n\n  const artifactVariantString = getArtifactVariantString(\n    nullifiers,\n    commitments,\n  );\n\n  return downloadAndCacheArtifact(artifactVariantString);\n};\n\nconst downloadAndCacheArtifact = async (\n  artifactVariantString: string,\n): Promise<Artifact> => {\n  // Use artifact in cache if available.\n  const cachedArtifact = artifactCache[artifactVariantString];\n  if (isDefined(cachedArtifact)) {\n    return cachedArtifact;\n  }\n\n  const downloader = new ArtifactDownloader(artifactStore, useNativeArtifacts);\n\n  // Try to pull previously downloaded from storage.\n  try {\n    const downloadedArtifacts = await downloader.getDownloadedArtifacts(\n      artifactVariantString,\n    );\n    artifactCache[artifactVariantString] = downloadedArtifacts;\n    return downloadedArtifacts;\n  } catch (err) {\n    // No op. Artifacts not yet downloaded.\n  }\n\n  // Download anew. Throws upon error.\n  await downloader.downloadArtifacts(artifactVariantString);\n  const downloadedArtifacts = await downloader.getDownloadedArtifacts(\n    artifactVariantString,\n  );\n  artifactCache[artifactVariantString] = downloadedArtifacts;\n  return downloadedArtifacts;\n};\n\nexport const artifactGetterDownloadJustInTime: ArtifactGetter = {\n  assertArtifactExists,\n  getArtifacts,\n};\n\nexport const overrideArtifact = (\n  artifactVariant: string,\n  artifact: Artifact,\n) => {\n  artifactCache[artifactVariant] = artifact;\n};\n\nexport const clearArtifactCache = () => {\n  for (const key in artifactCache) {\n    if (isDefined(artifactCache[key])) {\n      delete artifactCache[key];\n    }\n  }\n};\n"]}

package/dist/services/matrix/core/engine.d.ts

@@ -0,0 +1,4 @@
+import { MatrixEngine } from '@matrix-privacy/engine';
+export declare const getEngine: () => MatrixEngine;
+export declare const hasEngine: () => boolean;
+export declare const setEngine: (engine: Optional<MatrixEngine>) => void;

package/dist/services/matrix/core/engine.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEngine = exports.hasEngine = exports.getEngine = void 0;
+const shared_models_1 = require("@matrix-privacy/shared-models");
+let savedEngine;
+const getEngine = () => {
+    if (!savedEngine) {
+        throw new Error('Matrix Engine not yet initialized.');
+    }
+    return savedEngine;
+};
+exports.getEngine = getEngine;
+const hasEngine = () => {
+    return (0, shared_models_1.isDefined)(savedEngine);
+};
+exports.hasEngine = hasEngine;
+const setEngine = (engine) => {
+    savedEngine = engine;
+};
+exports.setEngine = setEngine;
+//# sourceMappingURL=engine.js.map

package/dist/services/matrix/core/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../../src/services/matrix/core/engine.ts"],"names":[],"mappings":";;;AACA,iEAA0D;AAE1D,IAAI,WAAmC,CAAC;AAEjC,MAAM,SAAS,GAAG,GAAiB,EAAE;IAC1C,IAAI,CAAC,WAAW,EAAE;QAChB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;KACvD;IACD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AALW,QAAA,SAAS,aAKpB;AAEK,MAAM,SAAS,GAAG,GAAY,EAAE;IACrC,OAAO,IAAA,yBAAS,EAAC,WAAW,CAAC,CAAC;AAChC,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB;AAEK,MAAM,SAAS,GAAG,CAAC,MAA8B,EAAE,EAAE;IAC1D,WAAW,GAAG,MAAM,CAAC;AACvB,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB","sourcesContent":["import { MatrixEngine } from '@matrix-privacy/engine';\nimport { isDefined } from '@matrix-privacy/shared-models';\n\nlet savedEngine: Optional<MatrixEngine>;\n\nexport const getEngine = (): MatrixEngine => {\n  if (!savedEngine) {\n    throw new Error('Matrix Engine not yet initialized.');\n  }\n  return savedEngine;\n};\n\nexport const hasEngine = (): boolean => {\n  return isDefined(savedEngine);\n};\n\nexport const setEngine = (engine: Optional<MatrixEngine>) => {\n  savedEngine = engine;\n};\n"]}

package/dist/services/matrix/core/index.d.ts

@@ -0,0 +1,8 @@
+export * from './artifacts';
+export * from './init';
+export * from './engine';
+export * from './load-provider';
+export * from './merkletree';
+export * from './prover';
+export * from './providers';
+export * from './shields';

package/dist/services/matrix/core/index.js

@@ -0,0 +1,25 @@
+"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("./artifacts"), exports);
+__exportStar(require("./init"), exports);
+__exportStar(require("./engine"), exports);
+__exportStar(require("./load-provider"), exports);
+__exportStar(require("./merkletree"), exports);
+__exportStar(require("./prover"), exports);
+__exportStar(require("./providers"), exports);
+__exportStar(require("./shields"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/matrix/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/matrix/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,yCAAuB;AACvB,2CAAyB;AACzB,kDAAgC;AAChC,+CAA6B;AAC7B,2CAAyB;AACzB,8CAA4B;AAC5B,4CAA0B","sourcesContent":["export * from './artifacts';\nexport * from './init';\nexport * from './engine';\nexport * from './load-provider';\nexport * from './merkletree';\nexport * from './prover';\nexport * from './providers';\nexport * from './shields';\n"]}

package/dist/services/matrix/core/init.d.ts

@@ -0,0 +1,21 @@
+import type { AbstractLevelDOWN } from 'abstract-leveldown';
+import { MerkletreeScanUpdateEvent } from '@matrix-privacy/shared-models';
+import { ArtifactStore } from '../../artifacts/artifact-store';
+export type EngineDebugger = {
+    log: (msg: string) => void;
+    error: (error: Error) => void;
+    verboseScanLogging: boolean;
+};
+export declare const setOnUTXOMerkletreeScanCallback: (onUTXOMerkletreeScanCallback: (scanData: MerkletreeScanUpdateEvent) => void) => void;
+/**
+ *
+ * @param walletSource - Name for your wallet implementation. Encrypted and viewable in private transaction history. Maximum of 16 characters, lowercase.
+ * @param db - LevelDOWN compatible database for storing encrypted wallets.
+ * @param shouldDebug - Whether to forward Engine debug logs to Logger.
+ * @param artifactStore - Persistent store for downloading large artifact files. See Wallet SDK Developer Guide for platform implementations.
+ * @param useNativeArtifacts - Whether to download native C++ or web-assembly artifacts. TRUE for mobile. FALSE for nodejs and browser.
+ * @param skipMerkletreeScans - Whether to skip merkletree syncs and private balance scans. Only set to TRUE in shield-only applications that don't load private wallets or balances.
+ * @returns
+ */
+export declare const startMatrixEngine: (walletSource: string, db: AbstractLevelDOWN, shouldDebug: boolean, artifactStore: ArtifactStore, useNativeArtifacts: boolean, skipMerkletreeScans: boolean, verboseScanLogging?: boolean) => Promise<void>;
+export declare const stopMatrixEngine: () => Promise<void>;

package/dist/services/matrix/core/init.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stopMatrixEngine = exports.startMatrixEngine = exports.setOnUTXOMerkletreeScanCallback = void 0;
+const engine_1 = require("@matrix-privacy/engine");
+const shared_models_1 = require("@matrix-privacy/shared-models");
+const logger_1 = require("../../../utils/logger");
+const artifacts_1 = require("./artifacts");
+const error_1 = require("../../../utils/error");
+const quick_sync_events_1 = require("../quick-sync/quick-sync-events");
+const engine_2 = require("./engine");
+const balance_update_1 = require("../wallets/balance-update");
+const createEngineDebugger = (verboseScanLogging) => {
+    return {
+        log: (msg) => (0, logger_1.sendMessage)(msg),
+        error: (error) => (0, logger_1.sendErrorMessage)(error),
+        verboseScanLogging,
+    };
+};
+const setOnUTXOMerkletreeScanCallback = (onUTXOMerkletreeScanCallback) => {
+    const engine = (0, engine_2.getEngine)();
+    engine.on(engine_1.EngineEvent.UTXOMerkletreeHistoryScanUpdate, ({ chain, scanStatus, progress }) => onUTXOMerkletreeScanCallback({
+        scanStatus,
+        chain,
+        progress: progress ?? 0.0,
+    }));
+};
+exports.setOnUTXOMerkletreeScanCallback = setOnUTXOMerkletreeScanCallback;
+const setOnUTXOScanDecryptBalancesCompleteListener = () => {
+    const engine = (0, engine_2.getEngine)();
+    engine.on(engine_1.EngineEvent.UTXOScanDecryptBalancesComplete, ({ chain, walletIdFilter, }) => {
+        const updateWalletBalances = async () => {
+            let walletsToUpdate = Object.values(engine.wallets);
+            if ((0, shared_models_1.isDefined)(walletIdFilter)) {
+                walletsToUpdate = walletsToUpdate.filter(wallet => walletIdFilter.includes(wallet.id));
+            }
+            // await onBalancesUpdate calls for each wallet
+            await Promise.all(walletsToUpdate.map(wallet => (0, balance_update_1.onBalancesUpdate)(wallet, chain)));
+            // emit event to notify listeners that UTXOMerkletreeHistoryScan is complete
+            engine.emitScanEventHistoryComplete(chain);
+        };
+        // eslint-disable-next-line @typescript-eslint/no-floating-promises
+        updateWalletBalances();
+    });
+};
+/**
+ *
+ * @param walletSource - Name for your wallet implementation. Encrypted and viewable in private transaction history. Maximum of 16 characters, lowercase.
+ * @param db - LevelDOWN compatible database for storing encrypted wallets.
+ * @param shouldDebug - Whether to forward Engine debug logs to Logger.
+ * @param artifactStore - Persistent store for downloading large artifact files. See Wallet SDK Developer Guide for platform implementations.
+ * @param useNativeArtifacts - Whether to download native C++ or web-assembly artifacts. TRUE for mobile. FALSE for nodejs and browser.
+ * @param skipMerkletreeScans - Whether to skip merkletree syncs and private balance scans. Only set to TRUE in shield-only applications that don't load private wallets or balances.
+ * @returns
+ */
+const startMatrixEngine = async (walletSource, db, shouldDebug, artifactStore, useNativeArtifacts, skipMerkletreeScans, verboseScanLogging = false) => {
+    if ((0, engine_2.hasEngine)()) {
+        return;
+    }
+    try {
+        (0, artifacts_1.setArtifactStore)(artifactStore);
+        (0, artifacts_1.setUseNativeArtifacts)(useNativeArtifacts);
+        const engine = await engine_1.MatrixEngine.init(walletSource, db, artifacts_1.artifactGetterDownloadJustInTime, quick_sync_events_1.quickSyncEventsGraph, shouldDebug ? createEngineDebugger(verboseScanLogging) : undefined, skipMerkletreeScans);
+        (0, engine_2.setEngine)(engine);
+        setOnUTXOScanDecryptBalancesCompleteListener();
+    }
+    catch (err) {
+        throw (0, error_1.reportAndSanitizeError)(exports.startMatrixEngine.name, err);
+    }
+};
+exports.startMatrixEngine = startMatrixEngine;
+const stopMatrixEngine = async () => {
+    if (!(0, engine_2.hasEngine)()) {
+        return;
+    }
+    await (0, engine_2.getEngine)()?.unload();
+    (0, engine_2.setEngine)(undefined);
+};
+exports.stopMatrixEngine = stopMatrixEngine;
+//# sourceMappingURL=init.js.map

package/dist/services/matrix/core/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../src/services/matrix/core/init.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AbstractLevelDOWN } from 'abstract-leveldown';\nimport {\n  MatrixEngine,\n  EngineEvent,\n  MerkletreeHistoryScanEventData,\n  UTXOScanDecryptBalancesCompleteEventData,\n  AbstractWallet,\n} from '@matrix-privacy/engine';\nimport {\n  MerkletreeScanUpdateEvent,\n  isDefined,\n} from '@matrix-privacy/shared-models';\nimport { sendErrorMessage, sendMessage } from '../../../utils/logger';\nimport {\n  artifactGetterDownloadJustInTime,\n  setArtifactStore,\n  setUseNativeArtifacts,\n} from './artifacts';\nimport { ArtifactStore } from '../../artifacts/artifact-store';\nimport { reportAndSanitizeError } from '../../../utils/error';\nimport { quickSyncEventsGraph } from '../quick-sync/quick-sync-events';\nimport { setEngine, getEngine, hasEngine } from './engine';\nimport { onBalancesUpdate } from '../wallets/balance-update';\n\nexport type EngineDebugger = {\n  log: (msg: string) => void;\n  error: (error: Error) => void;\n  verboseScanLogging: boolean;\n};\n\nconst createEngineDebugger = (verboseScanLogging: boolean): EngineDebugger => {\n  return {\n    log: (msg: string) => sendMessage(msg),\n    error: (error: Error) => sendErrorMessage(error),\n    verboseScanLogging,\n  };\n};\n\nexport const setOnUTXOMerkletreeScanCallback = (\n  onUTXOMerkletreeScanCallback: (scanData: MerkletreeScanUpdateEvent) => void,\n) => {\n  const engine = getEngine();\n  engine.on(\n    EngineEvent.UTXOMerkletreeHistoryScanUpdate,\n    ({ chain, scanStatus, progress }: MerkletreeHistoryScanEventData) =>\n      onUTXOMerkletreeScanCallback({\n        scanStatus,\n        chain,\n        progress: progress ?? 0.0,\n      }),\n  );\n};\n\nconst setOnUTXOScanDecryptBalancesCompleteListener = () => {\n  const engine = getEngine();\n  engine.on(\n    EngineEvent.UTXOScanDecryptBalancesComplete,\n    ({\n      chain,\n      walletIdFilter,\n    }: UTXOScanDecryptBalancesCompleteEventData) => {\n      const updateWalletBalances = async () => {\n        let walletsToUpdate: AbstractWallet[] = Object.values(engine.wallets);\n        if (isDefined(walletIdFilter)) {\n          walletsToUpdate = walletsToUpdate.filter(wallet =>\n            walletIdFilter.includes(wallet.id),\n          );\n        }\n\n        // await onBalancesUpdate calls for each wallet\n        await Promise.all(\n          walletsToUpdate.map(wallet =>\n            onBalancesUpdate(wallet, chain),\n          ),\n        );\n\n        // emit event to notify listeners that UTXOMerkletreeHistoryScan is complete\n        engine.emitScanEventHistoryComplete(chain);\n      };\n\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      updateWalletBalances();\n    },\n  );\n};\n\n/**\n *\n * @param walletSource - Name for your wallet implementation. Encrypted and viewable in private transaction history. Maximum of 16 characters, lowercase.\n * @param db - LevelDOWN compatible database for storing encrypted wallets.\n * @param shouldDebug - Whether to forward Engine debug logs to Logger.\n * @param artifactStore - Persistent store for downloading large artifact files. See Wallet SDK Developer Guide for platform implementations.\n * @param useNativeArtifacts - Whether to download native C++ or web-assembly artifacts. TRUE for mobile. FALSE for nodejs and browser.\n * @param skipMerkletreeScans - Whether to skip merkletree syncs and private balance scans. Only set to TRUE in shield-only applications that don't load private wallets or balances.\n * @returns\n */\nexport const startMatrixEngine = async (\n  walletSource: string,\n  db: AbstractLevelDOWN,\n  shouldDebug: boolean,\n  artifactStore: ArtifactStore,\n  useNativeArtifacts: boolean,\n  skipMerkletreeScans: boolean,\n  verboseScanLogging = false,\n): Promise<void> => {\n  if (hasEngine()) {\n    return;\n  }\n  try {\n    setArtifactStore(artifactStore);\n    setUseNativeArtifacts(useNativeArtifacts);\n\n    const engine = await MatrixEngine.init(\n      walletSource,\n      db,\n      artifactGetterDownloadJustInTime,\n      quickSyncEventsGraph,\n      shouldDebug ? createEngineDebugger(verboseScanLogging) : undefined,\n      skipMerkletreeScans,\n    );\n    setEngine(engine);\n\n    setOnUTXOScanDecryptBalancesCompleteListener();\n  } catch (err) {\n    throw reportAndSanitizeError(startMatrixEngine.name, err);\n  }\n};\n\nexport const stopMatrixEngine = async () => {\n  if (!hasEngine()) {\n    return;\n  }\n  await getEngine()?.unload();\n  setEngine(undefined);\n};\n"]}

package/dist/services/matrix/core/load-provider.d.ts

@@ -0,0 +1,9 @@
+import { FallbackProviderJsonConfig, LoadProviderResponse, NetworkName } from '@matrix-privacy/shared-models';
+/**
+ * Note: The first provider listed in your fallback provider config is used as a polling provider
+ * for new Matrix events (balance updates).
+ */
+export declare const loadProvider: (fallbackProviderJsonConfig: FallbackProviderJsonConfig, networkName: NetworkName, pollingInterval?: number) => Promise<LoadProviderResponse>;
+export declare const unloadProvider: (networkName: NetworkName) => Promise<void>;
+export declare const pauseAllPollingProviders: (excludeNetworkName?: NetworkName) => void;
+export declare const resumeIsolatedPollingProviderForNetwork: (networkName: NetworkName) => void;

package/dist/services/matrix/core/load-provider.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resumeIsolatedPollingProviderForNetwork = exports.pauseAllPollingProviders = exports.unloadProvider = exports.loadProvider = void 0;
+const shared_models_1 = require("@matrix-privacy/shared-models");
+const utils_1 = require("../../../utils");
+const error_1 = require("../../../utils/error");
+const engine_1 = require("./engine");
+const engine_2 = require("@matrix-privacy/engine");
+const providers_1 = require("./providers");
+const createFallbackProviderForNetwork = async (networkName, fallbackProviderJsonConfig) => {
+    const existingProvider = providers_1.fallbackProviderMap[networkName];
+    if (existingProvider) {
+        return existingProvider;
+    }
+    const fallbackProvider = (0, shared_models_1.createFallbackProviderFromJsonConfig)(fallbackProviderJsonConfig);
+    (0, providers_1.setFallbackProviderForNetwork)(networkName, fallbackProvider);
+    return fallbackProvider;
+};
+const createPollingProviderForNetwork = async (networkName, fallbackProvider, pollingInterval) => {
+    const existingProvider = providers_1.pollingProviderMap[networkName];
+    if (existingProvider) {
+        return existingProvider;
+    }
+    const network = shared_models_1.NETWORK_CONFIG[networkName];
+    if (!(0, shared_models_1.isDefined)(network)) {
+        throw new Error('No network found');
+    }
+    const pollingProvider = await (0, engine_2.createPollingJsonRpcProviderForListeners)(fallbackProvider, network.chain.id, pollingInterval);
+    (0, providers_1.setPollingProviderForNetwork)(networkName, pollingProvider);
+    return pollingProvider;
+};
+const loadProviderForNetwork = async (chain, networkName, fallbackProviderJsonConfig, pollingInterval) => {
+    (0, utils_1.sendMessage)(`Load provider for network: ${networkName}`);
+    const fallbackProvider = await createFallbackProviderForNetwork(networkName, fallbackProviderJsonConfig);
+    const pollingProvider = await createPollingProviderForNetwork(networkName, fallbackProvider, pollingInterval);
+    const network = shared_models_1.NETWORK_CONFIG[networkName];
+    const { relayAdaptContract, accumulatorContract, verifierContract, tokenVaultContract, deploymentBlock: networkDeploymentBlock, publicName, } = network;
+    if (!relayAdaptContract) {
+        throw new Error(`Could not find Relay Adapt contract for network: ${publicName}`);
+    }
+    const engine = (0, engine_1.getEngine)();
+    const deploymentBlock = networkDeploymentBlock ?? 0;
+    // This function will set up the contracts for this chain.
+    // Throws if provider does not respond.
+    await engine.loadNetwork(chain, accumulatorContract, verifierContract, tokenVaultContract, relayAdaptContract, fallbackProvider, pollingProvider, deploymentBlock);
+};
+/**
+ * Note: The first provider listed in your fallback provider config is used as a polling provider
+ * for new Matrix events (balance updates).
+ */
+const loadProvider = async (fallbackProviderJsonConfig, networkName, pollingInterval = 15000) => {
+    try {
+        delete providers_1.fallbackProviderMap[networkName];
+        const { chain } = shared_models_1.NETWORK_CONFIG[networkName];
+        if (fallbackProviderJsonConfig.chainId !== chain.id) {
+            throw new Error('Invalid chain ID');
+        }
+        await loadProviderForNetwork(chain, networkName, fallbackProviderJsonConfig, pollingInterval);
+        const { shield, unshield } = await engine_2.MatrixContracts.fees(chain);
+        // Note: Shield and Unshield fees are in basis points.
+        const feesSerialized = {
+            shieldFee: shield.toString(),
+            unshieldFee: unshield.toString(),
+        };
+        return { feesSerialized };
+    }
+    catch (err) {
+        throw (0, error_1.reportAndSanitizeError)(exports.loadProvider.name, err);
+    }
+};
+exports.loadProvider = loadProvider;
+const unloadProvider = async (networkName) => {
+    await providers_1.fallbackProviderMap[networkName]?.destroy();
+    providers_1.pollingProviderMap[networkName]?.destroy();
+    delete providers_1.fallbackProviderMap[networkName];
+    delete providers_1.pollingProviderMap[networkName];
+};
+exports.unloadProvider = unloadProvider;
+const pauseAllPollingProviders = (excludeNetworkName) => {
+    Object.keys(providers_1.pollingProviderMap).forEach(networkName => {
+        if (networkName === excludeNetworkName) {
+            return;
+        }
+        const pollingProvider = providers_1.pollingProviderMap[networkName];
+        if ((0, shared_models_1.isDefined)(pollingProvider) && !pollingProvider.paused) {
+            pollingProvider.pause();
+        }
+    });
+};
+exports.pauseAllPollingProviders = pauseAllPollingProviders;
+const resumeIsolatedPollingProviderForNetwork = (networkName) => {
+    (0, exports.pauseAllPollingProviders)(networkName);
+    const pollingProviderForNetwork = providers_1.pollingProviderMap[networkName];
+    if ((0, shared_models_1.isDefined)(pollingProviderForNetwork) &&
+        pollingProviderForNetwork.paused) {
+        pollingProviderForNetwork.resume();
+    }
+};
+exports.resumeIsolatedPollingProviderForNetwork = resumeIsolatedPollingProviderForNetwork;
+//# sourceMappingURL=load-provider.js.map

package/dist/services/matrix/core/load-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-provider.js","sourceRoot":"","sources":["../../../../src/services/matrix/core/load-provider.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Chain,\n  FallbackProviderJsonConfig,\n  LoadProviderResponse,\n  NETWORK_CONFIG,\n  NetworkName,\n  createFallbackProviderFromJsonConfig,\n  isDefined,\n} from '@matrix-privacy/shared-models';\nimport { sendMessage } from '../../../utils';\nimport { reportAndSanitizeError } from '../../../utils/error';\nimport { getEngine } from './engine';\nimport {\n  PollingJsonRpcProvider,\n  MatrixContracts,\n  createPollingJsonRpcProviderForListeners,\n} from '@matrix-privacy/engine';\nimport type { FallbackProvider } from 'ethers';\nimport {\n  fallbackProviderMap,\n  pollingProviderMap,\n  setFallbackProviderForNetwork,\n  setPollingProviderForNetwork,\n} from './providers';\n\nconst createFallbackProviderForNetwork = async (\n  networkName: NetworkName,\n  fallbackProviderJsonConfig: FallbackProviderJsonConfig,\n): Promise<FallbackProvider> => {\n  const existingProvider = fallbackProviderMap[networkName];\n  if (existingProvider) {\n    return existingProvider;\n  }\n  const fallbackProvider = createFallbackProviderFromJsonConfig(\n    fallbackProviderJsonConfig,\n  );\n  setFallbackProviderForNetwork(networkName, fallbackProvider);\n  return fallbackProvider;\n};\n\nconst createPollingProviderForNetwork = async (\n  networkName: NetworkName,\n  fallbackProvider: FallbackProvider,\n  pollingInterval: number,\n): Promise<PollingJsonRpcProvider> => {\n  const existingProvider = pollingProviderMap[networkName];\n  if (existingProvider) {\n    return existingProvider;\n  }\n  const network = NETWORK_CONFIG[networkName];\n  if (!isDefined(network)) {\n    throw new Error('No network found');\n  }\n  const pollingProvider = await createPollingJsonRpcProviderForListeners(\n    fallbackProvider,\n    network.chain.id,\n    pollingInterval,\n  );\n  setPollingProviderForNetwork(networkName, pollingProvider);\n  return pollingProvider;\n};\n\nconst loadProviderForNetwork = async (\n  chain: Chain,\n  networkName: NetworkName,\n  fallbackProviderJsonConfig: FallbackProviderJsonConfig,\n  pollingInterval: number,\n) => {\n  sendMessage(`Load provider for network: ${networkName}`);\n\n  const fallbackProvider = await createFallbackProviderForNetwork(\n    networkName,\n    fallbackProviderJsonConfig,\n  );\n  const pollingProvider = await createPollingProviderForNetwork(\n    networkName,\n    fallbackProvider,\n    pollingInterval\n  );\n\n  const network = NETWORK_CONFIG[networkName];\n  const {\n    relayAdaptContract,\n    accumulatorContract,\n    verifierContract,\n    tokenVaultContract,\n    deploymentBlock: networkDeploymentBlock,\n    publicName,\n  } = network;\n  if (!relayAdaptContract) {\n    throw new Error(\n      `Could not find Relay Adapt contract for network: ${publicName}`,\n    );\n  }\n\n  const engine = getEngine();\n\n  const deploymentBlock = networkDeploymentBlock ?? 0;\n\n  // This function will set up the contracts for this chain.\n  // Throws if provider does not respond.\n  await engine.loadNetwork(\n    chain,\n    accumulatorContract,\n    verifierContract,\n    tokenVaultContract,\n    relayAdaptContract,\n    fallbackProvider,\n    pollingProvider,\n    deploymentBlock,\n  );\n};\n\n/**\n * Note: The first provider listed in your fallback provider config is used as a polling provider\n * for new Matrix events (balance updates).\n */\nexport const loadProvider = async (\n  fallbackProviderJsonConfig: FallbackProviderJsonConfig,\n  networkName: NetworkName,\n  pollingInterval = 15000,\n): Promise<LoadProviderResponse> => {\n  try {\n    delete fallbackProviderMap[networkName];\n\n    const { chain } = NETWORK_CONFIG[networkName];\n    if (fallbackProviderJsonConfig.chainId !== chain.id) {\n      throw new Error('Invalid chain ID');\n    }\n\n    await loadProviderForNetwork(\n      chain,\n      networkName,\n      fallbackProviderJsonConfig,\n      pollingInterval,\n    );\n\n    const { shield, unshield } = await MatrixContracts.fees(chain);\n\n    // Note: Shield and Unshield fees are in basis points.\n    const feesSerialized = {\n      shieldFee: shield.toString(),\n      unshieldFee: unshield.toString(),\n    };\n    return { feesSerialized };\n  } catch (err) {\n    throw reportAndSanitizeError(loadProvider.name, err);\n  }\n};\n\nexport const unloadProvider = async (\n  networkName: NetworkName,\n): Promise<void> => {\n  await fallbackProviderMap[networkName]?.destroy();\n  pollingProviderMap[networkName]?.destroy();\n  delete fallbackProviderMap[networkName];\n  delete pollingProviderMap[networkName];\n};\n\nexport const pauseAllPollingProviders = (\n  excludeNetworkName?: NetworkName,\n): void => {\n  Object.keys(pollingProviderMap).forEach(networkName => {\n    if (networkName === excludeNetworkName) {\n      return;\n    }\n    const pollingProvider = pollingProviderMap[networkName];\n    if (isDefined(pollingProvider) && !pollingProvider.paused) {\n      pollingProvider.pause();\n    }\n  });\n};\n\nexport const resumeIsolatedPollingProviderForNetwork = (\n  networkName: NetworkName,\n): void => {\n  pauseAllPollingProviders(\n    networkName, // excludeNetworkName\n  );\n  const pollingProviderForNetwork = pollingProviderMap[networkName];\n  if (\n    isDefined(pollingProviderForNetwork) &&\n    pollingProviderForNetwork.paused\n  ) {\n    pollingProviderForNetwork.resume();\n  }\n};\n"]}

package/dist/services/matrix/core/merkletree.d.ts

@@ -0,0 +1,5 @@
+import { NetworkName } from '@matrix-privacy/shared-models';
+import { NFTTokenData, TXO, TokenData } from '@matrix-privacy/engine';
+export declare const getUTXOMerkletreeForNetwork: (networkName: NetworkName) => import("@matrix-privacy/engine/dist/merkletree/utxo-merkletree").UTXOMerkletree;
+export declare const getSpendableUTXOsForToken: (networkName: NetworkName, walletID: string, tokenData: TokenData) => Promise<Optional<TXO[]>>;
+export declare const getMerkleProofForERC721: (networkName: NetworkName, walletID: string, nftTokenData: NFTTokenData) => Promise<import("@matrix-privacy/engine").MerkleProof>;