@bitgo-beta/sdk-core 8.2.1-beta.13 → 8.2.1-beta.1300

package/dist/src/account-lib/mpc/tss/ecdsa/ecdsa.d.ts

@@ -1,10 +1,7 @@
-/// <reference types="node" />
-import HDTree from '../../hdTree';
 import { Hash } from 'crypto';
 import { Secp256k1Curve } from '../../curves';
-import Shamir from '../../shamir';
-import { EcdsaTypes } from '@bitgo-beta/sdk-lib-mpc';
-import { DShare, KeyCombined, KeyShare, NShare, OShare, PShare, Signature, SignCombine, SignCombineRT, SignConvert, SignConvertRT, SignShareRT, SShare, SubkeyShare, XShare, XShareWithNtilde, YShare, YShareWithNtilde } from './types';
+import { EcdsaTypes, HDTree, Shamir, SchnorrProof } from '@bitgo-beta/sdk-lib-mpc';
+import { DShare, KeyCombined, KeyShare, NShare, OShare, PShare, PublicUTShare, Signature, SignCombine, SignCombineRT, SignConvert, SignConvertRT, SignConvertStep1, SignConvertStep1Response, SignConvertStep2, SignConvertStep2Response, SignConvertStep3, SignConvertStep3Response, SignShareRT, SShare, SubkeyShare, UTShare, VAShareWithProofs, VAShare, XShareWithChallenges, YShareWithChallenges, PublicVAShareWithProofs } from './types';
 /**
  * ECDSA TSS implementation supporting 2:n Threshold
  */
@@ -18,7 +15,7 @@ export default class Ecdsa {
      * @param {number} threshold Signing threshold
      * @param {number} numShares  Number of shares
      * @param {Buffer} seed optional 64 byte seed to use for key generation
-     * @param {Boolean} sync optional sync flag, if true then a synchronous version of Paillier key generation is used that does not spawn Worker threads.
+     * @param sync optional sync flag, if true then a synchronous version of Paillier key generation is used that does not spawn Worker threads.
      * @returns {Promise<KeyShare>} Returns the private p-share
      * and n-shares to be distributed to participants at their corresponding index.
      */
@@ -40,6 +37,15 @@ export default class Ecdsa {
      * be distributed to participants at their corresponding index.
      */
     keyDerive(pShare: PShare, nShares: NShare[], path: string): SubkeyShare;
+    /**
+     * Verify Schnorr proof of knowledge of the discrete log of X_i = x_i * G.
+     * @param Y The combined public key.
+     * @param VSSs The VSS shares received from all participants.
+     * @param index The i of X_i.
+     * @param proof The schnorr proof.
+     * @returns True if it's a valid proof with regards to Y and VSSs.
+     */
+    verifySchnorrProofX(Y: bigint, VSSs: bigint[][], index: number, proof: SchnorrProof): boolean;
     /**
      * Derives a child common keychain from common keychain
      *
@@ -52,10 +58,11 @@ export default class Ecdsa {
      * Appends a given range proof challenge to the shares previously created
      * by #keyCombine. Generates a new challenge if not provided.
      * @param {XShare | YShare} share Private xShare or yShare of the signing operation
-     * @param {EcdsaTypes.SerializedNtilde} challenge
+     * @param rangeProofChallenge - challenge generated via generateNtilde
+     * @param paillierProofChallenge
      * @returns {KeyCombined} The share with amended challenge values
      */
-    appendChallenge<T extends XShare | YShare>(share: T, challenge?: EcdsaTypes.SerializedNtilde): Promise<T & EcdsaTypes.SerializedNtilde>;
+    appendChallenge<T>(share: T, rangeProofChallenge: EcdsaTypes.SerializedNtilde, paillierProofChallenge: EcdsaTypes.SerializedPaillierChallenge): T & EcdsaTypes.SerializedEcdsaChallenges;
     /**
      * Create signing shares.
      * @param {xShare} xShare Private xShare of current participant signer
@@ -63,11 +70,36 @@ export default class Ecdsa {
      * @returns {SignShareRT} Returns the participant private w-share
      * and k-share to be distributed to other participant signer
      */
-    signShare(xShare: XShare | XShareWithNtilde, yShare: YShareWithNtilde): Promise<SignShareRT>;
+    signShare(xShare: XShareWithChallenges, yShare: YShareWithChallenges): Promise<SignShareRT>;
+    /**
+     * Perform multiplicitive-to-additive (MtA) share conversion with another signer.
+     * Connection 1.2 in https://lucid.app/lucidchart/7061785b-bc5c-4002-b546-3f4a3612fc62/edit?page=IAVmvYO4FvKc#
+     * If signer A completed signShare initially (input to this fn), then this step is completed by signer B.
+     * @param {SignConvert} shares
+     * @returns {SignConvertRT}
+     */
+    signConvertStep1(shares: SignConvertStep1): Promise<SignConvertStep1Response>;
     /**
      * Perform multiplicitive-to-additive (MtA) share conversion with another
      * signer.
-     * @param {SignConvert}
+     * Connection 2.1 in https://lucid.app/lucidchart/7061785b-bc5c-4002-b546-3f4a3612fc62/edit?page=IAVmvYO4FvKc#
+     * If signer B completed signConvertStep1, then this step is completed by signer A.
+     * @param {SignConvert} shares
+     * @returns {SignConvertRT}
+     */
+    signConvertStep2(shares: SignConvertStep2): Promise<SignConvertStep2Response>;
+    /**
+     * Perform multiplicitive-to-additive (MtA) share conversion with another signer.
+     * Connection 2.2 in https://lucid.app/lucidchart/7061785b-bc5c-4002-b546-3f4a3612fc62/edit?page=IAVmvYO4FvKc#
+     * If signer A completed signConvertStep2, then this step is completed by signer B.
+     * @param {SignConvert} shares
+     * @returns {SignConvertRT}
+     */
+    signConvertStep3(shares: SignConvertStep3): Promise<SignConvertStep3Response>;
+    /**
+     * Perform multiplicitive-to-additive (MtA) share conversion with another signer.
+     * @deprecated - use one of [signConvertStep1, signConvertStep2, signConvertStep3] instead
+     * @param {SignConvert} shares
      * @returns {SignConvertRT}
      */
     signConvert(shares: SignConvert): Promise<SignConvertRT>;
@@ -83,10 +115,33 @@ export default class Ecdsa {
      * @param {OShare} oShare private omicron share of current participant
      * @param {DShare} dShare delta share received from the other participant
      * @param {Hash} hash hashing algorithm implementing Node`s standard crypto hash interface
-     * @param {boolean} shouldHash if true, we hash the provided buffer before signing
-     * @returns {SShare}
+     * @param shouldHash if true, we hash the provided buffer before signing
+     * @returns {VAShare}
+     */
+    sign(M: Buffer, oShare: OShare, dShare: DShare, hash?: Hash, shouldHash?: boolean): VAShare;
+    /**
+     * Generate proofs of V_i and A_i values.
+     * @param {Buffer} M Message to commit to as part of the context of the proof.
+     *    This doesn't need to be the same message that was signed in the sign function above.
+     *    But it should be the same for all participants for the purpose of providing proof context.
+     * @param {VAShare} vaShare The VAShare to prove.
+     * @returns {VAShareWithProofs}
+     */
+    generateVAProofs(M: Buffer, vaShare: VAShare): VAShareWithProofs;
+    /**
+     * Verify V_i and A_i values of all other participants during signing phase 5 steps 5A and 5B.
+     * @param {VAShareWithProofs} vaShare V_i, A_i info including SShare values of the currenct participant
+     * @param {PublicVAShareWithProofs[]} publicVAShares public V_i, A_i info of all other participants
+     * @returns {UTShare} U_i, T_i info of the current participant if all verifications pass
+     */
+    verifyVAShares(vaShare: VAShareWithProofs, publicVAShares: PublicVAShareWithProofs[]): UTShare;
+    /**
+     * Verify U_i and V_i values of all other participants during signing phase 5 steps 5C and 5D.
+     * @param {UTShare} utShare U_i, T_i info including SShare values of the currenct participant
+     * @param {PublicUTShare[]} publicUTShares public U_i, T_i info of all other participants
+     * @returns {SShare} SShare of the current participant if all verifications pass
      */
-    sign(M: Buffer, oShare: OShare, dShare: DShare, hash?: Hash, shouldHash?: boolean): SShare;
+    verifyUTShares(utShare: UTShare, publicUTShares: PublicUTShare[]): SShare;
     /**
      * Construct full signature by combining Sign Shares
      * @param {SShare[]} shares

package/dist/src/account-lib/mpc/tss/ecdsa/ecdsa.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecdsa.d.ts","sourceRoot":"","sources":["../../../../../../src/account-lib/mpc/tss/ecdsa/ecdsa.ts"],"names":[],"mappings":";AAGA,OAAO,MAAgC,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAc,IAAI,EAAe,MAAM,QAAQ,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,MAAM,MAAM,cAAc,CAAC;AAClC,OAAO,EAAmB,UAAU,EAAwC,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAGL,MAAM,EAEN,WAAW,EACX,QAAQ,EAGR,MAAM,EACN,MAAM,EACN,MAAM,EACN,SAAS,EACT,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,MAAM,EACN,WAAW,EACX,MAAM,EACN,gBAAgB,EAChB,MAAM,EACN,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAQjB;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,KAAK;IACxB,MAAM,CAAC,KAAK,EAAE,cAAc,CAAwB;IACpD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAe;IACpC,MAAM,CAAC,MAAM,EAAE,MAAM,CAA2B;IAChD;;;;;;;;;OASG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAkEnH;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW;IAiD1D;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IAkEvE;;;;;;OAMG;IACH,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAqB9D;;;;;;OAMG;IACG,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC7C,KAAK,EAAE,CAAC,EACR,SAAS,CAAC,EAAE,UAAU,CAAC,gBAAgB,GACtC,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,gBAAgB,CAAC;IAa3C;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IA8ElG;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAoS9D;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa;IAiC/C;;;;;;;;OAQG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,UAAO,GAAG,MAAM;IAwBvF;;;;OAIG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS;IAqB/C;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,UAAO,GAAG,OAAO;IAatF;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,UAAU,CAAC,gBAAgB,GAAG,UAAU,CAAC,kBAAkB;IAI/F;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,kBAAkB,GAAG,UAAU,CAAC,gBAAgB;CAG9F"}
+{"version":3,"file":"ecdsa.d.ts","sourceRoot":"","sources":["../../../../../../src/account-lib/mpc/tss/ecdsa/ecdsa.ts"],"names":[],"mappings":"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"}