@andrewkimjoseph/celina-sdk 0.1.0

package/build/services/blockchain.service.js

@@ -0,0 +1,81 @@
+export class BlockchainService {
+    clientFactory;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory;
+    }
+    async getNetworkStatus() {
+        const { public: client } = this.clientFactory.getClients();
+        const [chainId, blockNumber, gasPrice] = await Promise.all([
+            client.getChainId(),
+            client.getBlockNumber(),
+            client.getGasPrice(),
+        ]);
+        return {
+            network: "mainnet",
+            chainId,
+            blockNumber: blockNumber.toString(),
+            gasPriceWei: gasPrice.toString(),
+        };
+    }
+    async getBlock(blockId) {
+        const { public: client } = this.clientFactory.getClients();
+        const blockParams = typeof blockId === "number"
+            ? { blockNumber: BigInt(blockId), includeTransactions: false }
+            : blockId === "latest" || blockId === "pending"
+                ? {
+                    blockTag: blockId,
+                    includeTransactions: false,
+                }
+                : { blockHash: blockId, includeTransactions: false };
+        const block = await client.getBlock(blockParams);
+        if (!block) {
+            throw new Error(`Block not found: ${blockId}`);
+        }
+        return {
+            number: block.number?.toString(),
+            hash: block.hash,
+            timestamp: block.timestamp.toString(),
+            parentHash: block.parentHash,
+            gasUsed: block.gasUsed.toString(),
+            gasLimit: block.gasLimit.toString(),
+            miner: block.miner,
+            transactionCount: block.transactions.length,
+        };
+    }
+    async getLatestBlocks(count = 5) {
+        const { public: client } = this.clientFactory.getClients();
+        const latest = await client.getBlockNumber();
+        const start = latest - BigInt(Math.max(count - 1, 0));
+        const blocks = await Promise.all(Array.from({ length: count }, (_, index) => client.getBlock({ blockNumber: start + BigInt(index) })));
+        return blocks.filter(Boolean).map((block) => ({
+            number: block.number?.toString(),
+            hash: block.hash,
+            timestamp: block.timestamp.toString(),
+            transactionCount: block.transactions.length,
+        }));
+    }
+    async getTransaction(hash) {
+        const { public: client } = this.clientFactory.getClients();
+        const [tx, receipt] = await Promise.all([
+            client.getTransaction({ hash }),
+            client.getTransactionReceipt({ hash }),
+        ]);
+        if (!tx) {
+            throw new Error(`Transaction not found: ${hash}`);
+        }
+        return {
+            hash: tx.hash,
+            from: tx.from,
+            to: tx.to,
+            value: tx.value.toString(),
+            nonce: tx.nonce,
+            gas: tx.gas.toString(),
+            gasPrice: tx.gasPrice?.toString(),
+            input: tx.input,
+            blockNumber: tx.blockNumber?.toString(),
+            status: receipt?.status,
+            gasUsed: receipt?.gasUsed.toString(),
+        };
+    }
+}
+//# sourceMappingURL=blockchain.service.js.map

package/build/services/blockchain.service.js.map

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

package/build/services/ens.service.d.ts

@@ -0,0 +1,30 @@
+import { type EnsClientFactory } from "../clients/ens-client.js";
+export type EnsResolveChain = "celo" | "ethereum";
+export type ResolvedRecipient = {
+    address: `0x${string}`;
+    ens?: {
+        name: string;
+        normalizedName: string;
+        resolvedVia?: "celo" | "ethereum";
+    };
+};
+export declare class EnsService {
+    private readonly ensClientFactory;
+    constructor(ensClientFactory: EnsClientFactory);
+    resolveEns(name: string, chain?: EnsResolveChain): Promise<{
+        name: string;
+        normalizedName: string;
+        address: `0x${string}`;
+        coinType: string;
+        chain: "ethereum";
+        resolvedVia?: undefined;
+    } | {
+        name: string;
+        normalizedName: string;
+        address: `0x${string}`;
+        coinType: string;
+        chain: "celo";
+        resolvedVia: "celo" | "ethereum";
+    }>;
+    resolveAddressOrEns(input: string): Promise<ResolvedRecipient>;
+}

package/build/services/ens.service.js

@@ -0,0 +1,78 @@
+import { toCoinType } from "viem";
+import { celo } from "viem/chains";
+import { getEnsAddress, normalize } from "viem/ens";
+import { ENS_CCIP_GATEWAY, } from "../clients/ens-client.js";
+const ADDRESS_PATTERN = /^0x[a-fA-F0-9]{40}$/;
+export class EnsService {
+    ensClientFactory;
+    constructor(ensClientFactory) {
+        this.ensClientFactory = ensClientFactory;
+    }
+    async resolveEns(name, chain = "celo") {
+        const trimmedName = name.trim();
+        const normalizedName = normalize(trimmedName);
+        const client = this.ensClientFactory.getClient();
+        const gatewayUrls = [ENS_CCIP_GATEWAY];
+        if (chain === "ethereum") {
+            const address = await getEnsAddress(client, {
+                name: normalizedName,
+                gatewayUrls,
+            });
+            if (!address) {
+                throw new Error(`ENS name "${trimmedName}" has no Ethereum address record`);
+            }
+            return {
+                name: trimmedName,
+                normalizedName,
+                address,
+                coinType: "60",
+                chain: "ethereum",
+            };
+        }
+        const celoCoinType = toCoinType(celo.id);
+        let address = await getEnsAddress(client, {
+            name: normalizedName,
+            coinType: celoCoinType,
+            gatewayUrls,
+        });
+        let coinType = celoCoinType.toString();
+        let resolvedVia = "celo";
+        if (!address) {
+            address = await getEnsAddress(client, {
+                name: normalizedName,
+                gatewayUrls,
+            });
+            coinType = "60";
+            resolvedVia = "ethereum";
+        }
+        if (!address) {
+            throw new Error(`ENS name "${trimmedName}" could not be resolved to an address`);
+        }
+        return {
+            name: trimmedName,
+            normalizedName,
+            address,
+            coinType,
+            chain: "celo",
+            resolvedVia,
+        };
+    }
+    async resolveAddressOrEns(input) {
+        const trimmed = input.trim();
+        if (ADDRESS_PATTERN.test(trimmed)) {
+            return { address: trimmed };
+        }
+        const resolved = await this.resolveEns(trimmed);
+        return {
+            address: resolved.address,
+            ens: {
+                name: resolved.name,
+                normalizedName: resolved.normalizedName,
+                ...(resolved.chain === "celo"
+                    ? { resolvedVia: resolved.resolvedVia }
+                    : {}),
+            },
+        };
+    }
+}
+//# sourceMappingURL=ens.service.js.map

package/build/services/ens.service.js.map

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

package/build/services/gooddollar.service.d.ts

@@ -0,0 +1,38 @@
+import type { CeloClientFactory } from "../clients/celo-client.js";
+export declare class GoodDollarService {
+    private readonly clientFactory;
+    constructor(clientFactory: CeloClientFactory);
+    getWhitelistingInfo(address: `0x${string}`): Promise<{
+        address: `0x${string}`;
+        contract: "0xC361A6E67822a0EDc17D899227dd9FC50BD62F42";
+        isCurrentlyWhitelisted: boolean;
+        status: number;
+        statusLabel: string;
+        whitelistedOn: string | null;
+        lastAuthenticatedOn: string | null;
+        fieldDescriptions: {
+            whitelistedOn: string;
+            lastAuthenticatedOn: string;
+        };
+        reverification: {
+            daysSinceLastAuthentication: number;
+            currentReverificationPeriodDays: number;
+            maxReverificationPeriodDays: number;
+            daysUntilReverificationRequired: number;
+            reverificationRequiredOn: string;
+            reverificationProgressPercent: number;
+            isReverificationOverdue: boolean;
+        } | null;
+        identity: {
+            dateAuthenticated: number;
+            dateAdded: number;
+            did: string;
+            whitelistedOnChainId: number;
+            status: number;
+            authCount: number;
+        };
+    }>;
+    private effectiveAuthCount;
+    private fetchReverifyDaysOptions;
+    private buildReverificationProgress;
+}

package/build/services/gooddollar.service.js

@@ -0,0 +1,127 @@
+import { goodDollarIdentityAbi } from "../abis/gooddollar-identity.js";
+import { GOODDOLLAR_IDENTITY_ADDRESS } from "../config/gooddollar.js";
+import { formatUnixDate } from "../utils/format-date.js";
+const STATUS_LABELS = {
+    0: "none",
+    1: "whitelisted",
+    2: "dao_contract",
+    255: "blacklisted",
+};
+// Post-upgrade users authenticated before this timestamp use the last reverify step.
+const LEGACY_AUTH_CUTOFF = 1772697574;
+function statusLabel(status) {
+    return STATUS_LABELS[status] ?? "unknown";
+}
+export class GoodDollarService {
+    clientFactory;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory;
+    }
+    async getWhitelistingInfo(address) {
+        const { public: client } = this.clientFactory.getClients();
+        const contract = GOODDOLLAR_IDENTITY_ADDRESS;
+        const [identityResult, isCurrentlyWhitelisted, maxReverificationPeriodDays, reverifyDaysOptions,] = await Promise.all([
+            client.readContract({
+                address: contract,
+                abi: goodDollarIdentityAbi,
+                functionName: "identities",
+                args: [address],
+            }),
+            client.readContract({
+                address: contract,
+                abi: goodDollarIdentityAbi,
+                functionName: "isWhitelisted",
+                args: [address],
+            }),
+            client.readContract({
+                address: contract,
+                abi: goodDollarIdentityAbi,
+                functionName: "authenticationPeriod",
+            }),
+            this.fetchReverifyDaysOptions(client, contract),
+        ]);
+        const [dateAuthenticated, dateAdded, did, whitelistedOnChainId, status, authCount,] = identityResult;
+        const statusNum = Number(status);
+        const dateAuthenticatedNum = Number(dateAuthenticated);
+        const dateAddedNum = Number(dateAdded);
+        const authCountNum = Number(authCount);
+        let currentReverificationPeriodDays = null;
+        if (statusNum === 1 && dateAuthenticatedNum > 0 && reverifyDaysOptions.length > 0) {
+            const effectiveAuthCount = this.effectiveAuthCount(dateAuthenticatedNum, authCountNum, reverifyDaysOptions.length);
+            currentReverificationPeriodDays =
+                reverifyDaysOptions[effectiveAuthCount] ?? null;
+        }
+        const isWhitelistedStatus = statusNum === 1 && dateAddedNum > 0;
+        const reverification = statusNum === 1 && dateAuthenticatedNum > 0 && currentReverificationPeriodDays !== null
+            ? this.buildReverificationProgress(dateAuthenticatedNum, currentReverificationPeriodDays, Number(maxReverificationPeriodDays))
+            : null;
+        return {
+            address,
+            contract,
+            isCurrentlyWhitelisted,
+            status: statusNum,
+            statusLabel: statusLabel(statusNum),
+            whitelistedOn: isWhitelistedStatus ? formatUnixDate(dateAddedNum) : null,
+            lastAuthenticatedOn: dateAuthenticatedNum > 0 ? formatUnixDate(dateAuthenticatedNum) : null,
+            fieldDescriptions: {
+                whitelistedOn: "When the wallet was first added to the GoodDollar whitelist.",
+                lastAuthenticatedOn: "When the wallet last verified its identity. Periodic reverification is required to remain whitelisted.",
+            },
+            reverification,
+            identity: {
+                dateAuthenticated: dateAuthenticatedNum,
+                dateAdded: dateAddedNum,
+                did,
+                whitelistedOnChainId: Number(whitelistedOnChainId),
+                status: statusNum,
+                authCount: authCountNum,
+            },
+        };
+    }
+    effectiveAuthCount(dateAuthenticated, authCount, optionsLength) {
+        if (dateAuthenticated < LEGACY_AUTH_CUTOFF) {
+            return optionsLength - 1;
+        }
+        if (authCount >= optionsLength) {
+            return 0;
+        }
+        return authCount;
+    }
+    async fetchReverifyDaysOptions(client, contract) {
+        const options = [];
+        for (let index = 0; index < 8; index++) {
+            try {
+                const value = await client.readContract({
+                    address: contract,
+                    abi: goodDollarIdentityAbi,
+                    functionName: "reverifyDaysOptions",
+                    args: [BigInt(index)],
+                });
+                options.push(Number(value));
+            }
+            catch {
+                break;
+            }
+        }
+        return options;
+    }
+    buildReverificationProgress(dateAuthenticated, currentReverificationPeriodDays, maxReverificationPeriodDays) {
+        const nowSec = Math.floor(Date.now() / 1000);
+        const daysSinceLastAuthentication = Math.floor((nowSec - dateAuthenticated) / 86400);
+        const daysUntilReverificationRequired = currentReverificationPeriodDays - daysSinceLastAuthentication;
+        const reverificationRequiredTimestamp = dateAuthenticated + currentReverificationPeriodDays * 86400;
+        const isReverificationOverdue = daysUntilReverificationRequired < 0;
+        const reverificationProgressPercent = Math.min(100, Math.max(0, Math.round((daysSinceLastAuthentication / currentReverificationPeriodDays) *
+            100)));
+        return {
+            daysSinceLastAuthentication,
+            currentReverificationPeriodDays,
+            maxReverificationPeriodDays,
+            daysUntilReverificationRequired,
+            reverificationRequiredOn: formatUnixDate(reverificationRequiredTimestamp),
+            reverificationProgressPercent,
+            isReverificationOverdue,
+        };
+    }
+}
+//# sourceMappingURL=gooddollar.service.js.map

package/build/services/gooddollar.service.js.map

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

package/build/services/mento-fx.service.d.ts

@@ -0,0 +1,48 @@
+import type { CeloClientFactory } from "../clients/celo-client.js";
+import { type SerializedPreparedFlow } from "../types/prepared.js";
+export interface MentoFxParams {
+    slippageTolerance?: number;
+    deadlineMinutes?: number;
+    recipient?: `0x${string}`;
+}
+export declare class MentoFxService {
+    private readonly clientFactory;
+    private readonly tokenService;
+    constructor(clientFactory: CeloClientFactory);
+    private getMentoClient;
+    private resolveMentoPair;
+    private fxOptions;
+    private formatFxError;
+    private buildFxSwap;
+    private estimateCallGas;
+    private estimateSwapGasWithAllowance;
+    private baseQuoteFields;
+    getFxQuote(tokenIn: string, tokenOut: string, amount: string): Promise<{
+        protocol: "mento_fx";
+        network: "mainnet";
+        tokenIn: string;
+        tokenOut: string;
+        amountIn: string;
+        expectedOut: string;
+        routeHops: number;
+    }>;
+    estimateFx(from: `0x${string}`, tokenIn: string, tokenOut: string, amount: string, params?: MentoFxParams): Promise<{
+        from: `0x${string}`;
+        recipient: `0x${string}`;
+        amountOutMin: string;
+        approvalNeeded: boolean;
+        approvalGas: string | undefined;
+        fxGas: string;
+        slippageTolerance: number;
+        deadline: string;
+        deadlineMinutes: number;
+        protocol: "mento_fx";
+        network: "mainnet";
+        tokenIn: string;
+        tokenOut: string;
+        amountIn: string;
+        expectedOut: string;
+        routeHops: number;
+    }>;
+    prepareFx(from: `0x${string}`, tokenIn: string, tokenOut: string, amount: string, params?: MentoFxParams): Promise<SerializedPreparedFlow>;
+}

package/build/services/mento-fx.service.js

@@ -0,0 +1,234 @@
+import { concat, decodeFunctionData, erc20Abi, formatUnits, } from "viem";
+import { ChainId, deadlineFromMinutes, Mento, RouteNotFoundError, FXMarketClosedError, } from "../clients/mento-sdk.js";
+import { CELINA_DATA_SUFFIX } from "../config/celina-tag.js";
+import { toMentoTokenAddress } from "../config/chains.js";
+import { ALLOWANCE_MAPPING_SLOTS, erc20AllowanceStateOverride, isLikelyTransferFailed, } from "../utils/erc20-allowance-storage.js";
+import { serializePreparedFlow, } from "../types/prepared.js";
+import { TokenService } from "./token.service.js";
+const DEFAULT_SLIPPAGE = 0.5;
+const DEFAULT_DEADLINE_MINUTES = 5;
+function parseErc20Approve(params) {
+    try {
+        const decoded = decodeFunctionData({
+            abi: erc20Abi,
+            data: params.data,
+        });
+        if (decoded.functionName !== "approve") {
+            return null;
+        }
+        return {
+            token: params.to,
+            spender: decoded.args[0],
+            amount: decoded.args[1],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function taggedCalldata(data) {
+    return concat([data, CELINA_DATA_SUFFIX]);
+}
+function callParamsToPreparedTx(params, description) {
+    const approve = parseErc20Approve(params);
+    if (approve) {
+        return {
+            kind: "erc20",
+            to: approve.token,
+            data: taggedCalldata(params.data),
+            value: "0",
+            description,
+        };
+    }
+    return {
+        kind: "contract",
+        to: params.to,
+        data: taggedCalldata(params.data),
+        value: BigInt(params.value).toString(),
+        description,
+    };
+}
+export class MentoFxService {
+    clientFactory;
+    tokenService;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory;
+        this.tokenService = new TokenService(clientFactory);
+    }
+    async getMentoClient(publicClient) {
+        return Mento.create(ChainId.CELO, publicClient);
+    }
+    resolveMentoPair(tokenIn, tokenOut) {
+        const resolvedIn = this.tokenService.resolveToken(tokenIn);
+        const resolvedOut = this.tokenService.resolveToken(tokenOut);
+        return {
+            resolvedIn,
+            resolvedOut,
+            mentoIn: toMentoTokenAddress(resolvedIn.address),
+            mentoOut: toMentoTokenAddress(resolvedOut.address),
+        };
+    }
+    fxOptions(params) {
+        const slippageTolerance = params?.slippageTolerance ?? DEFAULT_SLIPPAGE;
+        const deadlineMinutes = params?.deadlineMinutes ?? DEFAULT_DEADLINE_MINUTES;
+        return {
+            slippageTolerance,
+            deadlineMinutes,
+            deadline: deadlineFromMinutes(deadlineMinutes),
+        };
+    }
+    formatFxError(error, tokenIn, tokenOut) {
+        if (error instanceof RouteNotFoundError) {
+            throw new Error(`No Mento FX route for ${tokenIn} → ${tokenOut}.`);
+        }
+        if (error instanceof FXMarketClosedError) {
+            throw new Error("Mento FX market is currently closed. FX quotes and execution are unavailable until the market reopens.");
+        }
+        if (error instanceof Error && /FXMarketClosed/i.test(error.message)) {
+            throw new Error("Mento FX market is currently closed. FX quotes and execution are unavailable until the market reopens.");
+        }
+        throw error instanceof Error ? error : new Error(String(error));
+    }
+    async buildFxSwap(from, tokenIn, tokenOut, amount, params) {
+        const { public: client } = this.clientFactory.getClients();
+        const { resolvedIn, resolvedOut, mentoIn, mentoOut } = this.resolveMentoPair(tokenIn, tokenOut);
+        const recipient = params?.recipient ?? from;
+        const amountInWei = this.tokenService.parseAmount(amount, resolvedIn.decimals);
+        const { slippageTolerance, deadlineMinutes, deadline } = this.fxOptions(params);
+        const mento = await this.getMentoClient(client);
+        const { approval, swap } = await mento.swap.buildSwapTransaction(mentoIn, mentoOut, amountInWei, recipient, from, { slippageTolerance, deadline });
+        return {
+            client,
+            from,
+            recipient,
+            resolvedIn,
+            resolvedOut,
+            amount,
+            approval,
+            swap,
+            slippageTolerance,
+            deadlineMinutes,
+            deadline,
+        };
+    }
+    async estimateCallGas(client, from, params) {
+        const approve = parseErc20Approve(params);
+        if (approve) {
+            const gas = await client.estimateContractGas({
+                account: from,
+                address: approve.token,
+                abi: erc20Abi,
+                functionName: "approve",
+                args: [approve.spender, approve.amount],
+            });
+            return gas.toString();
+        }
+        const gas = await client.estimateGas({
+            account: from,
+            to: params.to,
+            data: params.data,
+            value: BigInt(params.value),
+        });
+        return gas.toString();
+    }
+    async estimateSwapGasWithAllowance(client, from, params, approve) {
+        const request = {
+            account: from,
+            to: params.to,
+            data: params.data,
+            value: BigInt(params.value),
+        };
+        for (const mappingSlot of ALLOWANCE_MAPPING_SLOTS) {
+            try {
+                const gas = await client.estimateGas({
+                    ...request,
+                    stateOverride: erc20AllowanceStateOverride(approve.token, from, approve.spender, approve.amount, mappingSlot),
+                });
+                return gas.toString();
+            }
+            catch (error) {
+                if (!isLikelyTransferFailed(error)) {
+                    throw error;
+                }
+            }
+        }
+        throw new Error("Could not estimate Mento FX swap gas: failed to simulate ERC-20 allowance for this token.");
+    }
+    baseQuoteFields(resolvedIn, resolvedOut, amount, expectedOutWei, routeHops) {
+        return {
+            protocol: "mento_fx",
+            network: "mainnet",
+            tokenIn: resolvedIn.symbol,
+            tokenOut: resolvedOut.symbol,
+            amountIn: amount,
+            expectedOut: formatUnits(expectedOutWei, resolvedOut.decimals),
+            routeHops,
+        };
+    }
+    async getFxQuote(tokenIn, tokenOut, amount) {
+        const { public: client } = this.clientFactory.getClients();
+        const { resolvedIn, resolvedOut, mentoIn, mentoOut } = this.resolveMentoPair(tokenIn, tokenOut);
+        const amountInWei = this.tokenService.parseAmount(amount, resolvedIn.decimals);
+        try {
+            const mento = await this.getMentoClient(client);
+            const [expectedOutWei, route] = await Promise.all([
+                mento.quotes.getAmountOut(mentoIn, mentoOut, amountInWei),
+                mento.routes.findRoute(mentoIn, mentoOut),
+            ]);
+            return this.baseQuoteFields(resolvedIn, resolvedOut, amount, expectedOutWei, route.path.length);
+        }
+        catch (error) {
+            this.formatFxError(error, resolvedIn.symbol, resolvedOut.symbol);
+        }
+    }
+    async estimateFx(from, tokenIn, tokenOut, amount, params) {
+        try {
+            const built = await this.buildFxSwap(from, tokenIn, tokenOut, amount, params);
+            const { client, resolvedIn, resolvedOut, approval, swap, recipient, slippageTolerance, deadlineMinutes, deadline, } = built;
+            const approvalParsed = approval ? parseErc20Approve(approval) : null;
+            const approvalGas = approval
+                ? await this.estimateCallGas(client, from, approval)
+                : undefined;
+            const fxGas = approvalParsed !== null
+                ? await this.estimateSwapGasWithAllowance(client, from, swap.params, approvalParsed)
+                : await this.estimateCallGas(client, from, swap.params);
+            return {
+                ...this.baseQuoteFields(resolvedIn, resolvedOut, amount, swap.expectedAmountOut, swap.route.path.length),
+                from,
+                recipient,
+                amountOutMin: formatUnits(swap.amountOutMin, resolvedOut.decimals),
+                approvalNeeded: approval !== null,
+                approvalGas,
+                fxGas,
+                slippageTolerance,
+                deadline: deadline.toString(),
+                deadlineMinutes,
+            };
+        }
+        catch (error) {
+            this.formatFxError(error, tokenIn, tokenOut);
+        }
+    }
+    async prepareFx(from, tokenIn, tokenOut, amount, params) {
+        try {
+            const built = await this.buildFxSwap(from, tokenIn, tokenOut, amount, params);
+            const { resolvedIn, resolvedOut, approval, swap, recipient } = built;
+            const steps = [];
+            if (approval) {
+                steps.push(callParamsToPreparedTx(approval, `Approve ${resolvedIn.symbol} for Mento FX`));
+            }
+            steps.push(callParamsToPreparedTx(swap.params, `Swap ${amount} ${resolvedIn.symbol} → ~${formatUnits(swap.expectedAmountOut, resolvedOut.decimals)} ${resolvedOut.symbol}`));
+            const flow = {
+                network: "mainnet",
+                from,
+                summary: `Mento FX: ${amount} ${resolvedIn.symbol} → ${resolvedOut.symbol}${recipient !== from ? ` (recipient ${recipient})` : ""}`,
+                steps,
+            };
+            return serializePreparedFlow(flow);
+        }
+        catch (error) {
+            this.formatFxError(error, tokenIn, tokenOut);
+        }
+    }
+}
+//# sourceMappingURL=mento-fx.service.js.map