@getpara/core-sdk 1.5.1 → 1.7.0

package/dist/cjs/index.js

@@ -1104,13 +1104,14 @@ var TransactionReviewTimeout = class extends Error {
 };
 
 // src/constants.ts
-var PARA_CORE_VERSION = '1.5.1';
+var PARA_CORE_VERSION = '1.7.0';
 var PREFIX = "@CAPSULE/";
 var LOCAL_STORAGE_EMAIL = `${PREFIX}e-mail`;
 var LOCAL_STORAGE_PHONE = `${PREFIX}phone`;
 var LOCAL_STORAGE_COUNTRY_CODE = `${PREFIX}countryCode`;
 var LOCAL_STORAGE_FARCASTER_USERNAME = `${PREFIX}farcasterUsername`;
 var LOCAL_STORAGE_TELEGRAM_USER_ID = `${PREFIX}telegramUserId`;
+var LOCAL_STORAGE_EXTERNAL_WALLET_USER_ID = `${PREFIX}externalWalletUserId`;
 var LOCAL_STORAGE_USER_ID = `${PREFIX}userId`;
 var LOCAL_STORAGE_ED25519_WALLETS = `${PREFIX}ed25519Wallets`;
 var LOCAL_STORAGE_WALLETS = `${PREFIX}wallets`;
@@ -1413,16 +1414,23 @@ var _ParaCore = class _ParaCore {
     setupListeners.bind(this)();
   }
   get isEmail() {
-    return !!this.email && !this.phone && !this.countryCode && !this.farcasterUsername && !this.telegramUserId;
+    return !!this.email && !this.phone && !this.countryCode && !this.farcasterUsername && !this.telegramUserId && !this.externalWalletWithParaAuth;
   }
   get isPhone() {
-    return !!this.phone && !!this.countryCode && !this.email && !this.farcasterUsername && !this.telegramUserId;
+    return !!this.phone && !!this.countryCode && !this.email && !this.farcasterUsername && !this.telegramUserId && !this.externalWalletWithParaAuth;
   }
   get isFarcaster() {
-    return !!this.farcasterUsername && !this.email && !this.phone && !this.countryCode && !this.telegramUserId;
+    return !!this.farcasterUsername && !this.email && !this.phone && !this.countryCode && !this.telegramUserId && !this.externalWalletWithParaAuth;
   }
   get isTelegram() {
-    return !!this.telegramUserId && !this.email && !this.phone && !this.countryCode && !this.farcasterUsername;
+    return !!this.telegramUserId && !this.email && !this.phone && !this.countryCode && !this.farcasterUsername && !this.externalWalletWithParaAuth;
+  }
+  get externalWalletWithParaAuth() {
+    const externalWallets = Object.values(this.externalWallets);
+    return externalWallets.find((w) => w.isExternalWithParaAuth);
+  }
+  get isExternalWalletAuth() {
+    return !!this.externalWalletWithParaAuth && !this.email && !this.phone && !this.countryCode && !this.farcasterUsername && !this.telegramUserId;
   }
   get currentWalletIdsArray() {
     return this.supportedWalletTypes.reduce((acc, { type }) => {
@@ -1530,7 +1538,11 @@ var _ParaCore = class _ParaCore {
     ));
   }
   isWalletUsable(walletId, { type: types, scheme: schemes, forbidPregen = false } = {}, throwError = false) {
+    var _a;
     let error;
+    if ((_a = this.externalWallets) == null ? void 0 : _a[walletId]) {
+      return true;
+    }
     if (!this.wallets[walletId]) {
       error = `wallet with id ${walletId} does not exist`;
     } else {
@@ -1543,8 +1555,8 @@ var _ParaCore = class _ParaCore {
       } else if (!this.isWalletSupported(wallet)) {
         error = `wallet with id ${wallet == null ? void 0 : wallet.id} and type ${wallet == null ? void 0 : wallet.type} is not supported, supported types are: ${this.supportedWalletTypes.map(({ type }) => type).join(", ")}`;
       } else if (types && (!getEquivalentTypes(types).includes(wallet == null ? void 0 : wallet.type) || isOwned && !types.some((type) => {
-        var _a, _b;
-        return (_b = (_a = this.currentWalletIds) == null ? void 0 : _a[type]) == null ? void 0 : _b.includes(walletId);
+        var _a2, _b;
+        return (_b = (_a2 = this.currentWalletIds) == null ? void 0 : _a2[type]) == null ? void 0 : _b.includes(walletId);
       }))) {
         error = `wallet with id ${wallet == null ? void 0 : wallet.id} and type ${wallet == null ? void 0 : wallet.type} cannot be selected`;
       } else if (schemes && !schemes.includes(wallet == null ? void 0 : wallet.scheme)) {
@@ -1611,7 +1623,7 @@ var _ParaCore = class _ParaCore {
   }
   constructPortalUrl(_0) {
     return __async(this, arguments, function* (type, opts = {}) {
-      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
+      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
       const base = type === "onRamp" ? getPortalBaseURL(this.ctx) : yield this.getPortalURL(opts.partnerId);
       let path;
       switch (type) {
@@ -1663,7 +1675,10 @@ var _ParaCore = class _ParaCore {
         portalPrimaryButtonTextColor: this.portalPrimaryButtonTextColor,
         isForNewDevice: opts.isForNewDevice ? opts.isForNewDevice.toString() : void 0,
         supportedWalletTypes: __privateGet(this, _supportedWalletTypesOpt) ? JSON.stringify(__privateGet(this, _supportedWalletTypesOpt)) : void 0
-      }, isCreate || isLogin ? __spreadValues(__spreadValues(__spreadValues(__spreadValues({}, opts.authType === "email" ? { email: this.email } : {}), opts.authType === "phone" ? { phone: this.phone, countryCode: this.countryCode } : {}), opts.authType === "farcaster" ? { farcasterUsername: this.farcasterUsername } : {}), opts.authType === "telegram" ? { telegramUserId: this.telegramUserId } : {}) : {}), isLogin || isOnRamp ? { sessionId: opts.sessionId } : {}), isLogin ? {
+      }, isCreate || isLogin ? __spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadValues({}, opts.authType === "email" ? { email: this.email } : {}), opts.authType === "phone" ? { phone: this.phone, countryCode: this.countryCode } : {}), opts.authType === "farcaster" ? { farcasterUsername: this.farcasterUsername } : {}), opts.authType === "telegram" ? { telegramUserId: this.telegramUserId } : {}), opts.authType === "externalWallet" ? {
+        // Using id here since we store the bech32 address for cosmos in the address field of the wallet
+        externalWalletAddress: (_n = this.externalWalletWithParaAuth) == null ? void 0 : _n.id
+      } : {}) : {}), isLogin || isOnRamp ? { sessionId: opts.sessionId } : {}), isLogin ? {
         encryptionKey: opts.loginEncryptionPublicKey,
         newDeviceSessionLookupId: opts.newDeviceSessionId,
         newDeviceEncryptionKey: opts.newDeviceEncryptionKey,
@@ -1817,7 +1832,7 @@ var _ParaCore = class _ParaCore {
    * @param externalType - Type of external wallet to set.
    */
   setExternalWallet(_0) {
-    return __async(this, arguments, function* ({ address, type, provider, addressBech32 }) {
+    return __async(this, arguments, function* ({ address, type, provider, addressBech32, withFullParaAuth }) {
       this.externalWallets = {
         [address]: {
           id: address,
@@ -1825,6 +1840,7 @@ var _ParaCore = class _ParaCore {
           type,
           name: provider,
           isExternal: true,
+          isExternalWithParaAuth: withFullParaAuth,
           signer: ""
         }
       };
@@ -1943,6 +1959,23 @@ var _ParaCore = class _ParaCore {
       dispatchEvent(ParaEvent.WALLETS_CHANGE_EVENT, null);
     });
   }
+  /**
+   * Fetches the most recent OAuth account metadata for the signed-in user.
+   * If applicable, this will include the user's most recent metadata from their Google, Apple, Facebook, X, Discord, Farcaster, or Telegram account, the last time they signed in to your app.
+   * @returns {Promise<AccountMetadata>} the user's account metadata.
+   */
+  getAccountMetadata() {
+    return __async(this, null, function* () {
+      if (!(yield this.isSessionActive()) || !this.userId) {
+        throw new Error("no signed-in user");
+      }
+      const {
+        data: { partnerId }
+      } = yield this.touchSession();
+      const { accountMetadata } = yield this.ctx.client.getAccountMetadata(this.userId, partnerId);
+      return accountMetadata;
+    });
+  }
   /**
    * Validates that a wallet ID is present on the instance, usable, and matches the desired filters.
    * If no ID is passed, this will instead return the first valid, usable wallet ID that matches the filters.
@@ -1995,18 +2028,18 @@ var _ParaCore = class _ParaCore {
     return wallet;
   }
   findWallet(idOrAddress, overrideType, filter = {}) {
-    var _b, _c;
-    if (!idOrAddress && Object.keys(this.externalWallets).length > 0) {
+    var _a, _c, _d;
+    if (!this.isExternalWalletAuth && !idOrAddress && Object.keys(this.externalWallets).length > 0) {
       return Object.values(this.externalWallets)[0];
     }
-    if (this.externalWallets[idOrAddress]) {
+    if ((_a = this.externalWallets) == null ? void 0 : _a[idOrAddress]) {
       return this.externalWallets[idOrAddress];
     }
     try {
       const walletId = this.findWalletId(idOrAddress, filter);
       if (walletId && !!this.wallets[walletId]) {
-        const _a = this.wallets[walletId], { signer: _signer } = _a, wallet = __objRest(_a, ["signer"]);
-        const type = (_c = overrideType != null ? overrideType : (_b = this.currentWalletIdsArray.find(([id]) => id === walletId)) == null ? void 0 : _b[1]) != null ? _c : wallet.type;
+        const _b = this.wallets[walletId], { signer: _signer } = _b, wallet = __objRest(_b, ["signer"]);
+        const type = (_d = overrideType != null ? overrideType : (_c = this.currentWalletIdsArray.find(([id]) => id === walletId)) == null ? void 0 : _c[1]) != null ? _d : wallet.type;
         return __spreadProps(__spreadValues({}, wallet), {
           type: import_user_management_client5.WalletType[type]
         });
@@ -2290,7 +2323,8 @@ var _ParaCore = class _ParaCore {
         externalAddress: wallet.address,
         type: wallet.type,
         externalWalletProvider: wallet.provider,
-        shouldTrackUser: wallet.shouldTrackUser
+        // If the wallet isn't using full Para auth we want to track the login here
+        shouldTrackUser: !wallet.withFullParaAuth
       });
       yield this.setExternalWallet(wallet);
       yield this.setUserId(res.userId);
@@ -2298,10 +2332,10 @@ var _ParaCore = class _ParaCore {
     });
   }
   /**
-   * Returns whether or not the user is connected with an external wallet.
+   * Returns whether or not the user is connected with only an external wallet, not an external wallet with Para auth.
    */
   isUsingExternalWallet() {
-    return !!Object.keys(this.externalWallets).length;
+    return !this.isExternalWalletAuth && !!Object.keys(this.externalWallets).length;
   }
   /**
    * Passes the email code obtained from the user for verification.
@@ -2323,7 +2357,7 @@ var _ParaCore = class _ParaCore {
       cosmosSigner
     }) {
       yield this.ctx.client.verifyExternalWallet(this.userId, { address, signedMessage, cosmosPublicKeyHex, cosmosSigner });
-      return this.getSetUpBiometricsURL();
+      return this.getSetUpBiometricsURL({ authType: "externalWallet" });
     });
   }
   /**
@@ -2577,15 +2611,20 @@ var _ParaCore = class _ParaCore {
    */
   getUserBiometricLocationHints() {
     return __async(this, null, function* () {
-      if (!this.email && !this.phone && !this.farcasterUsername && !this.telegramUserId) {
-        throw new Error("one of email, phone or farcaster username are required to get biometric location hints");
+      var _a;
+      if (!this.email && !this.phone && !this.farcasterUsername && !this.telegramUserId && !this.isExternalWalletAuth) {
+        throw new Error(
+          "one of email, phone, farcaster username, telegram user id or external wallet with Para auth are required to get biometric location hints"
+        );
       }
       return yield this.ctx.client.getBiometricLocationHints({
         email: this.email,
         phone: this.phone,
         countryCode: this.countryCode,
         farcasterUsername: this.farcasterUsername,
-        telegramUserId: this.telegramUserId
+        telegramUserId: this.telegramUserId,
+        // Using id here since we store the bech32 address for cosmos in the address field of the wallet
+        externalWalletAddress: (_a = this.externalWalletWithParaAuth) == null ? void 0 : _a.id
       });
     });
   }
@@ -2697,7 +2736,9 @@ var _ParaCore = class _ParaCore {
   waitForAccountCreation() {
     return __async(this, arguments, function* ({ popupWindow } = {}) {
       yield this.touchSession();
-      this.externalWallets = {};
+      if (!this.isExternalWalletAuth) {
+        this.externalWallets = {};
+      }
       this.isAwaitingAccountCreation = true;
       while (this.isAwaitingAccountCreation) {
         try {
@@ -2865,7 +2906,9 @@ var _ParaCore = class _ParaCore {
       skipSessionRefresh = false
     } = {}) {
       var _a;
-      this.externalWallets = {};
+      if (!this.isExternalWalletAuth) {
+        this.externalWallets = {};
+      }
       this.isAwaitingLogin = true;
       while (this.isAwaitingLogin) {
         try {
@@ -3332,6 +3375,12 @@ var _ParaCore = class _ParaCore {
       if (pregenWallets.length === 0) {
         return void 0;
       }
+      const missingWallets = pregenWallets.filter((wallet) => !this.wallets[wallet.id]);
+      if (missingWallets.length > 0) {
+        throw new Error(
+          `Cannot claim pregen wallets because wallet data is missing. Please call setUserShare first to load the wallet data for the following wallet IDs: ${missingWallets.map((w) => w.id).join(", ")}`
+        );
+      }
       let newRecoverySecret;
       const { walletIds } = yield this.ctx.client.claimPregenWallets({
         userId: this.userId,
@@ -3785,13 +3834,14 @@ var _ParaCore = class _ParaCore {
   }
   /**
    * Serialize the current session for import by another Para instance.
+   * @param {boolean} excludeSigners - whether or not to exclude the signer from the exported wallets.
    * @returns {string} the serialized session
    */
-  exportSession() {
+  exportSession({ excludeSigners } = {}) {
     const sessionInfo = {
       email: this.email,
       userId: this.userId,
-      wallets: this.wallets,
+      wallets: structuredClone(this.wallets),
       currentWalletIds: this.currentWalletIds,
       sessionCookie: this.sessionCookie,
       phone: this.phone,
@@ -3800,6 +3850,11 @@ var _ParaCore = class _ParaCore {
       farcasterUsername: this.farcasterUsername,
       externalWallets: this.externalWallets
     };
+    if (excludeSigners) {
+      for (const wallet of Object.values(sessionInfo.wallets)) {
+        delete wallet.signer;
+      }
+    }
     return Buffer.from(JSON.stringify(sessionInfo)).toString("base64");
   }
   /**
@@ -3923,6 +3978,14 @@ var _ParaCore = class _ParaCore {
       }),
       {}
     );
+    const redactedExternalWallets = Object.keys(this.externalWallets).reduce(
+      (acc, walletId) => __spreadProps(__spreadValues({}, acc), {
+        [walletId]: __spreadProps(__spreadValues({}, this.externalWallets[walletId]), {
+          signer: this.externalWallets[walletId].signer ? "[REDACTED]" : void 0
+        })
+      }),
+      {}
+    );
     const obj = {
       supportedWalletTypes: this.supportedWalletTypes,
       cosmosPrefix: this.cosmosPrefix,
@@ -3935,6 +3998,7 @@ var _ParaCore = class _ParaCore {
       pregenIds: this.pregenIds,
       currentWalletIds: this.currentWalletIds,
       wallets: redactedWallets,
+      externalWallets: redactedExternalWallets,
       loginEncryptionKeyPair: this.loginEncryptionKeyPair ? "[REDACTED]" : void 0,
       ctx: {
         apiKey: this.ctx.apiKey,

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/esm/index.js

@@ -1021,13 +1021,14 @@ var TransactionReviewTimeout = class extends Error {
 };
 
 // src/constants.ts
-var PARA_CORE_VERSION = '1.5.1';
+var PARA_CORE_VERSION = '1.7.0';
 var PREFIX = "@CAPSULE/";
 var LOCAL_STORAGE_EMAIL = `${PREFIX}e-mail`;
 var LOCAL_STORAGE_PHONE = `${PREFIX}phone`;
 var LOCAL_STORAGE_COUNTRY_CODE = `${PREFIX}countryCode`;
 var LOCAL_STORAGE_FARCASTER_USERNAME = `${PREFIX}farcasterUsername`;
 var LOCAL_STORAGE_TELEGRAM_USER_ID = `${PREFIX}telegramUserId`;
+var LOCAL_STORAGE_EXTERNAL_WALLET_USER_ID = `${PREFIX}externalWalletUserId`;
 var LOCAL_STORAGE_USER_ID = `${PREFIX}userId`;
 var LOCAL_STORAGE_ED25519_WALLETS = `${PREFIX}ed25519Wallets`;
 var LOCAL_STORAGE_WALLETS = `${PREFIX}wallets`;
@@ -1330,16 +1331,23 @@ var _ParaCore = class _ParaCore {
     setupListeners.bind(this)();
   }
   get isEmail() {
-    return !!this.email && !this.phone && !this.countryCode && !this.farcasterUsername && !this.telegramUserId;
+    return !!this.email && !this.phone && !this.countryCode && !this.farcasterUsername && !this.telegramUserId && !this.externalWalletWithParaAuth;
   }
   get isPhone() {
-    return !!this.phone && !!this.countryCode && !this.email && !this.farcasterUsername && !this.telegramUserId;
+    return !!this.phone && !!this.countryCode && !this.email && !this.farcasterUsername && !this.telegramUserId && !this.externalWalletWithParaAuth;
   }
   get isFarcaster() {
-    return !!this.farcasterUsername && !this.email && !this.phone && !this.countryCode && !this.telegramUserId;
+    return !!this.farcasterUsername && !this.email && !this.phone && !this.countryCode && !this.telegramUserId && !this.externalWalletWithParaAuth;
   }
   get isTelegram() {
-    return !!this.telegramUserId && !this.email && !this.phone && !this.countryCode && !this.farcasterUsername;
+    return !!this.telegramUserId && !this.email && !this.phone && !this.countryCode && !this.farcasterUsername && !this.externalWalletWithParaAuth;
+  }
+  get externalWalletWithParaAuth() {
+    const externalWallets = Object.values(this.externalWallets);
+    return externalWallets.find((w) => w.isExternalWithParaAuth);
+  }
+  get isExternalWalletAuth() {
+    return !!this.externalWalletWithParaAuth && !this.email && !this.phone && !this.countryCode && !this.farcasterUsername && !this.telegramUserId;
   }
   get currentWalletIdsArray() {
     return this.supportedWalletTypes.reduce((acc, { type }) => {
@@ -1447,7 +1455,11 @@ var _ParaCore = class _ParaCore {
     ));
   }
   isWalletUsable(walletId, { type: types, scheme: schemes, forbidPregen = false } = {}, throwError = false) {
+    var _a;
     let error;
+    if ((_a = this.externalWallets) == null ? void 0 : _a[walletId]) {
+      return true;
+    }
     if (!this.wallets[walletId]) {
       error = `wallet with id ${walletId} does not exist`;
     } else {
@@ -1460,8 +1472,8 @@ var _ParaCore = class _ParaCore {
       } else if (!this.isWalletSupported(wallet)) {
         error = `wallet with id ${wallet == null ? void 0 : wallet.id} and type ${wallet == null ? void 0 : wallet.type} is not supported, supported types are: ${this.supportedWalletTypes.map(({ type }) => type).join(", ")}`;
       } else if (types && (!getEquivalentTypes(types).includes(wallet == null ? void 0 : wallet.type) || isOwned && !types.some((type) => {
-        var _a, _b;
-        return (_b = (_a = this.currentWalletIds) == null ? void 0 : _a[type]) == null ? void 0 : _b.includes(walletId);
+        var _a2, _b;
+        return (_b = (_a2 = this.currentWalletIds) == null ? void 0 : _a2[type]) == null ? void 0 : _b.includes(walletId);
       }))) {
         error = `wallet with id ${wallet == null ? void 0 : wallet.id} and type ${wallet == null ? void 0 : wallet.type} cannot be selected`;
       } else if (schemes && !schemes.includes(wallet == null ? void 0 : wallet.scheme)) {
@@ -1528,7 +1540,7 @@ var _ParaCore = class _ParaCore {
   }
   constructPortalUrl(_0) {
     return __async(this, arguments, function* (type, opts = {}) {
-      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
+      var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
       const base = type === "onRamp" ? getPortalBaseURL(this.ctx) : yield this.getPortalURL(opts.partnerId);
       let path;
       switch (type) {
@@ -1580,7 +1592,10 @@ var _ParaCore = class _ParaCore {
         portalPrimaryButtonTextColor: this.portalPrimaryButtonTextColor,
         isForNewDevice: opts.isForNewDevice ? opts.isForNewDevice.toString() : void 0,
         supportedWalletTypes: __privateGet(this, _supportedWalletTypesOpt) ? JSON.stringify(__privateGet(this, _supportedWalletTypesOpt)) : void 0
-      }, isCreate || isLogin ? __spreadValues(__spreadValues(__spreadValues(__spreadValues({}, opts.authType === "email" ? { email: this.email } : {}), opts.authType === "phone" ? { phone: this.phone, countryCode: this.countryCode } : {}), opts.authType === "farcaster" ? { farcasterUsername: this.farcasterUsername } : {}), opts.authType === "telegram" ? { telegramUserId: this.telegramUserId } : {}) : {}), isLogin || isOnRamp ? { sessionId: opts.sessionId } : {}), isLogin ? {
+      }, isCreate || isLogin ? __spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadValues({}, opts.authType === "email" ? { email: this.email } : {}), opts.authType === "phone" ? { phone: this.phone, countryCode: this.countryCode } : {}), opts.authType === "farcaster" ? { farcasterUsername: this.farcasterUsername } : {}), opts.authType === "telegram" ? { telegramUserId: this.telegramUserId } : {}), opts.authType === "externalWallet" ? {
+        // Using id here since we store the bech32 address for cosmos in the address field of the wallet
+        externalWalletAddress: (_n = this.externalWalletWithParaAuth) == null ? void 0 : _n.id
+      } : {}) : {}), isLogin || isOnRamp ? { sessionId: opts.sessionId } : {}), isLogin ? {
         encryptionKey: opts.loginEncryptionPublicKey,
         newDeviceSessionLookupId: opts.newDeviceSessionId,
         newDeviceEncryptionKey: opts.newDeviceEncryptionKey,
@@ -1734,7 +1749,7 @@ var _ParaCore = class _ParaCore {
    * @param externalType - Type of external wallet to set.
    */
   setExternalWallet(_0) {
-    return __async(this, arguments, function* ({ address, type, provider, addressBech32 }) {
+    return __async(this, arguments, function* ({ address, type, provider, addressBech32, withFullParaAuth }) {
       this.externalWallets = {
         [address]: {
           id: address,
@@ -1742,6 +1757,7 @@ var _ParaCore = class _ParaCore {
           type,
           name: provider,
           isExternal: true,
+          isExternalWithParaAuth: withFullParaAuth,
           signer: ""
         }
       };
@@ -1860,6 +1876,23 @@ var _ParaCore = class _ParaCore {
       dispatchEvent(ParaEvent.WALLETS_CHANGE_EVENT, null);
     });
   }
+  /**
+   * Fetches the most recent OAuth account metadata for the signed-in user.
+   * If applicable, this will include the user's most recent metadata from their Google, Apple, Facebook, X, Discord, Farcaster, or Telegram account, the last time they signed in to your app.
+   * @returns {Promise<AccountMetadata>} the user's account metadata.
+   */
+  getAccountMetadata() {
+    return __async(this, null, function* () {
+      if (!(yield this.isSessionActive()) || !this.userId) {
+        throw new Error("no signed-in user");
+      }
+      const {
+        data: { partnerId }
+      } = yield this.touchSession();
+      const { accountMetadata } = yield this.ctx.client.getAccountMetadata(this.userId, partnerId);
+      return accountMetadata;
+    });
+  }
   /**
    * Validates that a wallet ID is present on the instance, usable, and matches the desired filters.
    * If no ID is passed, this will instead return the first valid, usable wallet ID that matches the filters.
@@ -1912,18 +1945,18 @@ var _ParaCore = class _ParaCore {
     return wallet;
   }
   findWallet(idOrAddress, overrideType, filter = {}) {
-    var _b, _c;
-    if (!idOrAddress && Object.keys(this.externalWallets).length > 0) {
+    var _a, _c, _d;
+    if (!this.isExternalWalletAuth && !idOrAddress && Object.keys(this.externalWallets).length > 0) {
       return Object.values(this.externalWallets)[0];
     }
-    if (this.externalWallets[idOrAddress]) {
+    if ((_a = this.externalWallets) == null ? void 0 : _a[idOrAddress]) {
       return this.externalWallets[idOrAddress];
     }
     try {
       const walletId = this.findWalletId(idOrAddress, filter);
       if (walletId && !!this.wallets[walletId]) {
-        const _a = this.wallets[walletId], { signer: _signer } = _a, wallet = __objRest(_a, ["signer"]);
-        const type = (_c = overrideType != null ? overrideType : (_b = this.currentWalletIdsArray.find(([id]) => id === walletId)) == null ? void 0 : _b[1]) != null ? _c : wallet.type;
+        const _b = this.wallets[walletId], { signer: _signer } = _b, wallet = __objRest(_b, ["signer"]);
+        const type = (_d = overrideType != null ? overrideType : (_c = this.currentWalletIdsArray.find(([id]) => id === walletId)) == null ? void 0 : _c[1]) != null ? _d : wallet.type;
         return __spreadProps(__spreadValues({}, wallet), {
           type: WalletType2[type]
         });
@@ -2207,7 +2240,8 @@ var _ParaCore = class _ParaCore {
         externalAddress: wallet.address,
         type: wallet.type,
         externalWalletProvider: wallet.provider,
-        shouldTrackUser: wallet.shouldTrackUser
+        // If the wallet isn't using full Para auth we want to track the login here
+        shouldTrackUser: !wallet.withFullParaAuth
       });
       yield this.setExternalWallet(wallet);
       yield this.setUserId(res.userId);
@@ -2215,10 +2249,10 @@ var _ParaCore = class _ParaCore {
     });
   }
   /**
-   * Returns whether or not the user is connected with an external wallet.
+   * Returns whether or not the user is connected with only an external wallet, not an external wallet with Para auth.
    */
   isUsingExternalWallet() {
-    return !!Object.keys(this.externalWallets).length;
+    return !this.isExternalWalletAuth && !!Object.keys(this.externalWallets).length;
   }
   /**
    * Passes the email code obtained from the user for verification.
@@ -2240,7 +2274,7 @@ var _ParaCore = class _ParaCore {
       cosmosSigner
     }) {
       yield this.ctx.client.verifyExternalWallet(this.userId, { address, signedMessage, cosmosPublicKeyHex, cosmosSigner });
-      return this.getSetUpBiometricsURL();
+      return this.getSetUpBiometricsURL({ authType: "externalWallet" });
     });
   }
   /**
@@ -2494,15 +2528,20 @@ var _ParaCore = class _ParaCore {
    */
   getUserBiometricLocationHints() {
     return __async(this, null, function* () {
-      if (!this.email && !this.phone && !this.farcasterUsername && !this.telegramUserId) {
-        throw new Error("one of email, phone or farcaster username are required to get biometric location hints");
+      var _a;
+      if (!this.email && !this.phone && !this.farcasterUsername && !this.telegramUserId && !this.isExternalWalletAuth) {
+        throw new Error(
+          "one of email, phone, farcaster username, telegram user id or external wallet with Para auth are required to get biometric location hints"
+        );
       }
       return yield this.ctx.client.getBiometricLocationHints({
         email: this.email,
         phone: this.phone,
         countryCode: this.countryCode,
         farcasterUsername: this.farcasterUsername,
-        telegramUserId: this.telegramUserId
+        telegramUserId: this.telegramUserId,
+        // Using id here since we store the bech32 address for cosmos in the address field of the wallet
+        externalWalletAddress: (_a = this.externalWalletWithParaAuth) == null ? void 0 : _a.id
       });
     });
   }
@@ -2614,7 +2653,9 @@ var _ParaCore = class _ParaCore {
   waitForAccountCreation() {
     return __async(this, arguments, function* ({ popupWindow } = {}) {
       yield this.touchSession();
-      this.externalWallets = {};
+      if (!this.isExternalWalletAuth) {
+        this.externalWallets = {};
+      }
       this.isAwaitingAccountCreation = true;
       while (this.isAwaitingAccountCreation) {
         try {
@@ -2782,7 +2823,9 @@ var _ParaCore = class _ParaCore {
       skipSessionRefresh = false
     } = {}) {
       var _a;
-      this.externalWallets = {};
+      if (!this.isExternalWalletAuth) {
+        this.externalWallets = {};
+      }
       this.isAwaitingLogin = true;
       while (this.isAwaitingLogin) {
         try {
@@ -3249,6 +3292,12 @@ var _ParaCore = class _ParaCore {
       if (pregenWallets.length === 0) {
         return void 0;
       }
+      const missingWallets = pregenWallets.filter((wallet) => !this.wallets[wallet.id]);
+      if (missingWallets.length > 0) {
+        throw new Error(
+          `Cannot claim pregen wallets because wallet data is missing. Please call setUserShare first to load the wallet data for the following wallet IDs: ${missingWallets.map((w) => w.id).join(", ")}`
+        );
+      }
       let newRecoverySecret;
       const { walletIds } = yield this.ctx.client.claimPregenWallets({
         userId: this.userId,
@@ -3702,13 +3751,14 @@ var _ParaCore = class _ParaCore {
   }
   /**
    * Serialize the current session for import by another Para instance.
+   * @param {boolean} excludeSigners - whether or not to exclude the signer from the exported wallets.
    * @returns {string} the serialized session
    */
-  exportSession() {
+  exportSession({ excludeSigners } = {}) {
     const sessionInfo = {
       email: this.email,
       userId: this.userId,
-      wallets: this.wallets,
+      wallets: structuredClone(this.wallets),
       currentWalletIds: this.currentWalletIds,
       sessionCookie: this.sessionCookie,
       phone: this.phone,
@@ -3717,6 +3767,11 @@ var _ParaCore = class _ParaCore {
       farcasterUsername: this.farcasterUsername,
       externalWallets: this.externalWallets
     };
+    if (excludeSigners) {
+      for (const wallet of Object.values(sessionInfo.wallets)) {
+        delete wallet.signer;
+      }
+    }
     return Buffer.from(JSON.stringify(sessionInfo)).toString("base64");
   }
   /**
@@ -3840,6 +3895,14 @@ var _ParaCore = class _ParaCore {
       }),
       {}
     );
+    const redactedExternalWallets = Object.keys(this.externalWallets).reduce(
+      (acc, walletId) => __spreadProps(__spreadValues({}, acc), {
+        [walletId]: __spreadProps(__spreadValues({}, this.externalWallets[walletId]), {
+          signer: this.externalWallets[walletId].signer ? "[REDACTED]" : void 0
+        })
+      }),
+      {}
+    );
     const obj = {
       supportedWalletTypes: this.supportedWalletTypes,
       cosmosPrefix: this.cosmosPrefix,
@@ -3852,6 +3915,7 @@ var _ParaCore = class _ParaCore {
       pregenIds: this.pregenIds,
       currentWalletIds: this.currentWalletIds,
       wallets: redactedWallets,
+      externalWallets: redactedExternalWallets,
       loginEncryptionKeyPair: this.loginEncryptionKeyPair ? "[REDACTED]" : void 0,
       ctx: {
         apiKey: this.ctx.apiKey,

package/dist/esm/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "sideEffects": false
+}

package/dist/types/ParaCore.d.ts

@@ -1,4 +1,4 @@
-import Client, { AuthMethod, BackupKitEmailProps, CurrentWalletIds, EmailTheme, WalletEntity, WalletType, WalletParams, OAuthMethod, OnRampPurchaseCreateParams, OnRampPurchase, TPregenIdentifierType, PregenIds, BiometricLocationHint, TelegramAuthResponse, VerifyTelegramRes, Auth, ExternalWalletLoginRes } from '@getpara/user-management-client';
+import Client, { AuthMethod, BackupKitEmailProps, CurrentWalletIds, EmailTheme, WalletEntity, WalletType, WalletParams, OAuthMethod, OnRampPurchaseCreateParams, OnRampPurchase, TPregenIdentifierType, PregenIds, BiometricLocationHint, TelegramAuthResponse, VerifyTelegramRes, Auth, ExternalWalletLoginRes, AccountMetadata } from '@getpara/user-management-client';
 import type { pki as pkiType } from 'node-forge';
 import { Ctx, Environment, Theme, FullSignatureRes, ExternalWalletInfo, GetWebAuthUrlForLoginParams, AccountSetupResponse, LoginResponse, WalletFilters, WalletTypeProp, Wallet, SupportedWalletTypes, PortalUrlOptions, ConstructorOpts, RecoveryStatus } from './types/index.js';
 import { PlatformUtils } from './PlatformUtils.js';
@@ -22,6 +22,8 @@ export declare abstract class ParaCore {
     get isPhone(): boolean;
     get isFarcaster(): boolean;
     get isTelegram(): boolean;
+    get externalWalletWithParaAuth(): Wallet | undefined;
+    get isExternalWalletAuth(): boolean;
     /**
      * The IDs of the currently active wallets, for each supported wallet type. Any signer integrations will default to the first viable wallet ID in this dictionary.
      */
@@ -214,7 +216,7 @@ export declare abstract class ParaCore {
      * @param externalAddress - External wallet address to set.
      * @param externalType - Type of external wallet to set.
      */
-    setExternalWallet({ address, type, provider, addressBech32 }: ExternalWalletInfo): Promise<void>;
+    setExternalWallet({ address, type, provider, addressBech32, withFullParaAuth }: ExternalWalletInfo): Promise<void>;
     /**
      * Sets the user id associated with the `ParaCore` instance.
      * @param userId - User id to set.
@@ -269,6 +271,12 @@ export declare abstract class ParaCore {
         sessionLookupId?: string;
         newDeviceSessionLookupId?: string;
     }): Promise<void>;
+    /**
+     * Fetches the most recent OAuth account metadata for the signed-in user.
+     * If applicable, this will include the user's most recent metadata from their Google, Apple, Facebook, X, Discord, Farcaster, or Telegram account, the last time they signed in to your app.
+     * @returns {Promise<AccountMetadata>} the user's account metadata.
+     */
+    getAccountMetadata(): Promise<AccountMetadata>;
     /**
      * The prefix for the instance's managed Cosmos wallets. Defaults to `'cosmos'`.
      */
@@ -385,7 +393,7 @@ export declare abstract class ParaCore {
      */
     externalWalletLogin(wallet: ExternalWalletInfo): Promise<ExternalWalletLoginRes>;
     /**
-     * Returns whether or not the user is connected with an external wallet.
+     * Returns whether or not the user is connected with only an external wallet, not an external wallet with Para auth.
      */
     protected isUsingExternalWallet(): boolean;
     /**
@@ -906,9 +914,12 @@ export declare abstract class ParaCore {
     keepSessionAlive(): Promise<boolean>;
     /**
      * Serialize the current session for import by another Para instance.
+     * @param {boolean} excludeSigners - whether or not to exclude the signer from the exported wallets.
      * @returns {string} the serialized session
      */
-    exportSession(): string;
+    exportSession({ excludeSigners }?: {
+        excludeSigners?: boolean;
+    }): string;
     /**
      * Imports a session serialized by another Para instance.
      * @param {string} serializedInstanceBase64 the serialized session

package/dist/types/constants.d.ts

@@ -5,6 +5,7 @@ export declare const LOCAL_STORAGE_PHONE: string;
 export declare const LOCAL_STORAGE_COUNTRY_CODE: string;
 export declare const LOCAL_STORAGE_FARCASTER_USERNAME: string;
 export declare const LOCAL_STORAGE_TELEGRAM_USER_ID: string;
+export declare const LOCAL_STORAGE_EXTERNAL_WALLET_USER_ID: string;
 export declare const LOCAL_STORAGE_USER_ID: string;
 export declare const LOCAL_STORAGE_ED25519_WALLETS: string;
 export declare const LOCAL_STORAGE_WALLETS: string;

package/dist/types/types/params.d.ts

@@ -7,7 +7,14 @@ export type ExternalWalletInfo = {
     type: ExternalWalletType;
     provider?: string;
     addressBech32?: string;
-    shouldTrackUser?: boolean;
+    ensName?: string | null;
+    ensAvatar?: string | null;
+    withFullParaAuth?: boolean;
+};
+export type VerifyExternalWallet = {
+    signedMessage: string;
+    cosmosPublicKeyHex?: string;
+    cosmosSigner?: string;
 };
 export type PortalUrlOptions = {
     params?: Record<string, string | undefined | null>;

package/dist/types/types/wallet.d.ts

@@ -20,6 +20,9 @@ export interface Wallet {
     lastUsedPartner?: PartnerEntity;
     lastUsedPartnerId?: string;
     isExternal?: boolean;
+    ensName?: string | null;
+    ensAvatar?: string | null;
+    isExternalWithParaAuth?: boolean;
 }
 /** @deprecated */
 export declare enum PregenIdentifierType {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpara/core-sdk",
-  "version": "1.5.1",
+  "version": "1.7.0",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -9,7 +9,7 @@
   "dependencies": {
     "@celo/utils": "^8.0.0",
     "@cosmjs/encoding": "^0.32.4",
-    "@getpara/user-management-client": "1.5.1",
+    "@getpara/user-management-client": "1.7.0",
     "@noble/hashes": "^1.5.0",
     "base64url": "^3.0.1",
     "ethereumjs-util": "7.1.5",
@@ -40,5 +40,5 @@
       "require": "./dist/cjs/index.js"
     }
   },
-  "gitHead": "f77e0f5e162a1672219b01dbf7c06a3baadd2f35"
+  "gitHead": "241b03ee3d3502af3b8d702dabd615b266da10ae"
 }