@vultisig/core-chain 2.5.0 → 2.7.0

package/CHANGELOG.md

@@ -1,5 +1,69 @@
 # @vultisig/core-chain
 
+## 2.7.0
+
+### Minor Changes
+
+- [#585](https://github.com/vultisig/vultisig-sdk/pull/585) [`1bf8a6d`](https://github.com/vultisig/vultisig-sdk/commit/1bf8a6d36788b702092d92918294d67cdc6e11b7) Thanks [@NeOMakinG](https://github.com/NeOMakinG)! - Add `getSwapExplorerUrl` helper for swap-provider tx links ([#426](https://github.com/vultisig/vultisig-sdk/issues/426)).
+
+  Tx history surfaces (vultisig-windows, vultiagent-app, future RN SDK) now have a single source of truth for "View on Explorer" URLs that point to the swap **provider's** scanner — `scan.li.fi`, `orb.helius.dev` for LI.FI Solana settlement, `runescan.io` for THORChain, and the MayaChain explorer — instead of every consumer reimplementing the routing and most defaulting to the source-chain explorer (which hides cross-chain routes from users).
+  - New: `getSwapExplorerUrl({ provider, txHash, fromChain })` in `@vultisig/core-chain/swap/utils/getSwapExplorerUrl`
+  - New: `Vultisig.getSwapExplorerUrl(provider, txHash, fromChain)` static method for parity with `getTxExplorerUrl`
+  - For `1inch` / `kyber` / `swapkit`, falls back to the source-chain explorer (no public per-tx aggregator page)
+  - Mirrors iOS `ExplorerLinkBuilder.swift` and Android `ExplorerLinkRepository.getSwapProgressLink`
+  - Pure URL builder, no new deps
+
+### Patch Changes
+
+- [#600](https://github.com/vultisig/vultisig-sdk/pull/600) [`d1c12b2`](https://github.com/vultisig/vultisig-sdk/commit/d1c12b24bc55a318a8f87998d2320651f875b00a) Thanks [@Ehsan-saradar](https://github.com/Ehsan-saradar)! - fix(swap/swapkit): reclassify noRoutesFound as "amount too small" when the pair is structurally supported - cross-checks the cached /providers snapshot so low-amount swaps (e.g. BCH->ETH) surface an actionable message instead of a misleading "no route" error
+
+## 2.6.0
+
+### Minor Changes
+
+- [#584](https://github.com/vultisig/vultisig-sdk/pull/584) [`a13c644`](https://github.com/vultisig/vultisig-sdk/commit/a13c644be796a7bf10dc0ab426ac888b9e962585) Thanks [@gomesalexandre](https://github.com/gomesalexandre)! - feat(cowswap): add CowSwap RFQ as swap provider for same-chain EVM trades (phase 1 sdk scaffold)
+
+  New `cowswap` module under `packages/core/chain/swap/general/cowswap/`:
+  - `config.ts` - chain configs (Ethereum, Arbitrum, Base, Avalanche), static EIP-2612 permit allowlist, app code / affiliate constants
+  - `types.ts` - CowSwap API response types
+  - `sign/buildCowSwapOrder.ts` - builds the EIP-712 CowSwap order struct; exports `buildCowSwapAppData` and `keccak256Hex` (uses viem)
+  - `sign/buildEip712Domain.ts` - EIP-712 domain for GPv2 settlement contract
+  - `api/getCowSwapQuote.ts` - POSTs to `/api/v1/quote`, returns `GeneralSwapQuote` with new `cowswap_order` tx arm
+  - `api/submitCowSwapOrder.ts` - POSTs signed order to `/api/v1/orders`
+  - `api/getCowSwapOrderStatus.ts` - polls order status
+  - `permit/buildEip2612Permit.ts` - builds EIP-2612 permit typed data for permit-eligible sell tokens
+
+  `GeneralSwapTx` union extended with `cowswap_order` arm.
+  `GeneralSwapProvider` extended with `'cowswap'`.
+  CowSwap is intentionally NOT registered as a live `findSwapQuote` fetcher (nor in
+  `aggregatorPreferenceOrder`) in phase 1 — the consumer build/sign path is wired in phase 2.
+  All `matchRecordUnion` call-sites over `GeneralSwapTx` updated for exhaustiveness.
+
+  No live fetcher registration, no mcp-ts wiring, no app UI changes. Consumer (mcp-ts) is responsible for USD threshold gating in phase 2.
+
+- [#584](https://github.com/vultisig/vultisig-sdk/pull/584) [`a13c644`](https://github.com/vultisig/vultisig-sdk/commit/a13c644be796a7bf10dc0ab426ac888b9e962585) Thanks [@gomesalexandre](https://github.com/gomesalexandre)! - ## New
+  - Polkadot Asset Hub USDT (asset_id 1984) + USDC (asset_id 1337) token registry ([#562](https://github.com/vultisig/vultisig-sdk/issues/562))
+  - Polkadot `pallet_assets.Account` balance resolver for Asset Hub tokens - replaces placeholder 0n guard ([#563](https://github.com/vultisig/vultisig-sdk/issues/563))
+  - Tron native send `data` field (proto field 12) for THORChain memos + exchange deposit memos; `BuildTronSendOptions` and `BuildTrc20TransferOptions` gain optional `data?: Uint8Array` field ([#559](https://github.com/vultisig/vultisig-sdk/issues/559))
+
+  ## Fixed
+  - Tron TRC-20 fee estimate now subtracts sender's available energy before charging TRX ([#556](https://github.com/vultisig/vultisig-sdk/issues/556))
+  - Tron native send free bandwidth check prevents spurious fee charge when bandwidth is available ([#555](https://github.com/vultisig/vultisig-sdk/issues/555))
+
+### Patch Changes
+
+- [#602](https://github.com/vultisig/vultisig-sdk/pull/602) [`5bb56a4`](https://github.com/vultisig/vultisig-sdk/commit/5bb56a4daba8b896626c54fabd94fd6c9a35320e) Thanks [@gomesalexandre](https://github.com/gomesalexandre)! - `getCosmosAccountInfo` now retries against a registered fallback LCD when the primary endpoint fails. Without this, a single-provider degradation (e.g. `terra-classic-lcd.publicnode.com` outage on 2026-05-28) hard-failed every cosmos signing surface that touches this code path — there was no recovery.
+
+  Fallback URLs per chain (Polkachu mirrors where available; Hexxagon for `TerraClassic` since polkachu has no Terra Classic endpoint, verified 2026-05-28). Chains not in the map preserve fail-closed behaviour.
+
+  Parallel to vultiagent-app#1017 (app-side fix) + mcp-ts#266 (mcp-side fix).
+
+- [#592](https://github.com/vultisig/vultisig-sdk/pull/592) [`c4b4560`](https://github.com/vultisig/vultisig-sdk/commit/c4b45604f043700068aaf1c3c1a1ecad5c8a874f) Thanks [@gomesalexandre](https://github.com/gomesalexandre)! - lifi: tighten slippage to 0.3% for stablecoin pairs (USDC/USDT/DAI/...), keep 1% for volatile pairs
+
+- [#596](https://github.com/vultisig/vultisig-sdk/pull/596) [`880cde0`](https://github.com/vultisig/vultisig-sdk/commit/880cde00a5978e8a4dff2cf8adb627059e4af5bf) Thanks [@gomesalexandre](https://github.com/gomesalexandre)! - Remove i18next dependency from `getNativeSwapQuote` — the lone `t()` call was the only i18next usage in the entire chain package, and consuming apps that don't initialize i18next (or initialize it without a Backend plugin) crash with `Cannot read property 'reload' of undefined` whenever code touches the SDK swap path. Replaced with a plain English fallback string. Drops i18next from `dependencies`.
+
+- [#593](https://github.com/vultisig/vultisig-sdk/pull/593) [`5d11cf3`](https://github.com/vultisig/vultisig-sdk/commit/5d11cf3bfb81aba929fe8e81bb77e7aebff15129) Thanks [@gomesalexandre](https://github.com/gomesalexandre)! - refactor(swap): typed SwapError class with stable codes at findSwapQuote throw sites - enables instanceof checks instead of message string matching
+
 ## 2.5.0
 
 ### Minor Changes

package/dist/chains/cosmos/account/getCosmosAccountInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getCosmosAccountInfo.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/account/getCosmosAccountInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAsEhE,eAAO,MAAM,oBAAoB,GAAU,oBAAoB,YAAY,CAAC,WAAW,CAAC;;;;;;EAgCvF,CAAA"}
+{"version":3,"file":"getCosmosAccountInfo.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/account/getCosmosAccountInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAyGhE,eAAO,MAAM,oBAAoB,GAAU,oBAAoB,YAAY,CAAC,WAAW,CAAC;;;;;;EAgCvF,CAAA"}

package/dist/chains/cosmos/account/getCosmosAccountInfo.js

@@ -1,3 +1,4 @@
+import { Chain } from '@vultisig/core-chain/Chain';
 import { getCosmosClient } from '@vultisig/core-chain/chains/cosmos/client';
 import { cosmosRpcUrl } from '@vultisig/core-chain/chains/cosmos/cosmosRpcUrl';
 import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
@@ -23,19 +24,54 @@ const parseLcdAccount = (resp) => {
 // LCD uses a different infra path (REST vs Tendermint RPC), supports
 // extended account types (vesting, module wrappers) via JSON shape parsing,
 // and gives us a second chance before we ship a doomed tx.
-const fetchAccountViaLcd = async (chain, address) => {
-    const base = cosmosRpcUrl[chain];
-    if (!base)
-        return null;
+//
+// SamYap timeout report (vultiagent-app#1017, 2026-05-28): the primary LCD
+// for Terra Classic (terra-classic-lcd.publicnode.com) was degraded for
+// hours, causing every cosmos signing surface that touches this code path
+// to hard-fail. The single-URL design had no recovery. Add a fallback URL
+// per chain so a publicnode degradation doesn't take out signing entirely.
+//
+// Polkachu mirrors per cosmos chain. Hexxagon for columbus-5 since polkachu
+// has no Terra Classic endpoint (verified 2026-05-28 — see
+// vultiagent-app#1017 + mcp-ts#266). Keys are the chain id used by
+// cosmos-sdk; chains not in this map have no fallback (degrade fail-closed
+// behaviour preserved).
+const COSMOS_LCD_FALLBACK_URLS = {
+    [Chain.Cosmos]: 'https://cosmos-api.polkachu.com',
+    [Chain.Osmosis]: 'https://osmosis-api.polkachu.com',
+    [Chain.Kujira]: 'https://kujira-api.polkachu.com',
+    [Chain.Terra]: 'https://terra-api.polkachu.com',
+    [Chain.TerraClassic]: 'https://lcd.terra-classic.hexxagon.io',
+    [Chain.THORChain]: 'https://thorchain-api.polkachu.com',
+    [Chain.Noble]: 'https://noble-api.polkachu.com',
+    [Chain.Dydx]: 'https://dydx-api.polkachu.com',
+    [Chain.Akash]: 'https://akash-api.polkachu.com',
+};
+const tryLcd = async (base, address) => {
     try {
         const resp = await queryUrl(`${base}/cosmos/auth/v1beta1/accounts/${address}`);
         return parseLcdAccount(resp);
     }
     catch {
-        // 404 (account not found) or transient LCD error — caller decides.
         return null;
     }
 };
+const fetchAccountViaLcd = async (chain, address) => {
+    const base = cosmosRpcUrl[chain];
+    if (!base)
+        return null;
+    const primary = await tryLcd(base, address);
+    if (primary)
+        return primary;
+    // Primary failed (network / 5xx / shape mismatch). Try the registered
+    // fallback for this chain. Both-failed surfaces as null and the caller
+    // ships with sequence:0 default — same legacy behaviour, but only after
+    // we've actually exhausted both endpoints.
+    const fallback = COSMOS_LCD_FALLBACK_URLS[chain];
+    if (!fallback)
+        return null;
+    return tryLcd(fallback, address);
+};
 export const getCosmosAccountInfo = async ({ chain, address }) => {
     const client = await getCosmosClient(chain);
     const [accountInfo, block] = await Promise.all([client.getAccount(address), client.getBlock()]);

package/dist/chains/cosmos/account/getCosmosAccountInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCosmosAccountInfo.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/account/getCosmosAccountInfo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"getCosmosAccountInfo.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/cosmos/account/getCosmosAccountInfo.ts"],"names":[],"mappings":"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"}

package/dist/swap/NoSwapRoutesError.d.ts

@@ -1,4 +1,5 @@
-export declare class NoSwapRoutesError extends Error {
+import { SwapError } from './SwapError.js';
+export declare class NoSwapRoutesError extends SwapError {
     constructor();
 }
 //# sourceMappingURL=NoSwapRoutesError.d.ts.map

package/dist/swap/NoSwapRoutesError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NoSwapRoutesError.d.ts","sourceRoot":"","sources":["../../../../../packages/core/chain/swap/NoSwapRoutesError.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;;CAI3C"}
+{"version":3,"file":"NoSwapRoutesError.d.ts","sourceRoot":"","sources":["../../../../../packages/core/chain/swap/NoSwapRoutesError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAA;AAEtD,qBAAa,iBAAkB,SAAQ,SAAS;;CAI/C"}

package/dist/swap/NoSwapRoutesError.js

@@ -1,6 +1,7 @@
-export class NoSwapRoutesError extends Error {
+import { SwapError, SwapErrorCode } from './SwapError.js';
+export class NoSwapRoutesError extends SwapError {
     constructor() {
-        super(`No swap routes found.`);
+        super(SwapErrorCode.NoRoutesFound, `No swap routes found.`);
     }
 }
 //# sourceMappingURL=NoSwapRoutesError.js.map

package/dist/swap/NoSwapRoutesError.js.map

@@ -1 +1 @@
-{"version":3,"file":"NoSwapRoutesError.js","sourceRoot":"","sources":["../../../../../packages/core/chain/swap/NoSwapRoutesError.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C;QACE,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAChC,CAAC;CACF"}
+{"version":3,"file":"NoSwapRoutesError.js","sourceRoot":"","sources":["../../../../../packages/core/chain/swap/NoSwapRoutesError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C;QACE,KAAK,CAAC,aAAa,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAA;IAC7D,CAAC;CACF"}

package/dist/swap/SwapError.d.ts

@@ -0,0 +1,18 @@
+export declare enum SwapErrorCode {
+    /** No swap provider supports this chain pair - swap cannot be attempted at all */
+    NoRoutesFound = "SWAP_NO_ROUTES_FOUND",
+    /** Amount is below the dust threshold of one or more providers */
+    AmountTooSmall = "SWAP_AMOUNT_TOO_SMALL",
+    /** Amount is below a provider's minimum but above dust - provider surfaced an explicit min */
+    AmountBelowMinimum = "SWAP_AMOUNT_BELOW_MINIMUM",
+    /** All configured providers were attempted and all failed */
+    AllProvidersFailed = "SWAP_ALL_PROVIDERS_FAILED",
+    /** Caller passed invalid configuration (e.g. mixed-case THORName affiliateFeeAddress) */
+    InvalidConfig = "SWAP_INVALID_CONFIG"
+}
+export declare class SwapError extends Error {
+    readonly code: SwapErrorCode;
+    readonly name = "SwapError";
+    constructor(code: SwapErrorCode, message: string);
+}
+//# sourceMappingURL=SwapError.d.ts.map

package/dist/swap/SwapError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwapError.d.ts","sourceRoot":"","sources":["../../../../../packages/core/chain/swap/SwapError.ts"],"names":[],"mappings":"AAAA,oBAAY,aAAa;IACvB,kFAAkF;IAClF,aAAa,yBAAyB;IACtC,kEAAkE;IAClE,cAAc,0BAA0B;IACxC,8FAA8F;IAC9F,kBAAkB,8BAA8B;IAChD,6DAA6D;IAC7D,kBAAkB,8BAA8B;IAChD,yFAAyF;IACzF,aAAa,wBAAwB;CACtC;AAED,qBAAa,SAAU,SAAQ,KAAK;aAIhB,IAAI,EAAE,aAAa;IAHrC,QAAQ,CAAC,IAAI,eAAc;gBAGT,IAAI,EAAE,aAAa,EACnC,OAAO,EAAE,MAAM;CAIlB"}

package/dist/swap/SwapError.js

@@ -0,0 +1,22 @@
+export var SwapErrorCode;
+(function (SwapErrorCode) {
+    /** No swap provider supports this chain pair - swap cannot be attempted at all */
+    SwapErrorCode["NoRoutesFound"] = "SWAP_NO_ROUTES_FOUND";
+    /** Amount is below the dust threshold of one or more providers */
+    SwapErrorCode["AmountTooSmall"] = "SWAP_AMOUNT_TOO_SMALL";
+    /** Amount is below a provider's minimum but above dust - provider surfaced an explicit min */
+    SwapErrorCode["AmountBelowMinimum"] = "SWAP_AMOUNT_BELOW_MINIMUM";
+    /** All configured providers were attempted and all failed */
+    SwapErrorCode["AllProvidersFailed"] = "SWAP_ALL_PROVIDERS_FAILED";
+    /** Caller passed invalid configuration (e.g. mixed-case THORName affiliateFeeAddress) */
+    SwapErrorCode["InvalidConfig"] = "SWAP_INVALID_CONFIG";
+})(SwapErrorCode || (SwapErrorCode = {}));
+export class SwapError extends Error {
+    code;
+    name = 'SwapError';
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=SwapError.js.map

package/dist/swap/SwapError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwapError.js","sourceRoot":"","sources":["../../../../../packages/core/chain/swap/SwapError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,aAWX;AAXD,WAAY,aAAa;IACvB,kFAAkF;IAClF,uDAAsC,CAAA;IACtC,kEAAkE;IAClE,yDAAwC,CAAA;IACxC,8FAA8F;IAC9F,iEAAgD,CAAA;IAChD,6DAA6D;IAC7D,iEAAgD,CAAA;IAChD,yFAAyF;IACzF,sDAAqC,CAAA;AACvC,CAAC,EAXW,aAAa,KAAb,aAAa,QAWxB;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAIhB;IAHT,IAAI,GAAG,WAAW,CAAA;IAE3B,YACkB,IAAmB,EACnC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,SAAI,GAAJ,IAAI,CAAe;IAIrC,CAAC;CACF"}

package/dist/swap/general/GeneralSwapProvider.d.ts

@@ -1,4 +1,4 @@
-export declare const generalSwapProviders: readonly ["1inch", "li.fi", "kyber", "swapkit"];
+export declare const generalSwapProviders: readonly ["1inch", "li.fi", "kyber", "swapkit", "cowswap"];
 export type GeneralSwapProvider = (typeof generalSwapProviders)[number];
 export declare const generalSwapProviderName: Record<GeneralSwapProvider, string>;
 //# sourceMappingURL=GeneralSwapProvider.d.ts.map

package/dist/swap/general/GeneralSwapProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneralSwapProvider.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/general/GeneralSwapProvider.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,iDAAkD,CAAA;AAEnF,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAKvE,CAAA"}
+{"version":3,"file":"GeneralSwapProvider.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/general/GeneralSwapProvider.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,4DAA6D,CAAA;AAE9F,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAMvE,CAAA"}

package/dist/swap/general/GeneralSwapProvider.js

@@ -1,8 +1,9 @@
-export const generalSwapProviders = ['1inch', 'li.fi', 'kyber', 'swapkit'];
+export const generalSwapProviders = ['1inch', 'li.fi', 'kyber', 'swapkit', 'cowswap'];
 export const generalSwapProviderName = {
     '1inch': '1Inch',
     'li.fi': 'LI.FI',
     kyber: 'KyberSwap',
     swapkit: 'SwapKit',
+    cowswap: 'CowSwap',
 };
 //# sourceMappingURL=GeneralSwapProvider.js.map

package/dist/swap/general/GeneralSwapProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeneralSwapProvider.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/general/GeneralSwapProvider.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAU,CAAA;AAInF,MAAM,CAAC,MAAM,uBAAuB,GAAwC;IAC1E,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,SAAS;CACnB,CAAA"}
+{"version":3,"file":"GeneralSwapProvider.js","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/general/GeneralSwapProvider.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAU,CAAA;AAI9F,MAAM,CAAC,MAAM,uBAAuB,GAAwC;IAC1E,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACnB,CAAA"}

package/dist/swap/general/GeneralSwapQuote.d.ts

@@ -1,4 +1,6 @@
 import { SwapFee } from '@vultisig/core-chain/swap/SwapFee';
+import { CowSwapTokenBalance } from './cowswap/sign/buildCowSwapOrder.js';
+import { CowSwapOrderKind } from './cowswap/types.js';
 import { GeneralSwapProvider } from './GeneralSwapProvider.js';
 export type GeneralSwapTx = {
     evm: {
@@ -25,7 +27,39 @@ export type GeneralSwapTx = {
         inboundAddress?: string;
         swapId?: string;
     };
+} | {
+    cowswap_order: {
+        sellToken: string;
+        buyToken: string;
+        receiver: string;
+        sellAmount: string;
+        buyAmount: string;
+        validTo: number;
+        appData: string;
+        appDataHash: string;
+        feeAmount: string;
+        kind: CowSwapOrderKind;
+        partiallyFillable: boolean;
+        sellTokenBalance: CowSwapTokenBalance;
+        buyTokenBalance: CowSwapTokenBalance;
+        chainId: number;
+        apiBase: string;
+        /** Set to true when the sellToken supports EIP-2612 permit. When true
+         * the signing flow should build and include a permit signature alongside
+         * the order signature, avoiding a separate ERC-20 approve transaction. */
+        permitRequired?: true;
+    };
 };
+/**
+ * Quote returned by an EVM/Solana general-purpose swap aggregator.
+ *
+ * Consumers building a "View on Explorer" link should call
+ * `getSwapExplorerUrl({ provider, txHash, fromChain })` from
+ * `@vultisig/core-chain/swap/utils/getSwapExplorerUrl` instead of routing
+ * by hand — the helper covers the LI.FI / Helius scanners and falls back to
+ * the source-chain explorer for `1inch` / `kyber` / `swapkit` (none of which
+ * expose a per-tx aggregator page).
+ */
 export type GeneralSwapQuote = {
     dstAmount: string;
     provider: GeneralSwapProvider;

package/dist/swap/general/GeneralSwapQuote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneralSwapQuote.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/general/GeneralSwapQuote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAA;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE3D,MAAM,MAAM,aAAa,GACrB;IACE,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,YAAY,CAAC,EAAE,OAAO,CAAA;KACvB,CAAA;CACF,GACD;IACE,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,OAAO,CAAA;KACjB,CAAA;CACF,GACD;IACE,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,SAAS,CAAC,EAAE,UAAU,CAAA;QACtB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAEL,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,EAAE,EAAE,aAAa,CAAA;CAClB,CAAA"}
+{"version":3,"file":"GeneralSwapQuote.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/chain/swap/general/GeneralSwapQuote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAA;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE3D,MAAM,MAAM,aAAa,GACrB;IACE,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,YAAY,CAAC,EAAE,OAAO,CAAA;KACvB,CAAA;CACF,GACD;IACE,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,OAAO,CAAA;KACjB,CAAA;CACF,GACD;IACE,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,SAAS,CAAC,EAAE,UAAU,CAAA;QACtB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,GACD;IACE,aAAa,EAAE;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,IAAI,EAAE,gBAAgB,CAAA;QACtB,iBAAiB,EAAE,OAAO,CAAA;QAC1B,gBAAgB,EAAE,mBAAmB,CAAA;QACrC,eAAe,EAAE,mBAAmB,CAAA;QACpC,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf;;kFAE0E;QAC1E,cAAc,CAAC,EAAE,IAAI,CAAA;KACtB,CAAA;CACF,CAAA;AAEL;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,EAAE,EAAE,aAAa,CAAA;CAClB,CAAA"}

package/dist/swap/general/cowswap/api/getCowSwapOrderStatus.d.ts

@@ -0,0 +1,9 @@
+import { CowSwapOrderStatusResponse } from '../types.js';
+type GetCowSwapOrderStatusInput = {
+    apiBase: string;
+    uid: string;
+};
+/** GET /api/v1/orders/{uid} — poll order status. */
+export declare function getCowSwapOrderStatus({ apiBase, uid, }: GetCowSwapOrderStatusInput): Promise<CowSwapOrderStatusResponse>;
+export {};
+//# sourceMappingURL=getCowSwapOrderStatus.d.ts.map

package/dist/swap/general/cowswap/api/getCowSwapOrderStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCowSwapOrderStatus.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/cowswap/api/getCowSwapOrderStatus.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAErD,KAAK,0BAA0B,GAAG;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,oDAAoD;AACpD,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,EACP,GAAG,GACJ,EAAE,0BAA0B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAUlE"}

package/dist/swap/general/cowswap/api/getCowSwapOrderStatus.js

@@ -0,0 +1,11 @@
+import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+/** GET /api/v1/orders/{uid} — poll order status. */
+export async function getCowSwapOrderStatus({ apiBase, uid, }) {
+    const raw = await queryUrl(`${apiBase}/api/v1/orders/${uid}`);
+    return {
+        status: raw.status,
+        txHash: raw.txHash,
+        executedBuyAmount: raw.executedBuyAmount,
+    };
+}
+//# sourceMappingURL=getCowSwapOrderStatus.js.map

package/dist/swap/general/cowswap/api/getCowSwapOrderStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCowSwapOrderStatus.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/cowswap/api/getCowSwapOrderStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAS7D,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,OAAO,EACP,GAAG,GACwB;IAC3B,MAAM,GAAG,GAAG,MAAM,QAAQ,CACxB,GAAG,OAAO,kBAAkB,GAAG,EAAE,CAClC,CAAA;IAED,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAA8C;QAC1D,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;KACzC,CAAA;AACH,CAAC"}

package/dist/swap/general/cowswap/api/getCowSwapQuote.d.ts

@@ -0,0 +1,14 @@
+import { GeneralSwapQuote } from '../../GeneralSwapQuote.js';
+import { CowSwapChainConfig } from '../config.js';
+type GetCowSwapQuoteInput = {
+    sellToken: string;
+    buyToken: string;
+    sellAmount: bigint;
+    from: string;
+    receiver: string;
+    chainConfig: CowSwapChainConfig;
+    affiliateBps?: number;
+};
+export declare function getCowSwapQuote({ sellToken, buyToken, sellAmount, from, receiver, chainConfig, affiliateBps, }: GetCowSwapQuoteInput): Promise<GeneralSwapQuote>;
+export {};
+//# sourceMappingURL=getCowSwapQuote.d.ts.map

package/dist/swap/general/cowswap/api/getCowSwapQuote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCowSwapQuote.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/cowswap/api/getCowSwapQuote.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAGL,kBAAkB,EAEnB,MAAM,WAAW,CAAA;AAiBlB,KAAK,oBAAoB,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,kBAAkB,CAAA;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,wBAAsB,eAAe,CAAC,EACpC,SAAS,EACT,QAAQ,EACR,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,YAAY,GACb,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqDlD"}

package/dist/swap/general/cowswap/api/getCowSwapQuote.js

@@ -0,0 +1,51 @@
+import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+import { COWSWAP_DEFAULT_AFFILIATE_BPS, COWSWAP_FEE_RECIPIENT, KNOWN_PERMIT_TOKENS, } from '../config.js';
+import { buildCowSwapAppData, keccak256Hex } from '../sign/buildCowSwapOrder.js';
+export async function getCowSwapQuote({ sellToken, buyToken, sellAmount, from, receiver, chainConfig, affiliateBps, }) {
+    const bps = affiliateBps ?? COWSWAP_DEFAULT_AFFILIATE_BPS;
+    const appData = buildCowSwapAppData(bps, COWSWAP_FEE_RECIPIENT);
+    const appDataHash = keccak256Hex(appData);
+    const body = {
+        sellToken: sellToken.toLowerCase(),
+        buyToken: buyToken.toLowerCase(),
+        sellAmountBeforeFee: sellAmount.toString(),
+        from: from.toLowerCase(),
+        receiver: receiver.toLowerCase(),
+        kind: 'sell',
+        signingScheme: 'eip712',
+        partiallyFillable: false,
+        appData,
+        appDataHash,
+    };
+    const response = await queryUrl(`${chainConfig.apiBase}/api/v1/quote`, {
+        method: 'POST',
+        body,
+    });
+    const { quote } = response;
+    const permitRequired = KNOWN_PERMIT_TOKENS[chainConfig.chainId]?.some(addr => addr.toLowerCase() === sellToken.toLowerCase());
+    return {
+        dstAmount: quote.buyAmount,
+        provider: 'cowswap',
+        tx: {
+            cowswap_order: {
+                sellToken: quote.sellToken,
+                buyToken: quote.buyToken,
+                receiver,
+                sellAmount: quote.sellAmount,
+                buyAmount: quote.buyAmount,
+                validTo: quote.validTo,
+                appData,
+                appDataHash,
+                feeAmount: quote.feeAmount,
+                kind: quote.kind,
+                partiallyFillable: quote.partiallyFillable,
+                sellTokenBalance: 'erc20',
+                buyTokenBalance: 'erc20',
+                chainId: chainConfig.chainId,
+                apiBase: chainConfig.apiBase,
+                ...(permitRequired ? { permitRequired: true } : {}),
+            },
+        },
+    };
+}
+//# sourceMappingURL=getCowSwapQuote.js.map

package/dist/swap/general/cowswap/api/getCowSwapQuote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCowSwapQuote.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/cowswap/api/getCowSwapQuote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAG7D,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EAErB,mBAAmB,GACpB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AA0B7E,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EACpC,SAAS,EACT,QAAQ,EACR,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,YAAY,GACS;IACrB,MAAM,GAAG,GAAG,YAAY,IAAI,6BAA6B,CAAA;IACzD,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAA;IAC/D,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;IAEzC,MAAM,IAAI,GAAwB;QAChC,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE;QAClC,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE;QAChC,mBAAmB,EAAE,UAAU,CAAC,QAAQ,EAAE;QAC1C,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;QACxB,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE;QAChC,IAAI,EAAE,MAAM;QACZ,aAAa,EAAE,QAAQ;QACvB,iBAAiB,EAAE,KAAK;QACxB,OAAO;QACP,WAAW;KACZ,CAAA;IAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAA0B,GAAG,WAAW,CAAC,OAAO,eAAe,EAAE;QAC9F,MAAM,EAAE,MAAM;QACd,IAAI;KACL,CAAC,CAAA;IAEF,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAA;IAE1B,MAAM,cAAc,GAAG,mBAAmB,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,IAAI,CACnE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CACvD,CAAA;IAED,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,SAAS;QACnB,EAAE,EAAE;YACF,aAAa,EAAE;gBACb,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ;gBACR,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO;gBACP,WAAW;gBACX,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,gBAAgB,EAAE,OAAO;gBACzB,eAAe,EAAE,OAAO;gBACxB,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpD;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/swap/general/cowswap/api/submitCowSwapOrder.d.ts

@@ -0,0 +1,12 @@
+import { CowSwapOrder } from '../sign/buildCowSwapOrder.js';
+type SubmitCowSwapOrderInput = {
+    apiBase: string;
+    order: CowSwapOrder;
+    signature: string;
+    from: string;
+};
+/** POST /api/v1/orders — submit a signed CowSwap order.
+ * Returns the orderUid assigned by the API. */
+export declare function submitCowSwapOrder({ apiBase, order, signature, from, }: SubmitCowSwapOrderInput): Promise<string>;
+export {};
+//# sourceMappingURL=submitCowSwapOrder.d.ts.map

package/dist/swap/general/cowswap/api/submitCowSwapOrder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submitCowSwapOrder.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/cowswap/api/submitCowSwapOrder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAExD,KAAK,uBAAuB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,YAAY,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;+CAC+C;AAC/C,wBAAsB,kBAAkB,CAAC,EACvC,OAAO,EACP,KAAK,EACL,SAAS,EACT,IAAI,GACL,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3C"}

package/dist/swap/general/cowswap/api/submitCowSwapOrder.js

@@ -0,0 +1,17 @@
+import { queryUrl } from '@vultisig/lib-utils/query/queryUrl';
+/** POST /api/v1/orders — submit a signed CowSwap order.
+ * Returns the orderUid assigned by the API. */
+export async function submitCowSwapOrder({ apiBase, order, signature, from, }) {
+    const body = {
+        ...order,
+        signature,
+        signingScheme: 'eip712',
+        from: from.toLowerCase(),
+    };
+    const orderUid = await queryUrl(`${apiBase}/api/v1/orders`, {
+        method: 'POST',
+        body,
+    });
+    return orderUid;
+}
+//# sourceMappingURL=submitCowSwapOrder.js.map

package/dist/swap/general/cowswap/api/submitCowSwapOrder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submitCowSwapOrder.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/swap/general/cowswap/api/submitCowSwapOrder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AAW7D;+CAC+C;AAC/C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,OAAO,EACP,KAAK,EACL,SAAS,EACT,IAAI,GACoB;IACxB,MAAM,IAAI,GAAG;QACX,GAAG,KAAK;QACR,SAAS;QACT,aAAa,EAAE,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;KACzB,CAAA;IAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAS,GAAG,OAAO,gBAAgB,EAAE;QAClE,MAAM,EAAE,MAAM;QACd,IAAI;KACL,CAAC,CAAA;IAEF,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/swap/general/cowswap/config.d.ts

@@ -0,0 +1,18 @@
+export declare const cowSwapSupportedChains: readonly ["Ethereum", "Arbitrum", "Base", "Avalanche"];
+export type CowSwapSupportedChain = (typeof cowSwapSupportedChains)[number];
+export declare const COW_SETTLEMENT_ADDRESS = "0x9008D19f58AAbD9eD0D60971565AA8510560ab41";
+export declare const COW_VAULT_RELAYER_ADDRESS = "0xC92E8bdf79f0507f65a392b0ab4667716BFE0110";
+export type CowSwapChainConfig = {
+    apiBase: string;
+    settlementContract: string;
+    vaultRelayer: string;
+    chainId: number;
+};
+export declare const cowSwapChainConfig: Record<CowSwapSupportedChain, CowSwapChainConfig>;
+export declare const KNOWN_PERMIT_TOKENS: Record<number, string[]>;
+export declare const COWSWAP_APP_CODE = "vultisig";
+export declare const COWSWAP_APP_VERSION = "0.1.0";
+export declare const COWSWAP_DEFAULT_AFFILIATE_BPS = 50;
+export declare const COWSWAP_FEE_RECIPIENT = "0x8E247a480449c84a5fDD25974A8501f3EFa4ABb9";
+export declare const COWSWAP_VALID_TO_SECONDS: number;
+//# sourceMappingURL=config.d.ts.map

package/dist/swap/general/cowswap/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/swap/general/cowswap/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,wDAAqF,CAAA;AAExH,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAA;AAG3E,eAAO,MAAM,sBAAsB,+CAA+C,CAAA;AAClF,eAAO,MAAM,yBAAyB,+CAA+C,CAAA;AAErF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAyBhF,CAAA;AAqBD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAqBxD,CAAA;AAED,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAC1C,eAAO,MAAM,mBAAmB,UAAU,CAAA;AAK1C,eAAO,MAAM,6BAA6B,KAAK,CAAA;AAG/C,eAAO,MAAM,qBAAqB,+CAA+C,CAAA;AAGjF,eAAO,MAAM,wBAAwB,QAAU,CAAA"}

package/dist/swap/general/cowswap/config.js

@@ -0,0 +1,83 @@
+import { EvmChain } from '@vultisig/core-chain/Chain';
+export const cowSwapSupportedChains = [EvmChain.Ethereum, EvmChain.Arbitrum, EvmChain.Base, EvmChain.Avalanche];
+// CowSwap GPv2 contract addresses — same across all supported EVM chains.
+export const COW_SETTLEMENT_ADDRESS = '0x9008D19f58AAbD9eD0D60971565AA8510560ab41';
+export const COW_VAULT_RELAYER_ADDRESS = '0xC92E8bdf79f0507f65a392b0ab4667716BFE0110';
+export const cowSwapChainConfig = {
+    [EvmChain.Ethereum]: {
+        apiBase: 'https://api.cow.fi/mainnet',
+        settlementContract: COW_SETTLEMENT_ADDRESS,
+        vaultRelayer: COW_VAULT_RELAYER_ADDRESS,
+        chainId: 1,
+    },
+    [EvmChain.Arbitrum]: {
+        apiBase: 'https://api.cow.fi/arbitrum_one',
+        settlementContract: COW_SETTLEMENT_ADDRESS,
+        vaultRelayer: COW_VAULT_RELAYER_ADDRESS,
+        chainId: 42161,
+    },
+    [EvmChain.Base]: {
+        apiBase: 'https://api.cow.fi/base',
+        settlementContract: COW_SETTLEMENT_ADDRESS,
+        vaultRelayer: COW_VAULT_RELAYER_ADDRESS,
+        chainId: 8453,
+    },
+    [EvmChain.Avalanche]: {
+        apiBase: 'https://api.cow.fi/avalanche',
+        settlementContract: COW_SETTLEMENT_ADDRESS,
+        vaultRelayer: COW_VAULT_RELAYER_ADDRESS,
+        chainId: 43114,
+    },
+};
+// Static allowlist of EIP-2612 permit-supporting tokens per chain.
+// Tradeoff: an RPC-probe approach would be fully dynamic but requires an extra
+// call per token per quote. Static list covers the vast majority of common
+// pairs (USDC/USDT on all v1 chains) at zero overhead. Track additions
+// as a follow-up when new permit tokens need support.
+//
+// IMPORTANT: every entry MUST implement the canonical EIP-2612 Permit struct
+// (`owner,spender,value,nonce,deadline`). Tokens with a non-EIP-2612 permit, or
+// no permit at all, are deliberately EXCLUDED — flagging them `permitRequired`
+// would have Phase 2 build an EIP-2612 signature the token can't honor, and the
+// CowSwap order would fail at settlement. On-chain `PERMIT_TYPEHASH()` /
+// `DOMAIN_SEPARATOR()` verified 2026-05-28:
+//   - Ethereum DAI (0x6B17…) — Maker-style permit (holder,spender,nonce,expiry,
+//     allowed); typehash 0xea2aa0a1…, NOT EIP-2612. EXCLUDED.
+//   - Ethereum USDT (0xdAC1…) — no EIP-2612 permit (DOMAIN_SEPARATOR reverts).
+//     EXCLUDED.
+//   - Base DAI (0x50c5…) / Avalanche DAI.e (0xd586…) — bridged tokens with no
+//     EIP-2612 permit (DOMAIN_SEPARATOR reverts). EXCLUDED.
+//   - Arbitrum DAI (0xDA10…) — genuine EIP-2612 permit. KEPT.
+export const KNOWN_PERMIT_TOKENS = {
+    // Ethereum
+    1: [
+        '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
+    ],
+    // Arbitrum
+    42161: [
+        '0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8', // USDC.e
+        '0xaf88d065e77c8cC2239327C5EDb3A432268e5831', // USDC native
+        '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9', // USDT
+        '0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1', // DAI (EIP-2612 on Arbitrum)
+    ],
+    // Base
+    8453: [
+        '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC
+    ],
+    // Avalanche
+    43114: [
+        '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E', // USDC
+        '0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7', // USDT
+    ],
+};
+export const COWSWAP_APP_CODE = 'vultisig';
+export const COWSWAP_APP_VERSION = '0.1.0';
+// CowSwap partner fee BPS for affiliate revenue.
+// Phase 2 (mcp-ts) will wire the consumer-level affiliateBps through.
+// Phase 1 uses a fixed default matching the vultisig-0 baseline.
+export const COWSWAP_DEFAULT_AFFILIATE_BPS = 50;
+// Vultisig fee recipient address for CowSwap partner fees.
+export const COWSWAP_FEE_RECIPIENT = '0x8E247a480449c84a5fDD25974A8501f3EFa4ABb9';
+// Order validity window in seconds (15 minutes).
+export const COWSWAP_VALID_TO_SECONDS = 15 * 60;
+//# sourceMappingURL=config.js.map

package/dist/swap/general/cowswap/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/swap/general/cowswap/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAErD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAU,CAAA;AAIxH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,4CAA4C,CAAA;AAClF,MAAM,CAAC,MAAM,yBAAyB,GAAG,4CAA4C,CAAA;AASrF,MAAM,CAAC,MAAM,kBAAkB,GAAsD;IACnF,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QACnB,OAAO,EAAE,4BAA4B;QACrC,kBAAkB,EAAE,sBAAsB;QAC1C,YAAY,EAAE,yBAAyB;QACvC,OAAO,EAAE,CAAC;KACX;IACD,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QACnB,OAAO,EAAE,iCAAiC;QAC1C,kBAAkB,EAAE,sBAAsB;QAC1C,YAAY,EAAE,yBAAyB;QACvC,OAAO,EAAE,KAAK;KACf;IACD,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACf,OAAO,EAAE,yBAAyB;QAClC,kBAAkB,EAAE,sBAAsB;QAC1C,YAAY,EAAE,yBAAyB;QACvC,OAAO,EAAE,IAAI;KACd;IACD,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;QACpB,OAAO,EAAE,8BAA8B;QACvC,kBAAkB,EAAE,sBAAsB;QAC1C,YAAY,EAAE,yBAAyB;QACvC,OAAO,EAAE,KAAK;KACf;CACF,CAAA;AAED,mEAAmE;AACnE,+EAA+E;AAC/E,2EAA2E;AAC3E,uEAAuE;AACvE,sDAAsD;AACtD,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,yEAAyE;AACzE,4CAA4C;AAC5C,gFAAgF;AAChF,8DAA8D;AAC9D,+EAA+E;AAC/E,gBAAgB;AAChB,8EAA8E;AAC9E,4DAA4D;AAC5D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAA6B;IAC3D,WAAW;IACX,CAAC,EAAE;QACD,4CAA4C,EAAE,OAAO;KACtD;IACD,WAAW;IACX,KAAK,EAAE;QACL,4CAA4C,EAAE,SAAS;QACvD,4CAA4C,EAAE,cAAc;QAC5D,4CAA4C,EAAE,OAAO;QACrD,4CAA4C,EAAE,6BAA6B;KAC5E;IACD,OAAO;IACP,IAAI,EAAE;QACJ,4CAA4C,EAAE,OAAO;KACtD;IACD,YAAY;IACZ,KAAK,EAAE;QACL,4CAA4C,EAAE,OAAO;QACrD,4CAA4C,EAAE,OAAO;KACtD;CACF,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAA;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAA;AAE1C,iDAAiD;AACjD,sEAAsE;AACtE,iEAAiE;AACjE,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAA;AAE/C,2DAA2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,4CAA4C,CAAA;AAEjF,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,CAAA"}