@portal-hq/web 3.13.2 → 3.14.0

package/lib/esm/mpc/index.js

@@ -11,7 +11,7 @@ import { PortalMpcError } from './errors';
 import { sdkLogger } from '../logger';
 import { BackupMethods, } from '../index';
 import { generateTraceId } from '../shared/trace';
-const WEB_SDK_VERSION = '3.13.2';
+const WEB_SDK_VERSION = '3.14.0';
 class Mpc {
     get ready() {
         return this._ready;
@@ -35,6 +35,8 @@ class Mpc {
                 mpcVersion: this.portal.mpcVersion,
                 featureFlags: this.portal.featureFlags,
                 logLevel: this.portal.getLogLevel(),
+                rpcConfig: this.portal.rpcConfig,
+                iframeRpcConfig: this.portal.iframeRpcConfig,
             };
             const message = {
                 type: 'portal:configure',
@@ -308,8 +310,18 @@ class Mpc {
             });
         });
     }
+    /**
+     * @deprecated This method is deprecated and will be removed in a future version.
+     * Please use `getTransactionHistory()` instead, which uses the new Portal v3 API
+     * endpoint and returns the unified transaction format across all chains.
+     */
     getTransactions(chainId, limit, offset, order) {
         return __awaiter(this, void 0, void 0, function* () {
+            // Log deprecation warning
+            sdkLogger.warn('[DEPRECATED] getTransactions() is deprecated and will be removed in a future version. ' +
+                'Please use getTransactionHistory() instead, which provides improved type safety with ' +
+                'discriminated unions for regular transactions and UserOperations, and proper polymorphic ' +
+                'response types for Solana vs unified formats.');
             return this.handleRequestToIframeAndPost({
                 methodMessage: 'portal:getTransactions',
                 errorMessage: 'portal:getTransactionsError',
@@ -323,6 +335,31 @@ class Mpc {
             });
         });
     }
+    /**
+     * Retrieves transaction history for the client's wallet on the specified chain.
+     *
+     * This method uses the new Portal v3 API endpoint and returns the unified
+     * transaction format. Supports EVM (EIP-155), Solana, Bitcoin, Tron, and Stellar chains.
+     *
+     * @param params - Request parameters
+     * @param params.chainId - Chain ID in CAIP-2 format (e.g., 'eip155:1', 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp')
+     * @param params.limit - Maximum number of transactions to return (default: 50)
+     * @param params.offset - Number of transactions to skip (default: 0)
+     * @param params.order - Sort order ('asc' or 'desc')
+     * @param params.address - Override wallet address (EVM only)
+     * @param params.userOperations - Filter for ERC-4337 UserOperations (EVM only)
+     * @returns Promise resolving to transaction history response
+     */
+    getTransactionHistory(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.handleRequestToIframeAndPost({
+                methodMessage: 'portal:getTransactionHistory',
+                errorMessage: 'portal:getTransactionHistoryError',
+                resultMessage: 'portal:getTransactionHistoryResult',
+                data: params,
+            });
+        });
+    }
     setBackupStatus(status, backupIds) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.handleRequestToIframeAndPost({
@@ -475,6 +512,26 @@ class Mpc {
             });
         });
     }
+    getYieldXyzDefaults(data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.handleRequestToIframeAndPost({
+                methodMessage: 'portal:yieldxyz:getDefaults',
+                errorMessage: 'portal:yieldxyz:getDefaultsError',
+                resultMessage: 'portal:yieldxyz:getDefaultsResult',
+                data: data !== null && data !== void 0 ? data : {},
+            });
+        });
+    }
+    getYieldXyzValidators(yieldId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.handleRequestToIframeAndPost({
+                methodMessage: 'portal:yieldxyz:getValidators',
+                errorMessage: 'portal:yieldxyz:getValidatorsError',
+                resultMessage: 'portal:yieldxyz:getValidatorsResult',
+                data: yieldId,
+            });
+        });
+    }
     getLifiRoutes(data) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.handleRequestToIframeAndPost({
@@ -950,6 +1007,65 @@ class Mpc {
             });
         });
     }
+    rpcRequest(data, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { timeoutMs = 30000, traceId } = options !== null && options !== void 0 ? options : {};
+            const requestId = typeof crypto !== 'undefined' && crypto.randomUUID
+                ? crypto.randomUUID()
+                : `${Date.now()}-${Math.random()}`;
+            const resolvedTraceId = traceId !== null && traceId !== void 0 ? traceId : generateTraceId();
+            sdkLogger.debug('[Portal] rpcRequest', {
+                requestId,
+                method: data.method,
+                chainId: data.chainId,
+                traceId: resolvedTraceId,
+                timeoutMs,
+            });
+            return new Promise((resolve, reject) => {
+                let timeoutId;
+                const cleanup = () => {
+                    window.removeEventListener('message', handleResponse);
+                    if (timeoutId !== undefined) {
+                        clearTimeout(timeoutId);
+                    }
+                };
+                const handleResponse = (event) => {
+                    var _a;
+                    const { origin } = event;
+                    if (origin !== this.getOrigin())
+                        return;
+                    const { type, data: result } = event.data;
+                    if (type === 'portal:rpc:requestResult' &&
+                        (result === null || result === void 0 ? void 0 : result.requestId) === requestId) {
+                        cleanup();
+                        resolve(result);
+                    }
+                    else if (type === 'portal:rpc:requestError' &&
+                        (result === null || result === void 0 ? void 0 : result.requestId) === requestId) {
+                        cleanup();
+                        reject(new Error((_a = result.message) !== null && _a !== void 0 ? _a : 'RPC proxy error'));
+                    }
+                };
+                timeoutId = setTimeout(() => {
+                    cleanup();
+                    const msg = `RPC request ${requestId} (${data.method}) timed out after ${timeoutMs}ms`;
+                    sdkLogger.error('[Portal] rpcRequest timeout', {
+                        requestId,
+                        method: data.method,
+                        chainId: data.chainId,
+                        timeoutMs,
+                    });
+                    reject(new Error(msg));
+                }, timeoutMs);
+                window.addEventListener('message', handleResponse);
+                this.postMessage({
+                    type: 'portal:rpc:request',
+                    data: Object.assign(Object.assign({}, data), { requestId }),
+                    traceId: resolvedTraceId,
+                });
+            });
+        });
+    }
     postMessage(event) {
         var _a, _b;
         (_b = (_a = this.iframe) === null || _a === void 0 ? void 0 : _a.contentWindow) === null || _b === void 0 ? void 0 : _b.postMessage(event, this.getOrigin());

package/lib/esm/provider/index.js

@@ -149,6 +149,11 @@ const signerMethods = [
     RequestMethod.sol_signMessage,
     RequestMethod.sol_signTransaction,
 ];
+const iframeProxiedMethodStrings = [
+    'eth_getTransactionReceipt',
+    'eth_getUserOperationReceipt',
+    'getSignatureStatuses',
+];
 class Provider {
     constructor({ portal, chainId }) {
         this.enforceEip155ChainId = (chainId) => {
@@ -384,6 +389,18 @@ class Provider {
      */
     handleGatewayRequest({ chainId, method, params, traceId, }) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (iframeProxiedMethodStrings.includes(method)) {
+                sdkLogger.info(`[PortalProvider] routing ${method} through iframe (chainId=${String(chainId)})`, { traceId });
+                return this.portal.mpc.rpcRequest({
+                    method,
+                    params: Array.isArray(params)
+                        ? params
+                        : params != null
+                            ? [params]
+                            : [],
+                    chainId: chainId,
+                }, { traceId });
+            }
             const requestBody = {
                 body: JSON.stringify({
                     jsonrpc: '2.0',

package/lib/esm/shared/trace/index.js

@@ -1,6 +1,5 @@
 /**
  * Request tracing for Portal API calls.
- * Aligns with portal-react-native X-Portal-Trace-Id / traceId behavior.
  *
  * Propagation in the Web SDK:
  * - Browser: High-level methods (backup, recover, sendAsset, provider.request) accept optional

package/noah-types.d.ts

@@ -1,11 +1,23 @@
 export type {
-  NoahAmountConditionRow,
+  AccountHolderDetails,
+  AmountCondition,
+  BankDetails,
+  BankToAddressRelatedPaymentMethod,
+  Channel,
+  ChannelCalculated,
+  ChannelLimits,
+  DepositSourceTriggerCondition,
+  FormNextStep,
+  IssuerDetails,
   NoahGetPaymentMethodsResponse,
   NoahGetPaymentMethodsResponseData,
   NoahGetPayoutChannelFormResponse,
+  NoahGetPayoutChannelFormResponseData,
   NoahGetPayoutChannelsRequest,
   NoahGetPayoutChannelsResponse,
+  NoahGetPayoutChannelsResponseData,
   NoahGetPayoutCountriesResponse,
+  NoahGetPayoutCountriesResponseData,
   NoahGetPayoutQuoteRequest,
   NoahGetPayoutQuoteResponse,
   NoahGetPayoutQuoteResponseData,
@@ -18,11 +30,13 @@ export type {
   NoahInitiatePayoutRequest,
   NoahInitiatePayoutResponse,
   NoahInitiatePayoutResponseData,
-  NoahPayoutConditionBlock,
   NoahSingleOnchainDepositSourceTriggerInput,
   NoahSimulatePayinRequest,
   NoahSimulatePayinResponse,
   NoahSimulatePayinResponseData,
   NoahSolanaCaipId,
+  PaymentMethod,
+  PaymentMethodDetails,
   PortalApiSuccessEnvelope,
+  StreetAddress,
 } from './src/shared/types/noah'

package/package.json

@@ -3,7 +3,7 @@
   "description": "Portal MPC Support for Web",
   "author": "Portal Labs, Inc.",
   "homepage": "https://portalhq.io/",
-  "version": "3.13.2",
+  "version": "3.14.0",
   "license": "MIT",
   "main": "lib/commonjs/index",
   "module": "lib/esm/index",

package/src/index.test.ts

@@ -1138,5 +1138,20 @@ describe('Portal', () => {
         ),
       )
     })
+
+    it('should use rpcConfig for getRpcUrl when iframeRpcConfig is also set', () => {
+      const iframeRpcConfig = {
+        'eip155:1': 'http://localhost:9999/rpc/v1/eip155/1',
+      }
+      portal = new Portal({
+        rpcConfig: mockRpcConfig,
+        iframeRpcConfig,
+      })
+      portal.mpc = mpcMock
+      portal.provider = providerMock
+
+      expect(portal.getRpcUrl('eip155:1')).toEqual(mockEthRpcUrl)
+      expect(portal.iframeRpcConfig).toEqual(iframeRpcConfig)
+    })
   })
 })

package/src/index.ts

@@ -16,6 +16,8 @@ import {
   NFTAsset,
   OrgBackupShares,
   SendAssetParams,
+  GetTransactionHistoryParams,
+  GetTransactionHistoryResponse,
   type BackupConfigs,
   type BackupResponse,
   type Balance,
@@ -58,6 +60,8 @@ import PasskeyService from './passkeys'
 import { EvmAccountType } from './namespaces/evmAccountType'
 import { sdkLogger } from './logger'
 import { generateTraceId } from './shared/trace'
+import { waitForEvmOrUserOpConfirmation } from './internal/waitForEvmOrUserOpConfirmation'
+import { waitForSolanaTxConfirmation } from './internal/waitForSolanaTxConfirmation'
 import type { LogLevel, ILogger } from '../types'
 
 class Portal {
@@ -82,7 +86,8 @@ class Portal {
   public featureFlags: FeatureFlags
 
   private errorCallbacks: ((reason: string) => any | Promise<any>)[] = []
-  private rpcConfig: RpcConfig
+  private _rpcConfig: RpcConfig
+  private _iframeRpcConfig?: RpcConfig
   private readyCallbacks: (() => any | Promise<any>)[] = []
   private passkeyService?: PasskeyService
   private passkeyServiceDefaultDomain?: string
@@ -92,11 +97,20 @@ class Portal {
     return this.mpc.ready
   }
 
+  public get rpcConfig(): RpcConfig {
+    return this._rpcConfig
+  }
+
+  public get iframeRpcConfig(): RpcConfig | undefined {
+    return this._iframeRpcConfig
+  }
+
   constructor({
     // Required
     rpcConfig,
 
     // Optional
+    iframeRpcConfig,
     apiKey,
     authToken,
     authUrl,
@@ -115,7 +129,8 @@ class Portal {
     this.authToken = authToken
     this.authUrl = authUrl
     this.autoApprove = autoApprove
-    this.rpcConfig = rpcConfig
+    this._rpcConfig = rpcConfig
+    this._iframeRpcConfig = iframeRpcConfig
     this.host = host
     this.mpcHost = mpcHost
     this.mpcVersion = mpcVersion
@@ -136,21 +151,58 @@ class Portal {
       portal: this,
     })
 
-    this.yield = new Yield({ mpc: this.mpc })
-
     this.ramps = new Ramps({ mpc: this.mpc })
 
-    this.trading = new Trading({ mpc: this.mpc })
-
     this.security = new Security({ mpc: this.mpc })
 
-    this.delegations = new Delegations({ mpc: this.mpc })
-
     this.provider = new Provider({
       portal: this,
       chainId: chainId ? Number(chainId) : undefined,
     })
 
+    const signAndSendTransaction = async (
+      transaction: unknown,
+      network: string,
+    ): Promise<string> => {
+      const method = network.startsWith('solana')
+        ? RequestMethod.sol_signAndSendTransaction
+        : RequestMethod.eth_sendTransaction
+      const hash = await this.provider.request({
+        chainId: network,
+        method,
+        params: [transaction],
+      })
+      if (typeof hash !== 'string' || hash.length === 0) {
+        throw new Error(
+          '[Portal] Signing request did not return a transaction hash. The user may have rejected the request, or the provider did not complete signing.',
+        )
+      }
+      return hash
+    }
+
+    const evmRequestFn = (method: string, params: unknown[], network: string) =>
+      this.provider.request({ chainId: network, method, params })
+
+    this.yield = new Yield({
+      mpc: this.mpc,
+      waitForConfirmation: this.waitForConfirmation.bind(this),
+      evmRequestFn,
+    })
+
+    this.trading = new Trading({
+      mpc: this.mpc,
+      signAndSendTransaction,
+      waitForConfirmation: this.waitForConfirmation.bind(this),
+      evmRequestFn,
+    })
+
+    this.yield.yieldXyz.setSignAndSendTransaction(signAndSendTransaction)
+
+    this.delegations = new Delegations({
+      mpc: this.mpc,
+      signAndSendTransaction,
+    })
+
     this.evmAccountType = new EvmAccountType({ mpc: this.mpc })
   }
 
@@ -690,6 +742,62 @@ class Portal {
     }
   }
 
+  /**
+   * Wait until a transaction is confirmed on-chain, or until timeout.
+   *
+   * - **EVM (`eip155:*`):** Polls both `eth_getTransactionReceipt` and
+   *   `eth_getUserOperationReceipt` (auto-detect, locks after first hit).
+   * - **Solana (`solana:*`):** Polls `getSignatureStatuses` until the
+   *   commitment level from `options.commitment`
+   *   is met (default `confirmed`).
+   * - **Other networks:** Returns `false` (unsupported for polling).
+   *
+   * Optional `options` tune poll/timeout for all polled chains; EVM also accepts
+   * `onTimeout` (default `resolve_false`) and `lockModeAfterDetection` (default `true`) for dual-receipt polling and timeout handling.
+   *
+   * All RPC calls are routed through the iframe proxy to avoid CORS issues.
+   */
+  public async waitForConfirmation(
+    txHash: string,
+    network: string,
+    options?: {
+      pollIntervalMs?: number
+      timeoutMs?: number
+      /** EVM / dual-mode only. @default 'resolve_false' */
+      onTimeout?: 'resolve_false' | 'throw'
+      /** EVM / dual-mode only. @default true */
+      lockModeAfterDetection?: boolean
+      /** Solana only. @default 'confirmed' */
+      commitment?: 'processed' | 'confirmed' | 'finalized'
+    },
+  ): Promise<boolean> {
+    const requestFn = (method: string, params: unknown[], chainId: string) =>
+      this.provider.request({ chainId, method, params })
+
+    if (network.startsWith('eip155:')) {
+      return waitForEvmOrUserOpConfirmation(txHash, network, requestFn, {
+        pollIntervalMs: options?.pollIntervalMs ?? 4_000,
+        timeoutMs: options?.timeoutMs ?? 900_000,
+        onTimeout: options?.onTimeout ?? 'resolve_false',
+        lockModeAfterDetection: options?.lockModeAfterDetection ?? true,
+      })
+    }
+
+    if (network.toLowerCase().startsWith('solana:')) {
+      return waitForSolanaTxConfirmation(txHash, network, requestFn, {
+        pollIntervalMs: options?.pollIntervalMs ?? 4_000,
+        timeoutMs: options?.timeoutMs ?? 900_000,
+        commitment: options?.commitment ?? 'confirmed',
+      })
+    }
+
+    sdkLogger.warn(
+      `[Portal.waitForConfirmation] Unsupported network: "${network}". Returning false (cannot verify confirmation).`,
+      { txHash, network },
+    )
+    return false
+  }
+
   /****************************
    * Provider Methods
    ****************************/
@@ -1054,6 +1162,14 @@ class Portal {
     return this.mpc?.getNFTs(chainId)
   }
 
+  /**
+   * @deprecated This method is deprecated and will be removed in a future version.
+   * Please use `getTransactionHistory()` instead, which uses the new Portal v3 API
+   * endpoint and returns the unified transaction format across all chains.
+   * 
+   * Legacy endpoint: /api/v3/clients/me/transactions?chainId={chainId}
+   * New endpoint: /api/v3/clients/me/chains/{chain}/transactions
+   */
   public async getTransactions(
     chainId: string,
     limit?: number,
@@ -1063,6 +1179,43 @@ class Portal {
     return this.mpc?.getTransactions(chainId, limit, offset, order)
   }
 
+  /**
+   * Retrieves transaction history for the client's wallet on the specified chain.
+   * 
+   * This method uses the new Portal v3 API endpoint and returns the unified
+   * transaction format. Supports EVM (EIP-155), Solana, Bitcoin, Tron, and Stellar chains.
+   * 
+   * Response format varies by chain:
+   * - Solana returns the legacy format (will be migrated in a future release)
+   * - All other chains return the unified TransactionHistoryItem format
+   * 
+   * @param params - Request parameters
+   * @param params.chainId - Chain ID in CAIP-2 format (e.g., 'eip155:1', 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp')
+   * @param params.limit - Maximum number of transactions to return (default: 50, max: 1000 for EVM, 15 for Solana)
+   * @param params.offset - Number of transactions to skip (default: 0)
+   * @param params.order - Sort order ('asc' or 'desc')
+   * @param params.address - Override wallet address (EVM only, must match client's known addresses)
+   * @param params.userOperations - Filter for ERC-4337 UserOperations (EVM only): 'include', 'only', or 'exclude'
+   * @returns Promise resolving to transaction history response
+   * 
+   * @example
+   * ```typescript
+   * // Fetch latest 100 transactions for Ethereum mainnet
+   * const response = await portal.getTransactionHistory({
+   *   chainId: 'eip155:1',
+   *   limit: 100,
+   *   order: 'desc'
+   * });
+   * 
+   * console.log(response.data.transactions); // Array of TransactionHistoryItem
+   * ```
+   */
+  public async getTransactionHistory(
+    params: GetTransactionHistoryParams,
+  ): Promise<GetTransactionHistoryResponse> {
+    return this.mpc?.getTransactionHistory(params)
+  }
+
   /**
    * @deprecated This method is deprecated. Use `portal.evaluateTransaction` instead.
    */
@@ -1150,16 +1303,14 @@ class Portal {
       )
     }
 
-    // Ensure the chainId is configured in the rpcConfig.
     // eslint-disable-next-line no-prototype-builtins
-    if (!this.rpcConfig.hasOwnProperty(chainId)) {
+    if (!this._rpcConfig.hasOwnProperty(chainId)) {
       throw new Error(
         `[Portal] No RPC endpoint configured for chainId: ${chainId}`,
       )
     }
 
-    // Derive the RPC endpoint from the rpcConfig.
-    const gatewayUrl = this.rpcConfig[chainId]
+    const gatewayUrl = this._rpcConfig[chainId]
 
     // If the RPC endpoint is a string, return it as-is.
     if (typeof gatewayUrl === 'string') {
@@ -1307,6 +1458,13 @@ class Portal {
   }
 }
 
+export type {
+  IDelegations,
+  IPortalDelegationsApi,
+  DelegationsOptions,
+  DelegationSubmitOptions,
+} from './integrations/delegations'
+
 export {
   type YieldXyzEnterRequest,
   type YieldXyzEnterYieldResponse,
@@ -1324,6 +1482,22 @@ export {
   type YieldXyzManageYieldResponse,
   type YieldXyzTrackTransactionRequest,
   type YieldXyzTrackTransactionResponse,
+  type YieldXyzGetYieldDefaultsRequest,
+  type YieldXyzGetYieldDefaultsResponse,
+  type YieldXyzGetYieldValidatorsResponse,
+  type YieldDepositParams,
+  type YieldDepositResult,
+  type YieldSubmitOptions,
+  type YieldSubmitProgress,
+  type YieldWithdrawParams,
+  type YieldWithdrawResult,
+  type LifiTradeAssetParams,
+  type LifiTradeAssetOptions,
+  type LifiTradeAssetResult,
+  type LifiPollStatusOptions,
+  type ZeroXTradeAssetParams,
+  type ZeroXTradeAssetOptions,
+  type ZeroXTradeAssetResult,
   type ApproveDelegationRequest,
   type ApproveDelegationResponse,
   type RevokeDelegationRequest,
@@ -1332,6 +1506,7 @@ export {
   type DelegationStatusResponse,
   type TransferFromRequest,
   type TransferFromResponse,
+  type DelegationSubmitProgress,
   type EvmAccountTypeGetStatusRequest,
   type EvmAccountTypeGetStatusResponse,
   type BuildAuthorizationListRequest,
@@ -1341,16 +1516,23 @@ export {
   type UpgradeTo7702Request,
   type UpgradeTo7702Response,
   type GetAddressesResponse,
+  type GetTransactionHistoryParams,
+  type GetTransactionHistoryResponse,
+  type TransactionHistoryItem,
+  type SolanaTransactionDetails,
+  type Transaction,
 } from './shared/types'
 
 export type {
-  NoahAmountConditionRow,
   NoahGetPaymentMethodsResponse,
   NoahGetPaymentMethodsResponseData,
   NoahGetPayoutChannelFormResponse,
+  NoahGetPayoutChannelFormResponseData,
   NoahGetPayoutChannelsRequest,
   NoahGetPayoutChannelsResponse,
+  NoahGetPayoutChannelsResponseData,
   NoahGetPayoutCountriesResponse,
+  NoahGetPayoutCountriesResponseData,
   NoahGetPayoutQuoteRequest,
   NoahGetPayoutQuoteResponse,
   NoahGetPayoutQuoteResponseData,
@@ -1363,7 +1545,6 @@ export type {
   NoahInitiatePayoutRequest,
   NoahInitiatePayoutResponse,
   NoahInitiatePayoutResponseData,
-  NoahPayoutConditionBlock,
   NoahSingleOnchainDepositSourceTriggerInput,
   NoahSimulatePayinRequest,
   NoahSimulatePayinResponse,
@@ -1372,6 +1553,14 @@ export type {
   PortalApiSuccessEnvelope,
 } from './shared/types'
 
+export type {
+  TradingOptions,
+  LifiOptions,
+  ZeroXOptions,
+  ILiFi,
+  IZeroX,
+} from './integrations/trading'
+
 export { MpcError, MpcErrorCodes } from './mpc'
 
 export { PortalMpcError } from './mpc/errors'