@bsv/wallet-toolbox 1.1.0

package/out/src/storage/methods/purgeData.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.purgeData = purgeData;
+const sdk_1 = require("@bsv/sdk");
+const index_client_1 = require("../../index.client");
+async function purgeData(storage, params, trx) {
+    const r = { count: 0, log: '' };
+    const defaultAge = 1000 * 60 * 60 * 24 * 14;
+    const runPurgeQuery = async (pq) => {
+        try {
+            pq.sql = pq.q.toString();
+            const count = await pq.q;
+            if (count > 0) {
+                r.count += count;
+                r.log += `${count} ${pq.log}\n`;
+            }
+        }
+        catch (eu) {
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const e = index_client_1.sdk.WalletError.fromUnknown(eu);
+            throw eu;
+        }
+    };
+    if (params.purgeCompleted) {
+        const age = params.purgeCompletedAge || defaultAge;
+        const before = toSqlWhereDate(new Date(Date.now() - age));
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const qs = [];
+        // select * from transactions where updated_at < '2024-08-20' and status = 'completed' and not provenTxId is null and (not truncatedExternalInputs is null or not beef is null or not rawTx is null)
+        qs.push({
+            log: 'conpleted transactions purged of transient data',
+            q: storage
+                .toDb(trx)('transactions')
+                .update({
+                inputBEEF: null,
+                rawTx: null
+            })
+                .where('updated_at', '<', before)
+                .where('status', 'completed')
+                .whereNotNull('provenTxId')
+                .where(function () {
+                this.orWhereNotNull('inputBEEF');
+                this.orWhereNotNull('rawTx');
+            })
+        });
+        const completedReqs = await storage
+            .toDb(trx)('proven_tx_reqs')
+            .select('provenTxReqId')
+            .where('updated_at', '<', before)
+            .where('status', 'completed')
+            .whereNotNull('provenTxId')
+            .where('notified', 1);
+        const completedReqIds = completedReqs.map(o => o.provenTxReqId);
+        if (completedReqIds.length > 0) {
+            qs.push({
+                log: 'completed proven_tx_reqs deleted',
+                q: storage
+                    .toDb(trx)('proven_tx_reqs')
+                    .whereIn('provenTxReqId', completedReqIds)
+                    .delete()
+            });
+        }
+        for (const q of qs)
+            await runPurgeQuery(q);
+    }
+    if (params.purgeFailed) {
+        const age = params.purgeFailedAge || defaultAge;
+        const before = toSqlWhereDate(new Date(Date.now() - age));
+        const qs = [];
+        const failedTxsQ = storage
+            .toDb(trx)('transactions')
+            .select('transactionId')
+            .where('updated_at', '<', before)
+            .where('status', 'failed');
+        const txs = await failedTxsQ;
+        const failedTxIds = txs.map(tx => tx.transactionId);
+        await deleteTransactions(failedTxIds, qs, 'failed', true);
+        const invalidReqs = await storage
+            .toDb(trx)('proven_tx_reqs')
+            .select('provenTxReqId')
+            .where('updated_at', '<', before)
+            .where('status', 'invalid');
+        const invalidReqIds = invalidReqs.map(o => o.provenTxReqId);
+        if (invalidReqIds.length > 0)
+            qs.push({
+                log: 'invalid proven_tx_reqs deleted',
+                q: storage
+                    .toDb(trx)('proven_tx_reqs')
+                    .whereIn('provenTxReqId', invalidReqIds)
+                    .delete()
+            });
+        const doubleSpendReqs = await storage
+            .toDb(trx)('proven_tx_reqs')
+            .select('provenTxReqId')
+            .where('updated_at', '<', before)
+            .where('status', 'doubleSpend');
+        const doubleSpendReqIds = doubleSpendReqs.map(o => o.provenTxReqId);
+        if (doubleSpendReqIds.length > 0)
+            qs.push({
+                log: 'doubleSpend proven_tx_reqs deleted',
+                q: storage
+                    .toDb(trx)('proven_tx_reqs')
+                    .whereIn('provenTxReqId', doubleSpendReqIds)
+                    .delete()
+            });
+        for (const q of qs)
+            await runPurgeQuery(q);
+    }
+    if (params.purgeSpent) {
+        const age = params.purgeSpentAge || defaultAge;
+        const before = toSqlWhereDate(new Date(Date.now() - age));
+        const beef = new sdk_1.Beef();
+        const utxos = await storage.findOutputs({
+            partial: { spendable: true },
+            txStatus: ['sending', 'unproven', 'completed', 'nosend']
+        });
+        for (const utxo of utxos) {
+            // Figure out all the txids required to prove the validity of this utxo and merge proofs into beef.
+            const options = {
+                mergeToBeef: beef,
+                ignoreServices: true
+            };
+            if (utxo.txid)
+                await storage.getBeefForTransaction(utxo.txid, options);
+        }
+        const proofTxids = {};
+        for (const btx of beef.txs)
+            proofTxids[btx.txid] = true;
+        let qs = [];
+        const spentTxsQ = storage
+            .toDb(trx)('transactions')
+            .where('updated_at', '<', before)
+            .where('status', 'completed')
+            .whereRaw(`not exists(select outputId from outputs as o where o.transactionId = transactions.transactionId and o.spendable = 1)`);
+        const txs = await spentTxsQ;
+        // Save any spent txid still needed to prove a utxo:
+        const nptxs = txs.filter(t => !proofTxids[t.txid || '']);
+        let spentTxIds = nptxs.map(tx => tx.transactionId);
+        if (spentTxIds.length > 0) {
+            const update = { spentBy: undefined };
+            qs.push({
+                log: 'spent outputs no longer tracked by spentBy',
+                q: storage
+                    .toDb(trx)('outputs')
+                    .update(storage.validatePartialForUpdate(update, undefined, ['spendable']))
+                    .where('spendable', false)
+                    .whereIn('spentBy', spentTxIds)
+            });
+            await deleteTransactions(spentTxIds, qs, 'spent', false);
+            for (const q of qs)
+                await runPurgeQuery(q);
+        }
+    }
+    // Delete proven_txs no longer referenced by remaining transactions.
+    const qs = [];
+    qs.push({
+        log: 'orphan proven_txs deleted',
+        q: storage
+            .toDb(trx)('proven_txs')
+            .whereRaw(`not exists(select * from transactions as t where t.txid = proven_txs.txid or t.provenTxId = proven_txs.provenTxId)`)
+            .whereRaw(`not exists(select * from proven_tx_reqs as r where r.txid = proven_txs.txid or r.provenTxId = proven_txs.provenTxId)`)
+            .delete()
+    });
+    for (const q of qs)
+        await runPurgeQuery(q);
+    return r;
+    async function deleteTransactions(transactionIds, qs, reason, markNotSpentBy) {
+        if (transactionIds.length > 0) {
+            const outputs = await storage
+                .toDb(trx)('outputs')
+                .select('outputId')
+                .whereIn('transactionId', transactionIds);
+            const outputIds = outputs.map(o => o.outputId);
+            if (outputIds.length > 0) {
+                qs.push({
+                    log: `${reason} output_tags_map deleted`,
+                    q: storage
+                        .toDb(trx)('output_tags_map')
+                        .whereIn('outputId', outputIds)
+                        .delete()
+                });
+                qs.push({
+                    log: `${reason} outputs deleted`,
+                    q: storage
+                        .toDb(trx)('outputs')
+                        .whereIn('outputId', outputIds)
+                        .delete()
+                });
+            }
+            qs.push({
+                log: `${reason} tx_labels_map deleted`,
+                q: storage
+                    .toDb(trx)('tx_labels_map')
+                    .whereIn('transactionId', transactionIds)
+                    .delete()
+            });
+            qs.push({
+                log: `${reason} commissions deleted`,
+                q: storage
+                    .toDb(trx)('commissions')
+                    .whereIn('transactionId', transactionIds)
+                    .delete()
+            });
+            if (markNotSpentBy) {
+                qs.push({
+                    log: 'unspent outputs updated to spendable',
+                    q: storage
+                        .toDb(trx)('outputs')
+                        .update({ spendable: true, spentBy: undefined })
+                        .whereIn('spentBy', transactionIds)
+                });
+            }
+            qs.push({
+                log: `${reason} transactions deleted`,
+                q: storage
+                    .toDb(trx)('transactions')
+                    .whereIn('transactionId', transactionIds)
+                    .delete()
+            });
+        }
+    }
+}
+function toSqlWhereDate(d) {
+    let s = d.toISOString();
+    s = s.replace('T', ' ');
+    s = s.replace('Z', '');
+    return s;
+}
+//# sourceMappingURL=purgeData.js.map

package/out/src/storage/methods/purgeData.js.map

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

package/out/src/storage/methods/reviewStatus.d.ts

@@ -0,0 +1,9 @@
+import { sdk } from '../../index.client';
+import { StorageKnex } from '../StorageKnex';
+export declare function reviewStatus(storage: StorageKnex, args: {
+    agedLimit: Date;
+    trx?: sdk.TrxToken;
+}): Promise<{
+    log: string;
+}>;
+//# sourceMappingURL=reviewStatus.d.ts.map

package/out/src/storage/methods/reviewStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewStatus.d.ts","sourceRoot":"","sources":["../../../../src/storage/methods/reviewStatus.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAA;CAAE,GAC5C,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA+E1B"}

package/out/src/storage/methods/reviewStatus.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reviewStatus = reviewStatus;
+const index_client_1 = require("../../index.client");
+async function reviewStatus(storage, args) {
+    const r = { log: '' };
+    const runReviewStatusQuery = async (pq) => {
+        try {
+            pq.sql = pq.q.toString();
+            const count = await pq.q;
+            if (count > 0) {
+                r.log += `${count} ${pq.log}\n`;
+            }
+        }
+        catch (eu) {
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const e = index_client_1.sdk.WalletError.fromUnknown(eu);
+            throw eu;
+        }
+    };
+    const k = storage.toDb(args.trx);
+    const qs = [];
+    qs.push({
+        log: `transactions updated to status of 'failed' where provenTxReq with matching txid is 'invalid'`,
+        /*
+            UPDATE transactions SET status = 'failed'
+            WHERE exists(select 1 from proven_tx_reqs as r where transactions.txid = r.txid and r.status = 'invalid')
+            */
+        q: k('transactions')
+            .update({ status: 'failed' })
+            .whereNot({ status: 'failed' })
+            .whereExists(function () {
+            this.select(k.raw(1))
+                .from('proven_tx_reqs as r')
+                .whereRaw(`transactions.txid = r.txid and r.status = 'invalid'`);
+        })
+    });
+    qs.push({
+        log: `outputs updated to spendable where spentBy is a transaction with status 'failed'`,
+        /*
+            UPDATE outputs SET spentBy = null, spendable = 1
+            where exists(select 1 from transactions as t where outputs.spentBy = t.transactionId and t.status = 'failed')
+            */
+        q: k('outputs')
+            .update({ spentBy: undefined, spendable: true })
+            .whereExists(function () {
+            this.select(k.raw(1))
+                .from('transactions as t')
+                .whereRaw(`outputs.spentBy = t.transactionId and t.status = 'failed'`);
+        })
+    });
+    qs.push({
+        log: `transactions updated with provenTxId and status of 'completed' where provenTx with matching txid exists`,
+        /*
+            UPDATE transactions SET status = 'completed', provenTxId = p.provenTxId
+            FROM proven_txs p
+            WHERE transactions.txid = p.txid AND transactions.provenTxId IS NULL
+            */
+        q: k('transactions')
+            .update({
+            status: 'completed',
+            provenTxId: k.raw('(SELECT provenTxId FROM proven_txs AS p WHERE transactions.txid = p.txid)')
+        })
+            .whereNull('provenTxId')
+            .whereExists(function () {
+            this.select(k.raw(1))
+                .from('proven_txs as p')
+                .whereRaw('transactions.txid = p.txid');
+        })
+    });
+    for (const q of qs)
+        await runReviewStatusQuery(q);
+    return r;
+}
+//# sourceMappingURL=reviewStatus.js.map

package/out/src/storage/methods/reviewStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewStatus.js","sourceRoot":"","sources":["../../../../src/storage/methods/reviewStatus.ts"],"names":[],"mappings":";;AAMA,oCAkFC;AArFD,qDAAwC;AAGjC,KAAK,UAAU,YAAY,CAChC,OAAoB,EACpB,IAA6C;IAE7C,MAAM,CAAC,GAAoB,EAAE,GAAG,EAAE,EAAE,EAAE,CAAA;IAEtC,MAAM,oBAAoB,GAAG,KAAK,EAChC,EAAqB,EACN,EAAE;QACjB,IAAI,CAAC;YACH,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;YACxB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC,CAAA;YACxB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;YACjC,CAAC;QACH,CAAC;QAAC,OAAO,EAAW,EAAE,CAAC;YACrB,6DAA6D;YAC7D,MAAM,CAAC,GAAG,kBAAG,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;YACzC,MAAM,EAAE,CAAA;QACV,CAAC;IACH,CAAC,CAAA;IAED,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEhC,MAAM,EAAE,GAAwB,EAAE,CAAA;IAElC,EAAE,CAAC,IAAI,CAAC;QACN,GAAG,EAAE,8FAA8F;QACnG;;;cAGM;QACN,CAAC,EAAE,CAAC,CAAoB,cAAc,CAAC;aACpC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;aAC5B,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;aAC9B,WAAW,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBAClB,IAAI,CAAC,qBAAqB,CAAC;iBAC3B,QAAQ,CAAC,qDAAqD,CAAC,CAAA;QACpE,CAAC,CAAC;KACL,CAAC,CAAA;IAEF,EAAE,CAAC,IAAI,CAAC;QACN,GAAG,EAAE,kFAAkF;QACvF;;;cAGM;QACN,CAAC,EAAE,CAAC,CAAe,SAAS,CAAC;aAC1B,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;aAC/C,WAAW,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBAClB,IAAI,CAAC,mBAAmB,CAAC;iBACzB,QAAQ,CAAC,2DAA2D,CAAC,CAAA;QAC1E,CAAC,CAAC;KACL,CAAC,CAAA;IAEF,EAAE,CAAC,IAAI,CAAC;QACN,GAAG,EAAE,yGAAyG;QAC9G;;;;cAIM;QACN,CAAC,EAAE,CAAC,CAAoB,cAAc,CAAC;aACpC,MAAM,CAAC;YACN,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,CAAC,CAAC,GAAG,CACf,2EAA2E,CAC5E;SACF,CAAC;aACD,SAAS,CAAC,YAAY,CAAC;aACvB,WAAW,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBAClB,IAAI,CAAC,iBAAiB,CAAC;iBACvB,QAAQ,CAAC,4BAA4B,CAAC,CAAA;QAC3C,CAAC,CAAC;KACL,CAAC,CAAA;IAEF,KAAK,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,oBAAoB,CAAC,CAAC,CAAC,CAAA;IAEjD,OAAO,CAAC,CAAA;AACV,CAAC"}

package/out/src/storage/remoting/StorageClient.d.ts

@@ -0,0 +1,56 @@
+/**
+ * StorageClient.ts
+ *
+ * A client-side "remoted" WalletStorage that fulfills the WalletStorage interface
+ * by sending JSON-RPC calls to a configured remote WalletStorageServer.
+ */
+import { AbortActionArgs, AbortActionResult, InternalizeActionArgs, InternalizeActionResult, ListActionsResult, ListCertificatesResult, ListOutputsResult, RelinquishCertificateArgs, RelinquishOutputArgs, WalletInterface } from '@bsv/sdk';
+import { sdk, table } from '../../index.client';
+export declare class StorageClient implements sdk.WalletStorageProvider {
+    private endpointUrl;
+    private nextId;
+    private authClient;
+    settings?: table.Settings;
+    constructor(wallet: WalletInterface, endpointUrl: string);
+    isStorageProvider(): boolean;
+    /**
+     * Make a JSON-RPC call to the remote server.
+     * @param method The WalletStorage method name to call.
+     * @param params The array of parameters to pass to the method in order.
+     */
+    private rpcCall;
+    isAvailable(): boolean;
+    getSettings(): table.Settings;
+    makeAvailable(): Promise<table.Settings>;
+    destroy(): Promise<void>;
+    migrate(storageName: string, storageIdentityKey: string): Promise<string>;
+    getServices(): sdk.WalletServices;
+    setServices(v: sdk.WalletServices): void;
+    internalizeAction(auth: sdk.AuthId, args: InternalizeActionArgs): Promise<InternalizeActionResult>;
+    createAction(auth: sdk.AuthId, args: sdk.ValidCreateActionArgs): Promise<sdk.StorageCreateActionResult>;
+    processAction(auth: sdk.AuthId, args: sdk.StorageProcessActionArgs): Promise<sdk.StorageProcessActionResults>;
+    abortAction(auth: sdk.AuthId, args: AbortActionArgs): Promise<AbortActionResult>;
+    findOrInsertUser(identityKey: any): Promise<{
+        user: table.User;
+        isNew: boolean;
+    }>;
+    findOrInsertSyncStateAuth(auth: sdk.AuthId, storageIdentityKey: string, storageName: string): Promise<{
+        syncState: table.SyncState;
+        isNew: boolean;
+    }>;
+    insertCertificateAuth(auth: sdk.AuthId, certificate: table.CertificateX): Promise<number>;
+    listActions(auth: sdk.AuthId, vargs: sdk.ValidListActionsArgs): Promise<ListActionsResult>;
+    listOutputs(auth: sdk.AuthId, vargs: sdk.ValidListOutputsArgs): Promise<ListOutputsResult>;
+    listCertificates(auth: sdk.AuthId, vargs: sdk.ValidListCertificatesArgs): Promise<ListCertificatesResult>;
+    findCertificatesAuth(auth: sdk.AuthId, args: sdk.FindCertificatesArgs): Promise<table.Certificate[]>;
+    findOutputBasketsAuth(auth: sdk.AuthId, args: sdk.FindOutputBasketsArgs): Promise<table.OutputBasket[]>;
+    findOutputsAuth(auth: sdk.AuthId, args: sdk.FindOutputsArgs): Promise<table.Output[]>;
+    findProvenTxReqs(args: sdk.FindProvenTxReqsArgs): Promise<table.ProvenTxReq[]>;
+    relinquishCertificate(auth: sdk.AuthId, args: RelinquishCertificateArgs): Promise<number>;
+    relinquishOutput(auth: sdk.AuthId, args: RelinquishOutputArgs): Promise<number>;
+    processSyncChunk(args: sdk.RequestSyncChunkArgs, chunk: sdk.SyncChunk): Promise<sdk.ProcessSyncChunkResult>;
+    getSyncChunk(args: sdk.RequestSyncChunkArgs): Promise<sdk.SyncChunk>;
+    updateProvenTxReqWithNewProvenTx(args: sdk.UpdateProvenTxReqWithNewProvenTxArgs): Promise<sdk.UpdateProvenTxReqWithNewProvenTxResult>;
+    setActive(auth: sdk.AuthId, newActiveStorageIdentityKey: string): Promise<number>;
+}
+//# sourceMappingURL=StorageClient.d.ts.map

package/out/src/storage/remoting/StorageClient.d.ts.map

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

package/out/src/storage/remoting/StorageClient.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * StorageClient.ts
+ *
+ * A client-side "remoted" WalletStorage that fulfills the WalletStorage interface
+ * by sending JSON-RPC calls to a configured remote WalletStorageServer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageClient = void 0;
+const index_client_1 = require("../../index.client");
+const sdk_1 = require("@bsv/sdk");
+class StorageClient {
+    constructor(wallet, endpointUrl) {
+        this.nextId = 1;
+        this.authClient = new sdk_1.AuthFetch(wallet);
+        this.endpointUrl = endpointUrl;
+    }
+    isStorageProvider() {
+        return false;
+    }
+    //////////////////////////////////////////////////////////////////////////////
+    // JSON-RPC helper
+    //////////////////////////////////////////////////////////////////////////////
+    /**
+     * Make a JSON-RPC call to the remote server.
+     * @param method The WalletStorage method name to call.
+     * @param params The array of parameters to pass to the method in order.
+     */
+    async rpcCall(method, params) {
+        const id = this.nextId++;
+        const body = {
+            jsonrpc: '2.0',
+            method,
+            params,
+            id
+        };
+        const response = await this.authClient.fetch(this.endpointUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body)
+        });
+        if (!response.ok) {
+            throw new Error(`WalletStorageClient rpcCall: network error ${response.status} ${response.statusText}`);
+        }
+        const json = await response.json();
+        if (json.error) {
+            const { code, message, data } = json.error;
+            const err = new Error(`RPC Error: ${message}`);
+            err.code = code;
+            err.data = data;
+            throw err;
+        }
+        return json.result;
+    }
+    //////////////////////////////////////////////////////////////////////////////
+    // In a real environment, you might do lazy or real "makeAvailable" logic
+    // For demonstration, we assume that the remote store might return its "settings"
+    // and we store them locally in `this.settings`.
+    //////////////////////////////////////////////////////////////////////////////
+    isAvailable() {
+        // We'll just say "yes" if we have settings
+        return !!this.settings;
+    }
+    getSettings() {
+        if (!this.settings) {
+            throw new index_client_1.sdk.WERR_INVALID_OPERATION('call makeAvailable at least once before getSettings');
+        }
+        return this.settings;
+    }
+    async makeAvailable() {
+        if (!this.settings) {
+            this.settings = await this.rpcCall('makeAvailable', []);
+        }
+        return this.settings;
+    }
+    //////////////////////////////////////////////////////////////////////////////
+    //
+    // Implementation of all WalletStorage interface methods
+    // They are simple pass-thrus to rpcCall
+    //
+    // IMPORTANT: The parameter ordering must match exactly as in your interface.
+    //////////////////////////////////////////////////////////////////////////////
+    async destroy() {
+        return this.rpcCall('destroy', []);
+    }
+    async migrate(storageName, storageIdentityKey) {
+        return this.rpcCall('migrate', [storageName]);
+    }
+    getServices() {
+        // Typically, the client would not store or retrieve "Services" from a remote server.
+        // The "services" in local in-memory usage is a no-op or your own approach:
+        throw new Error('getServices() not implemented in remote client. This method typically is not used remotely.');
+    }
+    setServices(v) {
+        // Typically no-op for remote client
+        // Because "services" are usually local definitions to the Storage.
+    }
+    async internalizeAction(auth, args) {
+        return this.rpcCall('internalizeAction', [
+            auth,
+            args
+        ]);
+    }
+    async createAction(auth, args) {
+        return this.rpcCall('createAction', [
+            auth,
+            args
+        ]);
+    }
+    async processAction(auth, args) {
+        return this.rpcCall('processAction', [
+            auth,
+            args
+        ]);
+    }
+    async abortAction(auth, args) {
+        return this.rpcCall('abortAction', [auth, args]);
+    }
+    async findOrInsertUser(identityKey) {
+        return this.rpcCall('findOrInsertUser', [identityKey]);
+    }
+    async findOrInsertSyncStateAuth(auth, storageIdentityKey, storageName) {
+        return this.rpcCall('findOrInsertSyncStateAuth', [auth, storageIdentityKey, storageName]);
+    }
+    async insertCertificateAuth(auth, certificate) {
+        return this.rpcCall('insertCertificateAuth', [auth, certificate]);
+    }
+    async listActions(auth, vargs) {
+        return this.rpcCall('listActions', [auth, vargs]);
+    }
+    async listOutputs(auth, vargs) {
+        return this.rpcCall('listOutputs', [auth, vargs]);
+    }
+    async listCertificates(auth, vargs) {
+        return this.rpcCall('listCertificates', [
+            auth,
+            vargs
+        ]);
+    }
+    async findCertificatesAuth(auth, args) {
+        return this.rpcCall('findCertificatesAuth', [
+            auth,
+            args
+        ]);
+    }
+    async findOutputBasketsAuth(auth, args) {
+        return this.rpcCall('findOutputBaskets', [auth, args]);
+    }
+    async findOutputsAuth(auth, args) {
+        return this.rpcCall('findOutputsAuth', [auth, args]);
+    }
+    findProvenTxReqs(args) {
+        return this.rpcCall('findProvenTxReqs', [args]);
+    }
+    async relinquishCertificate(auth, args) {
+        return this.rpcCall('relinquishCertificate', [auth, args]);
+    }
+    async relinquishOutput(auth, args) {
+        return this.rpcCall('relinquishOutput', [auth, args]);
+    }
+    async processSyncChunk(args, chunk) {
+        return this.rpcCall('processSyncChunk', [
+            args,
+            chunk
+        ]);
+    }
+    async getSyncChunk(args) {
+        return this.rpcCall('getSyncChunk', [args]);
+    }
+    async updateProvenTxReqWithNewProvenTx(args) {
+        return this.rpcCall('updateProvenTxReqWithNewProvenTx', [args]);
+    }
+    async setActive(auth, newActiveStorageIdentityKey) {
+        return this.rpcCall('setActive', [
+            auth,
+            newActiveStorageIdentityKey
+        ]);
+    }
+}
+exports.StorageClient = StorageClient;
+//# sourceMappingURL=StorageClient.js.map

package/out/src/storage/remoting/StorageClient.js.map

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

package/out/src/storage/remoting/StorageServer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * StorageServer.ts
+ *
+ * A server-side class that "has a" local WalletStorage (like a StorageKnex instance),
+ * and exposes it via a JSON-RPC POST endpoint using Express.
+ */
+import { Request } from 'express';
+import { Wallet, StorageProvider } from '../../index.all';
+export interface WalletStorageServerOptions {
+    port: number;
+    wallet: Wallet;
+    monetize: boolean;
+    calculateRequestPrice?: (req: Request) => number | Promise<number>;
+}
+export declare class StorageServer {
+    private app;
+    private port;
+    private storage;
+    private wallet;
+    private monetize;
+    private calculateRequestPrice?;
+    constructor(storage: StorageProvider, options: WalletStorageServerOptions);
+    private setupRoutes;
+    start(): void;
+}
+//# sourceMappingURL=StorageServer.d.ts.map

package/out/src/storage/remoting/StorageServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageServer.d.ts","sourceRoot":"","sources":["../../../../src/storage/remoting/StorageServer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAgB,EAAE,OAAO,EAAY,MAAM,SAAS,CAAA;AAMpD,OAAO,EAAO,MAAM,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAI9D,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACnE;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,qBAAqB,CAAC,CAA4C;gBAE9D,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,0BAA0B;IAUzE,OAAO,CAAC,WAAW;IAgIZ,KAAK,IAAI,IAAI;CAOrB"}