@coinlist-co/react 0.5.1 → 0.9.0

package/dist/shared/index.d.ts

@@ -1,5 +1,646 @@
-import { N as Newtype } from '../requirement-BEO42QOr.js';
-export { p as Asset, q as AssetCode, r as AssetId, A as AuthorizationCode, B as Blockchain, s as ClientId, o as ClientSecret, t as CodeChallenge, C as CodeVerifier, a as Config, i as CreateParticipationParams, u as Cursor, F as FaqItem, L as Link, M as Milestone, O as OAuthAccessToken, v as OAuthRefreshToken, n as OAuthSession, b as Offer, e as OfferDetail, d as OfferId, w as OfferOption, j as OfferOptionId, x as OfferOptionSlug, y as OfferSlug, c as PaginatedResponse, z as PaginatedResponseDto, P as PaginationParams, f as Participation, h as ParticipationId, D as ParticipationStatus, g as ParticipationsPaginationParams, E as RedirectUri, R as Requirement, G as RequirementId, k as RequirementStatusInfo, m as RequirementStatusValue, l as RequirementType, T as TermItem, W as WalletAddress, H as fetchAllPages } from '../requirement-BEO42QOr.js';
+import { B as Bps, U as Uint256, N as Newtype, a as EthereumChain, F as AssetDecimals, L as AssetSymbol, c as BlockchainAmount, E as EvmWalletAddress, b as EvmContractAddress, M as SwapStatus, Q as KnownAssetSymbol, z as Erc20Asset, G as StablecoinSymbol, T as ClientId, V as RedirectUri, X as CodeChallenge, Y as PKCEState, d as CodeVerifier } from '../requirement-C2w45Q11.js';
+export { Z as AllowWalletParams, _ as AllowWalletResponse, $ as Asset, a0 as AssetCode, a1 as AssetId, A as AuthorizationCode, a2 as Blockchain, I as ClientCredentialsOAuth, J as ClientSecret, C as CoinListSwapNamespace, e as Config, o as ConnectExternalWalletParams, m as CreateParticipationParams, n as CreateWalletOwnershipChallengeParams, a3 as Cursor, a4 as DocumentFormType, u as DocumentSubmission, a5 as DocumentSubmissionStatus, D as DocumentType, a6 as FaqItem, a7 as GetSwapAuthorizationParams, a8 as GetSwapPreviewParams, a9 as GetTokenAllowanceParams, aa as GetTokenBalanceParams, ab as HexEncodedTransactionData, ac as Iso2CountryCode, K as KycLevelName, v as KycToken, ad as Link, ae as MAX_UINT_256, af as Milestone, f as OAuthAccessToken, ag as OAuthRefreshToken, H as OAuthSession, g as Offer, i as OfferDetail, O as OfferId, ah as OfferOption, p as OfferOptionAddress, r as OfferOptionAddressId, q as OfferOptionId, ai as OfferOptionSlug, aj as OfferSlug, h as PaginatedResponse, ak as PaginatedResponseDto, P as PaginationParams, j as Participation, l as ParticipationId, al as ParticipationStatus, k as ParticipationsPaginationParams, t as Pii, am as PiiAddress, an as PiiJurisdiction, ao as PiiKind, R as Requirement, ap as RequirementActionNeededReason, aq as RequirementId, s as RequirementStatusInfo, y as RequirementStatusValue, x as RequirementType, ar as SwapAuthorization, as as SwapContractRef, S as SwapNamespaceImpl, at as SwapPreview, au as TermItem, av as TokenAllowance, aw as TokenBalance, ax as WalletAddress, w as WalletChallengeType, W as WalletOwnershipChallenge, ay as WalletProtocol, az as assertUint256, aA as fetchAllPages } from '../requirement-C2w45Q11.js';
+import { Hash, TransactionReceipt } from 'viem';
+import { S as SwapQuote } from '../collections-BQbFJS3g.js';
+export { N as NonEmptyArray } from '../collections-BQbFJS3g.js';
+
+/**
+ * Minimal ERC-20 ABI the SDK writes against (mirrors viem's `erc20Abi`). The
+ * swap flow uses `approve`; `allowance`/`balanceOf`/`decimals`/`symbol`/`name`
+ * are included so reads share a single SDK-owned ABI.
+ */
+declare const ERC20_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "approve";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "decimals";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "name";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "symbol";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalSupply";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly inputs: readonly [{
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferFrom";
+    readonly inputs: readonly [{
+        readonly name: "sender";
+        readonly type: "address";
+    }, {
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "event";
+    readonly name: "Approval";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Transfer";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}];
+
+declare const SUPERSTATE_SWAP_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "authorized";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "stopped";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "SWAP_LEVEL";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "preview";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct Preview";
+        readonly components: readonly [{
+            readonly name: "input";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "fee";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "output";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "swap";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "slip";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "tokenBalance";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "outputToken";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "outputTokenBalance";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totals";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct SwapTotal";
+        readonly components: readonly [{
+            readonly name: "inputSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "feeSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "outputSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "count";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totals";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct SwapTotal";
+        readonly components: readonly [{
+            readonly name: "inputSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "feeSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "outputSum";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "count";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setBps";
+    readonly inputs: readonly [{
+        readonly name: "points";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "event";
+    readonly name: "Swapped";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "inputToken";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "outputToken";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "inputAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "outputAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Transferred";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "error";
+    readonly name: "InvalidAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "SwapFailed";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}];
+
+/** Basis-point denominator: 10_000 bps = 100%. */
+declare const BPS_DENOM: Bps;
+/**
+ * Applies a basis-point fraction to an amount, flooring the result.
+ * `floor((amount × bps) / BPS_DENOM)`. The result is bounds-checked, so an
+ * overflow (bps far above BPS_DENOM) or a negative product is rejected.
+ */
+declare function applyBps(amount: Uint256, bps: Bps): Uint256;
+
+type FormattedAmountUi = Newtype<string, 'FormattedAmountUi'>;
+declare const FormattedAmountUi: (value: string) => FormattedAmountUi;
+type FormattedPercentUi = Newtype<string, 'FormattedPercentUi'>;
+declare const FormattedPercentUi: (value: string) => FormattedPercentUi;
+type TxExplorerUrl = Newtype<string, 'TxExplorerUrl'>;
+declare const TxExplorerUrl: (value: string) => TxExplorerUrl;
+/**
+ * A wallet address shortened for display (e.g. `0x1234…5678`). Keeps a
+ * `0x${string}` base but drops the runtime `0x` narrowing.
+ */
+type ShortenedWalletAddress = Newtype<`0x${string}`, 'ShortenedWalletAddress'>;
+declare const ShortenedWalletAddress: (value: string) => ShortenedWalletAddress;
+type FormattedAmountAssetUi = Newtype<string, 'FormattedAmountAssetUi'>;
+declare const FormattedAmountAssetUi: (value: string) => FormattedAmountAssetUi;
+type AssetIconUrl = Newtype<string, 'AssetIconUrl'>;
+declare const AssetIconUrl: (value: string) => AssetIconUrl;
+
+declare function getChainId(chain: EthereumChain): number;
+declare function getNetworkName(chain: EthereumChain): string;
+declare function txExplorerUrl(chain: EthereumChain, txHash: Hash): TxExplorerUrl;
+
+declare function shortenAddress(address: EvmWalletAddress): ShortenedWalletAddress;
+type FormatAmountOptions = {
+    maxFractionDigits?: AssetDecimals;
+};
+declare function formatAmount(amount: BlockchainAmount, locale: string, options?: FormatAmountOptions): FormattedAmountUi;
+declare function formatRawAmount(amount: BlockchainAmount): string;
+/**
+ * Formats a {@link BlockchainAmount} using compact notation (e.g. `1.37B`,
+ * `5M`). Compact notation only surfaces a couple of significant decimals, so
+ * the bigint → number narrowing here is intentional and safe: full precision
+ * is deliberately dropped in favour of a human-readable summary value.
+ */
+declare function formatCompactAmount(amount: BlockchainAmount, locale: string): FormattedAmountUi;
+declare function formatBpsAsPercent(bps: Bps, locale: string): FormattedPercentUi;
+declare function usdAmount(amount: FormattedAmountUi): FormattedAmountAssetUi;
+declare function assetAmount(amount: FormattedAmountUi, symbol: AssetSymbol): FormattedAmountAssetUi;
+/** Placeholder shown when an amount is unavailable (e.g. a loading quote). */
+declare const NA_AMOUNT_ASSET_UI: FormattedAmountAssetUi;
+/**
+ * Formats a USD amount capped at 2 fractional digits, falling back to the
+ * {@link NA_AMOUNT_ASSET_UI} placeholder when the amount is absent.
+ */
+declare function formattedUsdPrice(amount: BlockchainAmount | null, locale: string): FormattedAmountAssetUi;
+/** Formats a quote's implied price per output token as a USD amount. */
+declare function formattedPricePerShare(quote: SwapQuote | null, locale: string): FormattedAmountAssetUi;
+
+/** A typed, i18n-agnostic reason a raw amount string failed to parse. */
+type AmountParseErrorReason = {
+    type: 'empty';
+} | {
+    type: 'negative';
+} | {
+    type: 'invalid-format';
+} | {
+    type: 'too-many-decimals';
+    maxDecimals: AssetDecimals;
+};
+type AmountParseResult = {
+    valid: true;
+    amount: BlockchainAmount;
+} | {
+    valid: false;
+    reason: AmountParseErrorReason;
+};
+/**
+ * Parses a user-entered decimal string into a {@link BlockchainAmount} at the
+ * given token decimals. Rejects scientific notation, negatives, malformed
+ * input, and more fractional digits than the token supports — surfacing a
+ * typed {@link AmountParseErrorReason} so callers own the display copy.
+ */
+declare function parseBlockchainAmount(amount: string, decimals: AssetDecimals): AmountParseResult;
+
+declare const SUPERSTATE_TOS_URL = "https://superstate.com/terms";
+/** Poll interval for refreshing on-chain swap quotes and balances. */
+declare const SWAP_POLL_INTERVAL_MS = 15000;
+/**
+ * Notional input used to derive a display price-per-share when the user has
+ * not yet entered an amount (1 USDC at 6 decimals).
+ */
+declare const DEFAULT_AMOUNT_TO_COMPUTE_PRICE = 1000000n;
+/** Slippage tolerances offered in the review step, in basis points. */
+declare const SLIPPAGE_OPTIONS_BPS: Bps[];
+/** Default slippage tolerance (0.5%). */
+declare const DEFAULT_SLIPPAGE_BPS: Bps;
+/**
+ * The Superstate swap contract on Ethereum Sepolia. The mainnet address is not
+ * yet finalized upstream, so it is intentionally not exported — callers pass
+ * the contract address explicitly.
+ */
+declare const SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA: EvmContractAddress;
+
+/**
+ * Price of 1 output token in USD, assuming the input token is a $1 stablecoin.
+ *
+ * `raw_price = inputTokenAmount.raw × 10^outputDecimals ÷ outputTokenAmount.raw`
+ *
+ * The multiplication happens before the division so we never lose precision to
+ * integer truncation early. This mirrors standard fixed-point practice on-chain.
+ * Returned decimals match the input token decimals (always the stablecoin's 6).
+ */
+declare function computePrice({ inputTokenAmount, outputTokenAmount, }: SwapQuote): BlockchainAmount | null;
+/**
+ * Applies slippage to an amount, returning the minimum acceptable amount:
+ * `amount × (BPS_DENOM − slippage) / BPS_DENOM`. Throws when `slippage` exceeds
+ * `BPS_DENOM` (the retained fraction would be negative).
+ */
+declare function computeSlip(amount: BlockchainAmount, slippage: Bps): BlockchainAmount;
+
+/**
+ * Interprets the on-chain swap availability read from `stopped()` and
+ * `SWAP_LEVEL()`.
+ *
+ * The contract tracks paused operations as a bitmask in `stopped`. The swap is
+ * stopped when the SWAP_LEVEL flag is set:
+ *
+ *   (stopped & SWAP_LEVEL) != 0  ->  stopped (not active)
+ */
+declare function isStopped(status: SwapStatus): boolean;
+
+/**
+ * Decodes the confirmed output amount from the `Swapped` event in a swap
+ * transaction receipt.
+ *
+ * Returns `null` when the event is absent or the amount is not a valid uint256
+ * so callers can fall back to the quote's expected output — the swap already
+ * confirmed on-chain, so a missing/undecodable event should not fail the flow.
+ */
+declare function decodeSwappedOutputAmount(receipt: TransactionReceipt, outputDecimals: AssetDecimals): BlockchainAmount | null;
+
+declare const USDC_SYMBOL: StablecoinSymbol;
+declare const USDC: Erc20Asset;
+declare const USDT_SYMBOL: StablecoinSymbol;
+declare const USDT: Erc20Asset;
+/** Lookups for the stablecoins the SDK's swap flows support out of the box. */
+declare const TOKEN_REGISTRY: {
+    erc20: (symbol: KnownAssetSymbol) => Erc20Asset;
+    contractAddress: (symbol: KnownAssetSymbol, chain: EthereumChain) => EvmContractAddress;
+};
+
+type PKCEParams = {
+    clientId: ClientId;
+    responseType: 'code';
+    redirectUri: RedirectUri;
+    codeChallenge: CodeChallenge;
+    codeChallengeMethod: 'S256';
+    state: PKCEState;
+    codeVerifier: CodeVerifier;
+};
+type PKCEConfig = {
+    clientId: ClientId;
+    redirectUri: RedirectUri;
+};
+/**
+ * Generates PKCE parameters for an OAuth2 authorization code flow.
+ * Pure crypto — no React, no DOM beyond Web Crypto API. Safe to use
+ * in server-side code and Next.js middleware.
+ */
+declare function generatePKCEParams(config: PKCEConfig): Promise<PKCEParams>;
 
 /**
  * Error thrown when a feature or code path is not yet implemented.
@@ -32,4 +673,4 @@ declare const User: {
     fromDto: (dto: UserDto) => User;
 };
 
-export { NotAuthenticatedError, NotImplementedError, User, UserEmail, UserId };
+export { type AmountParseErrorReason, type AmountParseResult, AssetDecimals, AssetIconUrl, AssetSymbol, BPS_DENOM, BlockchainAmount, Bps, ClientId, CodeChallenge, CodeVerifier, DEFAULT_AMOUNT_TO_COMPUTE_PRICE, DEFAULT_SLIPPAGE_BPS, ERC20_ABI, Erc20Asset, EthereumChain, EvmContractAddress, EvmWalletAddress, type FormatAmountOptions, FormattedAmountAssetUi, FormattedAmountUi, FormattedPercentUi, KnownAssetSymbol, NA_AMOUNT_ASSET_UI, NotAuthenticatedError, NotImplementedError, type PKCEConfig, type PKCEParams, PKCEState, RedirectUri, SLIPPAGE_OPTIONS_BPS, SUPERSTATE_SWAP_ABI, SUPERSTATE_SWAP_CONTRACT_ADDRESS_SEPOLIA, SUPERSTATE_TOS_URL, SWAP_POLL_INTERVAL_MS, ShortenedWalletAddress, StablecoinSymbol, SwapQuote, SwapStatus, TOKEN_REGISTRY, TxExplorerUrl, USDC, USDC_SYMBOL, USDT, USDT_SYMBOL, Uint256, User, UserEmail, UserId, applyBps, assetAmount, computePrice, computeSlip, decodeSwappedOutputAmount, formatAmount, formatBpsAsPercent, formatCompactAmount, formatRawAmount, formattedPricePerShare, formattedUsdPrice, generatePKCEParams, getChainId, getNetworkName, isStopped, parseBlockchainAmount, shortenAddress, txExplorerUrl, usdAmount };