@getpara/user-management-client 3.0.0-alpha.1 → 3.1.0

package/dist/cjs/client.js

@@ -84,9 +84,15 @@ __export(client_exports, {
 module.exports = __toCommonJS(client_exports);
 var import_axios = __toESM(require("axios"));
 var import_axios_retry = __toESM(require("axios-retry"));
+var import_api = require("@opentelemetry/api");
+var import_shared = require("@getpara/shared");
 var import_utils = require("./utils.js");
 var import_consts = require("./consts.js");
 var import_error = require("./error.js");
+const DISABLE_AXIOS_RETRY_CONFIG = {
+  "axios-retry": { retries: 0 }
+};
+const DEFAULT_FAUCET_CHAIN = "ETHEREUM_SEPOLIA";
 const handleResponseSuccess = (response) => {
   if (response.status === 200) {
     return response;
@@ -94,16 +100,31 @@ const handleResponseSuccess = (response) => {
   throw new import_error.ParaApiError("Invalid status code");
 };
 const handleResponseError = (error) => {
-  var _a, _b, _c, _d;
+  var _a, _b, _c;
   if (error === null) throw new import_error.ParaApiError("Error is null");
   if (import_axios.default.isAxiosError(error)) {
-    let message = (_b = (_a = error.response) == null ? void 0 : _a.data) != null ? _b : "Unknown error";
+    const data = (_a = error.response) == null ? void 0 : _a.data;
+    let message = typeof data === "string" ? data : "Unknown error";
+    let serverCode;
+    let serverData;
+    if (data && typeof data === "object") {
+      const body = data;
+      if (typeof body.message === "string") message = body.message;
+      serverCode = body.code;
+      serverData = body.data;
+    }
     if (error.code === "ERR_NETWORK") {
       message = "Connection error";
     } else if (error.code === "ERR_CANCELED") {
       message = "Connection canceled";
     }
-    throw new import_error.ParaApiError(message, error.code, (_c = error.response) == null ? void 0 : _c.status, (_d = error.request) == null ? void 0 : _d.responseURL);
+    throw new import_error.ParaApiError(
+      message,
+      serverCode != null ? serverCode : error.code,
+      (_b = error.response) == null ? void 0 : _b.status,
+      (_c = error.request) == null ? void 0 : _c.responseURL,
+      serverData
+    );
   }
   throw new import_error.ParaApiError("Unknown error");
 };
@@ -120,8 +141,10 @@ class Client {
     opts,
     retrieveSessionCookie,
     persistSessionCookie,
-    partnerConfigOverride
+    partnerConfigOverride,
+    staticTraceContext
   }) {
+    this.inFlightFaucetRequests = /* @__PURE__ */ new Map();
     this.signUpOrLogIn = (body) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/users/init`, body);
       return res.data;
@@ -166,10 +189,11 @@ class Client {
       });
       return res.data;
     });
-    this.verifyAccount = (userId, body) => __async(this, null, function* () {
+    this.verifyAccount = (userId, body, traceCarrier) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(
         `/users/${userId}/verify`,
-        body
+        body,
+        traceCarrier ? { headers: traceCarrier } : void 0
       );
       return res.data;
     });
@@ -338,19 +362,17 @@ class Client {
       const res = yield this.baseRequest.post(`/users/${userId}/wallets`, body);
       return res.data;
     });
-    /** @deprecated Use the REST API (`POST /v1/wallets`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
+    // POST /wallets/pregen
     this.createPregenWallet = (body) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/wallets/pregen`, body);
       return res.data;
     });
-    /** @deprecated Use the REST API (`GET /v1/wallets`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     this.getPregenWallets = (pregenIds, isPortal = false, userId) => __async(this, null, function* () {
       const res = yield this.baseRequest.get("/wallets/pregen", {
         params: { ids: pregenIds, expand: isPortal, userId }
       });
       return res.data;
     });
-    /** @deprecated Use the REST API (`POST /v1/wallets`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     this.claimPregenWallets = (body) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/wallets/pregen/claim`, body);
       return res.data;
@@ -367,12 +389,12 @@ class Client {
       return res;
     });
     // POST /users/:userId/wallets/:walletId/refresh
-    this.refreshKeys = (userId, walletId, oldPartnerId, newPartnerId, keyShareProtocolId) => __async(this, null, function* () {
-      const body = { oldPartnerId, newPartnerId, keyShareProtocolId };
+    this.refreshKeys = (userId, walletId, oldPartnerId, newPartnerId, keyShareProtocolId, useNewOT) => __async(this, null, function* () {
+      const body = { oldPartnerId, newPartnerId, keyShareProtocolId, useNewOT };
       const res = yield this.baseRequest.post(`/users/${userId}/wallets/${walletId}/refresh`, body);
       return res;
     });
-    /** @deprecated Use the REST API (`PATCH /v1/wallets/:id`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
+    // PATCH /wallets/pregen/:walletId
     this.updatePregenWallet = (walletId, body) => __async(this, null, function* () {
       const res = yield this.baseRequest.patch(`/wallets/pregen/${walletId}`, body);
       return res.data;
@@ -428,8 +450,8 @@ class Client {
       const res = yield this.baseRequest.post("/recovery", body);
       return res;
     });
-    this.preSignMessage = (userId, walletId, message, scheme, cosmosSignDoc, protocolId) => __async(this, null, function* () {
-      const body = { message, scheme, cosmosSignDoc, protocolId };
+    this.preSignMessage = (userId, walletId, message, scheme, cosmosSignDoc, protocolId, useNewOT) => __async(this, null, function* () {
+      const body = { message, scheme, cosmosSignDoc, protocolId, useNewOT };
       const res = yield this.baseRequest.post(`/users/${userId}/wallets/${walletId}/messages/sign`, body);
       return res.data;
     });
@@ -469,8 +491,14 @@ class Client {
       return res.data;
     });
     this.requestFaucet = (_0) => __async(this, [_0], function* ({ walletId, chain }) {
-      const res = yield this.baseRequest.post("/faucet", { walletId, chain });
-      return res.data;
+      const requestKey = `${walletId}:${chain != null ? chain : DEFAULT_FAUCET_CHAIN}`;
+      const inFlightRequest = this.inFlightFaucetRequests.get(requestKey);
+      if (inFlightRequest !== void 0) return yield inFlightRequest;
+      const request = this.baseRequest.post("/faucet", { walletId, chain }, DISABLE_AXIOS_RETRY_CONFIG).then((res) => res.data).finally(() => {
+        this.inFlightFaucetRequests.delete(requestKey);
+      });
+      this.inFlightFaucetRequests.set(requestKey, request);
+      return yield request;
     });
     this.issueJwt = (..._0) => __async(this, [..._0], function* ({ keyIndex = 0 } = {}) {
       const res = yield this.baseRequest.post(`/auth/jwt`, { keyIndex });
@@ -601,7 +629,12 @@ class Client {
       });
       return { success: res.data.success };
     });
-    const headers = __spreadValues(__spreadValues(__spreadValues({}, apiKey && { [import_consts.API_KEY_HEADER_NAME]: apiKey }), partnerId && { [import_consts.PARTNER_ID_HEADER_NAME]: partnerId }), partnerConfigOverride && { [import_consts.PARTNER_CONFIG_OVERRIDE_HEADER_NAME]: JSON.stringify(partnerConfigOverride) });
+    const headers = __spreadProps(__spreadValues(__spreadValues(__spreadValues({}, apiKey && { [import_consts.API_KEY_HEADER_NAME]: apiKey }), partnerId && { [import_consts.PARTNER_ID_HEADER_NAME]: partnerId }), partnerConfigOverride && { [import_consts.PARTNER_CONFIG_OVERRIDE_HEADER_NAME]: JSON.stringify(partnerConfigOverride) }), {
+      // Opts into structured-JSON error responses for OTP error classes (server-side
+      // contract added in @getpara/shared 1.16.0). Without it the server falls back to
+      // plain-text bodies for backward compat with older SDKs.
+      [import_shared.STRUCTURED_ERRORS_HEADER]: "1"
+    });
     const axiosConfig = {
       baseURL: userManagementHost,
       withCredentials: true,
@@ -647,6 +680,19 @@ class Client {
       if (version) {
         config.headers.set(import_consts.VERSION_HEADER_NAME, version);
       }
+      const g = globalThis;
+      const isBrowserMainThread = typeof g.window !== "undefined" && typeof g.WorkerGlobalScope === "undefined";
+      if (staticTraceContext) {
+        for (const [key, value] of Object.entries(staticTraceContext)) {
+          config.headers.set(key, value);
+        }
+      } else if (!isBrowserMainThread) {
+        import_api.propagation.inject(import_api.context.active(), config.headers, {
+          set: (carrier, key, value) => {
+            carrier.set(key, value);
+          }
+        });
+      }
       return config;
     });
     if (opts == null ? void 0 : opts.useFetchAdapter) {
@@ -748,7 +794,7 @@ class Client {
     return __async(this, null, function* () {
       var _f = _e, { userId } = _f, rest = __objRest(_f, ["userId"]);
       const res = yield this.baseRequest.post(`/users/${userId}/resend-verification-code`, rest);
-      return res;
+      return res.data;
     });
   }
   // POST '/users/:userId/resend-verification-code-by-phone

package/dist/cjs/error.js

@@ -20,7 +20,7 @@ __export(error_exports, {
   ParaApiError: () => ParaApiError
 });
 module.exports = __toCommonJS(error_exports);
-function ParaApiError(message, code, status, responseURL) {
+function ParaApiError(message, code, status, responseURL, data) {
   Error.call(this);
   if (Error.captureStackTrace) {
     Error.captureStackTrace(this, this.constructor);
@@ -32,6 +32,7 @@ function ParaApiError(message, code, status, responseURL) {
   code && (this.code = code);
   status && (this.status = status);
   responseURL && (this.responseURL = responseURL);
+  data && (this.data = data);
 }
 const prototype = ParaApiError.prototype;
 Object.defineProperty(prototype, "isParaApiError", { value: true });

package/dist/esm/client.js

@@ -6,6 +6,10 @@ import {
 } from "./chunk-BBZEL7EG.js";
 import axios from "axios";
 import axiosRetry from "axios-retry";
+import { context, propagation } from "@opentelemetry/api";
+import {
+  STRUCTURED_ERRORS_HEADER
+} from "@getpara/shared";
 import { extractWalletRef, fromAccountMetadata, fromLinkedAccounts } from "./utils.js";
 import {
   SESSION_COOKIE_HEADER_NAME,
@@ -15,6 +19,10 @@ import {
   PARTNER_CONFIG_OVERRIDE_HEADER_NAME
 } from "./consts.js";
 import { ParaApiError } from "./error.js";
+const DISABLE_AXIOS_RETRY_CONFIG = {
+  "axios-retry": { retries: 0 }
+};
+const DEFAULT_FAUCET_CHAIN = "ETHEREUM_SEPOLIA";
 const handleResponseSuccess = (response) => {
   if (response.status === 200) {
     return response;
@@ -22,16 +30,31 @@ const handleResponseSuccess = (response) => {
   throw new ParaApiError("Invalid status code");
 };
 const handleResponseError = (error) => {
-  var _a, _b, _c, _d;
+  var _a, _b, _c;
   if (error === null) throw new ParaApiError("Error is null");
   if (axios.isAxiosError(error)) {
-    let message = (_b = (_a = error.response) == null ? void 0 : _a.data) != null ? _b : "Unknown error";
+    const data = (_a = error.response) == null ? void 0 : _a.data;
+    let message = typeof data === "string" ? data : "Unknown error";
+    let serverCode;
+    let serverData;
+    if (data && typeof data === "object") {
+      const body = data;
+      if (typeof body.message === "string") message = body.message;
+      serverCode = body.code;
+      serverData = body.data;
+    }
     if (error.code === "ERR_NETWORK") {
       message = "Connection error";
     } else if (error.code === "ERR_CANCELED") {
       message = "Connection canceled";
     }
-    throw new ParaApiError(message, error.code, (_c = error.response) == null ? void 0 : _c.status, (_d = error.request) == null ? void 0 : _d.responseURL);
+    throw new ParaApiError(
+      message,
+      serverCode != null ? serverCode : error.code,
+      (_b = error.response) == null ? void 0 : _b.status,
+      (_c = error.request) == null ? void 0 : _c.responseURL,
+      serverData
+    );
   }
   throw new ParaApiError("Unknown error");
 };
@@ -48,8 +71,10 @@ class Client {
     opts,
     retrieveSessionCookie,
     persistSessionCookie,
-    partnerConfigOverride
+    partnerConfigOverride,
+    staticTraceContext
   }) {
+    this.inFlightFaucetRequests = /* @__PURE__ */ new Map();
     this.signUpOrLogIn = (body) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/users/init`, body);
       return res.data;
@@ -94,10 +119,11 @@ class Client {
       });
       return res.data;
     });
-    this.verifyAccount = (userId, body) => __async(this, null, function* () {
+    this.verifyAccount = (userId, body, traceCarrier) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(
         `/users/${userId}/verify`,
-        body
+        body,
+        traceCarrier ? { headers: traceCarrier } : void 0
       );
       return res.data;
     });
@@ -266,19 +292,17 @@ class Client {
       const res = yield this.baseRequest.post(`/users/${userId}/wallets`, body);
       return res.data;
     });
-    /** @deprecated Use the REST API (`POST /v1/wallets`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
+    // POST /wallets/pregen
     this.createPregenWallet = (body) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/wallets/pregen`, body);
       return res.data;
     });
-    /** @deprecated Use the REST API (`GET /v1/wallets`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     this.getPregenWallets = (pregenIds, isPortal = false, userId) => __async(this, null, function* () {
       const res = yield this.baseRequest.get("/wallets/pregen", {
         params: { ids: pregenIds, expand: isPortal, userId }
       });
       return res.data;
     });
-    /** @deprecated Use the REST API (`POST /v1/wallets`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     this.claimPregenWallets = (body) => __async(this, null, function* () {
       const res = yield this.baseRequest.post(`/wallets/pregen/claim`, body);
       return res.data;
@@ -295,12 +319,12 @@ class Client {
       return res;
     });
     // POST /users/:userId/wallets/:walletId/refresh
-    this.refreshKeys = (userId, walletId, oldPartnerId, newPartnerId, keyShareProtocolId) => __async(this, null, function* () {
-      const body = { oldPartnerId, newPartnerId, keyShareProtocolId };
+    this.refreshKeys = (userId, walletId, oldPartnerId, newPartnerId, keyShareProtocolId, useNewOT) => __async(this, null, function* () {
+      const body = { oldPartnerId, newPartnerId, keyShareProtocolId, useNewOT };
       const res = yield this.baseRequest.post(`/users/${userId}/wallets/${walletId}/refresh`, body);
       return res;
     });
-    /** @deprecated Use the REST API (`PATCH /v1/wallets/:id`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
+    // PATCH /wallets/pregen/:walletId
     this.updatePregenWallet = (walletId, body) => __async(this, null, function* () {
       const res = yield this.baseRequest.patch(`/wallets/pregen/${walletId}`, body);
       return res.data;
@@ -356,8 +380,8 @@ class Client {
       const res = yield this.baseRequest.post("/recovery", body);
       return res;
     });
-    this.preSignMessage = (userId, walletId, message, scheme, cosmosSignDoc, protocolId) => __async(this, null, function* () {
-      const body = { message, scheme, cosmosSignDoc, protocolId };
+    this.preSignMessage = (userId, walletId, message, scheme, cosmosSignDoc, protocolId, useNewOT) => __async(this, null, function* () {
+      const body = { message, scheme, cosmosSignDoc, protocolId, useNewOT };
       const res = yield this.baseRequest.post(`/users/${userId}/wallets/${walletId}/messages/sign`, body);
       return res.data;
     });
@@ -397,8 +421,14 @@ class Client {
       return res.data;
     });
     this.requestFaucet = (_0) => __async(this, [_0], function* ({ walletId, chain }) {
-      const res = yield this.baseRequest.post("/faucet", { walletId, chain });
-      return res.data;
+      const requestKey = `${walletId}:${chain != null ? chain : DEFAULT_FAUCET_CHAIN}`;
+      const inFlightRequest = this.inFlightFaucetRequests.get(requestKey);
+      if (inFlightRequest !== void 0) return yield inFlightRequest;
+      const request = this.baseRequest.post("/faucet", { walletId, chain }, DISABLE_AXIOS_RETRY_CONFIG).then((res) => res.data).finally(() => {
+        this.inFlightFaucetRequests.delete(requestKey);
+      });
+      this.inFlightFaucetRequests.set(requestKey, request);
+      return yield request;
     });
     this.issueJwt = (..._0) => __async(this, [..._0], function* ({ keyIndex = 0 } = {}) {
       const res = yield this.baseRequest.post(`/auth/jwt`, { keyIndex });
@@ -529,7 +559,12 @@ class Client {
       });
       return { success: res.data.success };
     });
-    const headers = __spreadValues(__spreadValues(__spreadValues({}, apiKey && { [API_KEY_HEADER_NAME]: apiKey }), partnerId && { [PARTNER_ID_HEADER_NAME]: partnerId }), partnerConfigOverride && { [PARTNER_CONFIG_OVERRIDE_HEADER_NAME]: JSON.stringify(partnerConfigOverride) });
+    const headers = __spreadProps(__spreadValues(__spreadValues(__spreadValues({}, apiKey && { [API_KEY_HEADER_NAME]: apiKey }), partnerId && { [PARTNER_ID_HEADER_NAME]: partnerId }), partnerConfigOverride && { [PARTNER_CONFIG_OVERRIDE_HEADER_NAME]: JSON.stringify(partnerConfigOverride) }), {
+      // Opts into structured-JSON error responses for OTP error classes (server-side
+      // contract added in @getpara/shared 1.16.0). Without it the server falls back to
+      // plain-text bodies for backward compat with older SDKs.
+      [STRUCTURED_ERRORS_HEADER]: "1"
+    });
     const axiosConfig = {
       baseURL: userManagementHost,
       withCredentials: true,
@@ -575,6 +610,19 @@ class Client {
       if (version) {
         config.headers.set(VERSION_HEADER_NAME, version);
       }
+      const g = globalThis;
+      const isBrowserMainThread = typeof g.window !== "undefined" && typeof g.WorkerGlobalScope === "undefined";
+      if (staticTraceContext) {
+        for (const [key, value] of Object.entries(staticTraceContext)) {
+          config.headers.set(key, value);
+        }
+      } else if (!isBrowserMainThread) {
+        propagation.inject(context.active(), config.headers, {
+          set: (carrier, key, value) => {
+            carrier.set(key, value);
+          }
+        });
+      }
       return config;
     });
     if (opts == null ? void 0 : opts.useFetchAdapter) {
@@ -676,7 +724,7 @@ class Client {
     return __async(this, null, function* () {
       var _f = _e, { userId } = _f, rest = __objRest(_f, ["userId"]);
       const res = yield this.baseRequest.post(`/users/${userId}/resend-verification-code`, rest);
-      return res;
+      return res.data;
     });
   }
   // POST '/users/:userId/resend-verification-code-by-phone

package/dist/esm/error.js

@@ -1,5 +1,5 @@
 import "./chunk-BBZEL7EG.js";
-function ParaApiError(message, code, status, responseURL) {
+function ParaApiError(message, code, status, responseURL, data) {
   Error.call(this);
   if (Error.captureStackTrace) {
     Error.captureStackTrace(this, this.constructor);
@@ -11,6 +11,7 @@ function ParaApiError(message, code, status, responseURL) {
   code && (this.code = code);
   status && (this.status = status);
   responseURL && (this.responseURL = responseURL);
+  data && (this.data = data);
 }
 const prototype = ParaApiError.prototype;
 Object.defineProperty(prototype, "isParaApiError", { value: true });

package/dist/types/client.d.ts

@@ -1,5 +1,5 @@
 import { AxiosError, AxiosResponse } from 'axios';
-import { AccountMetadata, Auth, AuthIdentifier, AuthMethod, BackupKitEmailProps, BiometricLocationHint, Chain, CurrentWalletIds, EncryptedKeyShare, EncryptorType, ExternalWalletInfo, LoginExternalWalletResponse, KeyShareType, Network, OnRampAsset, OnRampConfig, OnRampProvider, OnRampPurchase, OnRampPurchaseCreateParams, OnRampPurchaseUpdateParams, AuthMethodStatus, PregenIds, PrimaryAuth, PublicKeyType, ServerAuthStateSignup, SessionInfo, Setup2faResponse, SignUpOrLogInResponse, TelegramAuthResponse, TPregenIdentifierType, VerificationEmailProps, VerifiedAuth, VerifyFarcasterResponse, VerifyTelegramResponse, VerifyThirdPartyAuth, WalletEntity, WalletParams, TWalletScheme, TWalletType, VerifyExternalWalletParams, IssueJwtParams, IssueJwtResponse, LinkAccountParams, LinkedAccounts, ResendVerificationCodeParams, AssetMetadataIndexed, GetProfileBalanceParams, ProfileBalance, LegacyAuthMethod, PrimaryAuthInfo, ServerAuthStateLogin, ServerAuthStateDone, UserPreferences, EstimateTransactionOpts, EstimateTransactionResult, BroadcastTransactionOpts, BroadcastTransactionResult, TExternalWalletType, GetPendingTransactionResponse } from '@getpara/shared';
+import { AccountMetadata, Auth, AuthIdentifier, AuthMethod, BackupKitEmailProps, BiometricLocationHint, Chain, CurrentWalletIds, EncryptedKeyShare, EncryptorType, ExternalWalletInfo, LoginExternalWalletResponse, KeyShareType, Network, OnRampAsset, OnRampConfig, OnRampProvider, OnRampPurchase, OnRampPurchaseCreateParams, OnRampPurchaseUpdateParams, AuthMethodStatus, PregenIds, PrimaryAuth, PublicKeyType, ServerAuthStateSignup, SessionInfo, Setup2faResponse, SignUpOrLogInResponse, TelegramAuthResponse, TPregenIdentifierType, VerificationEmailProps, VerifiedAuth, VerifyFarcasterResponse, VerifyTelegramResponse, VerifyThirdPartyAuth, WalletEntity, WalletParams, TWalletScheme, TWalletType, VerifyExternalWalletParams, IssueJwtParams, IssueJwtResponse, LinkAccountParams, LinkedAccounts, ResendVerificationCodeParams, AssetMetadataIndexed, GetProfileBalanceParams, ProfileBalance, DeliveryChannel, LegacyAuthMethod, PrimaryAuthInfo, ServerAuthStateLogin, ServerAuthStateDone, UserPreferences, EstimateTransactionOpts, EstimateTransactionResult, BroadcastTransactionOpts, BroadcastTransactionResult, TExternalWalletType, GetPendingTransactionResponse } from '@getpara/shared';
 interface ConfigOpts {
     useFetchAdapter?: boolean;
 }
@@ -13,6 +13,15 @@ type ClientConfig = {
     persistSessionCookie?: (cookie: string) => void;
     /** E2E only: partner config overrides sent via X-Partner-Config-Override header. */
     partnerConfigOverride?: Record<string, unknown>;
+    /**
+     * Pre-captured W3C Trace Context headers (traceparent / tracestate) injected
+     * onto every outgoing request. Used by the MPC worker — it has no OTel SDK
+     * and no shared async context with the main thread, so the parent inject's
+     * carrier is passed across postMessage and threaded in here. main-thread
+     * callers leave this undefined and rely on the OTel-driven request
+     * interceptor that pulls from context.active().
+     */
+    staticTraceContext?: Record<string, string>;
 };
 interface createUserIdRes {
     protocolId: string;
@@ -94,6 +103,7 @@ interface RequestFaucetBody {
     chain?: string;
 }
 interface RequestFaucetRes {
+    /** Hash for the submitted faucet transaction. Wait for confirmation before assuming funds are spendable. */
     transactionHash: string;
     amount: string;
     chain: string;
@@ -115,12 +125,14 @@ interface signTransactionBody {
     transaction: string;
     chainId: string;
     protocolId?: string;
+    useNewOT?: boolean;
 }
 interface sendTransactionBody {
     transaction: string;
     chain?: Chain;
     chainId?: string;
     protocolId?: string;
+    useNewOT?: boolean;
 }
 interface AcceptScopesBody {
     scopeIds: string[];
@@ -158,7 +170,8 @@ export declare const handleResponseError: (error: any) => never;
 export declare const isRetryableError: (error: AxiosError) => boolean;
 declare class Client {
     private baseRequest;
-    constructor({ userManagementHost, apiKey, partnerId, version, opts, retrieveSessionCookie, persistSessionCookie, partnerConfigOverride, }: ClientConfig);
+    private inFlightFaucetRequests;
+    constructor({ userManagementHost, apiKey, partnerId, version, opts, retrieveSessionCookie, persistSessionCookie, partnerConfigOverride, staticTraceContext, }: ClientConfig);
     signUpOrLogIn: (body: VerifiedAuth & VerificationEmailProps) => Promise<SignUpOrLogInResponse>;
     /**
      * @deprecated
@@ -176,9 +189,13 @@ declare class Client {
         chainId?: string;
         uri?: string;
     }) => Promise<LoginExternalWalletResponse>;
-    verifyAccount: (userId: string, body: verifyBody) => Promise<ServerAuthStateSignup | ServerAuthStateLogin | ServerAuthStateDone>;
+    verifyAccount: (userId: string, body: verifyBody, traceCarrier?: Record<string, string>) => Promise<ServerAuthStateSignup | ServerAuthStateLogin | ServerAuthStateDone>;
     sendLoginVerificationCode: (auth: PrimaryAuthInfo, isRecovery?: boolean) => Promise<{
         userId: string;
+        deliveryChannel?: DeliveryChannel;
+        fallbackUsed?: boolean;
+        fallbackChannel?: DeliveryChannel;
+        isSmsAllowed?: boolean;
     }>;
     getLinkedAccounts: ({ userId, withMetadata, }: {
         userId: string;
@@ -253,20 +270,16 @@ declare class Client {
     getSessionChallenge: (userId: string) => Promise<any>;
     verifySessionChallenge: (userId: string, body: verifySessionChallengeBody) => Promise<any>;
     createWallet: (userId: string, body?: createWalletBody) => Promise<createWalletRes>;
-    /** @deprecated Use the REST API (`POST /v1/wallets`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     createPregenWallet: (body?: createPregenWalletBody) => Promise<createWalletRes>;
-    /** @deprecated Use the REST API (`GET /v1/wallets`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     getPregenWallets: (pregenIds: PregenIds, isPortal?: boolean, userId?: string) => Promise<{
         wallets: WalletEntity[];
     }>;
-    /** @deprecated Use the REST API (`POST /v1/wallets`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
     claimPregenWallets: (body?: claimPreGenWalletsBody) => Promise<{
         walletIds: string[];
     }>;
     sendTransaction: (userId: string, walletId: string, body: sendTransactionBody) => Promise<any>;
     signTransaction: (userId: string, walletId: string, body: signTransactionBody) => Promise<any>;
-    refreshKeys: (userId: string, walletId: string, oldPartnerId?: string, newPartnerId?: string, keyShareProtocolId?: string) => Promise<any>;
-    /** @deprecated Use the REST API (`PATCH /v1/wallets/:id`) instead. See https://docs.getpara.com/v2/rest/migrate-from-sdk-pregen */
+    refreshKeys: (userId: string, walletId: string, oldPartnerId?: string, newPartnerId?: string, keyShareProtocolId?: string, useNewOT?: boolean) => Promise<any>;
     updatePregenWallet: (walletId: string, body: updatePregenWalletBody) => Promise<any>;
     getWallets: (userId: string, includePartnerData?: boolean) => Promise<AxiosResponse<GetWalletsRes, any>>;
     getAllWallets: (userId: string) => Promise<AxiosResponse<GetWalletsRes, any>>;
@@ -278,7 +291,7 @@ declare class Client {
     logout: () => Promise<any>;
     recoveryVerification: (email: string, verificationCode: string) => Promise<any>;
     recoveryInit: (email: string) => Promise<any>;
-    preSignMessage: (userId: string, walletId: string, message: string, scheme?: TWalletScheme, cosmosSignDoc?: string, protocolId?: string) => Promise<any>;
+    preSignMessage: (userId: string, walletId: string, message: string, scheme?: TWalletScheme, cosmosSignDoc?: string, protocolId?: string, useNewOT?: boolean) => Promise<any>;
     deleteSelf: (userId: string) => Promise<any>;
     uploadKeyshares(userId: string, walletId: string, encryptedKeyshares: EncryptedKeyShare[]): Promise<any>;
     uploadUserKeyShares(userId: string, encryptedKeyshares: (EncryptedKeyShare & {
@@ -296,7 +309,12 @@ declare class Client {
     getTransmissionKeyshares(userId: string, sessionLookupId: string): Promise<any>;
     getParaShare: (userId: string, walletId: string) => Promise<string>;
     getBackupKit: (userId: string, walletId: string) => Promise<any>;
-    resendVerificationCode({ userId, ...rest }: ResendVerificationCodeParams): Promise<AxiosResponse<any, any>>;
+    resendVerificationCode({ userId, ...rest }: ResendVerificationCodeParams): Promise<{
+        deliveryChannel?: DeliveryChannel;
+        fallbackUsed?: boolean;
+        fallbackChannel?: DeliveryChannel;
+        isSmsAllowed?: boolean;
+    }>;
     resendVerificationCodeByPhone({ userId, ...rest }: {
         userId: string;
     } & VerificationEmailProps): Promise<AxiosResponse<any, any>>;

package/dist/types/error.d.ts

@@ -1 +1 @@
-export declare function ParaApiError(message: string, code?: string, status?: number, responseURL?: string): void;
+export declare function ParaApiError(message: string, code?: string, status?: number, responseURL?: string, data?: Record<string, unknown>): void;

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@getpara/user-management-client",
-  "version": "3.0.0-alpha.1",
+  "version": "3.1.0",
   "dependencies": {
-    "@getpara/shared": "^1.14.0",
+    "@getpara/shared": "^1.21.0",
+    "@opentelemetry/api": "^1.9.1",
     "axios": "^1.8.4",
     "axios-retry": "^4.5.0",
     "libphonenumber-js": "^1.11.7"
@@ -21,7 +22,7 @@
     "dist",
     "package.json"
   ],
-  "gitHead": "839d225579de67feb5be4da225d232290b2a2a04",
+  "gitHead": "e73f17cd7960fdfe62ff68a972b3461e47b21eb0",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "scripts": {