@getpara/core-sdk 2.0.0-alpha.53 → 2.0.0-alpha.55

package/dist/types/shares/enclave.d.ts

@@ -0,0 +1,81 @@
+import UserManagementClient from '@getpara/user-management-client';
+export interface ShareData {
+    userId: string;
+    walletId: string;
+    walletScheme: string;
+    partnerId?: string;
+    protocolId?: string;
+    signer: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface ShareQuery {
+    userId: string;
+    walletId?: string;
+    partnerId?: string;
+}
+export interface EncryptedPayload {
+    encryptedData: string;
+    keyId: string;
+    algorithm: string;
+    ephemeral: string;
+}
+/**
+ * Enclave client for secure key share operations
+ * Handles encryption/decryption and communication with the enclave service
+ */
+export declare class EnclaveClient {
+    private userManagementClient;
+    private enclavePublicKey;
+    private frontendKeyPair;
+    private retrieveJwt;
+    private persistJwt;
+    private retrieveRefreshJwt;
+    private persistRefreshJwt;
+    constructor({ userManagementClient, retrieveJwt, persistJwt, retrieveRefreshJwt, persistRefreshJwt, }: {
+        userManagementClient: UserManagementClient;
+        retrieveJwt: () => string;
+        persistJwt: (jwt: string) => void;
+        retrieveRefreshJwt: () => string;
+        persistRefreshJwt: (refreshJwt: string) => void;
+    });
+    private refreshJwt;
+    private withJwtRefreshRetry;
+    private issueEnclaveJwt;
+    /**
+     * Generate a P-256 keypair for the frontend to receive encrypted responses
+     */
+    private generateFrontendKeyPair;
+    /**
+     * Get the enclave's public key from the user-management service
+     */
+    private getEnclavePublicKey;
+    /**
+     * Import a PEM-formatted public key for use with Web Crypto API
+     */
+    private importPublicKeyFromPEM;
+    /**
+     * Export a public key to PEM format
+     */
+    private exportPublicKeyToPEM;
+    /**
+     * Encrypt data using P-256 ECIES for the enclave
+     */
+    private encryptForEnclave;
+    /**
+     * Decrypt response encrypted for the frontend
+     */
+    private decryptForFrontend;
+    /**
+     * Persist key shares to the enclave
+     * @param shares Array of share data to persist
+     */
+    private persistShares;
+    /**
+     * Retrieve key shares from the enclave
+     * @param query Query parameters for finding shares (single query or array of queries)
+     */
+    private retrieveShares;
+    retrieveSharesWithRetry(query: ShareQuery[]): Promise<ShareData[]>;
+    persistSharesWithRetry(shares: ShareData[]): Promise<any>;
+}

package/dist/types/shares/shareDistribution.d.ts

@@ -1,6 +1,6 @@
-import { BackupKitEmailProps } from '@getpara/user-management-client';
+import { BackupKitEmailProps, TWalletScheme } from '@getpara/user-management-client';
 import { Ctx } from '../types/index.js';
-export declare function distributeNewShare({ ctx, userId, walletId, userShare, ignoreRedistributingBackupEncryptedShare, emailProps, partnerId, protocolId, }: {
+export declare function distributeNewShare({ ctx, userId, walletId, userShare, ignoreRedistributingBackupEncryptedShare, emailProps, partnerId, protocolId, isEnclaveUser, walletScheme, }: {
     ctx: Ctx;
     userId: string;
     walletId: string;
@@ -9,4 +9,6 @@ export declare function distributeNewShare({ ctx, userId, walletId, userShare, i
     emailProps?: BackupKitEmailProps;
     partnerId?: string;
     protocolId?: string;
+    isEnclaveUser: boolean;
+    walletScheme: TWalletScheme;
 }): Promise<string>;

package/dist/types/types/assets.d.ts

@@ -0,0 +1,14 @@
+import { TNetwork, TOnRampAsset } from '@getpara/user-management-client';
+import { Wallet } from './wallet.js';
+export type AssetTransferType = 'INBOUND' | 'OUTBOUND';
+export type AssetTransfer = {
+    wallet: Omit<Wallet, 'signer'>;
+    type: AssetTransferType;
+    sourceAddress: string;
+    destinationAddress: string;
+    asset: TOnRampAsset;
+    network: TNetwork;
+    quantity: string;
+    chainId?: string;
+    contractAddress?: string;
+};

package/dist/types/types/config.d.ts

@@ -1,5 +1,6 @@
 import { AxiosInstance } from 'axios';
 import Client, { EmailTheme, Network, OnRampAsset, OnRampProvider, PregenAuth, TWalletScheme, TWalletType, Theme } from '@getpara/user-management-client';
+import { EnclaveClient } from '../shares/enclave.js';
 export declare enum Environment {
     DEV = "DEV",
     SANDBOX = "SANDBOX",
@@ -12,6 +13,7 @@ export interface Ctx {
     env: Environment;
     apiKey: string;
     client: Client;
+    enclaveClient?: EnclaveClient;
     disableWorkers?: boolean;
     offloadMPCComputationURL?: string;
     mpcComputationClient?: AxiosInstance;

package/dist/types/types/coreApi.d.ts

@@ -118,6 +118,7 @@ export type CoreMethods = Record<CoreMethodName, {
     getOAuthUrl: {
         params: OAuthUrlParams & {
             sessionLookupId?: string;
+            encryptionKey?: string;
         };
         response: string;
     };

package/dist/types/types/events.d.ts

@@ -1,7 +1,8 @@
-import { CurrentWalletIds } from '@getpara/user-management-client';
+import { CurrentWalletIds, OnRampPurchase } from '@getpara/user-management-client';
 import { FullSignatureRes } from './wallet.js';
 import { Wallet } from './wallet.js';
 import { CoreMethodResponse } from './coreApi.js';
+import { AssetTransfer } from './assets.js';
 export declare enum ParaEvent {
     LOGIN_EVENT = "paraLogin",
     ACCOUNT_CREATION_EVENT = "paraAccountCreation",
@@ -13,7 +14,9 @@ export declare enum ParaEvent {
     WALLETS_CHANGE_EVENT = "paraWalletsChange",
     WALLET_CREATED = "paraWalletCreated",
     PREGEN_WALLET_CLAIMED = "paraPregenWalletClaimed",
-    GUEST_WALLETS_CREATED = "paraGuestWalletsCreated"
+    GUEST_WALLETS_CREATED = "paraGuestWalletsCreated",
+    ASSET_TRANSFERRED = "paraAssetTransferred",
+    ONRAMP_TRANSACTION_COMPLETE = "paraOnRampTransactionComplete"
 }
 export type BaseEvent<T> = {
     data: T;
@@ -48,3 +51,5 @@ export type PregenWalletClaimedResponse = {
 };
 export type PregenWalletClaimedEvent = CustomEventInit<BaseEvent<WalletCreatedResponse>>;
 export type GuestWalletsCreatedEvent = CustomEventInit<BaseEvent<CoreMethodResponse<'createGuestWallets'>>>;
+export type AssetTransferredEvent = CustomEventInit<BaseEvent<AssetTransfer>>;
+export type OnRampTransactionCompleteResponse = CustomEventInit<BaseEvent<OnRampPurchase>>;

package/dist/types/types/methods.d.ts

@@ -1,4 +1,4 @@
-import { PrimaryAuthInfo, ServerAuthStateLogin, ServerAuthStateSignup, AuthMethod, ServerAuthStateVerify, VerifiedAuth, AuthExtras, RecoveryStatus, Theme, TOAuthMethod, TWalletType, TelegramAuthResponse } from '@getpara/user-management-client';
+import { PrimaryAuthInfo, ServerAuthStateLogin, ServerAuthStateSignup, AuthMethod, ServerAuthStateVerify, VerifiedAuth, AuthExtras, RecoveryStatus, Theme, TOAuthMethod, TWalletType, TelegramAuthResponse, VerifyThirdPartyAuth, ServerAuthStateDone } from '@getpara/user-management-client';
 import { Wallet } from './wallet.js';
 type Device = {
     sessionId: string;
@@ -12,7 +12,7 @@ export type VerifyExternalWalletV1 = {
     cosmosPublicKeyHex?: string;
     cosmosSigner?: string;
 };
-export type PortalUrlType = 'createAuth' | 'createPassword' | 'loginAuth' | 'loginPassword' | 'txReview' | 'onRamp' | 'telegramLogin' | 'createPIN' | 'loginPIN';
+export type PortalUrlType = 'createAuth' | 'createPassword' | 'loginAuth' | 'loginPassword' | 'txReview' | 'onRamp' | 'telegramLogin' | 'createPIN' | 'loginPIN' | 'oAuth' | 'oAuthCallback' | 'loginOTP' | 'telegramLoginVerify' | 'loginFarcaster';
 export type PortalUrlOptions = {
     params?: Record<string, string | undefined | null>;
     isForNewDevice?: boolean;
@@ -23,6 +23,9 @@ export type PortalUrlOptions = {
     pathId?: string;
     shorten?: boolean;
     isEmbedded?: boolean;
+    oAuthMethod?: OAuthUrlParams['method'];
+    appScheme?: string;
+    encryptionKey?: string;
 };
 export type WithAuthMethod = {
     /**
@@ -74,12 +77,14 @@ export type FarcasterParams = PollParams & {
      * You will need to display the URI as a QR code.
      */
     onConnectUri?: (uri: string) => void;
+    serverAuthState?: VerifyThirdPartyAuth;
 };
 export type TelegramParams = {
     /**
      * The response received from the Telegram login bot.
      */
-    telegramAuthResponse: TelegramAuthResponse;
+    telegramAuthResponse?: TelegramAuthResponse;
+    serverAuthState?: VerifyThirdPartyAuth;
 };
 export type LoginUrlParams = WithAuthMethod & WithCustomTheme & WithShorten & {
     sessionId?: string;
@@ -121,7 +126,9 @@ export type OAuthParams = OAuthUrlParams & PollParams & {
     onOAuthPopup?: (popup: Window) => void;
 };
 export type AuthStateBaseParams = WithCustomTheme & WithUseShortUrls;
-export type AuthStateVerify = ServerAuthStateVerify;
+export type AuthStateVerify = ServerAuthStateVerify & {
+    loginUrl?: string;
+};
 export type AuthStateLogin = Omit<ServerAuthStateLogin, 'loginAuthMethods'> & WithIsPasskeySupported & {
     /**
      * A Para Portal URL for logging in via a WebAuth passkey. For best compatibility, you should open this URL in a new window or tab.
@@ -166,10 +173,11 @@ export type AuthStateSignup = Omit<ServerAuthStateSignup, 'signupAuthMethods'> &
      */
     pinId?: string;
 };
+export type AuthStateDone = ServerAuthStateDone;
 export type AuthStateVerifyOrLogin = AuthStateVerify | AuthStateLogin;
-export type AuthStateSignupOrLogin = AuthStateSignup | AuthStateLogin;
-export type OAuthResponse = AuthStateSignupOrLogin;
-export type AuthState = AuthStateVerify | AuthStateLogin | AuthStateSignup;
+export type AuthStateSignupOrLoginOrDone = AuthStateSignup | AuthStateLogin | AuthStateDone;
+export type OAuthResponse = AuthStateSignupOrLoginOrDone;
+export type AuthState = AuthStateVerify | AuthStateLogin | AuthStateSignup | AuthStateDone;
 export type Verify2faParams = {
     auth: VerifiedAuth;
     verificationCode: string;

package/dist/types/utils/config.d.ts

@@ -0,0 +1,7 @@
+import { BalancesConfig } from '@getpara/user-management-client';
+/**
+ * Validates if an object is a valid BalancesConfig
+ * @param obj - The object to validate
+ * @returns True if the object is a valid BalancesConfig, false otherwise
+ */
+export declare function validateBalancesConfig(obj: any): obj is BalancesConfig;

package/dist/types/utils/formatting.d.ts

@@ -1,4 +1,4 @@
-import { TWalletType } from '@getpara/user-management-client';
+import { AssetValue, TWalletType } from '@getpara/user-management-client';
 export type Hex = `0x${string}`;
 export interface Signature {
     r: Hex;
@@ -17,3 +17,12 @@ export declare function truncateAddress(str: string, addressType: TWalletType, {
     prefix?: string;
     targetLength?: number;
 }): string;
+export declare function formatCurrency(value?: AssetValue, { fallback }?: {
+    fallback?: string;
+}): string;
+export declare function formatAssetQuantity({ quantity, symbol, decimals, fallback, }: {
+    quantity?: number;
+    symbol?: string;
+    decimals?: number;
+    fallback?: string;
+}): string;

package/dist/types/utils/index.d.ts

@@ -1,4 +1,5 @@
 export * from './autobind.js';
+export * from './config.js';
 export * from './events.js';
 export * from './formatting.js';
 export * from './json.js';

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@getpara/core-sdk",
-  "version": "2.0.0-alpha.53",
+  "version": "2.0.0-alpha.55",
   "dependencies": {
     "@celo/utils": "^8.0.2",
     "@cosmjs/encoding": "^0.32.4",
     "@ethereumjs/util": "^9.1.0",
-    "@getpara/user-management-client": "2.0.0-alpha.53",
+    "@getpara/user-management-client": "2.0.0-alpha.55",
     "@noble/hashes": "^1.5.0",
     "base64url": "^3.0.1",
     "libphonenumber-js": "^1.11.7",
@@ -27,7 +27,7 @@
     "dist",
     "package.json"
   ],
-  "gitHead": "ad18fa268a41b0e4c080fa8349553fb546983513",
+  "gitHead": "370bc842fc70118826e3b75815ba923c50f28100",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "scripts": {