@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/quoted-calls/builder.js

@@ -0,0 +1,161 @@
+import { zeroAddress } from 'viem';
+import { assert } from '@recoillink/utils';
+import { encodeExecuteCalldata, encodePermit2PermitInput, encodePermit2TransferFromInput, encodeQuoteExecuteCalldata, encodeSubmitQuoteInput, encodeSweepInput, encodeTransferFromInput, encodeTransferRemoteInput, encodeTransferRemoteToInput, extractQuoteTotals, } from './codec.js';
+import { QuotedCallsCommand, TokenPullMode } from './types.js';
+/** type(uint256).max — standing approval so subsequent calls skip the SSTORE */
+const MAX_UINT256 = 2n ** 256n - 1n;
+// ============ Shared: build quote command sequence ============
+/** Build the command sequence for quoteExecute (no token pull/sweep) */
+function buildQuoteCommands(params) {
+    const commands = [];
+    const inputs = [];
+    // Submit quotes
+    for (const cmd of params.quotes) {
+        commands.push(QuotedCallsCommand.SUBMIT_QUOTE);
+        inputs.push(encodeSubmitQuoteInput(cmd, params.clientSalt));
+    }
+    // Transfer command (for quoting — amount matters, value/approval don't)
+    if (params.targetRouter) {
+        commands.push(QuotedCallsCommand.TRANSFER_REMOTE_TO);
+        inputs.push(encodeTransferRemoteToInput({
+            router: params.warpRoute,
+            destination: params.destination,
+            recipient: params.recipient,
+            amount: params.amount,
+            targetRouter: params.targetRouter,
+            value: 0n,
+            token: params.token,
+            approval: 0n,
+        }));
+    }
+    else {
+        commands.push(QuotedCallsCommand.TRANSFER_REMOTE);
+        inputs.push(encodeTransferRemoteInput({
+            warpRoute: params.warpRoute,
+            destination: params.destination,
+            recipient: params.recipient,
+            amount: params.amount,
+            value: 0n,
+            token: params.token,
+            approval: 0n,
+        }));
+    }
+    return { commands, inputs };
+}
+// ============ Step 1: Build quoteExecute calldata ============
+/**
+ * Build calldata for QuotedCalls.quoteExecute() — used via eth_call
+ * to discover fee amounts before building the real execute tx.
+ *
+ * Commands: [SUBMIT_QUOTE×N, TRANSFER_REMOTE/TRANSFER_REMOTE_TO]
+ */
+export function buildQuoteCalldata(params) {
+    const { commands, inputs } = buildQuoteCommands(params);
+    return {
+        to: params.quotedCallsAddress,
+        data: encodeQuoteExecuteCalldata(commands, inputs),
+        value: 0n,
+    };
+}
+// ============ Step 2: Build execute calldata using quote results ============
+/**
+ * Build calldata for QuotedCalls.execute() using fee amounts
+ * from a prior quoteExecute call.
+ *
+ * Commands: [SUBMIT_QUOTE×N, TRANSFER_FROM/PERMIT2, TRANSFER_REMOTE, SWEEP]
+ */
+export function buildExecuteCalldata(params) {
+    const commands = [];
+    const inputs = [];
+    const isNativeRoute = params.token === zeroAddress;
+    // The transfer command is the last command in feeQuotes
+    // (index = number of quotes, since quoteExecute had [SUBMIT_QUOTE×N, TRANSFER])
+    const transferCommandIndex = params.quotes.length;
+    assert(params.feeQuotes.length > transferCommandIndex, `feeQuotes has ${params.feeQuotes.length} entries but transfer command is at index ${transferCommandIndex}`);
+    const transferQuotes = params.feeQuotes[transferCommandIndex];
+    // Extract per-command native value from the transfer quotes
+    let transferNativeValue = 0n;
+    let transferTokenFee = 0n;
+    for (const q of transferQuotes) {
+        if (q.token.toLowerCase() === zeroAddress) {
+            transferNativeValue += q.amount;
+        }
+        else {
+            transferTokenFee += q.amount;
+        }
+    }
+    // Total ERC20 to pull = sum of all token fees across all commands
+    // sumQuotesByToken normalizes keys to lowercase
+    const { nativeValue: totalNativeValue, tokenTotals } = extractQuoteTotals(params.feeQuotes);
+    const tokenKey = params.token.toLowerCase();
+    const totalTokenNeeded = isNativeRoute
+        ? 0n
+        : (tokenTotals.get(tokenKey) ?? 0n);
+    // 1. Submit quotes
+    for (const cmd of params.quotes) {
+        commands.push(QuotedCallsCommand.SUBMIT_QUOTE);
+        inputs.push(encodeSubmitQuoteInput(cmd, params.clientSalt));
+    }
+    // 2. Token pull (skip for native routes)
+    if (!isNativeRoute && totalTokenNeeded > 0n) {
+        if (params.tokenPullMode === TokenPullMode.Permit2) {
+            assert(params.permit2Data != null, 'permit2Data required when tokenPullMode is Permit2');
+            commands.push(QuotedCallsCommand.PERMIT2_PERMIT);
+            inputs.push(encodePermit2PermitInput(params.permit2Data));
+            commands.push(QuotedCallsCommand.PERMIT2_TRANSFER_FROM);
+            inputs.push(encodePermit2TransferFromInput(params.token, totalTokenNeeded));
+        }
+        else {
+            commands.push(QuotedCallsCommand.TRANSFER_FROM);
+            inputs.push(encodeTransferFromInput(params.token, totalTokenNeeded));
+        }
+    }
+    // 3. Transfer remote — use max approval for standing allowance (skips SSTORE after first call)
+    const approval = isNativeRoute ? 0n : MAX_UINT256;
+    if (params.targetRouter) {
+        commands.push(QuotedCallsCommand.TRANSFER_REMOTE_TO);
+        inputs.push(encodeTransferRemoteToInput({
+            router: params.warpRoute,
+            destination: params.destination,
+            recipient: params.recipient,
+            amount: params.amount,
+            targetRouter: params.targetRouter,
+            value: transferNativeValue,
+            token: params.token,
+            approval,
+        }));
+    }
+    else {
+        commands.push(QuotedCallsCommand.TRANSFER_REMOTE);
+        inputs.push(encodeTransferRemoteInput({
+            warpRoute: params.warpRoute,
+            destination: params.destination,
+            recipient: params.recipient,
+            amount: params.amount,
+            value: transferNativeValue,
+            token: params.token,
+            approval,
+        }));
+    }
+    // 4. Sweep leftover tokens + ETH back to caller.
+    // Skip when using TransferFrom (exact pull) and no token fees — nothing to sweep.
+    const hasTokenFees = transferTokenFee > 0n;
+    const needsSweep = isNativeRoute ||
+        params.tokenPullMode === TokenPullMode.Permit2 ||
+        hasTokenFees;
+    if (needsSweep) {
+        commands.push(QuotedCallsCommand.SWEEP);
+        inputs.push(encodeSweepInput(params.token));
+    }
+    // msg.value = total native value from quotes.
+    // For native routes, quoteTransferRemote already includes the transfer amount
+    // in the native quotes (Quote({token: address(0), amount: _amount + feeAmount})),
+    // so we don't add params.amount again.
+    const value = totalNativeValue;
+    return {
+        to: params.quotedCallsAddress,
+        data: encodeExecuteCalldata(commands, inputs),
+        value,
+    };
+}
+//# sourceMappingURL=builder.js.map

package/dist/quoted-calls/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/quoted-calls/builder.ts"],"names":[],"mappings":"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"}

package/dist/quoted-calls/builder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=builder.test.d.ts.map

package/dist/quoted-calls/builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.test.d.ts","sourceRoot":"","sources":["../../src/quoted-calls/builder.test.ts"],"names":[],"mappings":""}

package/dist/quoted-calls/builder.test.js

@@ -0,0 +1,193 @@
+import { expect } from 'chai';
+import { decodeFunctionData, zeroAddress } from 'viem';
+import { buildExecuteCalldata, buildQuoteCalldata } from './builder.js';
+import { QuotedCallsCommand, TokenPullMode } from './types.js';
+const QUOTED_CALLS = '0x1111111111111111111111111111111111111111';
+const WARP_ROUTE = '0x2222222222222222222222222222222222222222';
+const TOKEN = '0x3333333333333333333333333333333333333333';
+const RECIPIENT = '0x0000000000000000000000004444444444444444444444444444444444444444';
+const CLIENT_SALT = '0x5555555555555555555555555555555555555555555555555555555555555555';
+const MOCK_QUOTE = {
+    quoter: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+    quote: {
+        context: '0xdeadbeef',
+        data: '0xcafebabe',
+        issuedAt: 1000,
+        expiry: 1000,
+        salt: CLIENT_SALT,
+        submitter: QUOTED_CALLS,
+    },
+    signature: '0xaabb',
+};
+const BASE_PARAMS = {
+    quotedCallsAddress: QUOTED_CALLS,
+    warpRoute: WARP_ROUTE,
+    destination: 42161,
+    recipient: RECIPIENT,
+    amount: 1000n,
+    token: TOKEN,
+    quotes: [MOCK_QUOTE],
+    clientSalt: CLIENT_SALT,
+};
+const executeAbi = [
+    {
+        name: 'execute',
+        type: 'function',
+        inputs: [
+            { name: 'commands', type: 'bytes' },
+            { name: 'inputs', type: 'bytes[]' },
+        ],
+        outputs: [],
+        stateMutability: 'payable',
+    },
+    {
+        name: 'quoteExecute',
+        type: 'function',
+        inputs: [
+            { name: 'commands', type: 'bytes' },
+            { name: 'inputs', type: 'bytes[]' },
+        ],
+        outputs: [],
+        stateMutability: 'nonpayable',
+    },
+];
+function decodeCommands(data) {
+    const decoded = decodeFunctionData({ abi: executeAbi, data });
+    const commandsHex = decoded.args[0].slice(2);
+    const commands = [];
+    for (let i = 0; i < commandsHex.length; i += 2) {
+        commands.push(parseInt(commandsHex.slice(i, i + 2), 16));
+    }
+    return { fn: decoded.functionName, commands };
+}
+// Mock fee quotes from quoteExecute
+const MOCK_FEE_QUOTES = [
+    [], // SUBMIT_QUOTE → empty
+    [
+        // TRANSFER_REMOTE → 3 quotes
+        { token: zeroAddress, amount: 100n }, // IGP native fee
+        { token: TOKEN, amount: 1050n }, // amount + internal fee
+        { token: TOKEN, amount: 10n }, // external fee
+    ],
+];
+describe('buildQuoteCalldata', () => {
+    it('builds quoteExecute with SUBMIT_QUOTE + TRANSFER_REMOTE', () => {
+        const result = buildQuoteCalldata(BASE_PARAMS);
+        expect(result.to).to.equal(QUOTED_CALLS);
+        expect(result.value).to.equal(0n);
+        const { fn, commands } = decodeCommands(result.data);
+        expect(fn).to.equal('quoteExecute');
+        expect(commands).to.deep.equal([
+            QuotedCallsCommand.SUBMIT_QUOTE,
+            QuotedCallsCommand.TRANSFER_REMOTE,
+        ]);
+    });
+    it('builds quoteExecute with TRANSFER_REMOTE_TO for cross-collateral', () => {
+        const targetRouter = '0x0000000000000000000000007777777777777777777777777777777777777777';
+        const result = buildQuoteCalldata({ ...BASE_PARAMS, targetRouter });
+        const { commands } = decodeCommands(result.data);
+        expect(commands).to.deep.equal([
+            QuotedCallsCommand.SUBMIT_QUOTE,
+            QuotedCallsCommand.TRANSFER_REMOTE_TO,
+        ]);
+    });
+});
+describe('buildExecuteCalldata', () => {
+    it('builds ERC20 TransferFrom execute from fee quotes', () => {
+        const result = buildExecuteCalldata({
+            ...BASE_PARAMS,
+            feeQuotes: MOCK_FEE_QUOTES,
+            tokenPullMode: TokenPullMode.TransferFrom,
+        });
+        expect(result.to).to.equal(QUOTED_CALLS);
+        // native value = IGP fee (100)
+        expect(result.value).to.equal(100n);
+        const { fn, commands } = decodeCommands(result.data);
+        expect(fn).to.equal('execute');
+        expect(commands).to.deep.equal([
+            QuotedCallsCommand.SUBMIT_QUOTE,
+            QuotedCallsCommand.TRANSFER_FROM,
+            QuotedCallsCommand.TRANSFER_REMOTE,
+            QuotedCallsCommand.SWEEP,
+        ]);
+    });
+    it('builds Permit2 execute from fee quotes', () => {
+        const result = buildExecuteCalldata({
+            ...BASE_PARAMS,
+            feeQuotes: MOCK_FEE_QUOTES,
+            tokenPullMode: TokenPullMode.Permit2,
+            permit2Data: {
+                permitSingle: {
+                    details: {
+                        token: TOKEN,
+                        amount: 2000n,
+                        expiration: 9999,
+                        nonce: 0,
+                    },
+                    spender: QUOTED_CALLS,
+                    sigDeadline: 9999,
+                },
+                signature: '0xaabb',
+            },
+        });
+        const { commands } = decodeCommands(result.data);
+        expect(commands).to.deep.equal([
+            QuotedCallsCommand.SUBMIT_QUOTE,
+            QuotedCallsCommand.PERMIT2_PERMIT,
+            QuotedCallsCommand.PERMIT2_TRANSFER_FROM,
+            QuotedCallsCommand.TRANSFER_REMOTE,
+            QuotedCallsCommand.SWEEP,
+        ]);
+    });
+    it('builds native route execute (no TRANSFER_FROM)', () => {
+        const nativeFeeQuotes = [
+            [],
+            [{ token: zeroAddress, amount: 5100n }],
+        ];
+        const result = buildExecuteCalldata({
+            ...BASE_PARAMS,
+            token: zeroAddress,
+            amount: 5000n,
+            feeQuotes: nativeFeeQuotes,
+            tokenPullMode: TokenPullMode.TransferFrom,
+        });
+        // msg.value = native total from quotes (5100 already includes transfer amount)
+        expect(result.value).to.equal(5100n);
+        const { commands } = decodeCommands(result.data);
+        // No TRANSFER_FROM for native route
+        expect(commands).to.deep.equal([
+            QuotedCallsCommand.SUBMIT_QUOTE,
+            QuotedCallsCommand.TRANSFER_REMOTE,
+            QuotedCallsCommand.SWEEP,
+        ]);
+    });
+    it('skips SWEEP for TransferFrom with zero token fees', () => {
+        const zeroTokenFeeQuotes = [
+            [], // SUBMIT_QUOTE → empty
+            [
+                // TRANSFER_REMOTE → native fee only, no token fee
+                { token: zeroAddress, amount: 100n },
+            ],
+        ];
+        const result = buildExecuteCalldata({
+            ...BASE_PARAMS,
+            feeQuotes: zeroTokenFeeQuotes,
+            tokenPullMode: TokenPullMode.TransferFrom,
+        });
+        const { commands } = decodeCommands(result.data);
+        // No TRANSFER_FROM (totalTokenNeeded=0) and no SWEEP (TransferFrom + zero token fees)
+        expect(commands).to.deep.equal([
+            QuotedCallsCommand.SUBMIT_QUOTE,
+            QuotedCallsCommand.TRANSFER_REMOTE,
+        ]);
+        expect(result.value).to.equal(100n);
+    });
+    it('throws when Permit2 mode without permit2Data', () => {
+        expect(() => buildExecuteCalldata({
+            ...BASE_PARAMS,
+            feeQuotes: MOCK_FEE_QUOTES,
+            tokenPullMode: TokenPullMode.Permit2,
+        })).to.throw('permit2Data required');
+    });
+});
+//# sourceMappingURL=builder.test.js.map

package/dist/quoted-calls/builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.test.js","sourceRoot":"","sources":["../../src/quoted-calls/builder.test.ts"],"names":[],"mappings":"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"}

package/dist/quoted-calls/client.d.ts

@@ -0,0 +1,69 @@
+import type { Address, Hex } from 'viem';
+import type { AnyQuoteV2Entry, FeeQuotingCommand, FeeQuotingQuoteResponse } from './types.js';
+import { NoQuoteAvailableReason } from './types.js';
+export interface FeeQuotingClientOptions {
+    baseUrl: string;
+    apiKey: string;
+}
+export interface QuoteParams {
+    origin: string;
+    command: FeeQuotingCommand;
+    router: Address;
+    destination: number;
+    /** Pre-computed salt (e.g. keccak256(sender, clientSalt) for QuotedCalls) */
+    salt: Hex;
+    /** Required for warp commands (transferRemote, transferRemoteTo) */
+    recipient?: Hex;
+    /** Target router for transferRemoteTo with CrossCollateralRoutingFee */
+    targetRouter?: Hex;
+}
+export declare class FeeQuotingClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(options: FeeQuotingClientOptions);
+    getQuote(params: QuoteParams): Promise<FeeQuotingQuoteResponse>;
+}
+/** Query params for `GET /v2/quote/warp`. Mirrors the server-side route schema. */
+export interface FeeQuotingV2WarpParams {
+    origin: string;
+    /** EVM hex or Sealevel base58 — server validates per protocol. */
+    router: string;
+    destination: number;
+    /** bytes32 — already scope-mixed for transient mode. */
+    salt: Hex;
+    recipient: Hex;
+    targetRouter: Hex;
+    /** EVM hex or Sealevel base58 — payer / submitter address. */
+    txSubmitter: string;
+}
+/** Query params for `GET /v2/quote/igp`. */
+export interface FeeQuotingV2IgpParams {
+    origin: string;
+    router: string;
+    destination: number;
+    salt: Hex;
+    txSubmitter: string;
+}
+/**
+ * JS-level error mirroring the server-side 404 body
+ * (`NoQuoteAvailableError` JSON shape from `types.ts`). Thrown by
+ * `FeeQuotingV2Client` when the server returns 404 — callers can catch +
+ * inspect `reason` / `detail` to decide whether to fall back to legacy
+ * quoting or surface a clear "no quote available" UX.
+ */
+export declare class FeeQuotingNoQuoteAvailableError extends Error {
+    readonly reason: NoQuoteAvailableReason;
+    readonly detail: string;
+    constructor(reason: NoQuoteAvailableReason, detail: string);
+}
+export declare class FeeQuotingV2Client {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(options: FeeQuotingClientOptions);
+    /** GET /v2/quote/warp. Throws `FeeQuotingNoQuoteAvailableError` on 404. */
+    getWarpQuote(params: FeeQuotingV2WarpParams): Promise<AnyQuoteV2Entry>;
+    /** GET /v2/quote/igp. Throws `FeeQuotingNoQuoteAvailableError` on 404. */
+    getIgpQuote(params: FeeQuotingV2IgpParams): Promise<AnyQuoteV2Entry>;
+    private fetchQuote;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/quoted-calls/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/quoted-calls/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAMzC,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EAIxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,IAAI,EAAE,GAAG,CAAC;IACV,oEAAoE;IACpE,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,wEAAwE;IACxE,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,YAAY,OAAO,EAAE,uBAAuB,EAG3C;IAEK,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAwBpE;CACF;AAcD,mFAAmF;AACnF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,GAAG,CAAC;IACf,YAAY,EAAE,GAAG,CAAC;IAClB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,GAAG,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,EAIzD;CACF;AAyHD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,YAAY,OAAO,EAAE,uBAAuB,EAG3C;IAED,2EAA2E;IACrE,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CAW3E;IAED,0EAA0E;IACpE,WAAW,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CASzE;YAEa,UAAU;CAwCzB"}

package/dist/quoted-calls/client.js

@@ -0,0 +1,205 @@
+import { isHex } from 'viem';
+import { ProtocolType } from '@recoillink/provider-sdk';
+import { assert } from '@recoillink/utils';
+import { NO_QUOTE_AVAILABLE_ERROR, NoQuoteAvailableReason, QUOTE_V2_BASE_PATH, QuoteV2Endpoint as QuoteV2EndpointValues, } from './types.js';
+/** Runtime membership set for the `NoQuoteAvailableReason` discriminant. */
+const NO_QUOTE_AVAILABLE_REASONS = new Set(Object.values(NoQuoteAvailableReason));
+export class FeeQuotingClient {
+    baseUrl;
+    apiKey;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        this.apiKey = options.apiKey;
+    }
+    async getQuote(params) {
+        const query = new URLSearchParams({
+            origin: params.origin,
+            router: params.router,
+            destination: String(params.destination),
+            salt: params.salt,
+        });
+        if (params.recipient)
+            query.set('recipient', params.recipient);
+        if (params.targetRouter)
+            query.set('targetRouter', params.targetRouter);
+        const res = await fetch(`${this.baseUrl}/quote/${params.command}?${query}`, { headers: { Authorization: `Bearer ${this.apiKey}` } });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            throw new Error(`Fee quoting request failed (${res.status}): ${body.message ?? res.statusText}`);
+        }
+        return res.json();
+    }
+}
+/**
+ * JS-level error mirroring the server-side 404 body
+ * (`NoQuoteAvailableError` JSON shape from `types.ts`). Thrown by
+ * `FeeQuotingV2Client` when the server returns 404 — callers can catch +
+ * inspect `reason` / `detail` to decide whether to fall back to legacy
+ * quoting or surface a clear "no quote available" UX.
+ */
+export class FeeQuotingNoQuoteAvailableError extends Error {
+    reason;
+    detail;
+    constructor(reason, detail) {
+        super(`No quote available (${reason}): ${detail}`);
+        this.reason = reason;
+        this.detail = detail;
+    }
+}
+/**
+ * Type guard for the `NoQuoteAvailableError` JSON body shape.
+ *
+ * Defined here so the constructor of `FeeQuotingNoQuoteAvailableError` can
+ * stay narrow — we only want to interpret a 404 body as "no quote" when the
+ * `error` discriminator matches; other 404s (e.g. nginx misroute) should
+ * surface as the generic HTTP error.
+ */
+function isNoQuoteAvailableBody(body) {
+    if (typeof body !== 'object' || body === null)
+        return false;
+    const b = body;
+    return (b.error === NO_QUOTE_AVAILABLE_ERROR &&
+        typeof b.reason === 'string' &&
+        NO_QUOTE_AVAILABLE_REASONS.has(b.reason) &&
+        typeof b.detail === 'string');
+}
+/** Type-predicate narrowing of `unknown` to an indexable object. */
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * True when `value` is a `0x`-prefixed hex string whose decoded byte length is
+ * one of `byteLengths`. Empty `byteLengths` accepts any length.
+ */
+function isHexBytes(value, ...byteLengths) {
+    if (!isHex(value))
+        return false;
+    if (byteLengths.length === 0)
+        return true;
+    return byteLengths.includes((value.length - 2) / 2);
+}
+// Valid SVM signed-quote `context` widths, by endpoint. Warp fee contexts are
+// 44B (leaf/routing) or 76B (cross-collateral); the IGP context is 68B (see
+// the IGP context layout in `@recoillink/svm-sdk`). The two endpoints never
+// share a width, so the guard is parameterized by endpoint to reject a
+// context that is well-formed for the other route.
+const WARP_CONTEXT_BYTES = [44, 76]; // non-CC | CC
+const IGP_CONTEXT_BYTES = [68];
+// Fixed byte widths for the remaining SVM `SvmSignedQuote` wire fields (see
+// `SealevelSignedQuote` in `./types.ts`).
+const SVM_ISSUED_AT_BYTES = 6;
+const SVM_EXPIRY_BYTES = 6;
+const SVM_CLIENT_SALT_BYTES = 32;
+const SVM_SIGNATURE_BYTES = 65;
+/** Byte width of an EVM `bytes32` field (salt). */
+const EVM_SALT_BYTES = 32;
+/** Byte width of an EVM address (`submitter`). */
+const EVM_ADDRESS_BYTES = 20;
+/** Validate the EVM `SignedQuoteData` shape (see `./types.ts`). */
+function isSignedQuoteData(value) {
+    if (!isRecord(value))
+        return false;
+    return (isHexBytes(value.context) &&
+        isHexBytes(value.data) &&
+        typeof value.issuedAt === 'number' &&
+        typeof value.expiry === 'number' &&
+        isHexBytes(value.salt, EVM_SALT_BYTES) &&
+        isHexBytes(value.submitter, EVM_ADDRESS_BYTES));
+}
+/**
+ * Validate a v2 success body before trusting it. The server signs these
+ * responses, but a misrouted 2xx (empty `{}`, a reverse-proxy page coerced to
+ * an object, or server/client schema drift) must fail loudly here rather than
+ * returning `undefined` or malformed data that only blows up later during
+ * transaction construction.
+ *
+ * `svmContextBytes` is the set of `context` widths valid for the endpoint being
+ * validated (warp vs IGP), since the two carry different-sized contexts.
+ */
+function isQuoteV2Response(body, svmContextBytes) {
+    if (!isRecord(body) || !isRecord(body.quote))
+        return false;
+    const quote = body.quote;
+    if (typeof quote.quoter !== 'string' ||
+        typeof quote.issuedAt !== 'number' ||
+        typeof quote.expiry !== 'number' ||
+        !isRecord(quote.details)) {
+        return false;
+    }
+    const details = quote.details;
+    switch (quote.protocol) {
+        case ProtocolType.Ethereum:
+            return isSignedQuoteData(details.quote) && isHex(details.signature);
+        case ProtocolType.Sealevel: {
+            if (typeof details.domainId !== 'number' ||
+                !isRecord(details.signedQuote)) {
+                return false;
+            }
+            const sq = details.signedQuote;
+            return (isHexBytes(sq.context, ...svmContextBytes) &&
+                isHexBytes(sq.data) &&
+                isHexBytes(sq.issuedAt, SVM_ISSUED_AT_BYTES) &&
+                isHexBytes(sq.expiry, SVM_EXPIRY_BYTES) &&
+                isHexBytes(sq.clientSalt, SVM_CLIENT_SALT_BYTES) &&
+                isHexBytes(sq.signature, SVM_SIGNATURE_BYTES));
+        }
+        default:
+            return false;
+    }
+}
+export class FeeQuotingV2Client {
+    baseUrl;
+    apiKey;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        this.apiKey = options.apiKey;
+    }
+    /** GET /v2/quote/warp. Throws `FeeQuotingNoQuoteAvailableError` on 404. */
+    async getWarpQuote(params) {
+        const query = new URLSearchParams({
+            origin: params.origin,
+            router: params.router,
+            destination: String(params.destination),
+            salt: params.salt,
+            recipient: params.recipient,
+            targetRouter: params.targetRouter,
+            txSubmitter: params.txSubmitter,
+        });
+        return this.fetchQuote(QuoteV2EndpointValues.Warp, query);
+    }
+    /** GET /v2/quote/igp. Throws `FeeQuotingNoQuoteAvailableError` on 404. */
+    async getIgpQuote(params) {
+        const query = new URLSearchParams({
+            origin: params.origin,
+            router: params.router,
+            destination: String(params.destination),
+            salt: params.salt,
+            txSubmitter: params.txSubmitter,
+        });
+        return this.fetchQuote(QuoteV2EndpointValues.Igp, query);
+    }
+    async fetchQuote(endpoint, query) {
+        const res = await fetch(`${this.baseUrl}${QUOTE_V2_BASE_PATH}/${endpoint}?${query}`, { headers: { Authorization: `Bearer ${this.apiKey}` } });
+        // Parse once — Response.json() can only be consumed a single time per
+        // response. A null body means the server returned a non-JSON 4xx/5xx
+        // (e.g. an HTML error page from a reverse proxy).
+        const body = await res.json().catch(() => null);
+        if (res.status === 404 && isNoQuoteAvailableBody(body)) {
+            throw new FeeQuotingNoQuoteAvailableError(body.reason, body.detail);
+        }
+        if (!res.ok) {
+            const message = typeof body === 'object' &&
+                body !== null &&
+                typeof body.message === 'string'
+                ? body.message
+                : res.statusText;
+            throw new Error(`Fee quoting v2 request failed (${res.status}): ${message}`);
+        }
+        const svmContextBytes = endpoint === QuoteV2EndpointValues.Warp
+            ? WARP_CONTEXT_BYTES
+            : IGP_CONTEXT_BYTES;
+        assert(isQuoteV2Response(body, svmContextBytes), `Fee quoting v2 returned a malformed success body (HTTP ${res.status})`);
+        return body.quote;
+    }
+}
+//# sourceMappingURL=client.js.map