@bsv/wallet-toolbox 1.7.14 → 1.7.16

package/mobile/node_modules/@bsv/sdk/dist/esm/src/auth/certificates/VerifiableCertificate.js

@@ -0,0 +1,58 @@
+import SymmetricKey from '../../primitives/SymmetricKey.js';
+import * as Utils from '../../primitives/utils.js';
+import Certificate from './Certificate.js';
+/**
+ * VerifiableCertificate extends the Certificate class, adding functionality to manage a verifier-specific keyring.
+ * This keyring allows selective decryption of certificate fields for authorized verifiers.
+ */
+export class VerifiableCertificate extends Certificate {
+    keyring;
+    decryptedFields;
+    constructor(type, serialNumber, subject, certifier, revocationOutpoint, fields, keyring, signature, decryptedFields) {
+        super(type, serialNumber, subject, certifier, revocationOutpoint, fields, signature);
+        this.keyring = keyring;
+        this.decryptedFields = decryptedFields;
+    }
+    /**
+     *
+     * @param {WalletCertificate} certificate – The source certificate that was issued and signed by the certifier.
+     * @param {Record<CertificateFieldNameUnder50Bytes, string>} keyring – A allows the verifier to decrypt selected certificate fields.
+     * @returns {VerifiableCertificate} – A fully-formed instance containing the
+     *   original certificate data plus the supplied keyring.
+     */
+    static fromCertificate(certificate, keyring) {
+        return new VerifiableCertificate(certificate.type, certificate.serialNumber, certificate.subject, certificate.certifier, certificate.revocationOutpoint, certificate.fields, keyring, certificate.signature);
+    }
+    /**
+     * Decrypts selectively revealed certificate fields using the provided keyring and verifier wallet
+     * @param {ProtoWallet} verifierWallet - The wallet instance of the certificate's verifier, used to decrypt field keys.
+     * @returns {Promise<Record<CertificateFieldNameUnder50Bytes, string>>} - A promise that resolves to an object where each key is a field name and each value is the decrypted field value as a string.
+     * @param {BooleanDefaultFalse} [privileged] - Whether this is a privileged request.
+     * @param {DescriptionString5to50Bytes} [privilegedReason] - Reason provided for privileged access, required if this is a privileged operation.
+     * @throws {Error} Throws an error if any of the decryption operations fail, with a message indicating the failure context.
+     */
+    async decryptFields(verifierWallet, privileged, privilegedReason, originator) {
+        if (this.keyring == null || Object.keys(this.keyring).length === 0) {
+            throw new Error('A keyring is required to decrypt certificate fields for the verifier.');
+        }
+        try {
+            const decryptedFields = {};
+            for (const fieldName in this.keyring) {
+                const { plaintext: fieldRevelationKey } = await verifierWallet.decrypt({
+                    ciphertext: Utils.toArray(this.keyring[fieldName], 'base64'),
+                    ...Certificate.getCertificateFieldEncryptionDetails(fieldName, this.serialNumber),
+                    counterparty: this.subject,
+                    privileged,
+                    privilegedReason
+                }, originator);
+                const fieldValue = new SymmetricKey(fieldRevelationKey).decrypt(Utils.toArray(this.fields[fieldName], 'base64'));
+                decryptedFields[fieldName] = Utils.toUTF8(fieldValue);
+            }
+            return decryptedFields;
+        }
+        catch (error) {
+            throw new Error(`Failed to decrypt selectively revealed certificate fields using keyring: ${String(error instanceof Error ? error.message : error)}`);
+        }
+    }
+}
+//# sourceMappingURL=VerifiableCertificate.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/auth/certificates/VerifiableCertificate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VerifiableCertificate.js","sourceRoot":"","sources":["../../../../../src/auth/certificates/VerifiableCertificate.ts"],"names":[],"mappings":"AASA,OAAO,YAAY,MAAM,kCAAkC,CAAA;AAC3D,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAA;AAElD,OAAO,WAAW,MAAM,kBAAkB,CAAA;AAE1C;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IASpD,OAAO,CAAkD;IACzD,eAAe,CAAyD;IAExE,YACE,IAAkB,EAClB,YAA0B,EAC1B,OAAkB,EAClB,SAAoB,EACpB,kBAAkC,EAClC,MAAwD,EACxD,OAAyD,EACzD,SAAqB,EACrB,eAAwE;QAExE,KAAK,CACH,IAAI,EACJ,YAAY,EACZ,OAAO,EACP,SAAS,EACT,kBAAkB,EAClB,MAAM,EACN,SAAS,CACV,CAAA;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAA;IACxC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CACpB,WAA8B,EAC9B,OAAyD;QAEzD,OAAO,IAAI,qBAAqB,CAC9B,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,YAAY,EACxB,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,SAAS,EACrB,WAAW,CAAC,kBAAkB,EAC9B,WAAW,CAAC,MAAM,EAClB,OAAO,EACP,WAAW,CAAC,SAAS,CACtB,CAAA;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,aAAa,CACjB,cAA2B,EAC3B,UAAoB,EACpB,gBAAyB,EACzB,UAAoD;QAEpD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAA;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,eAAe,GACnB,EAAE,CAAA;YACJ,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrC,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC;oBACrE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;oBAC5D,GAAG,WAAW,CAAC,oCAAoC,CACjD,SAAS,EACT,IAAI,CAAC,YAAY,CAClB;oBACD,YAAY,EAAE,IAAI,CAAC,OAAO;oBAC1B,UAAU;oBACV,gBAAgB;iBACjB,EAAE,UAAU,CAAC,CAAA;gBAEd,MAAM,UAAU,GAAG,IAAI,YAAY,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAC7D,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAChD,CAAA;gBACD,eAAe,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,UAAsB,CAAC,CAAA;YACnE,CAAC;YACD,OAAO,eAAe,CAAA;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,4EAA4E,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CACrI,CAAA;QACH,CAAC;IACH,CAAC;CACF"}

package/mobile/node_modules/@bsv/sdk/dist/esm/src/auth/certificates/__tests/CompletedProtoWallet.js

@@ -0,0 +1,105 @@
+//@ts-nocheck
+import PrivateKey from '../../../primitives/PrivateKey.js';
+import { ProtoWallet, KeyDeriver, CachedKeyDeriver } from '../../../wallet/index.js';
+// Test Mock wallet which extends ProtoWallet but still implements Wallet interface
+// Unsupported methods throw
+export class CompletedProtoWallet extends ProtoWallet {
+    keyDeriver;
+    constructor(rootKeyOrKeyDeriver) {
+        super(rootKeyOrKeyDeriver);
+        if (rootKeyOrKeyDeriver instanceof KeyDeriver) {
+            this.keyDeriver = rootKeyOrKeyDeriver;
+        }
+        else if (typeof rootKeyOrKeyDeriver === 'string' ||
+            rootKeyOrKeyDeriver instanceof PrivateKey) {
+            this.keyDeriver = new CachedKeyDeriver(rootKeyOrKeyDeriver);
+        }
+        else {
+            throw new Error('Invalid key deriver provided');
+        }
+    }
+    async isAuthenticated() {
+        throw new Error('not implemented');
+    }
+    async waitForAuthentication() {
+        throw new Error('not implemented');
+    }
+    async getNetwork() {
+        throw new Error('not implemented');
+    }
+    async getVersion() {
+        throw new Error('not implemented');
+    }
+    async getPublicKey(args) {
+        if (args.privileged === true) {
+            throw new Error('no privilege support');
+        }
+        if (args.identityKey === true) {
+            if (this.keyDeriver === null || this.keyDeriver === undefined) {
+                throw new Error('keyDeriver is not initialized');
+            }
+            return { publicKey: this.keyDeriver.rootKey.toPublicKey().toString() };
+        }
+        else {
+            if (args.protocolID == null || typeof args.keyID !== 'string' || args.keyID.trim() === '') {
+                throw new Error('protocolID and keyID are required if identityKey is false or undefined.');
+            }
+            if (this.keyDeriver === null || this.keyDeriver === undefined) {
+                throw new Error('keyDeriver is not initialized');
+            }
+            return {
+                publicKey: this.keyDeriver
+                    .derivePublicKey(args.protocolID, args.keyID, typeof args.counterparty === 'string' && args.counterparty.trim() !== ''
+                    ? args.counterparty
+                    : 'self', Boolean(args.forSelf))
+                    .toString()
+            };
+        }
+    }
+    async createAction() {
+        throw new Error('not implemented');
+    }
+    async signAction() {
+        throw new Error('not implemented');
+    }
+    async abortAction() {
+        throw new Error('not implemented');
+    }
+    async listActions() {
+        throw new Error('not implemented');
+    }
+    async internalizeAction() {
+        throw new Error('not implemented');
+    }
+    async listOutputs() {
+        throw new Error('not implemented');
+    }
+    async relinquishOutput() {
+        throw new Error('not implemented');
+    }
+    async acquireCertificate() {
+        throw new Error('not implemented');
+    }
+    async listCertificates() {
+        throw new Error('not implemented');
+    }
+    async proveCertificate() {
+        throw new Error('not implemented');
+    }
+    async relinquishCertificate() {
+        throw new Error('not implemented');
+    }
+    async discoverByIdentityKey() {
+        throw new Error('not implemented');
+    }
+    async discoverByAttributes() {
+        throw new Error('not implemented');
+    }
+    async getHeight() {
+        throw new Error('not implemented');
+    }
+    async getHeaderForHeight() {
+        throw new Error('not implemented');
+    }
+}
+//# sourceMappingURL=CompletedProtoWallet.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/auth/certificates/__tests/CompletedProtoWallet.js.map

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

package/mobile/node_modules/@bsv/sdk/dist/esm/src/auth/certificates/index.js

@@ -0,0 +1,5 @@
+export { default as Certificate } from './Certificate.js';
+export * from './MasterCertificate.js';
+export * from './VerifiableCertificate.js';
+export * from './__tests/CompletedProtoWallet.js';
+//# sourceMappingURL=index.js.map

package/mobile/node_modules/@bsv/sdk/dist/esm/src/auth/certificates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/auth/certificates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACzD,cAAc,wBAAwB,CAAA;AACtC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mCAAmC,CAAA"}