@bitgo-beta/sdk-core 8.2.1-beta.21 → 8.2.1-beta.2100

package/dist/src/bitgo/utils/tss/eddsa/eddsa.d.ts

@@ -1,14 +1,20 @@
-import { SignShare, GShare } from '../../../../account-lib/mpc/tss';
-import { Keychain } from '../../../keychain';
-import { CustomGShareGeneratingFunction, CustomRShareGeneratingFunction, SignatureShareRecord, TSSParams, TxRequest } from '../baseTypes';
-import { CreateEddsaBitGoKeychainParams, CreateEddsaKeychainParams, KeyShare, YShare } from './types';
+import { GShare, SignShare } from '../../../../account-lib/mpc/tss';
+import { Keychain, WebauthnKeyEncryptionInfo } from '../../../keychain';
+import { CommitmentShareRecord, CustomCommitmentGeneratingFunction, CustomGShareGeneratingFunction, CustomRShareGeneratingFunction, EncryptedSignerShareRecord, SignatureShareRecord, TSSParamsForMessageWithPrv, TssSignTxRequestParamsWithPrv, TxRequest } from '../baseTypes';
+import { CreateEddsaBitGoKeychainParams, CreateEddsaKeychainParams, KeyShare } from './types';
 import baseTSSUtils from '../baseTSSUtils';
 import { KeychainsTriplet } from '../../../baseCoin';
+import { EncryptionVersion, IRequestTracer } from '../../../../api';
+import { EnvironmentName } from '../../../environments';
+import type { EddsaKeyGenCallbacks } from '../../../wallet/iWallets';
 /**
  * Utility functions for TSS work flows.
  */
 export declare class EddsaUtils extends baseTSSUtils<KeyShare> {
-    verifyWalletSignatures(userGpgPub: string, backupGpgPub: string, bitgoKeychain: Keychain, decryptedShare: string, verifierIndex: 1 | 2): Promise<void>;
+    verifyWalletSignatures(userGpgPub: string, backupGpgPub: string, bitgoKeychain: Keychain, decryptedShare: string, verifierIndex: 1 | 2, useHardcodedBitGoKeys?: {
+        env: EnvironmentName;
+        pubKeyType: 'nitro' | 'onprem';
+    }): Promise<void>;
     /**
      * Creates a Keychain containing the User's TSS signing materials.
      * We need to have the passphrase be optional to allow for the client to store their backup key on their premises
@@ -20,7 +26,7 @@ export declare class EddsaUtils extends baseTSSUtils<KeyShare> {
      * @param [passphrase] - optional wallet passphrase used to encrypt user's signing materials
      * @param [originalPasscodeEncryptionCode] - optional encryption code needed for wallet password reset for hot wallets
      */
-    createUserKeychain({ userGpgKey, backupGpgKey, userKeyShare, backupKeyShare, bitgoKeychain, passphrase, originalPasscodeEncryptionCode, }: CreateEddsaKeychainParams): Promise<Keychain>;
+    createUserKeychain({ userGpgKey, backupGpgKey, userKeyShare, backupKeyShare, bitgoKeychain, passphrase, originalPasscodeEncryptionCode, webauthnInfo, encryptionSession, encryptionVersion, enterprise, }: CreateEddsaKeychainParams): Promise<Keychain>;
     /**
      * Creates a Keychain containing the Backup party's TSS signing materials.
      * We need to have the passphrase be optional to allow for the client to store their backup key on their premises
@@ -32,7 +38,7 @@ export declare class EddsaUtils extends baseTSSUtils<KeyShare> {
      * @param bitgoKeychain - previously created BitGo keychain; must be compatible with user and backup key shares
      * @param [passphrase] - optional wallet passphrase used to encrypt user's signing materials
      */
-    createBackupKeychain({ userGpgKey, backupGpgKey, userKeyShare, backupKeyShare, bitgoKeychain, passphrase, }: CreateEddsaKeychainParams): Promise<Keychain>;
+    createBackupKeychain({ userGpgKey, backupGpgKey, userKeyShare, backupKeyShare, bitgoKeychain, passphrase, encryptionSession, encryptionVersion, }: CreateEddsaKeychainParams): Promise<Keychain>;
     /**
      * Creates a Keychain containing BitGo's TSS signing materials.
      *
@@ -51,30 +57,66 @@ export declare class EddsaUtils extends baseTSSUtils<KeyShare> {
         passphrase?: string;
         enterprise?: string;
         originalPasscodeEncryptionCode?: string;
+        webauthnInfo?: WebauthnKeyEncryptionInfo;
+        encryptionVersion?: EncryptionVersion;
+        safeId?: string;
     }): Promise<KeychainsTriplet>;
-    createRShareFromTxRequest(params: {
+    /**
+     * Creates EdDSA TSS keychains using external signer callbacks instead of a passphrase.
+     * The external signer holds all private key material and pre-encrypts shares to BitGo's GPG key.
+     */
+    createKeychainsWithExternalSigner(params: {
+        enterprise: string;
+        callbacks: EddsaKeyGenCallbacks;
+    }): Promise<KeychainsTriplet>;
+    createCommitmentShareFromTxRequest(params: {
         txRequest: TxRequest;
         prv: string;
+        walletPassphrase: string;
+        bitgoGpgPubKey: string;
+        encryptedPrv?: string;
+    }): Promise<{
+        userToBitgoCommitment: CommitmentShareRecord;
+        encryptedSignerShare: EncryptedSignerShareRecord;
+        encryptedUserToBitgoRShare: EncryptedSignerShareRecord;
+    }>;
+    createRShareFromTxRequest(params: {
+        txRequest: TxRequest;
+        walletPassphrase: string;
+        encryptedUserToBitgoRShare: EncryptedSignerShareRecord;
     }): Promise<{
         rShare: SignShare;
-        signingKeyYShare: YShare;
     }>;
     createGShareFromTxRequest(params: {
         txRequest: string | TxRequest;
         prv: string;
         bitgoToUserRShare: SignatureShareRecord;
         userToBitgoRShare: SignShare;
+        bitgoToUserCommitment: CommitmentShareRecord;
     }): Promise<GShare>;
-    signUsingExternalSigner(txRequest: string | TxRequest, externalSignerRShareGenerator: CustomRShareGeneratingFunction, externalSignerGShareGenerator: CustomGShareGeneratingFunction): Promise<TxRequest>;
+    signEddsaTssUsingExternalSigner(txRequest: string | TxRequest, externalSignerCommitmentGenerator: CustomCommitmentGeneratingFunction, externalSignerRShareGenerator: CustomRShareGeneratingFunction, externalSignerGShareGenerator: CustomGShareGeneratingFunction, reqId?: IRequestTracer): Promise<TxRequest>;
     /**
      * Signs the transaction associated to the transaction request.
      *
-     * @param txRequest - transaction request object or id
-     * @param prv - decrypted private key
-     * @param reqId - request id
+     @param params - parameters for signing the transaction request
+     * @returns {Promise<TxRequest>} fully signed TxRequest object
+     */
+    signTxRequest(params: TssSignTxRequestParamsWithPrv): Promise<TxRequest>;
+    private signRequestBase;
+    /**
+     * 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
      */
-    signTxRequest(params: TSSParams): Promise<TxRequest>;
+    signTxRequestForMessage(params: TSSParamsForMessageWithPrv): Promise<TxRequest>;
+    supportsVerifyKey(): boolean;
+    verifyKey(params: {
+        prv: string;
+        commonKeychain: string;
+    }): Promise<boolean>;
     /**
      * Get the commonPub portion of the commonKeychain.
      *
@@ -82,6 +124,9 @@ export declare class EddsaUtils extends baseTSSUtils<KeyShare> {
      * @returns {string}
      */
     static getPublicKeyFromCommonKeychain(commonKeychain: string): string;
+    createUserToBitgoCommitmentShare(commitment: string): CommitmentShareRecord;
+    createUserToBitgoEncryptedSignerShare(encryptedSignerShare: string): EncryptedSignerShareRecord;
+    createUserToBitgoEncryptedRShare(encryptedRShare: string): EncryptedSignerShareRecord;
 }
 /**
  * @deprecated - use EddsaUtils

package/dist/src/bitgo/utils/tss/eddsa/eddsa.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eddsa.d.ts","sourceRoot":"","sources":["../../../../../../src/bitgo/utils/tss/eddsa/eddsa.ts"],"names":[],"mappings":"AAOA,OAAc,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAsB,QAAQ,EAAgC,MAAM,mBAAmB,CAAC;AAY/F,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,EAC9B,oBAAoB,EACpB,SAAS,EACT,SAAS,EACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtG,OAAO,YAAY,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AAEH,qBAAa,UAAW,SAAQ,YAAY,CAAC,QAAQ,CAAC;IAC9C,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,QAAQ,EACvB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,CAAC,GAAG,CAAC,GACnB,OAAO,CAAC,IAAI,CAAC;IA8ChB;;;;;;;;;;OAUG;IACG,kBAAkB,CAAC,EACvB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,aAAa,EACb,UAAU,EACV,8BAA8B,GAC/B,EAAE,yBAAyB,GAAG,OAAO,CAAC,QAAQ,CAAC;IA4DhD;;;;;;;;;;OAUG;IACG,oBAAoB,CAAC,EACzB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,aAAa,EACb,UAAU,GACX,EAAE,yBAAyB,GAAG,OAAO,CAAC,QAAQ,CAAC;IA2DhD;;;;;;;OAOG;IACG,mBAAmB,CAAC,EACxB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,UAAU,GACX,EAAE,8BAA8B,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8CrD;;;;OAIG;IACG,eAAe,CAAC,MAAM,EAAE;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,8BAA8B,CAAC,EAAE,MAAM,CAAC;KACzC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+CvB,yBAAyB,CAAC,MAAM,EAAE;QACtC,SAAS,EAAE,SAAS,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IA+BtD,yBAAyB,CAAC,MAAM,EAAE;QACtC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,GAAG,EAAE,MAAM,CAAC;QACZ,iBAAiB,EAAE,oBAAoB,CAAC;QACxC,iBAAiB,EAAE,SAAS,CAAC;KAC9B,GAAG,OAAO,CAAC,MAAM,CAAC;IAkCb,uBAAuB,CAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,6BAA6B,EAAE,8BAA8B,EAC7D,6BAA6B,EAAE,8BAA8B,GAC5D,OAAO,CAAC,SAAS,CAAC;IA6BrB;;;;;;;OAOG;IACG,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IA6E1D;;;;;OAKG;IACH,MAAM,CAAC,8BAA8B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;CAOtE;AACD;;GAEG;AACH,eAAO,MAAM,QAAQ,mBAAa,CAAC"}
+{"version":3,"file":"eddsa.d.ts","sourceRoot":"","sources":["../../../../../../src/bitgo/utils/tss/eddsa/eddsa.ts"],"names":[],"mappings":"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"}