@bsv/sdk 1.6.8 → 1.6.9

package/dist/esm/src/wallet/createActionSdk.js

@@ -0,0 +1,223 @@
+import { Script, Transaction } from "@bsv/sdk";
+import { asBsvSdkScript, makeAtomicBeef, verifyTruthy } from "./utilityHelpers.js";
+import { ScriptTemplateSABPPP } from './ScriptTemplateSABPPP.js';
+import { sdk } from './sdk';
+export async function createActionSdk(signer, vargs) {
+    const r = {};
+    let prior = undefined;
+    if (vargs.isNewTx) {
+        prior = await createNewTx(signer, vargs);
+        if (vargs.isSignAction) {
+            return makeSignableTransactionResult(prior, signer, vargs);
+        }
+        prior.tx = await completeSignedTransaction(prior, {}, signer);
+        r.txid = prior.tx.id('hex');
+        r.noSendChange = prior.dcr.noSendChangeOutputVouts?.map(vout => `${r.txid}.${vout}`);
+        if (!vargs.options.returnTXIDOnly)
+            r.tx = makeAtomicBeef(prior.tx, prior.dcr.inputBeef);
+    }
+    r.sendWithResults = await processActionSdk(prior, signer, vargs);
+    return r;
+}
+async function createNewTx(signer, args) {
+    const storageArgs = removeUnlockScripts(args);
+    const dcr = await signer.storage.createTransactionSdk(storageArgs);
+    const reference = dcr.reference;
+    const { tx, amount, pdi } = buildSignableTransaction(dcr, args, signer);
+    const prior = { reference, dcr, args, amount, tx, pdi };
+    return prior;
+}
+function makeSignableTransactionResult(prior, signer, args) {
+    if (!prior.dcr.inputBeef)
+        throw new sdk.WERR_INTERNAL('prior.dcr.inputBeef must be valid');
+    const txid = prior.tx.id('hex');
+    const r = {
+        noSendChange: args.isNoSend ? prior.dcr.noSendChangeOutputVouts?.map(vout => `${txid}.${vout}`) : undefined,
+        signableTransaction: {
+            reference: prior.dcr.reference,
+            tx: makeAtomicBeef(prior.tx, prior.dcr.inputBeef)
+        }
+    };
+    signer.pendingSignActions[r.signableTransaction.reference] = prior;
+    return r;
+}
+/**
+ * Derive a change output locking script
+ */
+function makeChangeLock(out, dctr, args, changeKeys, signer) {
+    const derivationPrefix = dctr.derivationPrefix;
+    const derivationSuffix = verifyTruthy(out.derivationSuffix);
+    const sabppp = new ScriptTemplateSABPPP({ derivationPrefix, derivationSuffix, keyDeriver: signer.keyDeriver });
+    const lockingScript = sabppp.lock(changeKeys.privateKey, changeKeys.publicKey);
+    return lockingScript;
+}
+export async function completeSignedTransaction(prior, spends, signer) {
+    /////////////////////
+    // Insert the user provided unlocking scripts from "spends" arg
+    /////////////////////
+    for (const [key, spend] of Object.entries(spends)) {
+        const vin = Number(key);
+        const createInput = prior.args.inputs[vin];
+        const input = prior.tx.inputs[vin];
+        if (!createInput || !input || createInput.unlockingScript || !Number.isInteger(createInput.unlockingScriptLength))
+            throw new sdk.WERR_INVALID_PARAMETER('args', `spend does not correspond to prior input with valid unlockingScriptLength.`);
+        if (spend.unlockingScript.length / 2 > createInput.unlockingScriptLength)
+            throw new sdk.WERR_INVALID_PARAMETER('args', `spend unlockingScript length ${spend.unlockingScript.length} exceeds expected length ${createInput.unlockingScriptLength}`);
+        input.unlockingScript = asBsvSdkScript(spend.unlockingScript);
+        if (spend.sequenceNumber !== undefined)
+            input.sequence = spend.sequenceNumber;
+    }
+    const results = {
+        sdk: {}
+    };
+    /////////////////////
+    // Insert SABPPP unlock templates for storage signed inputs
+    /////////////////////
+    for (const pdi of prior.pdi) {
+        const sabppp = new ScriptTemplateSABPPP({
+            derivationPrefix: pdi.derivationPrefix,
+            derivationSuffix: pdi.derivationSuffix,
+            keyDeriver: signer.keyDeriver
+        });
+        const keys = signer.getClientChangeKeyPair();
+        const lockerPrivKey = keys.privateKey;
+        const unlockerPubKey = pdi.unlockerPubKey || keys.publicKey;
+        const sourceSatoshis = pdi.sourceSatoshis;
+        const lockingScript = asBsvSdkScript(pdi.lockingScript);
+        const unlockTemplate = sabppp.unlock(lockerPrivKey, unlockerPubKey, sourceSatoshis, lockingScript);
+        const input = prior.tx.inputs[pdi.vin];
+        input.unlockingScriptTemplate = unlockTemplate;
+    }
+    /////////////////////
+    // Sign storage signed inputs making transaction fully valid.
+    /////////////////////
+    await prior.tx.sign();
+    return prior.tx;
+}
+function removeUnlockScripts(args) {
+    let storageArgs = args;
+    if (!storageArgs.inputs.every(i => i.unlockingScript === undefined)) {
+        // Never send unlocking scripts to storage, all it needs is the script length.
+        storageArgs = { ...args, inputs: [] };
+        for (const i of args.inputs) {
+            const di = {
+                ...i,
+                unlockingScriptLength: i.unlockingScript !== undefined ? i.unlockingScript.length : i.unlockingScriptLength
+            };
+            delete di.unlockingScript;
+            storageArgs.inputs.push(di);
+        }
+    }
+    return storageArgs;
+}
+export async function processActionSdk(prior, signer, vargs) {
+    const params = {
+        userId: vargs.userId, ////////////!!!!!!!!!!!!!!!!!!!!!!!!!!
+        isNewTx: vargs.isNewTx,
+        isSendWith: vargs.isSendWith,
+        isNoSend: vargs.isNoSend,
+        isDelayed: vargs.isDelayed,
+        reference: prior ? prior.reference : undefined,
+        txid: prior ? prior.tx.id('hex') : undefined,
+        rawTx: prior ? prior.tx.toBinary() : undefined,
+        sendWith: vargs.isSendWith ? vargs.options.sendWith : [],
+    };
+    const r = await signer.storage.processActionSdk(params);
+    return r.sendWithResults;
+}
+function buildSignableTransaction(dctr, args, signer) {
+    const changeKeys = signer.getClientChangeKeyPair();
+    const { inputs: storageInputs, outputs: storageOutputs, } = dctr;
+    const tx = new Transaction(args.version, [], [], args.lockTime);
+    // The order of outputs in storageOutputs is always:
+    // CreateActionArgs.outputs in the original order
+    // Commission output
+    // Change outputs
+    // The Vout values will be randomized if args.options.randomizeOutputs is true. Default is true.
+    const voutToIndex = Array(storageOutputs.length);
+    for (let vout = 0; vout < storageOutputs.length; vout++) {
+        const i = storageOutputs.findIndex(o => o.vout === vout);
+        if (i < 0)
+            throw new sdk.WERR_INVALID_PARAMETER('output.vout', `sequential. ${vout} is missing`);
+        voutToIndex[vout] = i;
+    }
+    //////////////
+    // Add OUTPUTS
+    /////////////
+    for (let vout = 0; vout < storageOutputs.length; vout++) {
+        const i = voutToIndex[vout];
+        const out = storageOutputs[i];
+        if (vout !== out.vout)
+            throw new sdk.WERR_INVALID_PARAMETER('output.vout', `equal to array index. ${out.vout} !== ${vout}`);
+        const change = out.providedBy === 'storage' && out.purpose === 'change';
+        const lockingScript = change ? makeChangeLock(out, dctr, args, changeKeys, signer) : asBsvSdkScript(out.lockingScript);
+        const output = {
+            satoshis: out.satoshis,
+            lockingScript,
+            change
+        };
+        tx.addOutput(output);
+    }
+    //////////////
+    // Merge and sort INPUTS info by vin order.
+    /////////////
+    const inputs = [];
+    for (const storageInput of storageInputs) {
+        const argsInput = (storageInput.vin !== undefined && storageInput.vin < args.inputs.length) ? args.inputs[storageInput.vin] : undefined;
+        inputs.push({ argsInput, storageInput });
+    }
+    inputs.sort((a, b) => a.storageInput.vin < b.storageInput.vin ? -1 : a.storageInput.vin === b.storageInput.vin ? 0 : 1);
+    const pendingStorageInputs = [];
+    //////////////
+    // Add INPUTS
+    /////////////
+    let totalChangeInputs = 0;
+    for (const { storageInput, argsInput } of inputs) {
+        // Two types of inputs are handled: user specified wth/without unlockingScript and storage specified using SABPPP template.
+        if (argsInput) {
+            // Type 1: User supplied input, with or without an explicit unlockingScript.
+            // If without, signAction must be used to provide the actual unlockScript.
+            const hasUnlock = typeof argsInput.unlockingScript === 'string';
+            const unlock = hasUnlock ? asBsvSdkScript(argsInput.unlockingScript) : new Script();
+            const inputToAdd = {
+                sourceTXID: argsInput.outpoint.txid,
+                sourceOutputIndex: argsInput.outpoint.vout,
+                unlockingScript: unlock,
+                sequence: argsInput.sequenceNumber
+            };
+            tx.addInput(inputToAdd);
+        }
+        else {
+            // Type2: SABPPP protocol inputs which are signed using ScriptTemplateSABPPP.
+            if (storageInput.type !== 'P2PKH')
+                throw new sdk.WERR_INVALID_PARAMETER('type', `vin ${storageInput.vin}, "${storageInput.type}" is not a supported unlocking script type.`);
+            pendingStorageInputs.push({
+                vin: tx.inputs.length,
+                derivationPrefix: verifyTruthy(storageInput.derivationPrefix),
+                derivationSuffix: verifyTruthy(storageInput.derivationSuffix),
+                unlockerPubKey: storageInput.senderIdentityKey,
+                sourceSatoshis: storageInput.sourceSatoshis,
+                lockingScript: storageInput.sourceLockingScript
+            });
+            const inputToAdd = {
+                sourceTXID: storageInput.sourceTxid,
+                sourceOutputIndex: storageInput.sourceVout,
+                unlockingScript: new Script(),
+                sequence: 0xffffffff
+            };
+            tx.addInput(inputToAdd);
+            totalChangeInputs += verifyTruthy(storageInput.sourceSatoshis);
+        }
+    }
+    // The amount is the total of non-foreign inputs minus change outputs
+    // Note that the amount can be negative when we are redeeming more inputs than we are spending
+    const totalChangeOutputs = storageOutputs.filter(x => x.purpose === 'change').reduce((acc, el) => acc + el.satoshis, 0);
+    const amount = totalChangeInputs - totalChangeOutputs;
+    return {
+        tx,
+        amount,
+        pdi: pendingStorageInputs,
+        log: ''
+    };
+}
+//# sourceMappingURL=createActionSdk.js.map

package/dist/esm/src/wallet/createActionSdk.js.map

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

package/dist/esm/src/wallet/sdk/CachedKeyDeriver.js

@@ -0,0 +1,174 @@
+import { PrivateKey, PublicKey } from '@bsv/sdk';
+import { KeyDeriver } from './KeyDeriver';
+/**
+ * A cached version of KeyDeriver that caches the results of key derivation methods.
+ * This is useful for optimizing performance when the same keys are derived multiple times.
+ * It supports configurable cache size with sane defaults and maintains cache entries using LRU (Least Recently Used) eviction policy.
+ */
+export default class CachedKeyDeriver {
+    keyDeriver;
+    cache;
+    maxCacheSize;
+    /**
+       * Initializes the CachedKeyDeriver instance with a root private key and optional cache settings.
+       * @param {PrivateKey | 'anyone'} rootKey - The root private key or the string 'anyone'.
+       * @param {Object} [options] - Optional settings for the cache.
+       * @param {number} [options.maxCacheSize=1000] - The maximum number of entries to store in the cache.
+       */
+    constructor(rootKey, options) {
+        this.keyDeriver = new KeyDeriver(rootKey);
+        this.cache = new Map();
+        this.maxCacheSize = options?.maxCacheSize || 1000;
+    }
+    /**
+       * Derives a public key based on protocol ID, key ID, and counterparty.
+       * Caches the result for future calls with the same parameters.
+       * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+       * @param {string} keyID - The key identifier.
+       * @param {Counterparty} 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) {
+        const cacheKey = this.generateCacheKey('derivePublicKey', protocolID, keyID, counterparty, forSelf);
+        if (this.cache.has(cacheKey)) {
+            return this.cacheGet(cacheKey);
+        }
+        else {
+            const result = this.keyDeriver.derivePublicKey(protocolID, keyID, counterparty, forSelf);
+            this.cacheSet(cacheKey, result);
+            return result;
+        }
+    }
+    /**
+       * Derives a private key based on protocol ID, key ID, and counterparty.
+       * Caches the result for future calls with the same parameters.
+       * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+       * @param {string} keyID - The key identifier.
+       * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+       * @returns {PrivateKey} - The derived private key.
+       */
+    derivePrivateKey(protocolID, keyID, counterparty) {
+        const cacheKey = this.generateCacheKey('derivePrivateKey', protocolID, keyID, counterparty);
+        if (this.cache.has(cacheKey)) {
+            return this.cacheGet(cacheKey);
+        }
+        else {
+            const result = this.keyDeriver.derivePrivateKey(protocolID, keyID, counterparty);
+            this.cacheSet(cacheKey, result);
+            return result;
+        }
+    }
+    /**
+       * Derives a symmetric key based on protocol ID, key ID, and counterparty.
+       * Caches the result for future calls with the same parameters.
+       * @param {WalletProtocol} protocolID - The protocol ID including a security level and protocol name.
+       * @param {string} keyID - The key identifier.
+       * @param {Counterparty} 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) {
+        const cacheKey = this.generateCacheKey('deriveSymmetricKey', protocolID, keyID, counterparty);
+        if (this.cache.has(cacheKey)) {
+            return this.cacheGet(cacheKey);
+        }
+        else {
+            const result = this.keyDeriver.deriveSymmetricKey(protocolID, keyID, counterparty);
+            this.cacheSet(cacheKey, result);
+            return result;
+        }
+    }
+    /**
+       * Reveals the shared secret between the root key and the counterparty.
+       * Caches the result for future calls with the same parameters.
+       * @param {Counterparty} 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) {
+        const cacheKey = this.generateCacheKey('revealCounterpartySecret', counterparty);
+        if (this.cache.has(cacheKey)) {
+            return this.cacheGet(cacheKey);
+        }
+        else {
+            const result = this.keyDeriver.revealCounterpartySecret(counterparty);
+            this.cacheSet(cacheKey, result);
+            return result;
+        }
+    }
+    /**
+       * Reveals the specific key association for a given protocol ID, key ID, and counterparty.
+       * Caches the result for future calls with the same parameters.
+       * @param {Counterparty} counterparty - The counterparty's public key or a predefined value ('self' or 'anyone').
+       * @param {WalletProtocol} 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) {
+        const cacheKey = this.generateCacheKey('revealSpecificSecret', counterparty, protocolID, keyID);
+        if (this.cache.has(cacheKey)) {
+            return this.cacheGet(cacheKey);
+        }
+        else {
+            const result = this.keyDeriver.revealSpecificSecret(counterparty, protocolID, keyID);
+            this.cacheSet(cacheKey, result);
+            return result;
+        }
+    }
+    /**
+       * Generates a unique cache key based on the method name and input parameters.
+       * @param {string} methodName - The name of the method.
+       * @param {...any} args - The arguments passed to the method.
+       * @returns {string} - The generated cache key.
+       */
+    generateCacheKey(methodName, ...args) {
+        const serializedArgs = args.map((arg) => this.serializeArgument(arg)).join('|');
+        return `${methodName}|${serializedArgs}`;
+    }
+    /**
+       * Serializes an argument to a string for use in a cache key.
+       * @param {any} arg - The argument to serialize.
+       * @returns {string} - The serialized argument.
+       */
+    serializeArgument(arg) {
+        if (arg instanceof PublicKey || arg instanceof PrivateKey) {
+            return arg.toString();
+        }
+        else if (Array.isArray(arg)) {
+            return arg.map((item) => this.serializeArgument(item)).join(',');
+        }
+        else if (typeof arg === 'object' && arg !== null) {
+            return JSON.stringify(arg);
+        }
+        else {
+            return String(arg);
+        }
+    }
+    /**
+       * Retrieves an item from the cache and updates its position to reflect recent use.
+       * @param {string} cacheKey - The key of the cached item.
+       * @returns {any} - The cached value.
+       */
+    cacheGet(cacheKey) {
+        const value = this.cache.get(cacheKey);
+        // Update the entry to reflect recent use
+        this.cache.delete(cacheKey);
+        this.cache.set(cacheKey, value);
+        return value;
+    }
+    /**
+       * Adds an item to the cache and evicts the least recently used item if necessary.
+       * @param {string} cacheKey - The key of the item to cache.
+       * @param {any} value - The value to cache.
+       */
+    cacheSet(cacheKey, value) {
+        if (this.cache.size >= this.maxCacheSize) {
+            // Evict the least recently used item (first item in Map)
+            const firstKey = this.cache.keys().next().value;
+            this.cache.delete(firstKey);
+        }
+        this.cache.set(cacheKey, value);
+    }
+}
+//# sourceMappingURL=CachedKeyDeriver.js.map

package/dist/esm/src/wallet/sdk/CachedKeyDeriver.js.map

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

package/dist/esm/src/wallet/sdk/CertOps.js

@@ -0,0 +1,181 @@
+import { sdk } from '..';
+import { SymmetricKey, Utils } from "@bsv/sdk";
+import { Certificate } from './Certificate';
+import { WERR_INVALID_OPERATION } from './WERR_errors';
+export class CertOps extends Certificate {
+    wallet;
+    _keyring;
+    _encryptedFields;
+    _decryptedFields;
+    constructor(wallet, wc) {
+        super(wc.type, wc.serialNumber, wc.subject, wc.certifier, wc.revocationOutpoint, wc.fields, wc.signature);
+        this.wallet = wallet;
+    }
+    static async fromCounterparty(wallet, e) {
+        const c = new CertOps(wallet, e.certificate);
+        // confirm cert verifies and decrypts.
+        await c.verify();
+        await c.decryptFields(e.counterparty, e.keyring);
+        // un-decrypt
+        c.fields = c._encryptedFields;
+        return c;
+    }
+    static async fromCertifier(wallet, e) {
+        return await CertOps.fromCounterparty(wallet, { counterparty: e.certificate.certifier, ...e });
+    }
+    static async fromEncrypted(wallet, wc, keyring) {
+        const c = new CertOps(wallet, wc);
+        c._keyring = keyring;
+        c._encryptedFields = this.copyFields(c.fields);
+        c._decryptedFields = await c.decryptFields();
+        await c.verify();
+        return c;
+    }
+    static async fromDecrypted(wallet, wc) {
+        const c = new CertOps(wallet, wc);
+        ({ fields: c._encryptedFields, keyring: c._keyring } = await c.encryptFields());
+        c._decryptedFields = await c.decryptFields();
+        return c;
+    }
+    static copyFields(fields) {
+        const copy = {};
+        for (const [n, v] of Object.entries(fields))
+            copy[n] = v;
+        return copy;
+    }
+    static getProtocolForCertificateFieldEncryption(serialNumber, fieldName) {
+        return { protocolID: [2, 'certificate field encryption'], keyID: `${serialNumber} ${fieldName}` };
+    }
+    exportForSubject() {
+        if (!this._keyring || !this._encryptedFields || !this.signature || this.signature.length === 0)
+            throw new WERR_INVALID_OPERATION(`Certificate must be encrypted and signed prior to export.`);
+        const certificate = this.toWalletCertificate();
+        const keyring = this._keyring;
+        return { certificate, keyring };
+    }
+    toWalletCertificate() {
+        const wc = {
+            signature: '',
+            ...this
+        };
+        return wc;
+    }
+    async encryptFields(counterparty = 'self') {
+        const fields = this._decryptedFields || this.fields;
+        const encryptedFields = {};
+        const keyring = {};
+        for (const fieldName of Object.keys(fields)) {
+            const fieldSymmetricKey = SymmetricKey.fromRandom();
+            const encryptedFieldValue = fieldSymmetricKey.encrypt(Utils.toArray(this.fields[fieldName], 'utf8'));
+            encryptedFields[fieldName] = Utils.toBase64(encryptedFieldValue);
+            const encryptedFieldKey = await this.wallet.encrypt({
+                plaintext: fieldSymmetricKey.toArray(),
+                counterparty,
+                ...CertOps.getProtocolForCertificateFieldEncryption(this.serialNumber, fieldName)
+            });
+            keyring[fieldName] = Utils.toBase64(encryptedFieldKey.ciphertext);
+        }
+        this._keyring = keyring;
+        this._decryptedFields = fields;
+        this.fields = this._encryptedFields = encryptedFields;
+        return { fields: encryptedFields, keyring };
+    }
+    async decryptFields(counterparty, keyring) {
+        keyring ||= this._keyring;
+        const fields = this._encryptedFields || this.fields;
+        const decryptedFields = {};
+        if (!keyring)
+            throw new sdk.WERR_INVALID_PARAMETER('keyring', 'valid');
+        try {
+            for (const fieldName of Object.keys(keyring)) {
+                const { plaintext: fieldRevelationKey } = await this.wallet.decrypt({
+                    ciphertext: Utils.toArray(keyring[fieldName], 'base64'),
+                    counterparty: counterparty || this.subject,
+                    ...CertOps.getProtocolForCertificateFieldEncryption(this.serialNumber, fieldName)
+                });
+                const fieldValue = new SymmetricKey(fieldRevelationKey).decrypt(Utils.toArray(fields[fieldName], 'base64'));
+                decryptedFields[fieldName] = Utils.toUTF8(fieldValue);
+            }
+            this._keyring = keyring;
+            this._encryptedFields = fields;
+            this.fields = this._decryptedFields = decryptedFields;
+            return decryptedFields;
+        }
+        catch (eu) {
+            const e = sdk.WalletError.fromUnknown(eu);
+            throw e;
+        }
+    }
+    async exportForCounterparty(
+    /** The incoming counterparty is who they are to us. */
+    counterparty, fieldsToReveal) {
+        if (!this._keyring || !this._encryptedFields || !this.signature || this.signature.length === 0)
+            throw new WERR_INVALID_OPERATION(`Certificate must be encrypted and signed prior to export.`);
+        const certificate = this.toWalletCertificate();
+        const keyring = await this.createKeyringForVerifier(counterparty, fieldsToReveal);
+        // The exported counterparty is who we are to them...
+        return { certificate, keyring, counterparty: this.wallet.keyDeriver.identityKey };
+    }
+    /**
+    * Creates a verifiable certificate structure for a specific verifier, allowing them access to specified fields.
+    * This method decrypts the master field keys for each field specified in `fieldsToReveal` and re-encrypts them
+    * for the verifier's identity key. The resulting certificate structure includes only the fields intended to be
+    * revealed and a verifier-specific keyring for field decryption.
+    *
+    * @param {sdk.PubKeyHex} verifierIdentityKey - The public identity key of the verifier who will receive access to the specified fields.
+    * @param {sdk.CertificateFieldNameUnder50Bytes[]} fieldsToReveal - An array of field names to be revealed to the verifier. Must be a subset of the certificate's fields.
+    * @param {sdk.OriginatorDomainNameStringUnder250Bytes} [originator] - Optional originator identifier, used if additional context is needed for decryption and encryption operations.
+    * @returns {Promise<Record<sdk.CertificateFieldNameUnder50Bytes[], sdk.Base64String>} - A new certificate structure containing the original encrypted fields, the verifier-specific field decryption keyring, and essential certificate metadata.
+    * @throws {WERR_INVALID_PARAMETER} Throws an error if:
+    *   - fieldsToReveal is empty or a field in `fieldsToReveal` does not exist in the certificate.
+    *   - The decrypted master field key fails to decrypt the corresponding field (indicating an invalid key).
+    */
+    async createKeyringForVerifier(verifierIdentityKey, fieldsToReveal, originator) {
+        if (!this._keyring || !this._encryptedFields)
+            throw new sdk.WERR_INVALID_OPERATION(`certificate must be encrypted`);
+        if (!Array.isArray(fieldsToReveal) || fieldsToReveal.some(n => this._encryptedFields[n] === undefined))
+            throw new sdk.WERR_INVALID_PARAMETER('fieldsToReveal', `an array of certificate field names`);
+        const fieldRevelationKeyring = {};
+        for (const fieldName of fieldsToReveal) {
+            // Create a keyID
+            const encryptedFieldKey = this._keyring[fieldName];
+            const protocol = CertOps.getProtocolForCertificateFieldEncryption(this.serialNumber, fieldName);
+            // Decrypt the master field key
+            const { plaintext: fieldKey } = await this.wallet.decrypt({
+                ciphertext: Utils.toArray(encryptedFieldKey, 'base64'),
+                counterparty: this.certifier,
+                ...protocol
+            }, originator);
+            // Verify that derived key actually decrypts requested field
+            try {
+                new SymmetricKey(fieldKey).decrypt(Utils.toArray(this.fields[fieldName], 'base64'));
+            }
+            catch (_) {
+                throw new sdk.WERR_INTERNAL(`unable to decrypt field "${fieldName}" using derived field key.`);
+            }
+            // Encrypt derived fieldRevelationKey for verifier
+            const { ciphertext: encryptedFieldRevelationKey } = await this.wallet.encrypt({
+                plaintext: fieldKey,
+                counterparty: verifierIdentityKey,
+                ...protocol
+            }, originator);
+            // Add encryptedFieldRevelationKey to fieldRevelationKeyring
+            fieldRevelationKeyring[fieldName] = Utils.toBase64(encryptedFieldRevelationKey);
+        }
+        // Return the field revelation keyring which can be used to create a verifiable certificate for a verifier.
+        return fieldRevelationKeyring;
+    }
+    /**
+     * encrypt plaintext field values for the subject
+     * update the signature using the certifier's private key.
+     */
+    async encryptAndSignNewCertificate() {
+        if (this.wallet.keyDeriver.identityKey !== this.certifier)
+            throw new sdk.WERR_INVALID_PARAMETER('wallet', 'the certifier for new certificate issuance.');
+        await this.encryptFields(this.subject);
+        await this.sign(this.wallet);
+        // Confirm the signed certificate verifies:
+        await this.verify();
+    }
+}
+//# sourceMappingURL=CertOps.js.map

package/dist/esm/src/wallet/sdk/CertOps.js.map

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