@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/quoted-calls/EvmQuotedTransferProvider.js

@@ -0,0 +1,207 @@
+import { isAddress } from 'viem';
+import { ProtocolType } from '@recoillink/provider-sdk';
+import { addressToBytes32, assert, isEVMLike, isZeroishAddress, } from '@recoillink/utils';
+import { Token } from '../token/Token.js';
+import { TokenAmount } from '../token/TokenAmount.js';
+import { TOKEN_STANDARD_TO_PROVIDER_TYPE } from '../token/TokenStandard.js';
+import { resolveDestinationToken } from '../warp/resolveDestinationToken.js';
+import { WarpTxCategory } from '../warp/types.js';
+import { toAddress, toHex } from './assertHex.js';
+import { buildExecuteCalldata, buildQuoteCalldata } from './builder.js';
+import { decodeQuoteExecuteResult, extractQuoteTotals, } from './codec.js';
+import { TokenPullMode } from './types.js';
+/**
+ * EVM implementation of `QuotedTransferProvider`. Wraps the on-chain
+ * `QuotedCalls` contract: signed quotes + token pull + transferRemote + sweep
+ * are encoded into a single atomic `execute()` calldata.
+ *
+ * The body of this class is the EVM-specific logic previously inlined in
+ * `WarpCore.getQuotedCallsTransferTxs` + `WarpCore.resolveQuotedCallsParams` +
+ * `WarpCore.getQuotedTransferFee`. WarpCore now dispatches through the
+ * `QuotedTransferProvider` interface, with this class handling all EVM
+ * concerns.
+ */
+export class EvmQuotedTransferProvider {
+    params;
+    protocol = ProtocolType.Ethereum;
+    constructor(params) {
+        this.params = params;
+    }
+    /**
+     * Runs the `QuotedCalls.quoteExecute` eth_call and returns the raw decoded
+     * per-command `Quote[][]` plus the resolved transfer params. Shared between
+     * the public display-time and submit-time paths so both hit the same
+     * code; eth_call is read-only and deterministic for a given
+     * `(quotes, clientSalt, block)`, so display and submit will compute the
+     * same priced fees.
+     */
+    async runQuoteExecute({ warpCore, originTokenAmount, destination, sender, recipient, destinationToken, }) {
+        assert(isAddress(sender), `Invalid EVM sender address: ${sender}`);
+        const transferParams = this.resolveExecuteParams({
+            warpCore,
+            originTokenAmount,
+            destination,
+            recipient,
+            destinationToken,
+        });
+        const quoteTx = buildQuoteCalldata(transferParams);
+        const provider = warpCore.multiProvider.getEthersV5Provider(originTokenAmount.token.chainName);
+        const quoteResult = await provider.call({
+            to: quoteTx.to,
+            data: quoteTx.data,
+            from: sender,
+        });
+        const feeQuotes = decodeQuoteExecuteResult(toHex(quoteResult, 'quoteExecute eth_call returned non-hex result'));
+        return { feeQuotes, transferParams };
+    }
+    /**
+     * Fee-quoting eth_call. Returns the priced display tuple matching
+     * `getInterchainTransferFee` shape.
+     */
+    async getQuotedTransferFee({ warpCore, originTokenAmount, destination, sender, recipient, destinationToken, }) {
+        const { token: originToken } = originTokenAmount;
+        const originName = originToken.chainName;
+        const { feeQuotes, transferParams } = await this.runQuoteExecute({
+            warpCore,
+            originTokenAmount,
+            destination,
+            sender,
+            recipient,
+            destinationToken,
+        });
+        const { nativeValue, tokenTotals } = extractQuoteTotals(feeQuotes);
+        // For native routes, quoteTransferRemote includes the transfer amount in
+        // the native quotes, so we subtract it to get the fee-only portion.
+        const isNativeRoute = isZeroishAddress(transferParams.token);
+        const nativeToken = Token.FromChainMetadataNativeToken(warpCore.multiProvider.getChainMetadata(originName));
+        const igpFeeOnly = isNativeRoute
+            ? nativeValue - originTokenAmount.amount
+            : nativeValue;
+        assert(igpFeeOnly >= 0n, `IGP fee quote underflow: quoted ${nativeValue} < amount ${originTokenAmount.amount}`);
+        const igpQuote = new TokenAmount(igpFeeOnly, nativeToken);
+        const tokenKey = toAddress(transferParams.token.toLowerCase(), 'token address lowercase narrowing failed');
+        assert(tokenTotals.size <= 1, `Unexpected multi-token fee quotes: ${[...tokenTotals.keys()].join(', ')}`);
+        let tokenFeeQuote;
+        const totalTokenQuoted = tokenTotals.get(tokenKey);
+        if (totalTokenQuoted != null) {
+            const feeOnly = totalTokenQuoted - originTokenAmount.amount;
+            assert(feeOnly >= 0n, `Token fee quote underflow: quoted ${totalTokenQuoted} < amount ${originTokenAmount.amount}`);
+            if (feeOnly > 0n) {
+                tokenFeeQuote = new TokenAmount(feeOnly, originToken);
+            }
+        }
+        return { igpQuote, tokenFeeQuote };
+    }
+    async buildQuotedTransferTxs({ warpCore, originTokenAmount, destination, sender, recipient, destinationToken, }) {
+        const { token } = originTokenAmount;
+        const transactions = [];
+        const providerType = TOKEN_STANDARD_TO_PROVIDER_TYPE[token.standard];
+        const { feeQuotes, transferParams } = await this.runQuoteExecute({
+            warpCore,
+            originTokenAmount,
+            destination,
+            sender,
+            recipient,
+            destinationToken,
+        });
+        const { tokenTotals } = extractQuoteTotals(feeQuotes);
+        const tokenKey = toAddress(transferParams.token.toLowerCase(), 'token address lowercase narrowing failed');
+        const totalTokenNeeded = tokenTotals.get(tokenKey) ?? 0n;
+        // Check approval for QuotedCalls (TransferFrom mode).
+        // The spender is `this.params.address` (not the token itself), so
+        // EvmHypSyntheticAdapter correctly falls through to the ERC20 allowance
+        // check rather than returning false.
+        if (this.params.tokenPullMode === TokenPullMode.TransferFrom &&
+            totalTokenNeeded > 0n) {
+            const adapter = token.getAdapter(warpCore.multiProvider);
+            const [isApproveRequired, isRevokeApprovalRequired] = await Promise.all([
+                adapter.isApproveRequired(sender, this.params.address, totalTokenNeeded),
+                adapter.isRevokeApprovalRequired(sender, this.params.address),
+            ]);
+            // USDT-like tokens require revoking to 0 before re-approving
+            if (isApproveRequired && isRevokeApprovalRequired) {
+                const revokeTxReq = await adapter.populateApproveTx({
+                    weiAmountOrId: 0,
+                    recipient: this.params.address,
+                });
+                transactions.push({
+                    category: WarpTxCategory.Revoke,
+                    type: providerType,
+                    transaction: revokeTxReq,
+                }); // CAST: providerType is determined at runtime from token.standard
+            }
+            if (isApproveRequired) {
+                const approveTxReq = await adapter.populateApproveTx({
+                    weiAmountOrId: totalTokenNeeded,
+                    recipient: this.params.address,
+                });
+                transactions.push({
+                    category: WarpTxCategory.Approval,
+                    type: providerType,
+                    transaction: approveTxReq,
+                }); // CAST: providerType is determined at runtime from token.standard
+            }
+        }
+        const executeTx = buildExecuteCalldata({
+            ...transferParams,
+            feeQuotes,
+            tokenPullMode: this.params.tokenPullMode,
+            permit2Data: this.params.permit2Data,
+        });
+        transactions.push({
+            category: WarpTxCategory.Transfer,
+            type: providerType,
+            transaction: {
+                to: executeTx.to,
+                data: executeTx.data,
+                value: executeTx.value.toString(),
+            },
+        }); // CAST: providerType is determined at runtime from token.standard
+        return transactions;
+    }
+    /**
+     * Build the params struct shared by `buildQuoteCalldata` /
+     * `buildExecuteCalldata`. Performs EVM/non-NFT preconditions and resolves
+     * the on-chain token address + (optional) cross-collateral target router.
+     */
+    resolveExecuteParams({ warpCore, originTokenAmount, destination, recipient, destinationToken, }) {
+        const { token, amount } = originTokenAmount;
+        assert(isEVMLike(token.protocol), 'QuotedCalls is only supported on EVM origins');
+        assert(!token.isNft(), 'QuotedCalls does not support NFT routes');
+        const destinationDomainId = warpCore.multiProvider.getDomainId(destination);
+        // For collateral routes, the ERC20 token is collateralAddressOrDenom.
+        // For synthetic/native routes, use addressOrDenom (the router itself).
+        // Only treat as native (zeroAddress) if collateral is explicitly address(0).
+        const collateral = token.collateralAddressOrDenom;
+        const rawTokenAddress = collateral && !isZeroishAddress(collateral)
+            ? collateral
+            : token.isNative() || token.isHypNative()
+                ? '0x0000000000000000000000000000000000000000'
+                : token.addressOrDenom;
+        const tokenAddress = toAddress(rawTokenAddress, 'token address narrowing failed');
+        let targetRouter;
+        if (destinationToken &&
+            warpCore.isCrossCollateralTransfer(token, destinationToken)) {
+            const resolved = resolveDestinationToken({
+                multiProvider: warpCore.multiProvider,
+                originToken: token,
+                destination,
+                destinationToken,
+            });
+            assert(resolved.addressOrDenom, 'Destination token missing addressOrDenom for cross-collateral');
+            targetRouter = toHex(addressToBytes32(resolved.addressOrDenom), 'targetRouter bytes32 narrowing failed');
+        }
+        return {
+            quotedCallsAddress: this.params.address,
+            warpRoute: toAddress(token.addressOrDenom, 'warpRoute address narrowing failed'),
+            destination: destinationDomainId,
+            recipient: toHex(addressToBytes32(recipient), 'recipient bytes32 narrowing failed'),
+            amount,
+            token: tokenAddress,
+            quotes: this.params.quotes,
+            clientSalt: this.params.clientSalt,
+            targetRouter,
+        };
+    }
+}
+//# sourceMappingURL=EvmQuotedTransferProvider.js.map

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

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

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

@@ -0,0 +1,50 @@
+import type { ProtocolType } from '@recoillink/provider-sdk';
+import type { IToken } from '../token/IToken.js';
+import type { TokenAmount } from '../token/TokenAmount.js';
+import type { ChainNameOrId } from '../types.js';
+import type { WarpCore } from '../warp/WarpCore.js';
+import type { WarpTypedTransaction } from '../warp/types.js';
+/**
+ * Protocol-agnostic abstraction over a warp transfer that consumes signed
+ * offchain quotes. Each protocol provides its own implementation:
+ *
+ *  - EVM (`EvmQuotedTransferProvider`): builds an atomic
+ *    `QuotedCalls.execute()` calldata against the on-chain wrapper contract.
+ *  - Sealevel (`SealevelQuotedTransferProvider`): composes a single tx that
+ *    prepends `SubmitFeeQuote` (+ optional `SubmitIgpQuote`) instructions
+ *    onto the adapter's `transferRemote` / `transferRemoteTo` instructions.
+ *
+ * `WarpCore.getTransferRemoteTxs` invokes `buildQuotedTransferTxs` whenever a
+ * provider is supplied and dispatches with a single protocol-agnostic call —
+ * no per-VM branching in WarpCore itself.
+ */
+export interface QuotedTransferProvider {
+    readonly protocol: ProtocolType;
+    /**
+     * Returns the priced fee tuple for display. Each protocol fetches its own
+     * signed quotes + decodes to `{ igpQuote, tokenFeeQuote? }` in origin-side
+     * denominations. Called from the UI hook at display time; the submit path
+     * (`buildQuotedTransferTxs`) re-fetches independently so there's no shared
+     * state between the two calls.
+     */
+    getQuotedTransferFee(args: {
+        warpCore: WarpCore;
+        originTokenAmount: TokenAmount<IToken>;
+        destination: ChainNameOrId;
+        sender: string;
+        recipient: string;
+        destinationToken?: IToken;
+    }): Promise<{
+        igpQuote: TokenAmount<IToken>;
+        tokenFeeQuote?: TokenAmount<IToken>;
+    }>;
+    buildQuotedTransferTxs(args: {
+        warpCore: WarpCore;
+        originTokenAmount: TokenAmount<IToken>;
+        destination: ChainNameOrId;
+        sender: string;
+        recipient: string;
+        destinationToken?: IToken;
+    }): Promise<Array<WarpTypedTransaction>>;
+}
+//# sourceMappingURL=QuotedTransferProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QuotedTransferProvider.d.ts","sourceRoot":"","sources":["../../src/quoted-calls/QuotedTransferProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAEhC;;;;;;OAMG;IACH,oBAAoB,CAAC,IAAI,EAAE;QACzB,QAAQ,EAAE,QAAQ,CAAC;QACnB,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,WAAW,EAAE,aAAa,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC;QACV,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC9B,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;KACrC,CAAC,CAAC;IAEH,sBAAsB,CAAC,IAAI,EAAE;QAC3B,QAAQ,EAAE,QAAQ,CAAC;QACnB,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,WAAW,EAAE,aAAa,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;CAC1C"}

package/dist/quoted-calls/QuotedTransferProvider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QuotedTransferProvider.js.map

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

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

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

@@ -0,0 +1,89 @@
+import { Connection, PublicKey } from '@solana/web3.js';
+import { ProtocolType } from '@recoillink/provider-sdk';
+import { IToken } from '../token/IToken.js';
+import { TokenAmount } from '../token/TokenAmount.js';
+import { ChainNameOrId } from '../types.js';
+import type { WarpCore } from '../warp/WarpCore.js';
+import { WarpTypedTransaction } from '../warp/types.js';
+import { FeeQuotingV2Client } from './client.js';
+import type { QuotedTransferProvider } from './QuotedTransferProvider.js';
+/**
+ * `keccak256(payer || clientSalt)` — mirrors the on-chain
+ * `SvmSignedQuote::compute_scoped_salt` in the Rust quote-verifier.
+ *
+ * Duplicated from svm-sdk's `computeScopedSalt` per
+ * `[no-svm-sdk-dep-in-main-sdk]`. The provider keeps the raw client salt
+ * (for the API request + the signed-quote payload) and the scoped salt
+ * (for the bundle PDA cascade + IGP transient PDA derivation) as
+ * separate values.
+ *
+ * Exported for testing — not part of the package's external API surface.
+ */
+export declare function computeSealevelScopedSalt(payer: PublicKey, clientSalt: Uint8Array): Uint8Array;
+export interface SealevelQuotedTransferProviderOpts {
+    feeQuotingClient: FeeQuotingV2Client;
+    connection: Connection;
+    /**
+     * Random-salt source — override for deterministic tests. Defaults to ethers'
+     * isomorphic `randomBytes` (works in Node + browser).
+     */
+    randomSalt?: () => Uint8Array;
+}
+/**
+ * Sealevel implementation of `QuotedTransferProvider`. Produces a single
+ * atomic tx that prepends `SubmitFeeQuote` (and, when configured,
+ * `SubmitIgpQuote`) ixs onto the Sealevel adapter's `transfer_remote` /
+ * `transfer_remote_to` ix bundle.
+ *
+ * Tx layout:
+ *   [...computeBudgetIxs, submitFeeQuote, submitIgpQuote?, transferRemote]
+ *
+ * Atomicity is required for transient mode (one-shot PDA — racy if split
+ * across txs) and uniform with standing mode (one wallet confirmation).
+ */
+export declare class SealevelQuotedTransferProvider implements QuotedTransferProvider {
+    private readonly opts;
+    readonly protocol = ProtocolType.Sealevel;
+    constructor(opts: SealevelQuotedTransferProviderOpts);
+    /**
+     * Shared prep for both quote entry points. Resolves the SVM adapter + token
+     * account, builds the identical warp/IGP request shapes (same salt,
+     * targetRouter, recipient, and same-domain IGP gate), and fetches the warp +
+     * optional IGP signed quotes in parallel. `getQuotedTransferFee` prices these
+     * for display; `buildQuotedTransferTxs` composes them into submit txs —
+     * keeping the derivation in one place so displayed and paid quotes can't
+     * drift.
+     */
+    private prepareSealevelQuote;
+    /**
+     * Display-time fee fetch. Hits the offchain quoter for warp (+ optional
+     * IGP) signed quotes, decodes each `data` as a `FeeDataStrategy`, and
+     * applies the Linear formula at `originTokenAmount.amount` to produce the
+     * priced tuple. Standalone from `buildQuotedTransferTxs` — the submit path
+     * re-fetches independently rather than reusing display state.
+     *
+     * `tokenFeeQuote.token` is the bridged token (matches what the on-chain
+     * fee program charges); `igpQuote.token` is the origin chain's native
+     * (SOL on Solana mainnet).
+     */
+    getQuotedTransferFee({ warpCore, originTokenAmount, destination, sender, recipient, destinationToken, }: {
+        warpCore: WarpCore;
+        originTokenAmount: TokenAmount<IToken>;
+        destination: ChainNameOrId;
+        sender: string;
+        recipient: string;
+        destinationToken?: IToken;
+    }): Promise<{
+        igpQuote: TokenAmount<IToken>;
+        tokenFeeQuote?: TokenAmount<IToken>;
+    }>;
+    buildQuotedTransferTxs({ warpCore, originTokenAmount, destination, sender, recipient, destinationToken, }: {
+        warpCore: WarpCore;
+        originTokenAmount: TokenAmount<IToken>;
+        destination: ChainNameOrId;
+        sender: string;
+        recipient: string;
+        destinationToken?: IToken;
+    }): Promise<Array<WarpTypedTransaction>>;
+}
+//# sourceMappingURL=SealevelQuotedTransferProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SealevelQuotedTransferProvider.d.ts","sourceRoot":"","sources":["../../src/quoted-calls/SealevelQuotedTransferProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAA0B,MAAM,iBAAiB,CAAC;AAIhF,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AActD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAkB,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EACL,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAS1E;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,UAAU,GACrB,UAAU,CAKZ;AAuBD,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,UAAU,EAAE,UAAU,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,UAAU,CAAC;CAC/B;AAmJD;;;;;;;;;;;GAWG;AACH,qBAAa,8BAA+B,YAAW,sBAAsB;IAG/D,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,QAAQ,yBAAyB;IAE1C,YAA6B,IAAI,EAAE,kCAAkC,EAAI;IAEzE;;;;;;;;OAQG;YACW,oBAAoB;IAqJlC;;;;;;;;;;OAUG;IACG,oBAAoB,CAAC,EACzB,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,MAAM,EACN,SAAS,EACT,gBAAgB,GACjB,EAAE;QACD,QAAQ,EAAE,QAAQ,CAAC;QACnB,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,WAAW,EAAE,aAAa,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC;QACV,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC9B,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;KACrC,CAAC,CA4ED;IAEK,sBAAsB,CAAC,EAC3B,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,MAAM,EACN,SAAS,EACT,gBAAgB,GACjB,EAAE;QACD,QAAQ,EAAE,QAAQ,CAAC;QACnB,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,WAAW,EAAE,aAAa,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAqKvC;CACF"}