@rhea-finance/cross-chain-aggregation-dex 2.0.4 → 2.0.6

package/README.md

@@ -8,85 +8,113 @@ Supported chain families: EVM, Solana, Aptos, NEAR, Tron, Bitcoin, Zcash, and Su
 
 ## Supported chains and tokens
 
-The product support list matches `multi-chain-lending` Trade: **18 mainnets**. Use the HTTP API chain ID for `fromChain` / `toChain` in Swap calls, and the token-query alias when fetching token metadata.
-
-| Chain | Type | HTTP / SDK chain ID | Token query alias |
-| --- | --- | --- | --- |
-| Ethereum | EVM | `1` | `eth` |
-| BNB Smart Chain | EVM | `56` | `bsc` |
-| Arbitrum One | EVM | `42161` | `arb` |
-| Base | EVM | `8453` | `base` |
-| Optimism | EVM | `10` | `op` |
-| Berachain | EVM | `1385` | `bera` |
-| Monad | EVM | `143` | `monad` |
-| X Layer | EVM | `196` | `xlayer` |
-| Polygon PoS | EVM | `137` | `pol` |
-| Gnosis Chain | EVM | `100` | `gnosis` |
-| Plasma | EVM | `9745` | `plasma` |
-| Solana | Non-EVM | `solana` | `sol` |
-| Bitcoin | Non-EVM | `btc` | `btc` |
-| NEAR | Non-EVM | `near` | `near` |
-| Zcash | Non-EVM | `zcash` | `zcash` (also accepts `zec`) |
-| Aptos | Non-EVM | `aptos` | `aptos` |
-| Tron | Non-EVM | `tron` | `tron` |
-| Sui | Non-EVM | `sui` | `sui` |
+The product support list matches `multi-chain-lending` Trade: **25 mainnets**. Use the HTTP API chain ID for `fromChain` / `toChain` in Swap calls. Token-list endpoints use the separate numeric ID shown below; for EVM chains the two IDs are the same.
+
+| Chain | Type | HTTP / SDK chain ID | Token-list chain ID | `blockchain` alias |
+| --- | --- | --- | --- | --- |
+| Ethereum | EVM | `1` | `1` | `eth` |
+| Optimism | EVM | `10` | `10` | `op` |
+| Avalanche | EVM | `43114` | `43114` | `avax` |
+| Robinhood Chain | EVM | `4663` | `4663` | `robinhood` |
+| Katana | EVM | `747474` | `747474` | `katana` |
+| Sonic | EVM | `146` | `146` | `sonic` |
+| Unichain | EVM | `130` | `130` | `unichain` |
+| Pharos | EVM | `1672` | `1672` | `pharos` |
+| Tempo | EVM | `4217` | `4217` | `tempo` |
+| BNB Smart Chain | EVM | `56` | `56` | `bsc` |
+| Gnosis Chain | EVM | `100` | `100` | `gnosis` |
+| Polygon PoS | EVM | `137` | `137` | `pol` |
+| Monad | EVM | `143` | `143` | `monad` |
+| X Layer | EVM | `196` | `196` | `xlayer` |
+| Base | EVM | `8453` | `8453` | `base` |
+| Plasma | EVM | `9745` | `9745` | `plasma` |
+| Arbitrum One | EVM | `42161` | `42161` | `arb` |
+| Berachain | EVM | `80094` | `80094` | `bera` |
+| Tron | Non-EVM | `tron` | `195` | `tron` |
+| Solana | Non-EVM | `solana` | `501` | `sol` |
+| Sui | Non-EVM | `sui` | `784` | `sui` |
+| NEAR | Non-EVM | `near` | `900001` | `near` |
+| Bitcoin | Non-EVM | `btc` | `900002` | `btc` |
+| Zcash | Non-EVM | `zcash` | `900010` | `zec` |
+| Aptos | Non-EVM | `aptos` | `900012` | `aptos` |
 
 "Supported" means the product can load tokens for that chain and send them into the unified quote flow. It does **not** guarantee a route for every pair. Live liquidity, routers, amount, and service status still decide whether a quote succeeds.
 
 ### Token coverage (Unified Swap)
 
-Across the 18 product chains above, Unified Swap currently covers **4,000+** tokens (same-chain DEX metadata plus cross-chain Intents tokens, deduplicated per direction). Snapshot: 2026-07-24. Counts change as liquidity providers and Intents listings update; always fetch the live token APIs below for the current list.
+Token coverage is dynamic and direction-specific. The from-token list combines same-chain routing metadata with cross-chain-capable assets, while the cross-chain to-token list is maintained independently. Do not hard-code a token count or assume every from token can also be selected as a cross-chain destination; fetch both live endpoints described below.
 
-### How to fetch supported tokens
+### How to load supported tokens
 
-Token discovery uses HTTP endpoints **outside** `/api/swap/*`. The SDK does not wrap these calls; applications should `fetch` them directly and map results into `AssetRef` when calling `client.quote()`.
+Use the SDK methods for application selectors. Both methods return the same normalized `SwapTokenListItem[]` shape, even though the two HTTP endpoints have different raw response formats:
 
-#### 1. Product token list (recommended for Trade UI)
+```ts
+const fromTokens = await client.getFromTokens({ chainId: 8453 });
+const crossChainToTokens = await client.getCrossChainToTokens({ chainId: 501 });
 
-```http
-GET https://api.rhea.finance/get_multichain_lending_tokens_data?chains=<COMMA_SEPARATED_ALIASES>
+const tokenIn = fromTokens.find((token) => token.symbol === "USDC")!;
+const tokenOut = crossChainToTokens.find((token) => token.symbol === "USDC")!;
+
+const quote = await client.quote({
+  fromChain: tokenIn.chain,
+  toChain: tokenOut.chain,
+  tokenIn,
+  tokenOut,
+  amountIn: "1000000",
+  slippageBps: 50,
+  sender: "0x...",
+  recipient: "...",
+});
 ```
 
-Query all currently supported product chains:
+`chainId` is the numeric **token-list chain ID** from the table above. For same-chain tokenOut, reuse `getFromTokens`; call `getCrossChainToTokens` only for a destination on another chain.
 
-```bash
-curl "https://api.rhea.finance/get_multichain_lending_tokens_data?chains=bsc,eth,arb,base,op,bera,monad,xlayer,pol,gnosis,plasma,sol,btc,near,zcash,zec,aptos,tron,sui"
-```
+The normalized item extends `AssetRef`:
 
-A successful response is a **JSON array** of token objects (not the `/api/swap` `{ code, data, msg }` envelope). Typical fields:
+```ts
+interface SwapTokenListItem extends AssetRef {
+  chain: ChainRef;
+  address: string;
+  symbol: string;
+  decimals: number;
+  isNative: boolean;
+  tokenListChainId: number;
+  blockchain: string;
+  assetId: string;
+  contractAddress: string | null;
+  coinType: string | null;
+  name: string | null;
+  logoURI: string | null;
+  price: string | number | null;
+  priceUpdatedAt: number | null;
+  sources: string[];
+  raw: Record<string, unknown>;
+}
+```
 
-| Field | Description |
-| --- | --- |
-| `assetId` | Multichain / Intents asset ID |
-| `blockchain` | Token query alias (`eth`, `near`, …) |
-| `symbol` | Display symbol |
-| `decimals` | Token decimals |
-| `contractAddress` | On-chain address; may be empty for natives |
-| `price` / `priceUpdatedAt` | Display price only; not a swap quote |
-| `icon` | Optional icon URL |
+`address` and `assetId` contain the identifier accepted by the unified quote API. `contractAddress` separately preserves the on-chain contract/mint when available and is `null` for native assets. Unknown backend fields remain available in `raw`.
 
-Integration tips:
+The methods cache successful lists for 10 minutes per direction and chain, and merge concurrent identical loads. Failures are never cached. Configure `tokenListCacheTtlMs`, or set it to `0` to disable caching. Requests with an `AbortSignal` are not shared with another caller.
 
-- Group by `blockchain`; do not merge tokens by `symbol` alone.
-- For `quote()`, pass the chain-specific token address/ID as `AssetRef.address`, and use the HTTP/SDK chain ID in `fromChain` / `toChain` / `AssetRef.chain` (for example Base `"8453"`, Solana `"solana"`).
-- Presence in this list means the token is discoverable. Confirm a route with `client.quote()` (or `POST /api/swap/quote`) before trading.
-- Prefer short-lived cache; refresh periodically instead of hard-coding the list.
+The corresponding HTTP endpoints are documented below for server integrations that do not use the SDK.
 
-#### 2. Per-chain token price metadata
+#### 1. From-token list
 
 ```http
-GET https://api.rhea.finance/get_chain_prices?chain=<TOKEN_QUERY_ALIAS>
+GET https://api.rhea.finance/get_chain_prices?chain=<NUMERIC_CHAIN_ID>
 ```
 
 Example:
 
 ```bash
-curl "https://api.rhea.finance/get_chain_prices?chain=eth"
-curl "https://api.rhea.finance/get_chain_prices?chain=bsc"
-curl "https://api.rhea.finance/get_chain_prices?chain=base"
+curl "https://api.rhea.finance/get_chain_prices?chain=1"
+curl "https://api.rhea.finance/get_chain_prices?chain=56"
+curl "https://api.rhea.finance/get_chain_prices?chain=8453"
 ```
 
-`chain` is required and must be a **token query alias** (`eth`, `bsc`, `base`, …). A successful response uses `{ code, data, msg }`:
+`chain` is required and uses the token-list registry's numeric ID. EVM chains use their normal chain ID. Common non-EVM IDs are Solana `501`, Tron `195`, Sui `784`, NEAR `900001`, Bitcoin `900002`, Zcash `900010`, and Aptos `900012`.
+
+A successful response uses `{ code, data, msg }`:
 
 ```ts
 // code === 0 && msg === "success"
@@ -109,7 +137,50 @@ type ChainPricesResponse = {
 };
 ```
 
-Use this endpoint for same-chain token metadata and display prices. It is keyed by token address. It does not replace `get_multichain_lending_tokens_data` for the full multi-chain Trade selector, and some non-EVM aliases may return an empty `data` object.
+Use every returned row as the chain's from-token list. The same list is also used for tokenOut when the source and destination chains are the same.
+
+#### 2. Cross-chain to-token list
+
+```http
+GET https://api.rhea.finance/api/swap/supported_to_tokens?chain=<NUMERIC_CHAIN_ID>
+```
+
+Example:
+
+```bash
+curl "https://api.rhea.finance/api/swap/supported_to_tokens?chain=8453"
+```
+
+The response uses the standard envelope and returns the final destination list in `data.tokens`:
+
+```ts
+type SupportedToTokensResponse = {
+  code: number;
+  msg: string;
+  data: {
+    tokens: Array<{
+      address?: string;
+      assetId?: string;
+      symbol: string;
+      decimals: number;
+      logoURI?: string;
+      price?: string | number;
+      isNative?: boolean;
+      coinType?: string;
+      sources?: string[];
+    }>;
+  };
+};
+```
+
+Use this endpoint only when tokenOut is on a different chain from tokenIn. The returned rows are already the final supported tokenOut list; do not filter them again with legacy `crossChainTo` or `sameChain` flags.
+
+Integration rules:
+
+- Never build both selectors from one combined token list.
+- Do not merge tokens by symbol alone; use chain plus address, asset ID, or coin type.
+- Pass the selected normalized token to `client.quote()` and still confirm route availability with the quote API.
+- Invalidate a selected cross-chain tokenOut if a refreshed destination list no longer contains its chain and `address` pair.
 
 ## 1. What the SDK does
 
@@ -192,6 +263,8 @@ The build normalizer accepts EVM chain IDs as numbers, decimal strings, or JSON-
 
 ### 3.2 Create a SwapClient
 
+To request API access and an API key, sign in to the [RHEA Boss portal](https://boss.rhea.finance/#/login). Provide the issued credential through `apiKey` for a static credential or `getAccessToken` when your application refreshes access tokens.
+
 ```ts
 import { SwapClient } from "@rhea-finance/cross-chain-aggregation-dex";
 
@@ -232,6 +305,8 @@ const quoteRequest: QuoteRequest = {
   amountIn: "1000000",
   slippageBps: 50,
   quoteWaitingTimeMs: 3000,
+  sameChainTimeoutMs: 500,
+  crossChainTimeoutMs: 3000,
   sender: "0xYourBaseAddress",
   recipient: "YourSolanaAddress",
 };
@@ -239,29 +314,38 @@ const quoteRequest: QuoteRequest = {
 const quote = await client.quote(quoteRequest);
 ```
 
-`quote()` calls `POST /api/swap/quote`. The frontend can set `quoteWaitingTimeMs` on every `QuoteRequest` to control how long the quote service may wait for Near Intents and similar intent-based routes. The SDK sends `3000` when the field is omitted.
+`quote()` calls `POST /api/swap/quote`. The frontend can configure the Near Intents wait plus the same-chain and cross-chain route timeouts on every `QuoteRequest`. The SDK sends the defaults shown above when fields are omitted.
+
+Set `confidentiality: "basic"` to use the confidential 1Click route. The SDK preserves it through quote and build, and includes it in automatic or manual report payloads. Omit the field for public swaps:
+
+```ts
+const confidentialQuote = await client.quote({
+  ...quoteRequest,
+  confidentiality: "basic",
+});
+```
 
-#### 3.3.1 Configure the Near Intents quote wait
+#### 3.3.1 Configure quote timing
 
-`quoteWaitingTimeMs` is a first-class SDK parameter. Pass it directly to `client.quote()`; do not put it in `extensions` or an executor configuration.
+`quoteWaitingTimeMs`, `sameChainTimeoutMs`, and `crossChainTimeoutMs` are first-class SDK parameters. Pass them directly to `client.quote()`; do not put them in `extensions` or executor configuration.
 
 ```ts
 // Frontend: allow Near Intents up to 5 seconds to return a route quote.
 const quote = await client.quote({
   ...quoteRequest,
   quoteWaitingTimeMs: 5000,
+  sameChainTimeoutMs: 750,
+  crossChainTimeoutMs: 6000,
 });
 ```
 
-| Rule | Detail |
-| --- | --- |
-| Who sets it | The frontend or any other SDK caller, on each `client.quote(request)` call. |
-| Unit and range | Milliseconds; must be a non-negative integer. |
-| Default | `3000` (3 seconds) when omitted. Pass it explicitly when the product needs to control the Near Intents latency/route-availability tradeoff. |
-| Typical use | Increase it, for example to `5000`–`10000`, when Near Intents needs more time to return a quote. Decrease it, for example to `0`–`1000`, when a faster response is more important than waiting for that route. |
-| Scope | Quote aggregation for intent-based routes such as `nearintents` and `preswap-nearintents`. It also applies to MCA deposit/withdraw quote requests whose Near Intents previews are produced by the same quote call. |
+| Field | SDK default | Scope |
+| --- | --- | --- |
+| `quoteWaitingTimeMs` | `3000` | Wait window for Near Intents and similar intent-based route quotes, including MCA previews produced by the quote call. |
+| `sameChainTimeoutMs` | `500` | Timeout budget supplied to same-chain quote routing. |
+| `crossChainTimeoutMs` | `3000` | Timeout budget supplied to cross-chain quote routing. |
 
-This value limits the server-side route-quote wait only. It does **not** control the SDK HTTP request timeout, wallet signing, source-chain confirmation, bridge settlement, or `waitFor: "completed"` order polling. If the frontend configures a value close to or above the client's `timeoutMs`, increase `timeoutMs` enough to include the quote wait plus network overhead; otherwise the HTTP request may time out first.
+All three values use milliseconds and must be non-negative integers. They affect only `POST /api/swap/quote`; the SDK removes them from the subsequent build request. They do **not** control the SDK HTTP timeout, wallet signing, source-chain confirmation, bridge settlement, or order polling. Keep the client's `timeoutMs` above the configured quote budget plus network overhead.
 
 ### 3.4 Execute the swap directly
 
@@ -298,7 +382,9 @@ if (result.status === "completed") {
 }
 ```
 
-`"completed"` polls the API only when the build response contains a queryable `orderId`. The default polling interval is 5 seconds. There is no default polling timeout, so polling continues until the order reaches a terminal state or the supplied `AbortSignal` is aborted.
+`"completed"` polls the order-status API whenever the swap has a queryable order reference. Confidential swaps also require order-status polling when they are same-chain. For confidential Near Intents builds, the SDK uses `deposit.orderId` when present and otherwise uses `deposit.depositAddress` as the status key. If a cross-chain or confidential swap does not provide a usable status key, the SDK throws `INVALID_API_RESPONSE` at the `status` stage instead of treating source-chain confirmation as completion.
+
+The default polling interval is 5 seconds. There is no default polling timeout, so polling continues until the order reaches a terminal state or the supplied `AbortSignal` is aborted.
 
 Set `orderPolling.timeoutMs` only when the application needs a time limit. An explicit timeout throws `ORDER_TIMEOUT`, but it does not revert an already submitted on-chain transaction.
 
@@ -337,7 +423,7 @@ Terminal statuses are `completed`, `failed`, `refunded`, and `expired`.
 | Field | Type | Required | Description and default |
 | --- | --- | --- | --- |
 | `baseUrl` | `string` | Yes | API base URL, for example `https://api.rhea.finance`. A trailing `/` is removed. |
-| `apiKey` | `string` | No | API credential sent with requests. |
+| `apiKey` | `string` | No | Static API credential sent with requests. Request one through the [RHEA Boss portal](https://boss.rhea.finance/#/login). |
 | `getAccessToken` | `() => string \| Promise<string>` | No | Reads an access token before each request. Use this for refreshable sessions. |
 | `fetch` | `typeof globalThis.fetch` | No | Custom fetch implementation. The SDK binds its invocation context to avoid browser `Illegal invocation` errors. It is normally required on Node.js 16. |
 | `headers` | `Record<string,string>` or function | No | Additional request headers. The function form may return a promise. |
@@ -346,6 +432,7 @@ Terminal statuses are `completed`, `failed`, `refunded`, and `expired`.
 | `logger` | `SdkLogger` | No | Receives structured `api.request`, `api.response`, and `api.retry` entries. |
 | `executors` | `readonly ChainExecutor[]` | Required for execution | Wallet executors. May be omitted when only calling `quote()` or `buildSwap()`. |
 | `maxQuoteAgeMs` | `number \| null` | No | Maximum local quote age in milliseconds. Default: `30000`. Set to `null` to disable the local age check; an API-provided `expiresAt` still applies. |
+| `tokenListCacheTtlMs` | `number` | No | Successful token-list cache lifetime in milliseconds. Default: `600000` (10 minutes). Set to `0` to disable. |
 | `reportMode` | `"auto" \| "manual" \| "disabled"` | No | Reporting policy. Default: `"auto"`. A reporting failure does not turn a submitted swap into a failed swap. |
 | `onEvent` | `(event) => void` | No | Receives all lifecycle events. |
 | `now` | `() => number` | No | Custom millisecond clock, mainly for testing. Default: `Date.now`. |
@@ -372,7 +459,10 @@ Terminal statuses are `completed`, `failed`, `refunded`, and `expired`.
 | `tokenOut` | `AssetRef` | Yes | Asset being received. |
 | `amountIn` | `string` | Yes | A non-negative base-unit decimal integer string. Do not pass `"1.5"` or scientific notation. |
 | `slippageBps` | `number` | Yes | Slippage in basis points. `50` means 0.5%; `100` means 1%. |
-| `quoteWaitingTimeMs` | `number` | No | **Frontend-configurable Near Intents quote wait.** Milliseconds; must be a non-negative integer. Default: `3000`. See [Configure the Near Intents quote wait](#331-configure-the-near-intents-quote-wait). |
+| `quoteWaitingTimeMs` | `number` | No | Near Intents quote wait in milliseconds. Must be a non-negative integer. Default: `3000`. See [Configure quote timing](#331-configure-quote-timing). |
+| `sameChainTimeoutMs` | `number` | No | Same-chain route quote timeout in milliseconds. Must be a non-negative integer. Default: `500`. |
+| `crossChainTimeoutMs` | `number` | No | Cross-chain route quote timeout in milliseconds. Must be a non-negative integer. Default: `3000`. |
+| `confidentiality` | `"basic"` | No | Enables the confidential 1Click route and marks the resulting report. Omit for public swaps. |
 | `sender` | `string` | Yes | Sender address on the source chain. |
 | `recipient` | `string` | No | Recipient address on the destination chain. Cross-chain requests should normally provide it explicitly. |
 | `extensions` | `Record<string,unknown>` | No | Additional fields forwarded to the API. Regular applications should not use this to replace standard fields. |
@@ -407,7 +497,7 @@ Wait modes:
 | --- | --- |
 | `submitted` | Returns after the wallet signs or broadcasts the source action. |
 | `source-confirmed` | Calls the required wallet confirmation method and returns only when it reports `confirmed`. A `failed` or malformed status throws `BROADCAST_FAILED`. |
-| `completed` | After source execution, polls the server until a delivery terminal state when an order reference exists. Without an order reference, it returns the source execution result. |
+| `completed` | After source execution, polls the server until a delivery terminal state. Same-chain confidential swaps are included. A cross-chain or confidential swap without a usable status key fails at the `status` stage instead of being reported as completed. |
 
 `waitForOrder()` accepts the same polling values directly:
 
@@ -425,7 +515,7 @@ Wait modes:
 | `router` | `string` | Router used for execution. Pass it unchanged when querying order status. |
 | `txHash` | `string?` | Hash of a single source-chain transaction. |
 | `txHashes` | `string[]?` | Hashes of multiple source-chain transactions, such as a NEAR transaction batch. |
-| `orderId` | `string?` | Server order identifier. When present, it can be passed to `waitForOrder()`. |
+| `orderId` | `string?` | Status-query key. Usually a server order identifier; confidential Near Intents may use the deposit address. When present, it can be passed to `waitForOrder()`. |
 | `depositAddress` | `string?` | Cross-chain deposit address. |
 | `report` | `object?` | Reporting state: `reported`, `failed`, or `skipped`. A report warning does not invalidate the source submission. |
 | `raw` | `unknown` | Executor confirmation response or original swap API build data. |
@@ -577,6 +667,16 @@ const result = await client.swap({ quote, waitFor: "completed" });
 ### Withdraw
 
 ```ts
+import { resolveMcaWithdrawPolicy } from "@rhea-finance/cross-chain-aggregation-dex";
+
+const collateral = resolveMcaWithdrawPolicy({
+  amountBurrow,      // requested withdraw in Burrow internal decimals
+  suppliedBalance,   // current token supplied balance, same decimals
+  availableBalance,  // human/display precision, matching amountInHuman
+  amountIn: amountInHuman,
+  isMax,
+});
+
 const quote = await client.quote({
   flow: "withdraw",
   mcaAccountId: "account.near",
@@ -589,11 +689,7 @@ const quote = await client.quote({
   slippageBps: 50,
   sender: "account.near",
   recipient: "0xYourBaseAddress",
-  collateral: {
-    needDecrease: true,
-    decreaseAmountBurrow: "1.0",
-    withdrawAll: false,
-  },
+  collateral,
   executionPreference: "relayer",
 });
 
@@ -610,14 +706,16 @@ Withdraw-only fields:
 
 | Field | Type | Required | Description |
 | --- | --- | --- | --- |
-| `collateral.needDecrease` | `boolean` | Yes | Whether Burrow collateral must be decreased. |
-| `collateral.decreaseAmountBurrow` | `string` | Yes | Human-readable Burrow decimal amount, such as `"1.0"`. This is not a token base-unit amount. |
+| `collateral.needDecrease` | `boolean` | No | Compatibility hint only. The SDK derives the API value from `decreaseAmountBurrow` and corrects contradictory input. |
+| `collateral.decreaseAmountBurrow` | `string` | Yes | Required collateral decrease in Burrow decimals: `max(amountBurrow - suppliedBalance, 0)`. The SDK canonicalizes the value and sends `"0"` when supplied balance covers the withdrawal. |
 | `collateral.withdrawAll` | `boolean` | No | Whether to withdraw the full available amount. |
 | `executionPreference` | `"auto" \| "near" \| "relayer"` | No | Default: `"auto"`. Set explicitly to force direct NEAR or relayer execution. |
 | `boundNearAccountId` | `string` | Required for automatic NEAR selection | In `auto` mode, direct NEAR execution is selected only when `toChain === "near"` and `recipient` exactly matches this field. Otherwise, the relayer is selected. |
 
 For direct NEAR execution, the NEAR executor submits `nearMcaWithdrawTx`. For relayer execution, the executor selected by `signerChain` uses `signMessage()` to sign the API-provided `messageToSign`, after which the SDK submits the order. Application code only calls `swap()`.
 
+Derive the collateral policy from the same balances displayed by the application, as shown above. This mirrors Lending Withdraw and multi-chain Trade's 2026-08-20 withdraw fix: `decreaseCollateralAmountBurrow = max(amountBurrow - suppliedBalance, 0)`, and `needDecreaseCollateral` is true exactly when that result is positive. When relayer gas is reserved, use the supplied balance from the gas-adjusted portfolio snapshot, matching the amount used for the quote. `withdrawAll` remains an independent Max/available-balance decision.
+
 ## 9. Lifecycle, errors, and cancellation
 
 Lifecycle events can be observed globally on the client or for an individual swap:
@@ -700,6 +798,8 @@ await client.buildRaw(rawBuildRequest);
 await client.submitOrderRaw(rawSubmitRequest);
 await client.getOrderStatusRaw(rawStatusRequest);
 await client.reportRaw(rawReportRequest);
+await client.createHistoryAuthChallenge(rawChallengeRequest);
+await client.verifyHistoryAuthChallenge(rawVerifyRequest);
 await client.getHistoryRaw(rawHistoryRequest);
 ```
 
@@ -732,6 +832,36 @@ const history = await client.getHistory({
 
 The SDK applies `status` filtering locally. The returned page has `filteredLocally: true`.
 
+For confidential history, authorize the connected wallet, then query with the returned short-lived token:
+
+```ts
+const authorization = await client.authorizeConfidentialHistory(
+  {
+    chainFamily: "evm",
+    chainId: "1",
+    walletAddress: connectedAddress,
+    // Include mcaAccountId when authorizing an MCA principal.
+  },
+  async (challenge) => {
+    // Check the wallet/network has not changed, then sign exactly this message.
+    const signature = await signer.signMessage(
+      challenge.signingInput.message
+    );
+    return { signature };
+  }
+);
+
+const confidentialHistory = await client.getHistory({
+  sender: authorization.queryAddress,
+  mode: "confidential",
+  walletToken: authorization.token,
+  page: 1,
+  pageSize: 20,
+});
+```
+
+The callback returns the wallet-specific proof required by `challenge.signingMethod`; NEP-413 and other chain families may require additional proof fields. `authorizeConfidentialHistory()` validates that the challenge and verified token refer to the requested principal before returning them. The SDK sends the normal API credential in `Authorization` and the wallet token separately in `Authentication`. Public history omits `mode` and `walletToken`.
+
 ## 12. Amount utilities
 
 Avoid JavaScript floating-point arithmetic for token amounts:

package/dist/executors/aptos.d.mts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.mjs';
+import { ad as ExecutorErrorAdapter, C as ChainRef, ae as TransactionSubmission, T as TransactionConfirmation, w as ChainExecutor } from '../shared-COkGiqaz.mjs';
 
 interface AptosWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/aptos.d.ts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.js';
+import { ad as ExecutorErrorAdapter, C as ChainRef, ae as TransactionSubmission, T as TransactionConfirmation, w as ChainExecutor } from '../shared-COkGiqaz.js';
 
 interface AptosWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/aptos.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/errors.ts","../../src/executors/shared.ts","../../src/executors/aptos/index.ts"],"names":[],"mappings":"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","file":"aptos.js","sourcesContent":["export type SwapErrorCode =\n  | \"HTTP_ERROR\"\n  | \"API_ERROR\"\n  | \"RATE_LIMITED\"\n  | \"AUTH_FAILED\"\n  | \"REQUEST_ABORTED\"\n  | \"REQUEST_TIMEOUT\"\n  | \"INVALID_REQUEST\"\n  | \"INVALID_API_RESPONSE\"\n  | \"QUOTE_EXPIRED\"\n  | \"ROUTE_NOT_FOUND\"\n  | \"EXECUTOR_NOT_FOUND\"\n  | \"UNSUPPORTED_CHAIN\"\n  | \"CHAIN_MISMATCH\"\n  | \"INVALID_TRANSACTION\"\n  | \"USER_REJECTED\"\n  | \"INSUFFICIENT_BALANCE\"\n  | \"APPROVAL_FAILED\"\n  | \"SIGNING_FAILED\"\n  | \"BROADCAST_FAILED\"\n  | \"ORDER_SUBMIT_FAILED\"\n  | \"ORDER_TIMEOUT\"\n  | \"REPORT_FAILED\";\n\nexport type SwapErrorStage =\n  | \"quote\"\n  | \"build\"\n  | \"approve\"\n  | \"sign\"\n  | \"broadcast\"\n  | \"submit\"\n  | \"report\"\n  | \"status\"\n  | \"history\";\n\nexport interface SwapSdkErrorOptions {\n  retryable?: boolean;\n  cause?: unknown;\n  details?: Record<string, unknown>;\n}\n\nexport class SwapSdkError extends Error {\n  readonly name = \"SwapSdkError\";\n\n  constructor(\n    readonly code: SwapErrorCode,\n    readonly stage: SwapErrorStage,\n    message: string,\n    readonly options: SwapSdkErrorOptions = {}\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get retryable(): boolean {\n    return this.options.retryable ?? false;\n  }\n\n  get cause(): unknown {\n    return this.options.cause;\n  }\n\n  get details(): Record<string, unknown> | undefined {\n    return this.options.details;\n  }\n}\n\nexport function asSwapSdkError(\n  error: unknown,\n  stage: SwapErrorStage\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n\n  const message = error instanceof Error ? error.message : String(error);\n  return new SwapSdkError(\"API_ERROR\", stage, message, { cause: error });\n}\n","import {\n  SwapSdkError,\n  type SwapErrorCode,\n  type SwapErrorStage,\n} from \"../core/errors\";\nimport type {\n  ChainExecutor,\n  ExecutionContext,\n  MessageSignOptions,\n} from \"../core/registry\";\nimport type { ChainRef } from \"../types/chain\";\n\nexport interface TransactionSubmission {\n  txHash: string;\n  raw?: unknown;\n}\n\nexport interface TransactionConfirmation {\n  status: \"confirmed\" | \"failed\";\n  raw?: unknown;\n}\n\nexport interface ExecutorErrorAdapter {\n  isUserRejection?(error: unknown): boolean;\n  /** Identity serialized as `mca.signer.identityKey` for MCA quotes. */\n  getIdentityKey?(): string | Promise<string>;\n  /**\n   * Optional offline message signing for flows such as MCA relayer withdraw.\n   * Chain transfer executors do not call this during normal swap execution.\n   */\n  signMessage?(\n    message: string,\n    options?: MessageSignOptions\n  ): Promise<string>;\n}\n\nexport function exposeExecutorSigner(\n  signerChain: string,\n  adapter: ExecutorErrorAdapter\n): Pick<\n  ChainExecutor,\n  \"signerChain\" | \"getIdentityKey\" | \"signMessage\"\n> {\n  return {\n    signerChain,\n    ...(adapter.getIdentityKey\n      ? { getIdentityKey: () => adapter.getIdentityKey!() }\n      : {}),\n    ...(adapter.signMessage\n      ? {\n          signMessage: (\n            message: string,\n            options?: MessageSignOptions\n          ) => adapter.signMessage!(message, options),\n        }\n      : {}),\n  };\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal | undefined,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (!signal?.aborted) return;\n  throw new SwapSdkError(\"REQUEST_ABORTED\", stage, \"Execution was aborted\", {\n    cause: signal.reason,\n  });\n}\n\nexport function assertChain(\n  expected: ChainRef,\n  actual: ChainRef,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (expected === actual) return;\n  throw new SwapSdkError(\n    \"CHAIN_MISMATCH\",\n    stage,\n    `Connected chain ${actual} does not match execution chain ${expected}`,\n    { details: { expected, actual } }\n  );\n}\n\nexport async function requestSignApproval(\n  context: ExecutionContext,\n  chain: ChainRef,\n  kind: string,\n  summary: Record<string, unknown>\n): Promise<void> {\n  throwIfAborted(context.signal, \"sign\");\n  await context.beforeSign?.({ chain, kind, summary });\n  throwIfAborted(context.signal, \"sign\");\n}\n\nexport function mapExecutorError(\n  error: unknown,\n  adapter: ExecutorErrorAdapter,\n  stage: SwapErrorStage,\n  code: SwapErrorCode,\n  message: string\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n  if (isUserRejection(error, adapter)) {\n    return new SwapSdkError(\"USER_REJECTED\", stage, \"User rejected the request\", {\n      cause: error,\n    });\n  }\n  return new SwapSdkError(code, stage, message, { cause: error });\n}\n\nexport function assertTransactionConfirmed(\n  confirmation: TransactionConfirmation,\n  options: {\n    code: SwapErrorCode;\n    stage: SwapErrorStage;\n    message: string;\n  }\n): unknown {\n  if (confirmation?.status === \"confirmed\") {\n    return confirmation.raw;\n  }\n  const status =\n    confirmation &&\n    typeof confirmation === \"object\" &&\n    \"status\" in confirmation\n      ? String(confirmation.status)\n      : \"missing\";\n  throw new SwapSdkError(\n    options.code,\n    options.stage,\n    `${options.message}: wallet confirmation status is ${status}`,\n    {\n      cause:\n        confirmation &&\n        typeof confirmation === \"object\" &&\n        \"raw\" in confirmation\n          ? confirmation.raw\n          : confirmation,\n      details: { confirmationStatus: status },\n    }\n  );\n}\n\nfunction isUserRejection(\n  error: unknown,\n  adapter: ExecutorErrorAdapter\n): boolean {\n  if (adapter.isUserRejection?.(error)) return true;\n  if (typeof error !== \"object\" || error === null) return false;\n  const code = \"code\" in error ? error.code : undefined;\n  if (code === 4001 || code === \"ACTION_REJECTED\") return true;\n  const message =\n    \"message\" in error && typeof error.message === \"string\"\n      ? error.message.toLowerCase()\n      : \"\";\n  return /user (rejected|denied)|request rejected|cancelled by user/.test(message);\n}\n","import type {\n  ChainExecutionResult,\n  ChainExecutor,\n  ExecutionContext,\n} from \"../../core/registry\";\nimport type { ChainRef } from \"../../types/chain\";\nimport {\n  assertTransactionConfirmed,\n  assertChain,\n  exposeExecutorSigner,\n  mapExecutorError,\n  requestSignApproval,\n  throwIfAborted,\n  type ExecutorErrorAdapter,\n  type TransactionConfirmation,\n  type TransactionSubmission,\n} from \"../shared\";\n\nexport interface AptosWalletAdapter extends ExecutorErrorAdapter {\n  getChain(): ChainRef | Promise<ChainRef>;\n  signAndSubmitTransaction(\n    payload: {\n      function: string;\n      typeArguments: string[];\n      functionArguments: unknown[];\n    },\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionSubmission>;\n  waitForTransaction(\n    txHash: string,\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionConfirmation>;\n}\n\nexport function createAptosExecutor(\n  adapter: AptosWalletAdapter\n): ChainExecutor<\"aptos-entry-function\"> {\n  return {\n    ...exposeExecutorSigner(\"aptos\", adapter),\n    kinds: [\"aptos-entry-function\"],\n\n    async validate(execution, context) {\n      throwIfAborted(context.signal, \"sign\");\n      assertChain(execution.chain, await adapter.getChain());\n    },\n\n    async execute(execution, context) {\n      await requestSignApproval(context, execution.chain, execution.kind, {\n        function: execution.function,\n        typeArguments: execution.typeArguments,\n        functionArguments: execution.functionArguments,\n      });\n      let submission: TransactionSubmission;\n      try {\n        submission = await adapter.signAndSubmitTransaction(\n          {\n            function: execution.function,\n            typeArguments: execution.typeArguments,\n            functionArguments: execution.functionArguments,\n          },\n          { signal: context.signal }\n        );\n      } catch (error) {\n        throw mapExecutorError(\n          error,\n          adapter,\n          \"broadcast\",\n          \"BROADCAST_FAILED\",\n          \"Failed to sign or submit Aptos transaction\"\n        );\n      }\n      return confirm(adapter, submission, context);\n    },\n  };\n}\n\nasync function confirm(\n  adapter: AptosWalletAdapter,\n  submission: TransactionSubmission,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  if (context.waitFor === \"submitted\") {\n    return {\n      status: \"submitted\",\n      txHash: submission.txHash,\n      ...(submission.raw !== undefined ? { raw: submission.raw } : {}),\n    };\n  }\n  try {\n    const confirmation = await adapter.waitForTransaction(submission.txHash, {\n      signal: context.signal,\n    });\n    const confirmationRaw = assertTransactionConfirmed(confirmation, {\n      code: \"BROADCAST_FAILED\",\n      stage: \"broadcast\",\n      message: \"Aptos transaction failed\",\n    });\n    return {\n      status: \"source-confirmed\",\n      txHash: submission.txHash,\n      raw: confirmationRaw ?? submission.raw,\n    };\n  } catch (error) {\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed while confirming Aptos transaction\"\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../../src/core/errors.ts","../../src/executors/shared.ts","../../src/executors/aptos/index.ts"],"names":[],"mappings":"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","file":"aptos.js","sourcesContent":["export type SwapErrorCode =\n  | \"HTTP_ERROR\"\n  | \"API_ERROR\"\n  | \"RATE_LIMITED\"\n  | \"AUTH_FAILED\"\n  | \"REQUEST_ABORTED\"\n  | \"REQUEST_TIMEOUT\"\n  | \"INVALID_REQUEST\"\n  | \"INVALID_API_RESPONSE\"\n  | \"QUOTE_EXPIRED\"\n  | \"ROUTE_NOT_FOUND\"\n  | \"EXECUTOR_NOT_FOUND\"\n  | \"UNSUPPORTED_CHAIN\"\n  | \"CHAIN_MISMATCH\"\n  | \"INVALID_TRANSACTION\"\n  | \"USER_REJECTED\"\n  | \"INSUFFICIENT_BALANCE\"\n  | \"APPROVAL_FAILED\"\n  | \"SIGNING_FAILED\"\n  | \"BROADCAST_FAILED\"\n  | \"ORDER_SUBMIT_FAILED\"\n  | \"ORDER_TIMEOUT\"\n  | \"REPORT_FAILED\";\n\nexport type SwapErrorStage =\n  | \"quote\"\n  | \"build\"\n  | \"approve\"\n  | \"sign\"\n  | \"broadcast\"\n  | \"submit\"\n  | \"report\"\n  | \"status\"\n  | \"tokens\"\n  | \"history\";\n\nexport interface SwapSdkErrorOptions {\n  retryable?: boolean;\n  cause?: unknown;\n  details?: Record<string, unknown>;\n}\n\nexport class SwapSdkError extends Error {\n  readonly name = \"SwapSdkError\";\n\n  constructor(\n    readonly code: SwapErrorCode,\n    readonly stage: SwapErrorStage,\n    message: string,\n    readonly options: SwapSdkErrorOptions = {}\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get retryable(): boolean {\n    return this.options.retryable ?? false;\n  }\n\n  get cause(): unknown {\n    return this.options.cause;\n  }\n\n  get details(): Record<string, unknown> | undefined {\n    return this.options.details;\n  }\n}\n\nexport function asSwapSdkError(\n  error: unknown,\n  stage: SwapErrorStage\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n\n  const message = error instanceof Error ? error.message : String(error);\n  return new SwapSdkError(\"API_ERROR\", stage, message, { cause: error });\n}\n","import {\n  SwapSdkError,\n  type SwapErrorCode,\n  type SwapErrorStage,\n} from \"../core/errors\";\nimport type {\n  ChainExecutor,\n  ExecutionContext,\n  MessageSignOptions,\n} from \"../core/registry\";\nimport type { ChainRef } from \"../types/chain\";\n\nexport interface TransactionSubmission {\n  txHash: string;\n  raw?: unknown;\n}\n\nexport interface TransactionConfirmation {\n  status: \"confirmed\" | \"failed\";\n  raw?: unknown;\n}\n\nexport interface ExecutorErrorAdapter {\n  isUserRejection?(error: unknown): boolean;\n  /** Identity serialized as `mca.signer.identityKey` for MCA quotes. */\n  getIdentityKey?(): string | Promise<string>;\n  /**\n   * Optional offline message signing for flows such as MCA relayer withdraw.\n   * Chain transfer executors do not call this during normal swap execution.\n   */\n  signMessage?(\n    message: string,\n    options?: MessageSignOptions\n  ): Promise<string>;\n}\n\nexport function exposeExecutorSigner(\n  signerChain: string,\n  adapter: ExecutorErrorAdapter\n): Pick<\n  ChainExecutor,\n  \"signerChain\" | \"getIdentityKey\" | \"signMessage\"\n> {\n  return {\n    signerChain,\n    ...(adapter.getIdentityKey\n      ? { getIdentityKey: () => adapter.getIdentityKey!() }\n      : {}),\n    ...(adapter.signMessage\n      ? {\n          signMessage: (\n            message: string,\n            options?: MessageSignOptions\n          ) => adapter.signMessage!(message, options),\n        }\n      : {}),\n  };\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal | undefined,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (!signal?.aborted) return;\n  throw new SwapSdkError(\"REQUEST_ABORTED\", stage, \"Execution was aborted\", {\n    cause: signal.reason,\n  });\n}\n\nexport function assertChain(\n  expected: ChainRef,\n  actual: ChainRef,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (expected === actual) return;\n  throw new SwapSdkError(\n    \"CHAIN_MISMATCH\",\n    stage,\n    `Connected chain ${actual} does not match execution chain ${expected}`,\n    { details: { expected, actual } }\n  );\n}\n\nexport async function requestSignApproval(\n  context: ExecutionContext,\n  chain: ChainRef,\n  kind: string,\n  summary: Record<string, unknown>\n): Promise<void> {\n  throwIfAborted(context.signal, \"sign\");\n  await context.beforeSign?.({ chain, kind, summary });\n  throwIfAborted(context.signal, \"sign\");\n}\n\nexport function mapExecutorError(\n  error: unknown,\n  adapter: ExecutorErrorAdapter,\n  stage: SwapErrorStage,\n  code: SwapErrorCode,\n  message: string\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n  if (isUserRejection(error, adapter)) {\n    return new SwapSdkError(\"USER_REJECTED\", stage, \"User rejected the request\", {\n      cause: error,\n    });\n  }\n  return new SwapSdkError(code, stage, message, { cause: error });\n}\n\nexport function assertTransactionConfirmed(\n  confirmation: TransactionConfirmation,\n  options: {\n    code: SwapErrorCode;\n    stage: SwapErrorStage;\n    message: string;\n  }\n): unknown {\n  if (confirmation?.status === \"confirmed\") {\n    return confirmation.raw;\n  }\n  const status =\n    confirmation &&\n    typeof confirmation === \"object\" &&\n    \"status\" in confirmation\n      ? String(confirmation.status)\n      : \"missing\";\n  throw new SwapSdkError(\n    options.code,\n    options.stage,\n    `${options.message}: wallet confirmation status is ${status}`,\n    {\n      cause:\n        confirmation &&\n        typeof confirmation === \"object\" &&\n        \"raw\" in confirmation\n          ? confirmation.raw\n          : confirmation,\n      details: { confirmationStatus: status },\n    }\n  );\n}\n\nfunction isUserRejection(\n  error: unknown,\n  adapter: ExecutorErrorAdapter\n): boolean {\n  if (adapter.isUserRejection?.(error)) return true;\n  if (typeof error !== \"object\" || error === null) return false;\n  const code = \"code\" in error ? error.code : undefined;\n  if (code === 4001 || code === \"ACTION_REJECTED\") return true;\n  const message =\n    \"message\" in error && typeof error.message === \"string\"\n      ? error.message.toLowerCase()\n      : \"\";\n  return /user (rejected|denied)|request rejected|cancelled by user/.test(message);\n}\n","import type {\n  ChainExecutionResult,\n  ChainExecutor,\n  ExecutionContext,\n} from \"../../core/registry\";\nimport type { ChainRef } from \"../../types/chain\";\nimport {\n  assertTransactionConfirmed,\n  assertChain,\n  exposeExecutorSigner,\n  mapExecutorError,\n  requestSignApproval,\n  throwIfAborted,\n  type ExecutorErrorAdapter,\n  type TransactionConfirmation,\n  type TransactionSubmission,\n} from \"../shared\";\n\nexport interface AptosWalletAdapter extends ExecutorErrorAdapter {\n  getChain(): ChainRef | Promise<ChainRef>;\n  signAndSubmitTransaction(\n    payload: {\n      function: string;\n      typeArguments: string[];\n      functionArguments: unknown[];\n    },\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionSubmission>;\n  waitForTransaction(\n    txHash: string,\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionConfirmation>;\n}\n\nexport function createAptosExecutor(\n  adapter: AptosWalletAdapter\n): ChainExecutor<\"aptos-entry-function\"> {\n  return {\n    ...exposeExecutorSigner(\"aptos\", adapter),\n    kinds: [\"aptos-entry-function\"],\n\n    async validate(execution, context) {\n      throwIfAborted(context.signal, \"sign\");\n      assertChain(execution.chain, await adapter.getChain());\n    },\n\n    async execute(execution, context) {\n      await requestSignApproval(context, execution.chain, execution.kind, {\n        function: execution.function,\n        typeArguments: execution.typeArguments,\n        functionArguments: execution.functionArguments,\n      });\n      let submission: TransactionSubmission;\n      try {\n        submission = await adapter.signAndSubmitTransaction(\n          {\n            function: execution.function,\n            typeArguments: execution.typeArguments,\n            functionArguments: execution.functionArguments,\n          },\n          { signal: context.signal }\n        );\n      } catch (error) {\n        throw mapExecutorError(\n          error,\n          adapter,\n          \"broadcast\",\n          \"BROADCAST_FAILED\",\n          \"Failed to sign or submit Aptos transaction\"\n        );\n      }\n      return confirm(adapter, submission, context);\n    },\n  };\n}\n\nasync function confirm(\n  adapter: AptosWalletAdapter,\n  submission: TransactionSubmission,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  if (context.waitFor === \"submitted\") {\n    return {\n      status: \"submitted\",\n      txHash: submission.txHash,\n      ...(submission.raw !== undefined ? { raw: submission.raw } : {}),\n    };\n  }\n  try {\n    const confirmation = await adapter.waitForTransaction(submission.txHash, {\n      signal: context.signal,\n    });\n    const confirmationRaw = assertTransactionConfirmed(confirmation, {\n      code: \"BROADCAST_FAILED\",\n      stage: \"broadcast\",\n      message: \"Aptos transaction failed\",\n    });\n    return {\n      status: \"source-confirmed\",\n      txHash: submission.txHash,\n      raw: confirmationRaw ?? submission.raw,\n    };\n  } catch (error) {\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed while confirming Aptos transaction\"\n    );\n  }\n}\n"]}

package/dist/executors/aptos.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/errors.ts","../../src/executors/shared.ts","../../src/executors/aptos/index.ts"],"names":[],"mappings":"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","file":"aptos.mjs","sourcesContent":["export type SwapErrorCode =\n  | \"HTTP_ERROR\"\n  | \"API_ERROR\"\n  | \"RATE_LIMITED\"\n  | \"AUTH_FAILED\"\n  | \"REQUEST_ABORTED\"\n  | \"REQUEST_TIMEOUT\"\n  | \"INVALID_REQUEST\"\n  | \"INVALID_API_RESPONSE\"\n  | \"QUOTE_EXPIRED\"\n  | \"ROUTE_NOT_FOUND\"\n  | \"EXECUTOR_NOT_FOUND\"\n  | \"UNSUPPORTED_CHAIN\"\n  | \"CHAIN_MISMATCH\"\n  | \"INVALID_TRANSACTION\"\n  | \"USER_REJECTED\"\n  | \"INSUFFICIENT_BALANCE\"\n  | \"APPROVAL_FAILED\"\n  | \"SIGNING_FAILED\"\n  | \"BROADCAST_FAILED\"\n  | \"ORDER_SUBMIT_FAILED\"\n  | \"ORDER_TIMEOUT\"\n  | \"REPORT_FAILED\";\n\nexport type SwapErrorStage =\n  | \"quote\"\n  | \"build\"\n  | \"approve\"\n  | \"sign\"\n  | \"broadcast\"\n  | \"submit\"\n  | \"report\"\n  | \"status\"\n  | \"history\";\n\nexport interface SwapSdkErrorOptions {\n  retryable?: boolean;\n  cause?: unknown;\n  details?: Record<string, unknown>;\n}\n\nexport class SwapSdkError extends Error {\n  readonly name = \"SwapSdkError\";\n\n  constructor(\n    readonly code: SwapErrorCode,\n    readonly stage: SwapErrorStage,\n    message: string,\n    readonly options: SwapSdkErrorOptions = {}\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get retryable(): boolean {\n    return this.options.retryable ?? false;\n  }\n\n  get cause(): unknown {\n    return this.options.cause;\n  }\n\n  get details(): Record<string, unknown> | undefined {\n    return this.options.details;\n  }\n}\n\nexport function asSwapSdkError(\n  error: unknown,\n  stage: SwapErrorStage\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n\n  const message = error instanceof Error ? error.message : String(error);\n  return new SwapSdkError(\"API_ERROR\", stage, message, { cause: error });\n}\n","import {\n  SwapSdkError,\n  type SwapErrorCode,\n  type SwapErrorStage,\n} from \"../core/errors\";\nimport type {\n  ChainExecutor,\n  ExecutionContext,\n  MessageSignOptions,\n} from \"../core/registry\";\nimport type { ChainRef } from \"../types/chain\";\n\nexport interface TransactionSubmission {\n  txHash: string;\n  raw?: unknown;\n}\n\nexport interface TransactionConfirmation {\n  status: \"confirmed\" | \"failed\";\n  raw?: unknown;\n}\n\nexport interface ExecutorErrorAdapter {\n  isUserRejection?(error: unknown): boolean;\n  /** Identity serialized as `mca.signer.identityKey` for MCA quotes. */\n  getIdentityKey?(): string | Promise<string>;\n  /**\n   * Optional offline message signing for flows such as MCA relayer withdraw.\n   * Chain transfer executors do not call this during normal swap execution.\n   */\n  signMessage?(\n    message: string,\n    options?: MessageSignOptions\n  ): Promise<string>;\n}\n\nexport function exposeExecutorSigner(\n  signerChain: string,\n  adapter: ExecutorErrorAdapter\n): Pick<\n  ChainExecutor,\n  \"signerChain\" | \"getIdentityKey\" | \"signMessage\"\n> {\n  return {\n    signerChain,\n    ...(adapter.getIdentityKey\n      ? { getIdentityKey: () => adapter.getIdentityKey!() }\n      : {}),\n    ...(adapter.signMessage\n      ? {\n          signMessage: (\n            message: string,\n            options?: MessageSignOptions\n          ) => adapter.signMessage!(message, options),\n        }\n      : {}),\n  };\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal | undefined,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (!signal?.aborted) return;\n  throw new SwapSdkError(\"REQUEST_ABORTED\", stage, \"Execution was aborted\", {\n    cause: signal.reason,\n  });\n}\n\nexport function assertChain(\n  expected: ChainRef,\n  actual: ChainRef,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (expected === actual) return;\n  throw new SwapSdkError(\n    \"CHAIN_MISMATCH\",\n    stage,\n    `Connected chain ${actual} does not match execution chain ${expected}`,\n    { details: { expected, actual } }\n  );\n}\n\nexport async function requestSignApproval(\n  context: ExecutionContext,\n  chain: ChainRef,\n  kind: string,\n  summary: Record<string, unknown>\n): Promise<void> {\n  throwIfAborted(context.signal, \"sign\");\n  await context.beforeSign?.({ chain, kind, summary });\n  throwIfAborted(context.signal, \"sign\");\n}\n\nexport function mapExecutorError(\n  error: unknown,\n  adapter: ExecutorErrorAdapter,\n  stage: SwapErrorStage,\n  code: SwapErrorCode,\n  message: string\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n  if (isUserRejection(error, adapter)) {\n    return new SwapSdkError(\"USER_REJECTED\", stage, \"User rejected the request\", {\n      cause: error,\n    });\n  }\n  return new SwapSdkError(code, stage, message, { cause: error });\n}\n\nexport function assertTransactionConfirmed(\n  confirmation: TransactionConfirmation,\n  options: {\n    code: SwapErrorCode;\n    stage: SwapErrorStage;\n    message: string;\n  }\n): unknown {\n  if (confirmation?.status === \"confirmed\") {\n    return confirmation.raw;\n  }\n  const status =\n    confirmation &&\n    typeof confirmation === \"object\" &&\n    \"status\" in confirmation\n      ? String(confirmation.status)\n      : \"missing\";\n  throw new SwapSdkError(\n    options.code,\n    options.stage,\n    `${options.message}: wallet confirmation status is ${status}`,\n    {\n      cause:\n        confirmation &&\n        typeof confirmation === \"object\" &&\n        \"raw\" in confirmation\n          ? confirmation.raw\n          : confirmation,\n      details: { confirmationStatus: status },\n    }\n  );\n}\n\nfunction isUserRejection(\n  error: unknown,\n  adapter: ExecutorErrorAdapter\n): boolean {\n  if (adapter.isUserRejection?.(error)) return true;\n  if (typeof error !== \"object\" || error === null) return false;\n  const code = \"code\" in error ? error.code : undefined;\n  if (code === 4001 || code === \"ACTION_REJECTED\") return true;\n  const message =\n    \"message\" in error && typeof error.message === \"string\"\n      ? error.message.toLowerCase()\n      : \"\";\n  return /user (rejected|denied)|request rejected|cancelled by user/.test(message);\n}\n","import type {\n  ChainExecutionResult,\n  ChainExecutor,\n  ExecutionContext,\n} from \"../../core/registry\";\nimport type { ChainRef } from \"../../types/chain\";\nimport {\n  assertTransactionConfirmed,\n  assertChain,\n  exposeExecutorSigner,\n  mapExecutorError,\n  requestSignApproval,\n  throwIfAborted,\n  type ExecutorErrorAdapter,\n  type TransactionConfirmation,\n  type TransactionSubmission,\n} from \"../shared\";\n\nexport interface AptosWalletAdapter extends ExecutorErrorAdapter {\n  getChain(): ChainRef | Promise<ChainRef>;\n  signAndSubmitTransaction(\n    payload: {\n      function: string;\n      typeArguments: string[];\n      functionArguments: unknown[];\n    },\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionSubmission>;\n  waitForTransaction(\n    txHash: string,\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionConfirmation>;\n}\n\nexport function createAptosExecutor(\n  adapter: AptosWalletAdapter\n): ChainExecutor<\"aptos-entry-function\"> {\n  return {\n    ...exposeExecutorSigner(\"aptos\", adapter),\n    kinds: [\"aptos-entry-function\"],\n\n    async validate(execution, context) {\n      throwIfAborted(context.signal, \"sign\");\n      assertChain(execution.chain, await adapter.getChain());\n    },\n\n    async execute(execution, context) {\n      await requestSignApproval(context, execution.chain, execution.kind, {\n        function: execution.function,\n        typeArguments: execution.typeArguments,\n        functionArguments: execution.functionArguments,\n      });\n      let submission: TransactionSubmission;\n      try {\n        submission = await adapter.signAndSubmitTransaction(\n          {\n            function: execution.function,\n            typeArguments: execution.typeArguments,\n            functionArguments: execution.functionArguments,\n          },\n          { signal: context.signal }\n        );\n      } catch (error) {\n        throw mapExecutorError(\n          error,\n          adapter,\n          \"broadcast\",\n          \"BROADCAST_FAILED\",\n          \"Failed to sign or submit Aptos transaction\"\n        );\n      }\n      return confirm(adapter, submission, context);\n    },\n  };\n}\n\nasync function confirm(\n  adapter: AptosWalletAdapter,\n  submission: TransactionSubmission,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  if (context.waitFor === \"submitted\") {\n    return {\n      status: \"submitted\",\n      txHash: submission.txHash,\n      ...(submission.raw !== undefined ? { raw: submission.raw } : {}),\n    };\n  }\n  try {\n    const confirmation = await adapter.waitForTransaction(submission.txHash, {\n      signal: context.signal,\n    });\n    const confirmationRaw = assertTransactionConfirmed(confirmation, {\n      code: \"BROADCAST_FAILED\",\n      stage: \"broadcast\",\n      message: \"Aptos transaction failed\",\n    });\n    return {\n      status: \"source-confirmed\",\n      txHash: submission.txHash,\n      raw: confirmationRaw ?? submission.raw,\n    };\n  } catch (error) {\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed while confirming Aptos transaction\"\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../../src/core/errors.ts","../../src/executors/shared.ts","../../src/executors/aptos/index.ts"],"names":[],"mappings":"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","file":"aptos.mjs","sourcesContent":["export type SwapErrorCode =\n  | \"HTTP_ERROR\"\n  | \"API_ERROR\"\n  | \"RATE_LIMITED\"\n  | \"AUTH_FAILED\"\n  | \"REQUEST_ABORTED\"\n  | \"REQUEST_TIMEOUT\"\n  | \"INVALID_REQUEST\"\n  | \"INVALID_API_RESPONSE\"\n  | \"QUOTE_EXPIRED\"\n  | \"ROUTE_NOT_FOUND\"\n  | \"EXECUTOR_NOT_FOUND\"\n  | \"UNSUPPORTED_CHAIN\"\n  | \"CHAIN_MISMATCH\"\n  | \"INVALID_TRANSACTION\"\n  | \"USER_REJECTED\"\n  | \"INSUFFICIENT_BALANCE\"\n  | \"APPROVAL_FAILED\"\n  | \"SIGNING_FAILED\"\n  | \"BROADCAST_FAILED\"\n  | \"ORDER_SUBMIT_FAILED\"\n  | \"ORDER_TIMEOUT\"\n  | \"REPORT_FAILED\";\n\nexport type SwapErrorStage =\n  | \"quote\"\n  | \"build\"\n  | \"approve\"\n  | \"sign\"\n  | \"broadcast\"\n  | \"submit\"\n  | \"report\"\n  | \"status\"\n  | \"tokens\"\n  | \"history\";\n\nexport interface SwapSdkErrorOptions {\n  retryable?: boolean;\n  cause?: unknown;\n  details?: Record<string, unknown>;\n}\n\nexport class SwapSdkError extends Error {\n  readonly name = \"SwapSdkError\";\n\n  constructor(\n    readonly code: SwapErrorCode,\n    readonly stage: SwapErrorStage,\n    message: string,\n    readonly options: SwapSdkErrorOptions = {}\n  ) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  get retryable(): boolean {\n    return this.options.retryable ?? false;\n  }\n\n  get cause(): unknown {\n    return this.options.cause;\n  }\n\n  get details(): Record<string, unknown> | undefined {\n    return this.options.details;\n  }\n}\n\nexport function asSwapSdkError(\n  error: unknown,\n  stage: SwapErrorStage\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n\n  const message = error instanceof Error ? error.message : String(error);\n  return new SwapSdkError(\"API_ERROR\", stage, message, { cause: error });\n}\n","import {\n  SwapSdkError,\n  type SwapErrorCode,\n  type SwapErrorStage,\n} from \"../core/errors\";\nimport type {\n  ChainExecutor,\n  ExecutionContext,\n  MessageSignOptions,\n} from \"../core/registry\";\nimport type { ChainRef } from \"../types/chain\";\n\nexport interface TransactionSubmission {\n  txHash: string;\n  raw?: unknown;\n}\n\nexport interface TransactionConfirmation {\n  status: \"confirmed\" | \"failed\";\n  raw?: unknown;\n}\n\nexport interface ExecutorErrorAdapter {\n  isUserRejection?(error: unknown): boolean;\n  /** Identity serialized as `mca.signer.identityKey` for MCA quotes. */\n  getIdentityKey?(): string | Promise<string>;\n  /**\n   * Optional offline message signing for flows such as MCA relayer withdraw.\n   * Chain transfer executors do not call this during normal swap execution.\n   */\n  signMessage?(\n    message: string,\n    options?: MessageSignOptions\n  ): Promise<string>;\n}\n\nexport function exposeExecutorSigner(\n  signerChain: string,\n  adapter: ExecutorErrorAdapter\n): Pick<\n  ChainExecutor,\n  \"signerChain\" | \"getIdentityKey\" | \"signMessage\"\n> {\n  return {\n    signerChain,\n    ...(adapter.getIdentityKey\n      ? { getIdentityKey: () => adapter.getIdentityKey!() }\n      : {}),\n    ...(adapter.signMessage\n      ? {\n          signMessage: (\n            message: string,\n            options?: MessageSignOptions\n          ) => adapter.signMessage!(message, options),\n        }\n      : {}),\n  };\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal | undefined,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (!signal?.aborted) return;\n  throw new SwapSdkError(\"REQUEST_ABORTED\", stage, \"Execution was aborted\", {\n    cause: signal.reason,\n  });\n}\n\nexport function assertChain(\n  expected: ChainRef,\n  actual: ChainRef,\n  stage: SwapErrorStage = \"sign\"\n): void {\n  if (expected === actual) return;\n  throw new SwapSdkError(\n    \"CHAIN_MISMATCH\",\n    stage,\n    `Connected chain ${actual} does not match execution chain ${expected}`,\n    { details: { expected, actual } }\n  );\n}\n\nexport async function requestSignApproval(\n  context: ExecutionContext,\n  chain: ChainRef,\n  kind: string,\n  summary: Record<string, unknown>\n): Promise<void> {\n  throwIfAborted(context.signal, \"sign\");\n  await context.beforeSign?.({ chain, kind, summary });\n  throwIfAborted(context.signal, \"sign\");\n}\n\nexport function mapExecutorError(\n  error: unknown,\n  adapter: ExecutorErrorAdapter,\n  stage: SwapErrorStage,\n  code: SwapErrorCode,\n  message: string\n): SwapSdkError {\n  if (error instanceof SwapSdkError) return error;\n  if (isUserRejection(error, adapter)) {\n    return new SwapSdkError(\"USER_REJECTED\", stage, \"User rejected the request\", {\n      cause: error,\n    });\n  }\n  return new SwapSdkError(code, stage, message, { cause: error });\n}\n\nexport function assertTransactionConfirmed(\n  confirmation: TransactionConfirmation,\n  options: {\n    code: SwapErrorCode;\n    stage: SwapErrorStage;\n    message: string;\n  }\n): unknown {\n  if (confirmation?.status === \"confirmed\") {\n    return confirmation.raw;\n  }\n  const status =\n    confirmation &&\n    typeof confirmation === \"object\" &&\n    \"status\" in confirmation\n      ? String(confirmation.status)\n      : \"missing\";\n  throw new SwapSdkError(\n    options.code,\n    options.stage,\n    `${options.message}: wallet confirmation status is ${status}`,\n    {\n      cause:\n        confirmation &&\n        typeof confirmation === \"object\" &&\n        \"raw\" in confirmation\n          ? confirmation.raw\n          : confirmation,\n      details: { confirmationStatus: status },\n    }\n  );\n}\n\nfunction isUserRejection(\n  error: unknown,\n  adapter: ExecutorErrorAdapter\n): boolean {\n  if (adapter.isUserRejection?.(error)) return true;\n  if (typeof error !== \"object\" || error === null) return false;\n  const code = \"code\" in error ? error.code : undefined;\n  if (code === 4001 || code === \"ACTION_REJECTED\") return true;\n  const message =\n    \"message\" in error && typeof error.message === \"string\"\n      ? error.message.toLowerCase()\n      : \"\";\n  return /user (rejected|denied)|request rejected|cancelled by user/.test(message);\n}\n","import type {\n  ChainExecutionResult,\n  ChainExecutor,\n  ExecutionContext,\n} from \"../../core/registry\";\nimport type { ChainRef } from \"../../types/chain\";\nimport {\n  assertTransactionConfirmed,\n  assertChain,\n  exposeExecutorSigner,\n  mapExecutorError,\n  requestSignApproval,\n  throwIfAborted,\n  type ExecutorErrorAdapter,\n  type TransactionConfirmation,\n  type TransactionSubmission,\n} from \"../shared\";\n\nexport interface AptosWalletAdapter extends ExecutorErrorAdapter {\n  getChain(): ChainRef | Promise<ChainRef>;\n  signAndSubmitTransaction(\n    payload: {\n      function: string;\n      typeArguments: string[];\n      functionArguments: unknown[];\n    },\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionSubmission>;\n  waitForTransaction(\n    txHash: string,\n    options: { signal?: AbortSignal }\n  ): Promise<TransactionConfirmation>;\n}\n\nexport function createAptosExecutor(\n  adapter: AptosWalletAdapter\n): ChainExecutor<\"aptos-entry-function\"> {\n  return {\n    ...exposeExecutorSigner(\"aptos\", adapter),\n    kinds: [\"aptos-entry-function\"],\n\n    async validate(execution, context) {\n      throwIfAborted(context.signal, \"sign\");\n      assertChain(execution.chain, await adapter.getChain());\n    },\n\n    async execute(execution, context) {\n      await requestSignApproval(context, execution.chain, execution.kind, {\n        function: execution.function,\n        typeArguments: execution.typeArguments,\n        functionArguments: execution.functionArguments,\n      });\n      let submission: TransactionSubmission;\n      try {\n        submission = await adapter.signAndSubmitTransaction(\n          {\n            function: execution.function,\n            typeArguments: execution.typeArguments,\n            functionArguments: execution.functionArguments,\n          },\n          { signal: context.signal }\n        );\n      } catch (error) {\n        throw mapExecutorError(\n          error,\n          adapter,\n          \"broadcast\",\n          \"BROADCAST_FAILED\",\n          \"Failed to sign or submit Aptos transaction\"\n        );\n      }\n      return confirm(adapter, submission, context);\n    },\n  };\n}\n\nasync function confirm(\n  adapter: AptosWalletAdapter,\n  submission: TransactionSubmission,\n  context: ExecutionContext\n): Promise<ChainExecutionResult> {\n  if (context.waitFor === \"submitted\") {\n    return {\n      status: \"submitted\",\n      txHash: submission.txHash,\n      ...(submission.raw !== undefined ? { raw: submission.raw } : {}),\n    };\n  }\n  try {\n    const confirmation = await adapter.waitForTransaction(submission.txHash, {\n      signal: context.signal,\n    });\n    const confirmationRaw = assertTransactionConfirmed(confirmation, {\n      code: \"BROADCAST_FAILED\",\n      stage: \"broadcast\",\n      message: \"Aptos transaction failed\",\n    });\n    return {\n      status: \"source-confirmed\",\n      txHash: submission.txHash,\n      raw: confirmationRaw ?? submission.raw,\n    };\n  } catch (error) {\n    throw mapExecutorError(\n      error,\n      adapter,\n      \"broadcast\",\n      \"BROADCAST_FAILED\",\n      \"Failed while confirming Aptos transaction\"\n    );\n  }\n}\n"]}

package/dist/executors/bitcoin.d.mts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.mjs';
+import { ad as ExecutorErrorAdapter, C as ChainRef, ae as TransactionSubmission, T as TransactionConfirmation, w as ChainExecutor } from '../shared-COkGiqaz.mjs';
 
 interface BitcoinWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;

package/dist/executors/bitcoin.d.ts

@@ -1,4 +1,4 @@
-import { a4 as ExecutorErrorAdapter, C as ChainRef, a5 as TransactionSubmission, T as TransactionConfirmation, q as ChainExecutor } from '../shared-D0_DbMT2.js';
+import { ad as ExecutorErrorAdapter, C as ChainRef, ae as TransactionSubmission, T as TransactionConfirmation, w as ChainExecutor } from '../shared-COkGiqaz.js';
 
 interface BitcoinWalletAdapter extends ExecutorErrorAdapter {
     getChain(): ChainRef | Promise<ChainRef>;