@pafi-dev/core 0.3.0-beta.0 → 0.3.0-beta.2

package/dist/index.d.cts

@@ -7,8 +7,8 @@ import { SimulationResult } from './relay/index.cjs';
 export { buildRelaySwapParams, decodeExtData, decodeMintAndSwap, encodeExtData, encodeMintAndSwap, simulateMintAndSwap } from './relay/index.cjs';
 export { getIssuer, getMintRequestNonce, getPointTokenBalance, getPointTokenIssuer, getPointTokenIssuerAddress, getReceiverConsentNonce, getTokenName, getUsdt, isActiveIssuer, isMinter, verifyMintCap } from './contract/index.cjs';
 export { buildAllPaths, combineRoutes, findBestQuote, quoteBestRoute, quoteExactInput, quoteExactInputSingle } from './quoting/index.cjs';
-import { SwapSimulationResult } from './swap/index.cjs';
-export { SETTLE_ALL, SWAP_EXACT_IN, TAKE_ALL, V4_SWAP, buildErc20ApprovalCalldata, buildPermit2ApprovalCalldata, buildSwapFromQuote, buildUniversalRouterExecuteArgs, buildV4SwapInput, checkAllowance, simulateSwap } from './swap/index.cjs';
+import { O as Operation, P as PartialUserOperation, U as UserOperation, S as SwapSimulationResult } from './index-BpUYHGu3.cjs';
+export { B as BuildSwapWithGasDeductionParams, E as ENTRY_POINT_V07, a as PaymasterFields, b as SETTLE_ALL, c as SWAP_EXACT_IN, T as TAKE_ALL, d as UserOpReceipt, V as V4_SWAP, Z as ZERO_VALUE, e as buildErc20ApprovalCalldata, f as buildPermit2ApprovalCalldata, g as buildSwapFromQuote, h as buildSwapWithGasDeduction, i as buildUniversalRouterExecuteArgs, j as buildV4SwapInput, k as checkAllowance, s as simulateSwap } from './index-BpUYHGu3.cjs';
 import { LoginMessageParams } from './auth/index.cjs';
 export { VerifyLoginResult, createLoginMessage, parseLoginMessage, verifyLoginMessage } from './auth/index.cjs';
 
@@ -74,74 +74,6 @@ declare class ApiError extends PafiSDKError {
     constructor(message: string, status?: number | undefined);
 }
 
-/**
- * ERC-4337 v0.7 EntryPoint standard address (deployed deterministically
- * at the same address across chains).
- * https://eips.ethereum.org/EIPS/eip-4337
- */
-declare const ENTRY_POINT_V07: Address;
-/**
- * A single call inside a batch. `BatchExecutor.execute(Call[])` iterates
- * and invokes each one. When the batch runs via EIP-7702 delegation,
- * `msg.sender` for each call is the user's EOA.
- */
-interface Operation {
-    target: Address;
-    value: bigint;
-    data: Hex;
-}
-/**
- * Paymaster fields attached to a UserOperation. Populated by the
- * Coinbase Paymaster (via PAFI Backend proxy) before the user signs.
- */
-interface PaymasterFields {
-    paymaster: Address;
-    paymasterData: Hex;
-    paymasterVerificationGasLimit: bigint;
-    paymasterPostOpGasLimit: bigint;
-}
-/**
- * Partial UserOp used during preparation — before paymaster fields are
- * attached or the user signs.
- */
-interface PartialUserOperation {
-    sender: Address;
-    nonce: bigint;
-    callData: Hex;
-    callGasLimit: bigint;
-    verificationGasLimit: bigint;
-    preVerificationGas: bigint;
-    maxFeePerGas: bigint;
-    maxPriorityFeePerGas: bigint;
-}
-/**
- * Full ERC-4337 v0.7 UserOperation, ready for bundler submission.
- */
-interface UserOperation extends PartialUserOperation {
-    paymaster: Address;
-    paymasterData: Hex;
-    paymasterVerificationGasLimit: bigint;
-    paymasterPostOpGasLimit: bigint;
-    signature: Hex;
-}
-/**
- * Receipt returned by a bundler after a UserOp lands on-chain.
- */
-interface UserOpReceipt {
-    userOpHash: Hex;
-    success: boolean;
-    txHash: Hex;
-    blockNumber: bigint;
-    gasUsed: bigint;
-    /** Effective gas cost paid (wei). */
-    actualGasCost: bigint;
-}
-/**
- * Sentinel operation value used in tests + docs when `Operation.value`
- * is irrelevant (ERC-20 transfers, for example).
- */
-declare const ZERO_VALUE = 0n;
-
 /**
  * Build an ERC-20 `transfer(to, amount)` operation. Used inside a batch
  * to move fee tokens from the user to the fee recipient atomically with
@@ -812,6 +744,188 @@ declare function buildMockBurnConsentTypedData(domain: PointTokenDomainConfig, m
 declare function signMockBurnConsent(walletClient: WalletClient, domain: PointTokenDomainConfig, message: MockBurnConsent): Promise<EIP712Signature>;
 declare function verifyMockBurnConsent(domain: PointTokenDomainConfig, message: MockBurnConsent, signature: Hex, expectedUser: Address): Promise<SignatureVerification>;
 
+/**
+ * Options for opening a PAFI Web modal — passed through by all adapters.
+ * Web-only fields (width/height/windowName) are ignored by mobile
+ * adapters that can't resize a system in-app browser.
+ */
+interface ModalOpenOptions {
+    /** Web popup pixel width. Default 900. Ignored on mobile. */
+    width?: number;
+    /** Web popup pixel height. Default 700. Ignored on mobile. */
+    height?: number;
+    /**
+     * `window.open()` target name. Same name across calls re-uses an
+     * already-open popup. Default: `"pafi-web"`. Web-only.
+     */
+    windowName?: string;
+    /**
+     * Called when the modal closes — either user-initiated (clicked
+     * close, swiped down on mobile) or programmatically via `handle.close()`.
+     */
+    onClose?: () => void;
+    /**
+     * Called when the opened window posts a message back to the parent
+     * via `window.opener.postMessage(data, origin)`. PAFI Web uses this
+     * to signal "swap complete" / "perp deposit complete" back to the
+     * issuer app without needing a redirect.
+     *
+     * `origin` is the posting window's origin — caller MUST verify it
+     * matches the expected PAFI Web host before trusting `data`.
+     */
+    onMessage?: (data: unknown, origin: string) => void;
+    /**
+     * Allowed origins for `onMessage` — messages from other origins are
+     * silently dropped. Pass the PAFI Web host(s), e.g.
+     * `["https://app.pacificfinance.org", "https://app-dev.pacificfinance.org"]`.
+     *
+     * Default: empty (all messages rejected). Set explicitly for security.
+     */
+    allowedOrigins?: string[];
+}
+/**
+ * Handle to an open PAFI Web modal. Methods are no-ops when the modal
+ * has already closed — safe to call without tracking state yourself.
+ */
+interface PafiWebModalHandle {
+    /** True when the modal is still open. */
+    readonly isOpen: boolean;
+    /** Close the modal. Fires `onClose` if the callback was supplied. */
+    close(): void;
+    /** Bring the modal to focus (web popup only; mobile ignores). */
+    focus(): void;
+    /**
+     * Post a message INTO the modal — useful for ping/pong handshakes
+     * with PAFI Web. The modal page must be on the same origin or
+     * explicitly listen for the message.
+     */
+    postMessage(data: unknown): void;
+}
+/**
+ * Adapter that knows how to open a URL in the right UX for the host
+ * platform. Callers register one via `setPafiWebModalAdapter()`; if
+ * none is registered, the core module falls back to `openWebPopup()`
+ * (if `window` is present) or throws (in Node / React Native without
+ * an adapter set).
+ *
+ * ## Mobile adapter example (React Native)
+ *
+ * ```ts
+ * import { setPafiWebModalAdapter } from '@pafi-dev/core';
+ * import InAppBrowser from 'react-native-inappbrowser-reborn';
+ *
+ * setPafiWebModalAdapter({
+ *   async open(url, options) {
+ *     const result = await InAppBrowser.open(url, {
+ *       // iOS: SFSafariViewController
+ *       dismissButtonStyle: 'close',
+ *       preferredBarTintColor: '#1a1a1a',
+ *       preferredControlTintColor: 'white',
+ *       // Android: Chrome Custom Tab
+ *       toolbarColor: '#1a1a1a',
+ *       secondaryToolbarColor: 'black',
+ *     });
+ *     options?.onClose?.();
+ *     return {
+ *       isOpen: false,
+ *       close: () => InAppBrowser.close(),
+ *       focus: () => {},
+ *       postMessage: () => {},
+ *     };
+ *   },
+ * });
+ * ```
+ *
+ * ## Expo adapter example
+ *
+ * ```ts
+ * import * as WebBrowser from 'expo-web-browser';
+ *
+ * setPafiWebModalAdapter({
+ *   async open(url, options) {
+ *     await WebBrowser.openBrowserAsync(url);
+ *     options?.onClose?.();
+ *     return { isOpen: false, close: WebBrowser.dismissBrowser, focus: () => {}, postMessage: () => {} };
+ *   },
+ * });
+ * ```
+ */
+interface PafiWebModalAdapter {
+    open(url: string, options?: ModalOpenOptions): PafiWebModalHandle | Promise<PafiWebModalHandle>;
+}
+
+/**
+ * Web browser popup adapter. Opens the given URL in a centered
+ * `window.open()` popup, polls for close, and optionally forwards
+ * `postMessage` events back to the caller.
+ *
+ * Runtime requirement: `window.open` must exist. Throws if called
+ * under Node / SSR / React Native — use `setPafiWebModalAdapter()` to
+ * provide a platform-specific adapter in those environments.
+ *
+ * ## Popup blocking
+ *
+ * Browsers block `window.open()` unless it happens inside a user
+ * gesture (click handler). Callers MUST wire this into a direct click
+ * handler — wrapping it in a `setTimeout` or async await before the
+ * open call will trigger the blocker.
+ */
+declare function openWebPopup(url: string, options?: ModalOpenOptions): PafiWebModalHandle;
+/**
+ * The web popup packaged as a {@link PafiWebModalAdapter} so callers
+ * can register it explicitly (e.g. in a test harness).
+ */
+declare const webPopupAdapter: PafiWebModalAdapter;
+
+/**
+ * Register the adapter used by `openPafiWebModal()`. Typically called
+ * once during app initialization — mobile apps register a
+ * SFSafariViewController / Chrome Custom Tabs adapter, desktop apps
+ * can leave it unset (web popup is the default).
+ *
+ * Pass `null` to unregister and fall back to the default.
+ */
+declare function setPafiWebModalAdapter(adapter: PafiWebModalAdapter | null): void;
+/**
+ * Return the currently registered adapter, or `null` when none is set.
+ * Useful for tests that want to snapshot-and-restore the adapter.
+ */
+declare function getPafiWebModalAdapter(): PafiWebModalAdapter | null;
+/**
+ * Open PAFI Web in the host platform's appropriate UX:
+ *
+ *   - Browser (window.open): centered popup, 900×700 by default
+ *   - React Native (with adapter registered): SFSafariViewController
+ *     / Chrome Custom Tabs via `react-native-inappbrowser-reborn` or
+ *     `expo-web-browser`
+ *   - Desktop (with adapter registered): custom BrowserWindow / new tab
+ *
+ * Resolution order:
+ *   1. If an adapter was registered via `setPafiWebModalAdapter()`, use it.
+ *   2. Else if `window.open` is available, use the built-in web popup.
+ *   3. Else throw with a clear error pointing at the adapter registry.
+ *
+ * @example
+ * ```ts
+ * // User clicks "Trade on PAFI" button
+ * button.addEventListener('click', async () => {
+ *   const modal = await openPafiWebModal('https://app.pacificfinance.org', {
+ *     allowedOrigins: ['https://app.pacificfinance.org'],
+ *     onMessage: (data, origin) => {
+ *       if (typeof data === 'object' && data && 'txHash' in data) {
+ *         console.log('Swap confirmed:', data.txHash);
+ *         modal.close();
+ *       }
+ *     },
+ *     onClose: () => {
+ *       console.log('User closed modal');
+ *     },
+ *   });
+ * });
+ * ```
+ */
+declare function openPafiWebModal(url: string, options?: ModalOpenOptions): Promise<PafiWebModalHandle>;
+
 declare class PafiSDK {
     private _pointTokenAddress?;
     private _relayContractAddress?;
@@ -974,4 +1088,4 @@ declare class PafiSDK {
     signLoginMessage(message: string): Promise<Hex>;
 }
 
-export { ApiError, BATCH_EXECUTOR_ABI, MOCK_BATCH_EXECUTOR_ADDRESS_BASE_MAINNET as BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, MOCK_BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA as BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, MOCK_BURN_CONSENT_TYPES as BURN_CONSENT_TYPES, BestQuote, type BuildPartialUserOpParams, type MockBurnConsent as BurnConsent, COMMON_POOLS, COMMON_TOKENS, MOCK_ADDRESSES as CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, EIP712Signature, ENTRY_POINT_V07, LoginMessageParams, MOCK_MINT_REQUEST_V2_TYPES as MINT_REQUEST_V2_TYPES, MintParams, MintRequest, type MockMintRequestV2 as MintRequestV2, type Operation, POINT_TOKEN_POOLS, MOCK_POINT_TOKEN_V2_ABI as POINT_TOKEN_V2_ABI, PafiSDK, PafiSDKConfig, PafiSDKError, type PartialUserOperation, PathKey, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, QuoteResult, MOCK_RELAYER_V2_ABI as RELAYER_V2_ABI, MOCK_RELAYER_V2_MINT_SELECTOR as RELAYER_V2_MINT_SELECTOR, ReceiverConsent, SUPPORTED_CHAINS, type MockSignatureStruct as SignatureStruct, SignatureVerification, SigningError, SimulationError, SimulationResult, type SponsorshipScenario, type SubmissionPath, SwapParams, SwapSimulationResult, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOperation, V4_QUOTER_ADDRESSES, ZERO_VALUE, _resetPaymasterConfigForTests, assembleUserOperation, buildMockBurnConsentTypedData as buildBurnConsentTypedData, buildMockMintRequestV2TypedData as buildMintRequestV2TypedData, buildPartialUserOperation, checkEthAndBranch, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, getMockAddresses as getContractAddresses, getPaymasterConfig, isPaymasterConfigured, mintRequestTypes, rawCallOp, receiverConsentTypes, setPaymasterConfig, signMockBurnConsent as signBurnConsent, signMockMintRequestV2 as signMintRequestV2, verifyMockBurnConsent as verifyBurnConsent, verifyMockMintRequestV2 as verifyMintRequestV2 };
+export { ApiError, BATCH_EXECUTOR_ABI, MOCK_BATCH_EXECUTOR_ADDRESS_BASE_MAINNET as BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, MOCK_BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA as BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, MOCK_BURN_CONSENT_TYPES as BURN_CONSENT_TYPES, BestQuote, type BuildPartialUserOpParams, type MockBurnConsent as BurnConsent, COMMON_POOLS, COMMON_TOKENS, MOCK_ADDRESSES as CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, EIP712Signature, LoginMessageParams, MOCK_MINT_REQUEST_V2_TYPES as MINT_REQUEST_V2_TYPES, MintParams, MintRequest, type MockMintRequestV2 as MintRequestV2, type ModalOpenOptions, Operation, POINT_TOKEN_POOLS, MOCK_POINT_TOKEN_V2_ABI as POINT_TOKEN_V2_ABI, PafiSDK, PafiSDKConfig, PafiSDKError, type PafiWebModalAdapter, type PafiWebModalHandle, PartialUserOperation, PathKey, type PaymasterConfig, PointTokenDomainConfig, PoolKey, QuoteResult, MOCK_RELAYER_V2_ABI as RELAYER_V2_ABI, MOCK_RELAYER_V2_MINT_SELECTOR as RELAYER_V2_MINT_SELECTOR, ReceiverConsent, SUPPORTED_CHAINS, type MockSignatureStruct as SignatureStruct, SignatureVerification, SigningError, SimulationError, SimulationResult, type SponsorshipScenario, type SubmissionPath, SwapParams, SwapSimulationResult, UNIVERSAL_ROUTER_ADDRESSES, UserOperation, V4_QUOTER_ADDRESSES, _resetPaymasterConfigForTests, assembleUserOperation, buildMockBurnConsentTypedData as buildBurnConsentTypedData, buildMockMintRequestV2TypedData as buildMintRequestV2TypedData, buildPartialUserOperation, checkEthAndBranch, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, getMockAddresses as getContractAddresses, getPafiWebModalAdapter, getPaymasterConfig, isPaymasterConfigured, mintRequestTypes, openPafiWebModal, openWebPopup, rawCallOp, receiverConsentTypes, setPafiWebModalAdapter, setPaymasterConfig, signMockBurnConsent as signBurnConsent, signMockMintRequestV2 as signMintRequestV2, verifyMockBurnConsent as verifyBurnConsent, verifyMockMintRequestV2 as verifyMintRequestV2, webPopupAdapter };

package/dist/index.d.ts

@@ -7,8 +7,8 @@ import { SimulationResult } from './relay/index.js';
 export { buildRelaySwapParams, decodeExtData, decodeMintAndSwap, encodeExtData, encodeMintAndSwap, simulateMintAndSwap } from './relay/index.js';
 export { getIssuer, getMintRequestNonce, getPointTokenBalance, getPointTokenIssuer, getPointTokenIssuerAddress, getReceiverConsentNonce, getTokenName, getUsdt, isActiveIssuer, isMinter, verifyMintCap } from './contract/index.js';
 export { buildAllPaths, combineRoutes, findBestQuote, quoteBestRoute, quoteExactInput, quoteExactInputSingle } from './quoting/index.js';
-import { SwapSimulationResult } from './swap/index.js';
-export { SETTLE_ALL, SWAP_EXACT_IN, TAKE_ALL, V4_SWAP, buildErc20ApprovalCalldata, buildPermit2ApprovalCalldata, buildSwapFromQuote, buildUniversalRouterExecuteArgs, buildV4SwapInput, checkAllowance, simulateSwap } from './swap/index.js';
+import { O as Operation, P as PartialUserOperation, U as UserOperation, S as SwapSimulationResult } from './index-CNALKsH1.js';
+export { B as BuildSwapWithGasDeductionParams, E as ENTRY_POINT_V07, a as PaymasterFields, b as SETTLE_ALL, c as SWAP_EXACT_IN, T as TAKE_ALL, d as UserOpReceipt, V as V4_SWAP, Z as ZERO_VALUE, e as buildErc20ApprovalCalldata, f as buildPermit2ApprovalCalldata, g as buildSwapFromQuote, h as buildSwapWithGasDeduction, i as buildUniversalRouterExecuteArgs, j as buildV4SwapInput, k as checkAllowance, s as simulateSwap } from './index-CNALKsH1.js';
 import { LoginMessageParams } from './auth/index.js';
 export { VerifyLoginResult, createLoginMessage, parseLoginMessage, verifyLoginMessage } from './auth/index.js';
 
@@ -74,74 +74,6 @@ declare class ApiError extends PafiSDKError {
     constructor(message: string, status?: number | undefined);
 }
 
-/**
- * ERC-4337 v0.7 EntryPoint standard address (deployed deterministically
- * at the same address across chains).
- * https://eips.ethereum.org/EIPS/eip-4337
- */
-declare const ENTRY_POINT_V07: Address;
-/**
- * A single call inside a batch. `BatchExecutor.execute(Call[])` iterates
- * and invokes each one. When the batch runs via EIP-7702 delegation,
- * `msg.sender` for each call is the user's EOA.
- */
-interface Operation {
-    target: Address;
-    value: bigint;
-    data: Hex;
-}
-/**
- * Paymaster fields attached to a UserOperation. Populated by the
- * Coinbase Paymaster (via PAFI Backend proxy) before the user signs.
- */
-interface PaymasterFields {
-    paymaster: Address;
-    paymasterData: Hex;
-    paymasterVerificationGasLimit: bigint;
-    paymasterPostOpGasLimit: bigint;
-}
-/**
- * Partial UserOp used during preparation — before paymaster fields are
- * attached or the user signs.
- */
-interface PartialUserOperation {
-    sender: Address;
-    nonce: bigint;
-    callData: Hex;
-    callGasLimit: bigint;
-    verificationGasLimit: bigint;
-    preVerificationGas: bigint;
-    maxFeePerGas: bigint;
-    maxPriorityFeePerGas: bigint;
-}
-/**
- * Full ERC-4337 v0.7 UserOperation, ready for bundler submission.
- */
-interface UserOperation extends PartialUserOperation {
-    paymaster: Address;
-    paymasterData: Hex;
-    paymasterVerificationGasLimit: bigint;
-    paymasterPostOpGasLimit: bigint;
-    signature: Hex;
-}
-/**
- * Receipt returned by a bundler after a UserOp lands on-chain.
- */
-interface UserOpReceipt {
-    userOpHash: Hex;
-    success: boolean;
-    txHash: Hex;
-    blockNumber: bigint;
-    gasUsed: bigint;
-    /** Effective gas cost paid (wei). */
-    actualGasCost: bigint;
-}
-/**
- * Sentinel operation value used in tests + docs when `Operation.value`
- * is irrelevant (ERC-20 transfers, for example).
- */
-declare const ZERO_VALUE = 0n;
-
 /**
  * Build an ERC-20 `transfer(to, amount)` operation. Used inside a batch
  * to move fee tokens from the user to the fee recipient atomically with
@@ -812,6 +744,188 @@ declare function buildMockBurnConsentTypedData(domain: PointTokenDomainConfig, m
 declare function signMockBurnConsent(walletClient: WalletClient, domain: PointTokenDomainConfig, message: MockBurnConsent): Promise<EIP712Signature>;
 declare function verifyMockBurnConsent(domain: PointTokenDomainConfig, message: MockBurnConsent, signature: Hex, expectedUser: Address): Promise<SignatureVerification>;
 
+/**
+ * Options for opening a PAFI Web modal — passed through by all adapters.
+ * Web-only fields (width/height/windowName) are ignored by mobile
+ * adapters that can't resize a system in-app browser.
+ */
+interface ModalOpenOptions {
+    /** Web popup pixel width. Default 900. Ignored on mobile. */
+    width?: number;
+    /** Web popup pixel height. Default 700. Ignored on mobile. */
+    height?: number;
+    /**
+     * `window.open()` target name. Same name across calls re-uses an
+     * already-open popup. Default: `"pafi-web"`. Web-only.
+     */
+    windowName?: string;
+    /**
+     * Called when the modal closes — either user-initiated (clicked
+     * close, swiped down on mobile) or programmatically via `handle.close()`.
+     */
+    onClose?: () => void;
+    /**
+     * Called when the opened window posts a message back to the parent
+     * via `window.opener.postMessage(data, origin)`. PAFI Web uses this
+     * to signal "swap complete" / "perp deposit complete" back to the
+     * issuer app without needing a redirect.
+     *
+     * `origin` is the posting window's origin — caller MUST verify it
+     * matches the expected PAFI Web host before trusting `data`.
+     */
+    onMessage?: (data: unknown, origin: string) => void;
+    /**
+     * Allowed origins for `onMessage` — messages from other origins are
+     * silently dropped. Pass the PAFI Web host(s), e.g.
+     * `["https://app.pacificfinance.org", "https://app-dev.pacificfinance.org"]`.
+     *
+     * Default: empty (all messages rejected). Set explicitly for security.
+     */
+    allowedOrigins?: string[];
+}
+/**
+ * Handle to an open PAFI Web modal. Methods are no-ops when the modal
+ * has already closed — safe to call without tracking state yourself.
+ */
+interface PafiWebModalHandle {
+    /** True when the modal is still open. */
+    readonly isOpen: boolean;
+    /** Close the modal. Fires `onClose` if the callback was supplied. */
+    close(): void;
+    /** Bring the modal to focus (web popup only; mobile ignores). */
+    focus(): void;
+    /**
+     * Post a message INTO the modal — useful for ping/pong handshakes
+     * with PAFI Web. The modal page must be on the same origin or
+     * explicitly listen for the message.
+     */
+    postMessage(data: unknown): void;
+}
+/**
+ * Adapter that knows how to open a URL in the right UX for the host
+ * platform. Callers register one via `setPafiWebModalAdapter()`; if
+ * none is registered, the core module falls back to `openWebPopup()`
+ * (if `window` is present) or throws (in Node / React Native without
+ * an adapter set).
+ *
+ * ## Mobile adapter example (React Native)
+ *
+ * ```ts
+ * import { setPafiWebModalAdapter } from '@pafi-dev/core';
+ * import InAppBrowser from 'react-native-inappbrowser-reborn';
+ *
+ * setPafiWebModalAdapter({
+ *   async open(url, options) {
+ *     const result = await InAppBrowser.open(url, {
+ *       // iOS: SFSafariViewController
+ *       dismissButtonStyle: 'close',
+ *       preferredBarTintColor: '#1a1a1a',
+ *       preferredControlTintColor: 'white',
+ *       // Android: Chrome Custom Tab
+ *       toolbarColor: '#1a1a1a',
+ *       secondaryToolbarColor: 'black',
+ *     });
+ *     options?.onClose?.();
+ *     return {
+ *       isOpen: false,
+ *       close: () => InAppBrowser.close(),
+ *       focus: () => {},
+ *       postMessage: () => {},
+ *     };
+ *   },
+ * });
+ * ```
+ *
+ * ## Expo adapter example
+ *
+ * ```ts
+ * import * as WebBrowser from 'expo-web-browser';
+ *
+ * setPafiWebModalAdapter({
+ *   async open(url, options) {
+ *     await WebBrowser.openBrowserAsync(url);
+ *     options?.onClose?.();
+ *     return { isOpen: false, close: WebBrowser.dismissBrowser, focus: () => {}, postMessage: () => {} };
+ *   },
+ * });
+ * ```
+ */
+interface PafiWebModalAdapter {
+    open(url: string, options?: ModalOpenOptions): PafiWebModalHandle | Promise<PafiWebModalHandle>;
+}
+
+/**
+ * Web browser popup adapter. Opens the given URL in a centered
+ * `window.open()` popup, polls for close, and optionally forwards
+ * `postMessage` events back to the caller.
+ *
+ * Runtime requirement: `window.open` must exist. Throws if called
+ * under Node / SSR / React Native — use `setPafiWebModalAdapter()` to
+ * provide a platform-specific adapter in those environments.
+ *
+ * ## Popup blocking
+ *
+ * Browsers block `window.open()` unless it happens inside a user
+ * gesture (click handler). Callers MUST wire this into a direct click
+ * handler — wrapping it in a `setTimeout` or async await before the
+ * open call will trigger the blocker.
+ */
+declare function openWebPopup(url: string, options?: ModalOpenOptions): PafiWebModalHandle;
+/**
+ * The web popup packaged as a {@link PafiWebModalAdapter} so callers
+ * can register it explicitly (e.g. in a test harness).
+ */
+declare const webPopupAdapter: PafiWebModalAdapter;
+
+/**
+ * Register the adapter used by `openPafiWebModal()`. Typically called
+ * once during app initialization — mobile apps register a
+ * SFSafariViewController / Chrome Custom Tabs adapter, desktop apps
+ * can leave it unset (web popup is the default).
+ *
+ * Pass `null` to unregister and fall back to the default.
+ */
+declare function setPafiWebModalAdapter(adapter: PafiWebModalAdapter | null): void;
+/**
+ * Return the currently registered adapter, or `null` when none is set.
+ * Useful for tests that want to snapshot-and-restore the adapter.
+ */
+declare function getPafiWebModalAdapter(): PafiWebModalAdapter | null;
+/**
+ * Open PAFI Web in the host platform's appropriate UX:
+ *
+ *   - Browser (window.open): centered popup, 900×700 by default
+ *   - React Native (with adapter registered): SFSafariViewController
+ *     / Chrome Custom Tabs via `react-native-inappbrowser-reborn` or
+ *     `expo-web-browser`
+ *   - Desktop (with adapter registered): custom BrowserWindow / new tab
+ *
+ * Resolution order:
+ *   1. If an adapter was registered via `setPafiWebModalAdapter()`, use it.
+ *   2. Else if `window.open` is available, use the built-in web popup.
+ *   3. Else throw with a clear error pointing at the adapter registry.
+ *
+ * @example
+ * ```ts
+ * // User clicks "Trade on PAFI" button
+ * button.addEventListener('click', async () => {
+ *   const modal = await openPafiWebModal('https://app.pacificfinance.org', {
+ *     allowedOrigins: ['https://app.pacificfinance.org'],
+ *     onMessage: (data, origin) => {
+ *       if (typeof data === 'object' && data && 'txHash' in data) {
+ *         console.log('Swap confirmed:', data.txHash);
+ *         modal.close();
+ *       }
+ *     },
+ *     onClose: () => {
+ *       console.log('User closed modal');
+ *     },
+ *   });
+ * });
+ * ```
+ */
+declare function openPafiWebModal(url: string, options?: ModalOpenOptions): Promise<PafiWebModalHandle>;
+
 declare class PafiSDK {
     private _pointTokenAddress?;
     private _relayContractAddress?;
@@ -974,4 +1088,4 @@ declare class PafiSDK {
     signLoginMessage(message: string): Promise<Hex>;
 }
 
-export { ApiError, BATCH_EXECUTOR_ABI, MOCK_BATCH_EXECUTOR_ADDRESS_BASE_MAINNET as BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, MOCK_BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA as BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, MOCK_BURN_CONSENT_TYPES as BURN_CONSENT_TYPES, BestQuote, type BuildPartialUserOpParams, type MockBurnConsent as BurnConsent, COMMON_POOLS, COMMON_TOKENS, MOCK_ADDRESSES as CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, EIP712Signature, ENTRY_POINT_V07, LoginMessageParams, MOCK_MINT_REQUEST_V2_TYPES as MINT_REQUEST_V2_TYPES, MintParams, MintRequest, type MockMintRequestV2 as MintRequestV2, type Operation, POINT_TOKEN_POOLS, MOCK_POINT_TOKEN_V2_ABI as POINT_TOKEN_V2_ABI, PafiSDK, PafiSDKConfig, PafiSDKError, type PartialUserOperation, PathKey, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, QuoteResult, MOCK_RELAYER_V2_ABI as RELAYER_V2_ABI, MOCK_RELAYER_V2_MINT_SELECTOR as RELAYER_V2_MINT_SELECTOR, ReceiverConsent, SUPPORTED_CHAINS, type MockSignatureStruct as SignatureStruct, SignatureVerification, SigningError, SimulationError, SimulationResult, type SponsorshipScenario, type SubmissionPath, SwapParams, SwapSimulationResult, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOperation, V4_QUOTER_ADDRESSES, ZERO_VALUE, _resetPaymasterConfigForTests, assembleUserOperation, buildMockBurnConsentTypedData as buildBurnConsentTypedData, buildMockMintRequestV2TypedData as buildMintRequestV2TypedData, buildPartialUserOperation, checkEthAndBranch, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, getMockAddresses as getContractAddresses, getPaymasterConfig, isPaymasterConfigured, mintRequestTypes, rawCallOp, receiverConsentTypes, setPaymasterConfig, signMockBurnConsent as signBurnConsent, signMockMintRequestV2 as signMintRequestV2, verifyMockBurnConsent as verifyBurnConsent, verifyMockMintRequestV2 as verifyMintRequestV2 };
+export { ApiError, BATCH_EXECUTOR_ABI, MOCK_BATCH_EXECUTOR_ADDRESS_BASE_MAINNET as BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, MOCK_BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA as BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, MOCK_BURN_CONSENT_TYPES as BURN_CONSENT_TYPES, BestQuote, type BuildPartialUserOpParams, type MockBurnConsent as BurnConsent, COMMON_POOLS, COMMON_TOKENS, MOCK_ADDRESSES as CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, EIP712Signature, LoginMessageParams, MOCK_MINT_REQUEST_V2_TYPES as MINT_REQUEST_V2_TYPES, MintParams, MintRequest, type MockMintRequestV2 as MintRequestV2, type ModalOpenOptions, Operation, POINT_TOKEN_POOLS, MOCK_POINT_TOKEN_V2_ABI as POINT_TOKEN_V2_ABI, PafiSDK, PafiSDKConfig, PafiSDKError, type PafiWebModalAdapter, type PafiWebModalHandle, PartialUserOperation, PathKey, type PaymasterConfig, PointTokenDomainConfig, PoolKey, QuoteResult, MOCK_RELAYER_V2_ABI as RELAYER_V2_ABI, MOCK_RELAYER_V2_MINT_SELECTOR as RELAYER_V2_MINT_SELECTOR, ReceiverConsent, SUPPORTED_CHAINS, type MockSignatureStruct as SignatureStruct, SignatureVerification, SigningError, SimulationError, SimulationResult, type SponsorshipScenario, type SubmissionPath, SwapParams, SwapSimulationResult, UNIVERSAL_ROUTER_ADDRESSES, UserOperation, V4_QUOTER_ADDRESSES, _resetPaymasterConfigForTests, assembleUserOperation, buildMockBurnConsentTypedData as buildBurnConsentTypedData, buildMockMintRequestV2TypedData as buildMintRequestV2TypedData, buildPartialUserOperation, checkEthAndBranch, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, getMockAddresses as getContractAddresses, getPafiWebModalAdapter, getPaymasterConfig, isPaymasterConfigured, mintRequestTypes, openPafiWebModal, openWebPopup, rawCallOp, receiverConsentTypes, setPafiWebModalAdapter, setPaymasterConfig, signMockBurnConsent as signBurnConsent, signMockMintRequestV2 as signMintRequestV2, verifyMockBurnConsent as verifyBurnConsent, verifyMockMintRequestV2 as verifyMintRequestV2, webPopupAdapter };