@bitgo/sdk-core 27.4.1 → 27.6.0

package/dist/src/bitgo/utils/tss/ecdsa/ecdsaMPCv2.d.ts

@@ -1,34 +1,44 @@
 /// <reference types="node" />
-import { Buffer } from 'buffer';
 import { DklsTypes } from '@bitgo/sdk-lib-mpc';
-import { Keychain } from '../../../keychain';
+import { Buffer } from 'buffer';
 import { KeychainsTriplet } from '../../../baseCoin';
-import { BaseEcdsaUtils } from './base';
 import { MPCv2PartyFromStringOrNumber } from '@bitgo/public-types';
-import { TSSParams, TxRequest } from '../baseTypes';
+import { Ecdsa } from '../../../../account-lib';
+import { Keychain } from '../../../keychain';
+import { DecryptedRetrofitPayload } from '../../../keychain/iKeychains';
+import { CustomMPCv2SigningRound1GeneratingFunction, CustomMPCv2SigningRound2GeneratingFunction, CustomMPCv2SigningRound3GeneratingFunction, RequestType, SignatureShareRecord, TSSParams, TSSParamsForMessage, TSSParamsForMessageWithPrv, TSSParamsWithPrv, TxRequest } from '../baseTypes';
+import { BaseEcdsaUtils } from './base';
 export declare class EcdsaMPCv2Utils extends BaseEcdsaUtils {
     /** @inheritdoc */
     createKeychains(params: {
         passphrase: string;
         enterprise: string;
         originalPasscodeEncryptionCode?: string;
+        retrofit?: DecryptedRetrofitPayload;
     }): Promise<KeychainsTriplet>;
     createParticipantKeychain(participantIndex: MPCv2PartyFromStringOrNumber, commonKeychain: string, privateMaterial?: Buffer, reducedPrivateMaterial?: Buffer, passphrase?: string, originalPasscodeEncryptionCode?: string): Promise<Keychain>;
     /**
      * Converts user and backup MPCv1 SigningMaterial to RetrofitData needed by MPCv2 DKG.
      *
      * @param {Object} params - MPCv1 decrypted signing material for user and backup as a json.stringify string and bitgo's Big Si.
-     * @returns {Promise<{ mpcv2UserKeyShare: DklsTypes.RetrofitData; mpcv2BakcupKeyShare: DklsTypes.RetrofitData }>} - the retrofit data needed to start an MPCv2 DKG session.
+     * @returns {{ mpcv2UserKeyShare: DklsTypes.RetrofitData; mpcv2BakcupKeyShare: DklsTypes.RetrofitData }} - the retrofit data needed to start an MPCv2 DKG session.
      */
     getMpcV2RetrofitDataFromMpcV1Keys(params: {
         mpcv1UserKeyShare: string;
         mpcv1BackupKeyShare: string;
-    }): Promise<{
+    }): {
         mpcv2UserKeyShare: DklsTypes.RetrofitData;
-        mpcv2BakcupKeyShare: DklsTypes.RetrofitData;
-    }>;
+        mpcv2BackupKeyShare: DklsTypes.RetrofitData;
+    };
+    getMpcV2RetrofitDataFromMpcV1Key({ mpcv1PartyKeyShare, mpcv1PartyIndex, xiList, mpc, }: {
+        mpcv1PartyKeyShare: string;
+        mpcv1PartyIndex: number;
+        xiList: number[][];
+        mpc: Ecdsa;
+    }): DklsTypes.RetrofitData;
     private addUserKeychain;
     private addBackupKeychain;
+    private getUserAndBackupSession;
     private addBitgoKeychain;
     private sendKeyGenerationRequest;
     private sendKeyGenerationRound1;
@@ -41,9 +51,73 @@ export declare class EcdsaMPCv2Utils extends BaseEcdsaUtils {
      * @param {string} params.reqId - request id
      * @returns {Promise<TxRequest>} fully signed TxRequest object
      */
-    signTxRequest(params: TSSParams): Promise<TxRequest>;
+    signTxRequest(params: TSSParamsWithPrv): Promise<TxRequest>;
+    /**
+     * Signs the message associated to the transaction request.
+     * @param {string | TxRequest} params.txRequest - transaction request object or id
+     * @param {string} params.prv - decrypted private key
+     * @param {string} params.reqId - request id
+     * @returns {Promise<TxRequest>} fully signed TxRequest object
+     */
+    signTxRequestForMessage(params: TSSParamsForMessageWithPrv): Promise<TxRequest>;
     private signRequestBase;
     private formatBitgoBroadcastMessage;
     private formatP2PMessage;
+    /**
+     * Get the hash string and derivation path from the transaction request.
+     * @param {TxRequest} txRequest - the transaction request object
+     * @param {RequestType} requestType - the request type
+     * @returns {{ hashBuffer: Buffer; derivationPath: string }} - the hash string and derivation path
+     */
+    private getHashStringAndDerivationPath;
+    /**
+     * Gets the BitGo and user GPG keys from the BitGo public GPG key and the encrypted user GPG private key.
+     * @param {string} bitgoPublicGpgKey  - the BitGo public GPG key
+     * @param {string} encryptedUserGpgPrvKey  - the encrypted user GPG private key
+     * @param {string} walletPassphrase  - the wallet passphrase
+     * @returns {Promise<{ bitgoGpgKey: pgp.Key; userGpgKey: pgp.SerializedKeyPair<string> }>} - the BitGo and user GPG keys
+     */
+    private getBitgoAndUserGpgKeys;
+    /**
+     * Validates the adata and cyphertext.
+     * @param adata string
+     * @param cyphertext string
+     * @returns void
+     * @throws {Error} if the adata or cyphertext is invalid
+     */
+    private validateAdata;
+    /** @inheritdoc */
+    signEcdsaMPCv2TssUsingExternalSigner(params: TSSParams | TSSParamsForMessage, externalSignerMPCv2SigningRound1Generator: CustomMPCv2SigningRound1GeneratingFunction, externalSignerMPCv2SigningRound2Generator: CustomMPCv2SigningRound2GeneratingFunction, externalSignerMPCv2SigningRound3Generator: CustomMPCv2SigningRound3GeneratingFunction, requestType?: RequestType): Promise<TxRequest>;
+    createOfflineRound1Share(params: {
+        txRequest: TxRequest;
+        prv: string;
+        walletPassphrase: string;
+    }): Promise<{
+        signatureShareRound1: SignatureShareRecord;
+        userGpgPubKey: string;
+        encryptedRound1Session: string;
+        encryptedUserGpgPrvKey: string;
+    }>;
+    createOfflineRound2Share(params: {
+        txRequest: TxRequest;
+        prv: string;
+        walletPassphrase: string;
+        bitgoPublicGpgKey: string;
+        encryptedUserGpgPrvKey: string;
+        encryptedRound1Session: string;
+    }): Promise<{
+        signatureShareRound2: SignatureShareRecord;
+        encryptedRound2Session: string;
+    }>;
+    createOfflineRound3Share(params: {
+        txRequest: TxRequest;
+        prv: string;
+        walletPassphrase: string;
+        bitgoPublicGpgKey: string;
+        encryptedUserGpgPrvKey: string;
+        encryptedRound2Session: string;
+    }): Promise<{
+        signatureShareRound3: SignatureShareRecord;
+    }>;
 }
 //# sourceMappingURL=ecdsaMPCv2.d.ts.map

package/dist/src/bitgo/utils/tss/ecdsa/ecdsaMPCv2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecdsaMPCv2.d.ts","sourceRoot":"","sources":["../../../../../../src/bitgo/utils/tss/ecdsa/ecdsaMPCv2.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAW,SAAS,EAAwC,MAAM,oBAAoB,CAAC;AAE9F,OAAO,EAAsB,QAAQ,EAAW,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAWL,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAe,SAAS,EAAuB,SAAS,EAAE,MAAM,cAAc,CAAC;AAYtF,qBAAa,eAAgB,SAAQ,cAAc;IACjD,kBAAkB;IACZ,eAAe,CAAC,MAAM,EAAE;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,8BAA8B,CAAC,EAAE,MAAM,CAAC;KACzC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuRvB,yBAAyB,CAC7B,gBAAgB,EAAE,4BAA4B,EAC9C,cAAc,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,MAAM,EACxB,sBAAsB,CAAC,EAAE,MAAM,EAC/B,UAAU,CAAC,EAAE,MAAM,EACnB,8BAA8B,CAAC,EAAE,MAAM,GACtC,OAAO,CAAC,QAAQ,CAAC;IA0CpB;;;;;OAKG;IACG,iCAAiC,CAAC,MAAM,EAAE;QAC9C,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,GAAG,OAAO,CAAC;QAAE,iBAAiB,EAAE,SAAS,CAAC,YAAY,CAAC;QAAC,mBAAmB,EAAE,SAAS,CAAC,YAAY,CAAA;KAAE,CAAC;YA+BzF,eAAe;YAiBf,iBAAiB;YAiBjB,gBAAgB;YAMhB,wBAAwB;YAWxB,uBAAuB;YAqBvB,uBAAuB;YAsCvB,uBAAuB;IA4BrC;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;YAK5C,eAAe;IAsJ7B,OAAO,CAAC,2BAA2B;IAOnC,OAAO,CAAC,gBAAgB;CASzB"}
+{"version":3,"file":"ecdsaMPCv2.d.ts","sourceRoot":"","sources":["../../../../../../src/bitgo/utils/tss/ecdsa/ecdsaMPCv2.ts"],"names":[],"mappings":"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"}