@bsv/sdk 1.1.32 → 1.2.0

package/dist/cjs/src/wallet/KeyDeriver.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("../primitives/index.js");
+/**
+ * Class responsible for deriving various types of keys using a root private key.
+ * It supports deriving public and private keys, symmetric keys, and revealing key linkages.
+ */
+class KeyDeriver {
+    /**
+       * Initializes the KeyDeriver instance with a root private key.
+       * @param {PrivateKey | 'anyone'} rootKey - The root private key or the string 'anyone'.
+       */
+    constructor(rootKey) {
+        if (rootKey === 'anyone') {
+            this.rootKey = new index_js_1.PrivateKey(1);
+        }
+        else {
+            this.rootKey = rootKey;
+        }
+    }
+    /**
+       * Derives a public key based on protocol ID, key ID, and counterparty.
+       * @param {[0 | 1 | 2, string]} protocolID - The protocol ID including a security level and protocol name.
+       * @param {string} keyID - The key identifier.
+       * @param {PublicKey | string | 'self' | 'anyone'} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+       * @param {boolean} [forSelf=false] - Whether deriving for self.
+       * @returns {PublicKey} - The derived public key.
+       */
+    derivePublicKey(protocolID, keyID, counterparty, forSelf = false) {
+        counterparty = this.normalizeCounterparty(counterparty);
+        if (forSelf) {
+            return this.rootKey.deriveChild(counterparty, this.computeInvoiceNumber(protocolID, keyID)).toPublicKey();
+        }
+        else {
+            return counterparty.deriveChild(this.rootKey, this.computeInvoiceNumber(protocolID, keyID));
+        }
+    }
+    /**
+       * Derives a private key based on protocol ID, key ID, and counterparty.
+       * @param {[0 | 1 | 2, string]} protocolID - The protocol ID including a security level and protocol name.
+       * @param {string} keyID - The key identifier.
+       * @param {PublicKey | string | 'self' | 'anyone'} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+       * @returns {PrivateKey} - The derived private key.
+       */
+    derivePrivateKey(protocolID, keyID, counterparty) {
+        counterparty = this.normalizeCounterparty(counterparty);
+        return this.rootKey.deriveChild(counterparty, this.computeInvoiceNumber(protocolID, keyID));
+    }
+    /**
+       * Derives a symmetric key based on protocol ID, key ID, and counterparty.
+       * Note: Symmetric keys should not be derivable by everyone due to security risks.
+       * @param {[0 | 1 | 2, string]} protocolID - The protocol ID including a security level and protocol name.
+       * @param {string} keyID - The key identifier.
+       * @param {PublicKey | string | 'self' | 'anyone'} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+       * @returns {SymmetricKey} - The derived symmetric key.
+       * @throws {Error} - Throws an error if attempting to derive a symmetric key for 'anyone'.
+       */
+    deriveSymmetricKey(protocolID, keyID, counterparty) {
+        if (counterparty === 'anyone') {
+            throw new Error('Symmetric keys (such as encryption keys or HMAC keys) should not be derivable by everyone, because messages would be decryptable by anyone who knows the identity public key of the user, and HMACs would be similarly forgeable.');
+        }
+        counterparty = this.normalizeCounterparty(counterparty);
+        const derivedPublicKey = this.derivePublicKey(protocolID, keyID, counterparty);
+        const derivedPrivateKey = this.derivePrivateKey(protocolID, keyID, counterparty);
+        return new index_js_1.SymmetricKey(derivedPrivateKey.deriveSharedSecret(derivedPublicKey).x.toArray());
+    }
+    /**
+       * Reveals the shared secret between the root key and the counterparty.
+       * Note: This should not be used for 'self'.
+       * @param {PublicKey | string | 'self' | 'anyone'} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+       * @returns {number[]} - The shared secret as a number array.
+       * @throws {Error} - Throws an error if attempting to reveal a shared secret for 'self'.
+       */
+    revealCounterpartySecret(counterparty) {
+        if (counterparty === 'self') {
+            throw new Error('Counterparty secrets cannot be revealed for counterparty=self.');
+        }
+        counterparty = this.normalizeCounterparty(counterparty);
+        // Double-check to ensure not revealing the secret for 'self'
+        const self = this.rootKey.toPublicKey();
+        const keyDerivedBySelf = this.rootKey.deriveChild(self, 'test').toHex();
+        const keyDerivedByCounterparty = this.rootKey.deriveChild(counterparty, 'test').toHex();
+        if (keyDerivedBySelf === keyDerivedByCounterparty) {
+            throw new Error('Counterparty secrets cannot be revealed for counterparty=self.');
+        }
+        return this.rootKey.deriveSharedSecret(counterparty).encode(true);
+    }
+    /**
+       * Reveals the specific key association for a given protocol ID, key ID, and counterparty.
+       * @param {PublicKey | string | 'self' | 'anyone'} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+       * @param {[0 | 1 | 2, string]} protocolID - The protocol ID including a security level and protocol name.
+       * @param {string} keyID - The key identifier.
+       * @returns {number[]} - The specific key association as a number array.
+       */
+    revealSpecificSecret(counterparty, protocolID, keyID) {
+        counterparty = this.normalizeCounterparty(counterparty);
+        const sharedSecret = this.rootKey.deriveSharedSecret(counterparty);
+        const invoiceNumberBin = index_js_1.Utils.toArray(this.computeInvoiceNumber(protocolID, keyID), 'utf8');
+        return index_js_1.Hash.sha256hmac(sharedSecret.encode(true), invoiceNumberBin);
+    }
+    /**
+       * Normalizes the counterparty to a public key.
+       * @param {PublicKey | string | 'self' | 'anyone'} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+       * @returns {PublicKey} - The normalized counterparty public key.
+       * @throws {Error} - Throws an error if the counterparty is invalid.
+       */
+    normalizeCounterparty(counterparty) {
+        if (!counterparty) {
+            throw new Error('counterparty must be self, anyone or a public key!');
+        }
+        else if (counterparty === 'self') {
+            return this.rootKey.toPublicKey();
+        }
+        else if (counterparty === 'anyone') {
+            return new index_js_1.PrivateKey(1).toPublicKey();
+        }
+        else if (typeof counterparty === 'string') {
+            return index_js_1.PublicKey.fromString(counterparty);
+        }
+        else {
+            return counterparty;
+        }
+    }
+    /**
+       * Computes the invoice number based on the protocol ID and key ID.
+       * @param {[0 | 1 | 2, string]} protocolID - The protocol ID including a security level and protocol name.
+       * @param {string} keyID - The key identifier.
+       * @returns {string} - The computed invoice number.
+       * @throws {Error} - Throws an error if protocol ID or key ID are invalid.
+       */
+    computeInvoiceNumber(protocolID, keyID) {
+        const securityLevel = protocolID[0];
+        if (!Number.isInteger(securityLevel) || securityLevel < 0 || securityLevel > 2) {
+            throw new Error('Protocol security level must be 0, 1, or 2');
+        }
+        const protocolName = protocolID[1].toLowerCase().trim();
+        if (keyID.length > 800) {
+            throw new Error('Key IDs must be 800 characters or less');
+        }
+        if (keyID.length < 1) {
+            throw new Error('Key IDs must be 1 character or more');
+        }
+        if (protocolName.length > 400) {
+            // Specific linkage revelation is the only protocol ID that can contain another protocol ID.
+            // Therefore, we allow it to be long enough to encapsulate the target protocol
+            if (protocolName.startsWith('specific linkage revelation ')) {
+                // The format is: 'specific linkage revelation x YYYYY'
+                // Where: x is the security level and YYYYY is the target protocol
+                // Thus, the max acceptable length is 30 + 400 = 430 bytes
+                if (protocolName.length > 430) {
+                    throw new Error('Specific linkage revelation protocol names must be 430 characters or less');
+                }
+            }
+            else {
+                throw new Error('Protocol names must be 400 characters or less');
+            }
+        }
+        if (protocolName.length < 5) {
+            throw new Error('Protocol names must be 5 characters or more');
+        }
+        if (protocolName.includes('  ')) {
+            throw new Error('Protocol names cannot contain multiple consecutive spaces ("  ")');
+        }
+        if (!/^[a-z0-9 ]+$/g.test(protocolName)) {
+            throw new Error('Protocol names can only contain letters, numbers and spaces');
+        }
+        if (protocolName.endsWith(' protocol')) {
+            throw new Error('No need to end your protocol name with " protocol"');
+        }
+        return `${securityLevel}-${protocolName}-${keyID}`;
+    }
+}
+exports.default = KeyDeriver;
+//# sourceMappingURL=KeyDeriver.js.map

package/dist/cjs/src/wallet/KeyDeriver.js.map

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

package/dist/cjs/src/wallet/ProtoWallet.js

@@ -0,0 +1,245 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const KeyDeriver_js_1 = __importDefault(require("./KeyDeriver.js"));
+const index_js_1 = require("../primitives/index.js");
+const WalletError_js_1 = __importStar(require("./WalletError.js"));
+/**
+ * A ProtoWallet is a structure that fulfills the Wallet interface, capable of performing all foundational cryptographic operations. It can derive keys, create signatures, facilitate encryption and HMAC operations, and reveal key linkages. However, ProtoWallet does not create transactions, manage outputs, interact with the blockchain, enable the management of identity certificates, or store any data.
+ */
+class ProtoWallet {
+    constructor(rootKey, KeyDeriverClass = KeyDeriver_js_1.default) {
+        this.privilegedError = 'ProtoWallet is a single-keyring wallet, operating without context about whether its configured keyring is privileged.';
+        this.keyDeriver = new KeyDeriverClass(rootKey);
+    }
+    async createAction(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support creating transactions.', WalletError_js_1.default.unsupportedAction);
+    }
+    async signAction(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support creating transactions.', WalletError_js_1.default.unsupportedAction);
+    }
+    async abortAction(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support aborting transactions.', WalletError_js_1.default.unsupportedAction);
+    }
+    async listActions(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support retrieving transactions.', WalletError_js_1.default.unsupportedAction);
+    }
+    async internalizeAction(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support internalizing transactions.', WalletError_js_1.default.unsupportedAction);
+    }
+    async listOutputs(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support retrieving outputs.', WalletError_js_1.default.unsupportedAction);
+    }
+    async relinquishOutput(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support deleting outputs.', WalletError_js_1.default.unsupportedAction);
+    }
+    async getPublicKey(args, originator) {
+        if (args.privileged) {
+            throw new WalletError_js_1.WalletError(this.privilegedError);
+        }
+        if (args.identityKey) {
+            return { publicKey: this.keyDeriver.rootKey.toPublicKey().toString() };
+        }
+        else {
+            return {
+                publicKey: this.keyDeriver
+                    .derivePublicKey(args.protocolID, args.keyID, args.counterparty || 'self', args.forSelf)
+                    .toString()
+            };
+        }
+    }
+    async revealCounterpartyKeyLinkage(args, originator) {
+        if (args.privileged) {
+            throw new WalletError_js_1.WalletError(this.privilegedError);
+        }
+        const { publicKey: identityKey } = await this.getPublicKey({ identityKey: true });
+        const linkage = this.keyDeriver.revealCounterpartySecret(args.counterparty);
+        const linkageProof = new index_js_1.Schnorr().generateProof(this.keyDeriver.rootKey, this.keyDeriver.rootKey.toPublicKey(), index_js_1.PublicKey.fromString(args.counterparty), index_js_1.Point.fromDER(linkage));
+        const linkageProofBin = [
+            ...linkageProof.R.encode(true),
+            ...linkageProof.SPrime.encode(true),
+            ...linkageProof.z.toArray()
+        ];
+        const revelationTime = new Date().toISOString();
+        const { ciphertext: encryptedLinkage } = await this.encrypt({
+            plaintext: linkage,
+            protocolID: [2, 'counterparty linkage revelation'],
+            keyID: revelationTime,
+            counterparty: args.verifier
+        });
+        const { ciphertext: encryptedLinkageProof } = await this.encrypt({
+            plaintext: linkageProofBin,
+            protocolID: [2, 'counterparty linkage revelation'],
+            keyID: revelationTime,
+            counterparty: args.verifier
+        });
+        return {
+            prover: identityKey,
+            verifier: args.verifier,
+            counterparty: args.counterparty,
+            revelationTime,
+            encryptedLinkage,
+            encryptedLinkageProof
+        };
+    }
+    async revealSpecificKeyLinkage(args, originator) {
+        if (args.privileged) {
+            throw new WalletError_js_1.WalletError(this.privilegedError);
+        }
+        const { publicKey: identityKey } = await this.getPublicKey({ identityKey: true });
+        const linkage = this.keyDeriver.revealSpecificSecret(args.counterparty, args.protocolID, args.keyID);
+        const { ciphertext: encryptedLinkage } = await this.encrypt({
+            plaintext: linkage,
+            protocolID: [2, `specific linkage revelation ${args.protocolID[0]} ${args.protocolID[1]}`],
+            keyID: args.keyID,
+            counterparty: args.verifier
+        });
+        const { ciphertext: encryptedLinkageProof } = await this.encrypt({
+            plaintext: [0], // Proof type 0, no proof provided
+            protocolID: [2, `specific linkage revelation ${args.protocolID[0]} ${args.protocolID[1]}`],
+            keyID: args.keyID,
+            counterparty: args.verifier
+        });
+        return {
+            prover: identityKey,
+            verifier: args.verifier,
+            counterparty: args.counterparty,
+            protocolID: args.protocolID,
+            keyID: args.keyID,
+            encryptedLinkage,
+            encryptedLinkageProof,
+            proofType: 0
+        };
+    }
+    async encrypt(args, originator) {
+        if (args.privileged) {
+            throw new WalletError_js_1.WalletError(this.privilegedError);
+        }
+        const key = this.keyDeriver.deriveSymmetricKey(args.protocolID, args.keyID, args.counterparty || 'self');
+        return { ciphertext: key.encrypt(args.plaintext) };
+    }
+    async decrypt(args, originator) {
+        if (args.privileged) {
+            throw new WalletError_js_1.WalletError(this.privilegedError);
+        }
+        const key = this.keyDeriver.deriveSymmetricKey(args.protocolID, args.keyID, args.counterparty || 'self');
+        return { plaintext: key.decrypt(args.ciphertext) };
+    }
+    async createHmac(args, originator) {
+        if (args.privileged) {
+            throw new WalletError_js_1.WalletError(this.privilegedError);
+        }
+        const key = this.keyDeriver.deriveSymmetricKey(args.protocolID, args.keyID, args.counterparty || 'self');
+        return { hmac: index_js_1.Hash.sha256hmac(key.toArray(), args.data) };
+    }
+    async verifyHmac(args, originator) {
+        if (args.privileged) {
+            throw new WalletError_js_1.WalletError(this.privilegedError);
+        }
+        const key = this.keyDeriver.deriveSymmetricKey(args.protocolID, args.keyID, args.counterparty || 'self');
+        const valid = index_js_1.Hash.sha256hmac(key.toArray(), args.data).toString() === args.hmac.toString();
+        if (!valid) {
+            throw new WalletError_js_1.WalletError('HMAC is not valid', WalletError_js_1.default.invalidHmac);
+        }
+        return { valid };
+    }
+    async createSignature(args, originator) {
+        if (args.privileged) {
+            throw new WalletError_js_1.WalletError(this.privilegedError);
+        }
+        let hash = args.hashToDirectlySign;
+        if (!hash) {
+            hash = index_js_1.Hash.sha256(args.data);
+        }
+        const key = this.keyDeriver.derivePrivateKey(args.protocolID, args.keyID, args.counterparty || 'anyone');
+        return { signature: index_js_1.ECDSA.sign(new index_js_1.BigNumber(hash), key, true).toDER() };
+    }
+    async verifySignature(args, originator) {
+        if (args.privileged) {
+            throw new WalletError_js_1.WalletError(this.privilegedError);
+        }
+        let hash = args.hashToDirectlyVerify;
+        if (!hash) {
+            hash = index_js_1.Hash.sha256(args.data);
+        }
+        const key = this.keyDeriver.derivePublicKey(args.protocolID, args.keyID, args.counterparty || 'self', args.forSelf);
+        const valid = index_js_1.ECDSA.verify(new index_js_1.BigNumber(hash), index_js_1.Signature.fromDER(args.signature), key);
+        if (!valid) {
+            throw new WalletError_js_1.WalletError('Signature is not valid', WalletError_js_1.default.invalidSignature);
+        }
+        return { valid };
+    }
+    async acquireCertificate(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support acquiring certificates.', WalletError_js_1.default.unsupportedAction);
+    }
+    async listCertificates(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support retrieving certificates.', WalletError_js_1.default.unsupportedAction);
+    }
+    async proveCertificate(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support proving certificates.', WalletError_js_1.default.unsupportedAction);
+    }
+    async relinquishCertificate(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support deleting certificates.', WalletError_js_1.default.unsupportedAction);
+    }
+    async discoverByIdentityKey(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support resolving identities.', WalletError_js_1.default.unsupportedAction);
+    }
+    async discoverByAttributes(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support resolving identities.', WalletError_js_1.default.unsupportedAction);
+    }
+    async isAuthenticated(args, originator) {
+        return { authenticated: true };
+    }
+    async waitForAuthentication(args, originator) {
+        return { authenticated: true };
+    }
+    async getHeight(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support blockchain tracking.', WalletError_js_1.default.unsupportedAction);
+    }
+    async getHeaderForHeight(args, originator) {
+        throw new WalletError_js_1.WalletError('ProtoWallet does not support blockchain tracking.', WalletError_js_1.default.unsupportedAction);
+    }
+    async getNetwork(args, originator) {
+        return { network: 'mainnet' };
+    }
+    async getVersion(args, originator) {
+        return { version: 'proto-1.0.0' };
+    }
+}
+exports.default = ProtoWallet;
+//# sourceMappingURL=ProtoWallet.js.map

package/dist/cjs/src/wallet/ProtoWallet.js.map

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

package/dist/cjs/src/wallet/Wallet.interfaces.js

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

package/dist/cjs/src/wallet/Wallet.interfaces.js.map

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

package/dist/cjs/src/wallet/WalletClient.js

@@ -0,0 +1,181 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const window_CWI_js_1 = __importDefault(require("./substrates/window.CWI.js"));
+const XDM_js_1 = __importDefault(require("./substrates/XDM.js"));
+const WalletWireTransceiver_js_1 = __importDefault(require("./substrates/WalletWireTransceiver.js"));
+const HTTPWalletWire_js_1 = __importDefault(require("./substrates/HTTPWalletWire.js"));
+const MAX_XDM_RESPONSE_WAIT = 200;
+/**
+ * The SDK is how applications communicate with wallets over a communications substrate.
+ */
+class WalletClient {
+    constructor(substrate = 'auto', originator) {
+        if (substrate === 'Cicada')
+            substrate = new WalletWireTransceiver_js_1.default(new HTTPWalletWire_js_1.default(originator));
+        if (substrate === 'window.CWI')
+            substrate = new window_CWI_js_1.default();
+        if (substrate === 'XDM')
+            substrate = new XDM_js_1.default();
+        this.substrate = substrate;
+        this.originator = originator;
+    }
+    async connectToSubstrate() {
+        if (typeof this.substrate === 'object') {
+            return; // substrate is already connected
+        }
+        let sub;
+        const checkSub = async (timeout) => {
+            let result;
+            if (typeof timeout === 'number') {
+                result = await Promise.race([
+                    sub.getVersion({}),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Timed out.')), timeout))
+                ]);
+            }
+            else {
+                result = await sub.getVersion({});
+            }
+            if (typeof result !== 'object' || typeof result.version !== 'string') {
+                throw new Error('Failed to use substrate.');
+            }
+        };
+        try {
+            sub = new window_CWI_js_1.default();
+            await checkSub();
+            this.substrate = sub;
+        }
+        catch (e) {
+            try {
+                sub = new XDM_js_1.default();
+                await checkSub(MAX_XDM_RESPONSE_WAIT);
+                this.substrate = sub;
+            }
+            catch (e) {
+                try {
+                    sub = new WalletWireTransceiver_js_1.default(new HTTPWalletWire_js_1.default(this.originator));
+                    await checkSub();
+                    this.substrate = sub;
+                }
+                catch (e) {
+                    throw new Error('No wallet available over any communication substrate. Install a BSV wallet today!');
+                }
+            }
+        }
+    }
+    async createAction(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.createAction(args, this.originator);
+    }
+    async signAction(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.signAction(args, this.originator);
+    }
+    async abortAction(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.abortAction(args, this.originator);
+    }
+    async listActions(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.listActions(args, this.originator);
+    }
+    async internalizeAction(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.internalizeAction(args, this.originator);
+    }
+    async listOutputs(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.listOutputs(args, this.originator);
+    }
+    async relinquishOutput(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.relinquishOutput(args, this.originator);
+    }
+    async getPublicKey(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.getPublicKey(args, this.originator);
+    }
+    async revealCounterpartyKeyLinkage(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.revealCounterpartyKeyLinkage(args, this.originator);
+    }
+    async revealSpecificKeyLinkage(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.revealSpecificKeyLinkage(args, this.originator);
+    }
+    async encrypt(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.encrypt(args, this.originator);
+    }
+    async decrypt(args) {
+        return await this.substrate.decrypt(args, this.originator);
+    }
+    async createHmac(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.createHmac(args, this.originator);
+    }
+    async verifyHmac(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.verifyHmac(args, this.originator);
+    }
+    async createSignature(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.createSignature(args, this.originator);
+    }
+    async verifySignature(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.verifySignature(args, this.originator);
+    }
+    async acquireCertificate(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.acquireCertificate(args, this.originator);
+    }
+    async listCertificates(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.listCertificates(args, this.originator);
+    }
+    async proveCertificate(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.proveCertificate(args, this.originator);
+    }
+    async relinquishCertificate(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.relinquishCertificate(args, this.originator);
+    }
+    async discoverByIdentityKey(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.discoverByIdentityKey(args, this.originator);
+    }
+    async discoverByAttributes(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.discoverByAttributes(args, this.originator);
+    }
+    async isAuthenticated(args = {}) {
+        await this.connectToSubstrate();
+        return await this.substrate.isAuthenticated(args, this.originator);
+    }
+    async waitForAuthentication(args = {}) {
+        await this.connectToSubstrate();
+        return await this.substrate.waitForAuthentication(args, this.originator);
+    }
+    async getHeight(args = {}) {
+        await this.connectToSubstrate();
+        return await this.substrate.getHeight(args, this.originator);
+    }
+    async getHeaderForHeight(args) {
+        await this.connectToSubstrate();
+        return await this.substrate.getHeaderForHeight(args, this.originator);
+    }
+    async getNetwork(args = {}) {
+        await this.connectToSubstrate();
+        return await this.substrate.getNetwork(args, this.originator);
+    }
+    async getVersion(args = {}) {
+        await this.connectToSubstrate();
+        return await this.substrate.getVersion(args, this.originator);
+    }
+}
+exports.default = WalletClient;
+//# sourceMappingURL=WalletClient.js.map

package/dist/cjs/src/wallet/WalletClient.js.map

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