@stableflow/core 3.1.0 → 3.1.1-beta-0b82f1112c-20260722

package/README.md

@@ -25,10 +25,23 @@ For full cross-chain bridge flows (multi-route quote, send, status), use [`@stab
 | Models | `QuoteRequest`, `QuoteResponse`, `TokenResponse`, `TokenConfig`, `WalletConfig`, … |
 | Token / chain config | `tokens`, `usdtChains`, `usdcChains`, `frxusdChains`, `usdt0Chains` |
 | RPC | `setRpcUrls`, `getRpcUrls`, `getChainRpcUrl`, `NetworkRpcUrlsMap` |
+| Token prices | `getPrices`, `fetchPrices`, `PriceApiConfig`, `setPriceCacheTtl` |
+| Swap type | `OneClickSwapType` |
 | Utilities | `numberRemoveEndZero`, `getRouteStatus`, `getPrice`, `Csl`, `ExecTime`, … |
 
 See `dist/index.d.ts` after running `pnpm build`.
 
+## Token prices
+
+The SDK fetches trusted token USD prices internally (from
+`https://api.dapdap.net/get-token-price-by-dapdap`) and uses them for fee and
+gas-cost estimation, so integrators do not pass a `prices` map. `getPrices()`
+returns an in-memory cached map (TTL `PriceApiConfig.CACHE_TTL`, default 60s)
+and throws when prices are unavailable, so quotes are never computed with
+missing/untrusted prices. The endpoint is fixed and not user-configurable; use
+`setPriceCacheTtl` to tune the cache TTL, and `fetchPrices()` for an uncached
+network fetch.
+
 ## Authentication
 
 Required for API access:

package/dist/index.d.mts

@@ -91,7 +91,22 @@ declare enum SendType {
 /**
  * @deprecated Please use Service instead
  */
-type ServiceType = "oneclick" | "usdt0" | "cctp" | "fraxzero" | "fraxzero-oneclick" | "oneclick-fraxzero" | "usdt0-oneclick" | "oneclick-usdt0" | "native";
+type ServiceType = "oneclick" | "usdt0" | "cctp" | "fraxzero" | "fraxzero-oneclick" | "oneclick-fraxzero" | "usdt0-oneclick" | "oneclick-usdt0" | "cctp-oneclick" | "oneclick-cctp" | "native";
+/**
+ * OneClick swap type. Controls how `amount` is interpreted for OneClick-based
+ * routes and the underlying `/v0/quote` request.
+ *
+ * - `Input`  (`EXACT_INPUT`)  - `amount` is the fixed input amount.
+ * - `Output` (`EXACT_OUTPUT`) - `amount` is the fixed output amount; required
+ *   input is computed and any excess is refunded to `refundTo`.
+ * - `Flex`   (`FLEX_INPUT`)   - flexible input allowing partial deposits.
+ */
+declare const OneClickSwapType: {
+    readonly Input: "EXACT_INPUT";
+    readonly Output: "EXACT_OUTPUT";
+    readonly Flex: "FLEX_INPUT";
+};
+type OneClickSwapType = (typeof OneClickSwapType)[keyof typeof OneClickSwapType];
 declare const Service: {
     readonly OneClick: "oneclick";
     readonly Usdt0: "usdt0";
@@ -101,6 +116,8 @@ declare const Service: {
     readonly OneClickFraxZero: "oneclick-fraxzero";
     readonly Usdt0OneClick: "usdt0-oneclick";
     readonly OneClickUsdt0: "oneclick-usdt0";
+    readonly CCTPOneClick: "cctp-oneclick";
+    readonly OneClickCCTP: "oneclick-cctp";
     readonly Native: "native";
 };
 type Service = (typeof Service)[keyof typeof Service];
@@ -114,7 +131,9 @@ declare const enum ServiceProject {
     OneClickFraxZero = 8,
     Usdt0OneClick = 3,
     OneClickUsdt0 = 4,
-    Native = 5
+    Native = 5,
+    CCTPOneClick = 9,
+    OneClickCCTP = 10
 }
 
 type AppFee = {
@@ -614,9 +633,9 @@ type TokenResponse = {
      */
     decimals: number;
     /**
-     * Blockchain associated with the token
+     * Blockchain associated with the token (API chain key, e.g. eth, arb, tron, pharos)
      */
-    blockchain: TokenResponse.blockchain;
+    blockchain: string;
     /**
      * Token symbol (e.g. BTC, ETH)
      */
@@ -634,32 +653,6 @@ type TokenResponse = {
      */
     contractAddress?: string;
 };
-declare namespace TokenResponse {
-    /**
-     * Blockchain associated with the token
-     */
-    enum blockchain {
-        NEAR = "near",
-        ETH = "eth",
-        BASE = "base",
-        ARB = "arb",
-        BTC = "btc",
-        SOL = "sol",
-        TON = "ton",
-        DOGE = "doge",
-        XRP = "xrp",
-        ZEC = "zec",
-        GNOSIS = "gnosis",
-        BERA = "bera",
-        BSC = "bsc",
-        POL = "pol",
-        TRON = "tron",
-        SUI = "sui",
-        OP = "op",
-        AVAX = "avax",
-        CARDANO = "cardano"
-    }
-}
 
 interface ChainConfig {
     chainName: string;
@@ -769,6 +762,8 @@ declare const tokens: TokenConfig[];
 declare const usdtTokens: TokenConfig[];
 declare const usdcTokens: TokenConfig[];
 declare const frxusdTokens: TokenConfig[];
+declare const eureTokens: TokenConfig[];
+declare const isStableToken: (token: TokenConfig) => boolean;
 
 declare const usdtChains: Record<string, TokenConfig>;
 
@@ -776,6 +771,15 @@ declare const usdcChains: Record<string, TokenConfig>;
 
 declare const frxusdChains: Record<string, TokenConfig>;
 
+declare const eureChains: Record<string, TokenConfig>;
+declare const eureEvm: {
+    chains: TokenConfig[];
+    symbol: string;
+    decimals: number;
+    icon: string;
+    name: string;
+};
+
 declare const usdt0Chains: Record<string, TokenConfig>;
 
 declare const NetworkRpcUrlsMap: Record<string, string[]>;
@@ -811,8 +815,73 @@ declare const _default: {
     type: string;
 }[];
 
+/**
+ * Look up a token's USD price from a trusted price map (case-insensitive).
+ *
+ * The `prices` map is populated internally by the SDK from the built-in price
+ * source (see `getPrices`), so a missing entry means we cannot safely value the
+ * token. In that case we throw rather than falling back to a distorted default,
+ * to avoid computing fees / on-chain amounts with a wrong price.
+ *
+ * `USDT0` / `USD₮0` / `USD₮` are normalized to `USDT` since the price feed keys
+ * plain `USDT`.
+ *
+ * @throws when no price is found for the given symbol.
+ */
 declare function getPrice(prices: Record<string, string>, symbol: string): string;
 
+/**
+ * Override the in-memory price cache TTL (milliseconds).
+ */
+declare function setPriceCacheTtl(ms: number): void;
+/**
+ * Fetch token USD prices directly from the configured price endpoint.
+ *
+ * Always performs a network request (no caching). Throws when the request
+ * fails or the response is malformed, so callers never proceed with missing
+ * or untrusted prices.
+ *
+ * @returns Map of token symbol -> USD price (decimal string).
+ */
+declare function fetchPrices(): Promise<Record<string, string>>;
+/**
+ * Get token USD prices with a short-lived in-memory cache.
+ *
+ * The SDK calls this internally when generating quotes. Within the cache TTL
+ * (`PriceApiConfig.CACHE_TTL`) the cached map is returned without a network
+ * request; otherwise a fresh fetch is performed. Pass `{ force: true }` to
+ * bypass the cache.
+ *
+ * Throws when a fresh fetch is required but fails and no cache is available,
+ * ensuring quotes are never computed with stale/missing prices.
+ */
+declare function getPrices(opts?: {
+    force?: boolean;
+}): Promise<Record<string, string>>;
+
+/**
+ * Configuration for the built-in token price source.
+ *
+ * The SDK fetches trusted USD prices from this endpoint and uses them
+ * internally for fee/appFee computation, so integrators do not have to
+ * (and can no longer) supply their own `prices` map. This prevents wrong
+ * caller-supplied prices from causing on-chain losses.
+ *
+ * The endpoint mirrors the one used by the StableFlow web interface:
+ * `GET https://api.dapdap.net/get-token-price-by-dapdap`
+ * Response shape: `{ code: 0, msg: "success", data: Record<string, string> }`
+ * where `data` maps token symbol -> USD price (as a decimal string).
+ *
+ * The endpoint URL is fixed and cannot be changed by integrators; only the
+ * cache TTL can be tuned at runtime via `setPriceCacheTtl`.
+ */
+declare const PriceApiConfig: {
+    /** Full URL of the price endpoint (no query params, GET). Not user-configurable. */
+    URL: string;
+    /** In-memory cache TTL in milliseconds. */
+    CACHE_TTL: number;
+};
+
 declare const numberRemoveEndZero: (value: string) => string;
 
 type StyleScale = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | 950;
@@ -851,4 +920,4 @@ declare const getRouteStatus: (service: Service, disabledServices?: Service[]) =
     disabled: boolean;
 };
 
-export { ApiError, type AppFee, type BadRequestResponse, CancelError, CancelablePromise, type ChainType, Csl, DefaultAddresses, ExecTime, type GetExecutionStatusResponse, type GetStatusParams, type GetStatusStableflowResponse, LayerZeroStatus, NetworkRpcUrlsMap, OneClickStatus, OpenAPI, type OpenAPIConfig, type Quote, QuoteRequest, type QuoteResponse, SFA, SendType, Service, ServiceBackend, type ServiceType, StableflowStatus, type SubmitDepositTxRequest, type SubmitDepositTxResponse, type SwapDetails, type TokenConfig, TokenResponse, type TransactionDetails, TransactionStatus, type WalletConfig, _default as erc20Abi, frxusdChains, frxusdTokens, getChainRpcUrl, getPrice, getRequest, getRouteStatus, getRpcUrls, numberRemoveEndZero, postRequest, request, setRpcUrls, tokens, usdcChains, usdcTokens, usdt0Chains, usdtChains, usdtTokens };
+export { ApiError, type AppFee, type BadRequestResponse, CancelError, CancelablePromise, type ChainType, Csl, DefaultAddresses, ExecTime, type GetExecutionStatusResponse, type GetStatusParams, type GetStatusStableflowResponse, LayerZeroStatus, NetworkRpcUrlsMap, OneClickStatus, OneClickSwapType, OpenAPI, type OpenAPIConfig, PriceApiConfig, type Quote, QuoteRequest, type QuoteResponse, SFA, SendType, Service, ServiceBackend, type ServiceType, StableflowStatus, type SubmitDepositTxRequest, type SubmitDepositTxResponse, type SwapDetails, type TokenConfig, type TokenResponse, type TransactionDetails, TransactionStatus, type WalletConfig, _default as erc20Abi, eureChains, eureEvm, eureTokens, fetchPrices, frxusdChains, frxusdTokens, getChainRpcUrl, getPrice, getPrices, getRequest, getRouteStatus, getRpcUrls, isStableToken, numberRemoveEndZero, postRequest, request, setPriceCacheTtl, setRpcUrls, tokens, usdcChains, usdcTokens, usdt0Chains, usdtChains, usdtTokens };

package/dist/index.d.ts

@@ -91,7 +91,22 @@ declare enum SendType {
 /**
  * @deprecated Please use Service instead
  */
-type ServiceType = "oneclick" | "usdt0" | "cctp" | "fraxzero" | "fraxzero-oneclick" | "oneclick-fraxzero" | "usdt0-oneclick" | "oneclick-usdt0" | "native";
+type ServiceType = "oneclick" | "usdt0" | "cctp" | "fraxzero" | "fraxzero-oneclick" | "oneclick-fraxzero" | "usdt0-oneclick" | "oneclick-usdt0" | "cctp-oneclick" | "oneclick-cctp" | "native";
+/**
+ * OneClick swap type. Controls how `amount` is interpreted for OneClick-based
+ * routes and the underlying `/v0/quote` request.
+ *
+ * - `Input`  (`EXACT_INPUT`)  - `amount` is the fixed input amount.
+ * - `Output` (`EXACT_OUTPUT`) - `amount` is the fixed output amount; required
+ *   input is computed and any excess is refunded to `refundTo`.
+ * - `Flex`   (`FLEX_INPUT`)   - flexible input allowing partial deposits.
+ */
+declare const OneClickSwapType: {
+    readonly Input: "EXACT_INPUT";
+    readonly Output: "EXACT_OUTPUT";
+    readonly Flex: "FLEX_INPUT";
+};
+type OneClickSwapType = (typeof OneClickSwapType)[keyof typeof OneClickSwapType];
 declare const Service: {
     readonly OneClick: "oneclick";
     readonly Usdt0: "usdt0";
@@ -101,6 +116,8 @@ declare const Service: {
     readonly OneClickFraxZero: "oneclick-fraxzero";
     readonly Usdt0OneClick: "usdt0-oneclick";
     readonly OneClickUsdt0: "oneclick-usdt0";
+    readonly CCTPOneClick: "cctp-oneclick";
+    readonly OneClickCCTP: "oneclick-cctp";
     readonly Native: "native";
 };
 type Service = (typeof Service)[keyof typeof Service];
@@ -114,7 +131,9 @@ declare const enum ServiceProject {
     OneClickFraxZero = 8,
     Usdt0OneClick = 3,
     OneClickUsdt0 = 4,
-    Native = 5
+    Native = 5,
+    CCTPOneClick = 9,
+    OneClickCCTP = 10
 }
 
 type AppFee = {
@@ -614,9 +633,9 @@ type TokenResponse = {
      */
     decimals: number;
     /**
-     * Blockchain associated with the token
+     * Blockchain associated with the token (API chain key, e.g. eth, arb, tron, pharos)
      */
-    blockchain: TokenResponse.blockchain;
+    blockchain: string;
     /**
      * Token symbol (e.g. BTC, ETH)
      */
@@ -634,32 +653,6 @@ type TokenResponse = {
      */
     contractAddress?: string;
 };
-declare namespace TokenResponse {
-    /**
-     * Blockchain associated with the token
-     */
-    enum blockchain {
-        NEAR = "near",
-        ETH = "eth",
-        BASE = "base",
-        ARB = "arb",
-        BTC = "btc",
-        SOL = "sol",
-        TON = "ton",
-        DOGE = "doge",
-        XRP = "xrp",
-        ZEC = "zec",
-        GNOSIS = "gnosis",
-        BERA = "bera",
-        BSC = "bsc",
-        POL = "pol",
-        TRON = "tron",
-        SUI = "sui",
-        OP = "op",
-        AVAX = "avax",
-        CARDANO = "cardano"
-    }
-}
 
 interface ChainConfig {
     chainName: string;
@@ -769,6 +762,8 @@ declare const tokens: TokenConfig[];
 declare const usdtTokens: TokenConfig[];
 declare const usdcTokens: TokenConfig[];
 declare const frxusdTokens: TokenConfig[];
+declare const eureTokens: TokenConfig[];
+declare const isStableToken: (token: TokenConfig) => boolean;
 
 declare const usdtChains: Record<string, TokenConfig>;
 
@@ -776,6 +771,15 @@ declare const usdcChains: Record<string, TokenConfig>;
 
 declare const frxusdChains: Record<string, TokenConfig>;
 
+declare const eureChains: Record<string, TokenConfig>;
+declare const eureEvm: {
+    chains: TokenConfig[];
+    symbol: string;
+    decimals: number;
+    icon: string;
+    name: string;
+};
+
 declare const usdt0Chains: Record<string, TokenConfig>;
 
 declare const NetworkRpcUrlsMap: Record<string, string[]>;
@@ -811,8 +815,73 @@ declare const _default: {
     type: string;
 }[];
 
+/**
+ * Look up a token's USD price from a trusted price map (case-insensitive).
+ *
+ * The `prices` map is populated internally by the SDK from the built-in price
+ * source (see `getPrices`), so a missing entry means we cannot safely value the
+ * token. In that case we throw rather than falling back to a distorted default,
+ * to avoid computing fees / on-chain amounts with a wrong price.
+ *
+ * `USDT0` / `USD₮0` / `USD₮` are normalized to `USDT` since the price feed keys
+ * plain `USDT`.
+ *
+ * @throws when no price is found for the given symbol.
+ */
 declare function getPrice(prices: Record<string, string>, symbol: string): string;
 
+/**
+ * Override the in-memory price cache TTL (milliseconds).
+ */
+declare function setPriceCacheTtl(ms: number): void;
+/**
+ * Fetch token USD prices directly from the configured price endpoint.
+ *
+ * Always performs a network request (no caching). Throws when the request
+ * fails or the response is malformed, so callers never proceed with missing
+ * or untrusted prices.
+ *
+ * @returns Map of token symbol -> USD price (decimal string).
+ */
+declare function fetchPrices(): Promise<Record<string, string>>;
+/**
+ * Get token USD prices with a short-lived in-memory cache.
+ *
+ * The SDK calls this internally when generating quotes. Within the cache TTL
+ * (`PriceApiConfig.CACHE_TTL`) the cached map is returned without a network
+ * request; otherwise a fresh fetch is performed. Pass `{ force: true }` to
+ * bypass the cache.
+ *
+ * Throws when a fresh fetch is required but fails and no cache is available,
+ * ensuring quotes are never computed with stale/missing prices.
+ */
+declare function getPrices(opts?: {
+    force?: boolean;
+}): Promise<Record<string, string>>;
+
+/**
+ * Configuration for the built-in token price source.
+ *
+ * The SDK fetches trusted USD prices from this endpoint and uses them
+ * internally for fee/appFee computation, so integrators do not have to
+ * (and can no longer) supply their own `prices` map. This prevents wrong
+ * caller-supplied prices from causing on-chain losses.
+ *
+ * The endpoint mirrors the one used by the StableFlow web interface:
+ * `GET https://api.dapdap.net/get-token-price-by-dapdap`
+ * Response shape: `{ code: 0, msg: "success", data: Record<string, string> }`
+ * where `data` maps token symbol -> USD price (as a decimal string).
+ *
+ * The endpoint URL is fixed and cannot be changed by integrators; only the
+ * cache TTL can be tuned at runtime via `setPriceCacheTtl`.
+ */
+declare const PriceApiConfig: {
+    /** Full URL of the price endpoint (no query params, GET). Not user-configurable. */
+    URL: string;
+    /** In-memory cache TTL in milliseconds. */
+    CACHE_TTL: number;
+};
+
 declare const numberRemoveEndZero: (value: string) => string;
 
 type StyleScale = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | 950;
@@ -851,4 +920,4 @@ declare const getRouteStatus: (service: Service, disabledServices?: Service[]) =
     disabled: boolean;
 };
 
-export { ApiError, type AppFee, type BadRequestResponse, CancelError, CancelablePromise, type ChainType, Csl, DefaultAddresses, ExecTime, type GetExecutionStatusResponse, type GetStatusParams, type GetStatusStableflowResponse, LayerZeroStatus, NetworkRpcUrlsMap, OneClickStatus, OpenAPI, type OpenAPIConfig, type Quote, QuoteRequest, type QuoteResponse, SFA, SendType, Service, ServiceBackend, type ServiceType, StableflowStatus, type SubmitDepositTxRequest, type SubmitDepositTxResponse, type SwapDetails, type TokenConfig, TokenResponse, type TransactionDetails, TransactionStatus, type WalletConfig, _default as erc20Abi, frxusdChains, frxusdTokens, getChainRpcUrl, getPrice, getRequest, getRouteStatus, getRpcUrls, numberRemoveEndZero, postRequest, request, setRpcUrls, tokens, usdcChains, usdcTokens, usdt0Chains, usdtChains, usdtTokens };
+export { ApiError, type AppFee, type BadRequestResponse, CancelError, CancelablePromise, type ChainType, Csl, DefaultAddresses, ExecTime, type GetExecutionStatusResponse, type GetStatusParams, type GetStatusStableflowResponse, LayerZeroStatus, NetworkRpcUrlsMap, OneClickStatus, OneClickSwapType, OpenAPI, type OpenAPIConfig, PriceApiConfig, type Quote, QuoteRequest, type QuoteResponse, SFA, SendType, Service, ServiceBackend, type ServiceType, StableflowStatus, type SubmitDepositTxRequest, type SubmitDepositTxResponse, type SwapDetails, type TokenConfig, type TokenResponse, type TransactionDetails, TransactionStatus, type WalletConfig, _default as erc20Abi, eureChains, eureEvm, eureTokens, fetchPrices, frxusdChains, frxusdTokens, getChainRpcUrl, getPrice, getPrices, getRequest, getRouteStatus, getRpcUrls, isStableToken, numberRemoveEndZero, postRequest, request, setPriceCacheTtl, setRpcUrls, tokens, usdcChains, usdcTokens, usdt0Chains, usdtChains, usdtTokens };