@andrewkimjoseph/celina-sdk 0.9.8 → 0.10.0

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

@@ -0,0 +1,319 @@
+/**
+ * Mento FX: getFxQuote is read-only; prepareFx builds approve + swap steps when needed.
+ * Uses @mento-protocol/mento-sdk for routing and simulates allowance via state overrides.
+ */
+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 trimDisplayDecimals(value) {
+    const num = Number(value);
+    if (!Number.isFinite(num)) {
+        return value;
+    }
+    if (Math.abs(num) >= 1000) {
+        return num.toLocaleString(undefined, { maximumFractionDigits: 2 });
+    }
+    if (Math.abs(num) >= 1) {
+        return num.toLocaleString(undefined, { maximumFractionDigits: 4 });
+    }
+    return num.toLocaleString(undefined, { maximumSignificantDigits: 6 });
+}
+/** Human-friendly amount for UI labels (handles raw base-unit integers). */
+export function formatDisplayAmount(amount, decimals) {
+    const trimmed = amount.trim();
+    const approx = trimmed.startsWith("~");
+    let numeric = approx ? trimmed.slice(1).trim() : trimmed;
+    numeric = numeric.replace(/,/g, "");
+    const integerPart = numeric.split(".")[0] ?? numeric;
+    if (/^\d+(?:\.\d+)?$/.test(numeric) && integerPart.length >= 10) {
+        try {
+            const human = formatUnits(BigInt(integerPart), decimals);
+            const asNumber = Number(human);
+            if (Number.isFinite(asNumber) && asNumber >= 0 && asNumber < 1_000_000_000) {
+                numeric = trimDisplayDecimals(human);
+                return approx ? `~${numeric}` : numeric;
+            }
+        }
+        catch {
+            // fall through
+        }
+    }
+    if (/^\d+(?:\.\d+)?$/.test(numeric)) {
+        numeric = trimDisplayDecimals(numeric);
+    }
+    return approx ? `~${numeric}` : numeric;
+}
+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,
+    };
+}
+/** Mento FX quotes, gas estimates, and `prepareFx` flows on Celo mainnet. */
+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);
+        await this.tokenService.assertSpendableBalance(from, resolvedIn, amount, {
+            spendToken: resolvedIn.address === "native" ? mentoIn : resolvedIn.address,
+        });
+        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,
+        };
+    }
+    /**
+     * Expected Mento FX output for a token pair — no wallet required.
+     * @param tokenIn - Input token symbol or address
+     * @param tokenOut - Output token symbol or address
+     * @param amount - Human-readable input amount
+     * @param _from - Deprecated; ignored. Balance checks run on prepare/estimate only.
+     */
+    async getFxQuote(tokenIn, tokenOut, amount, _from) {
+        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);
+        }
+    }
+    /**
+     * Simulate gas for a Mento FX swap from `from`, including approval if needed.
+     * @param from - Sender wallet address
+     * @param tokenIn - Input token symbol or address
+     * @param tokenOut - Output token symbol or address
+     * @param amount - Human-readable input amount
+     * @param params - Optional slippage, deadline, and recipient
+     */
+    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;
+            let fxGas;
+            let swapGasEstimated = true;
+            try {
+                fxGas =
+                    approvalParsed !== null
+                        ? await this.estimateSwapGasWithAllowance(client, from, swap.params, approvalParsed)
+                        : await this.estimateCallGas(client, from, swap.params);
+            }
+            catch (error) {
+                // USDT and other proxy/non-standard ERC-20s often cannot be simulated pre-approval.
+                if (approvalParsed === null) {
+                    throw error;
+                }
+                swapGasEstimated = false;
+            }
+            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,
+                swapGasEstimated,
+                slippageTolerance,
+                deadline: deadline.toString(),
+                deadlineMinutes,
+            };
+        }
+        catch (error) {
+            this.formatFxError(error, tokenIn, tokenOut);
+        }
+    }
+    /**
+     * Build unsigned Mento FX steps (approve + swap when needed).
+     * @param from - Sender wallet address
+     * @param tokenIn - Input token symbol or address
+     * @param tokenOut - Output token symbol or address
+     * @param amount - Human-readable input amount
+     * @param params - Optional slippage, deadline, and recipient
+     * @returns 1–2 step `SerializedPreparedFlow` for sequential wallet signing
+     */
+    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 displayIn = formatDisplayAmount(amount, resolvedIn.decimals);
+            const displayOut = formatDisplayAmount(formatUnits(swap.expectedAmountOut, resolvedOut.decimals), resolvedOut.decimals);
+            const steps = [];
+            if (approval) {
+                steps.push(callParamsToPreparedTx(approval, `Approve ${resolvedIn.symbol} for Mento FX`));
+            }
+            steps.push(callParamsToPreparedTx(swap.params, `Swap ${displayIn} ${resolvedIn.symbol} → ~${displayOut} ${resolvedOut.symbol}`));
+            const flow = {
+                network: "mainnet",
+                from,
+                summary: `Mento FX: ${displayIn} ${resolvedIn.symbol} → ${displayOut} ${resolvedOut.symbol}${recipient !== from ? ` (recipient ${recipient})` : ""}`,
+                steps,
+            };
+            return serializePreparedFlow(flow);
+        }
+        catch (error) {
+            this.formatFxError(error, tokenIn, tokenOut);
+        }
+    }
+}
+//# sourceMappingURL=mento-fx.service.js.map

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

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

package/build/src/services/nft.service.d.ts

@@ -0,0 +1,58 @@
+import type { CeloClientFactory } from "../clients/celo-client.js";
+type NftStandard = "ERC721" | "ERC1155";
+/** ERC-721 / ERC-1155 collection and balance reads with optional metadata fetch. */
+export declare class NftService {
+    private readonly clientFactory;
+    constructor(clientFactory: CeloClientFactory);
+    private assertIsContract;
+    private detectStandard;
+    /**
+     * Collection and token metadata for an ERC-721 or ERC-1155 contract.
+     * @param contractAddress - NFT collection contract
+     * @param tokenId - Token id as decimal string
+     * @returns Standard, owner, collection info, and fetched JSON metadata when available
+     * @throws When the address is not a deployed NFT contract
+     */
+    getNftInfo(contractAddress: `0x${string}`, tokenId: string): Promise<{
+        network: "mainnet";
+        contractAddress: `0x${string}`;
+        tokenId: string;
+        standard: NftStandard;
+        owner: `0x${string}` | null;
+        collection: {
+            name: string;
+            symbol: string;
+            totalSupply: string | undefined;
+        };
+        name: string;
+        description: string | undefined;
+        image: string | undefined;
+        metadataUri: string | null;
+        metadata: Record<string, unknown> | null;
+        attributes: {};
+    }>;
+    /**
+     * NFT balance for an owner (ERC-721 collection total or ERC-1155 id-specific balance).
+     * @param contractAddress - NFT collection contract
+     * @param ownerAddress - Holder wallet address
+     * @param tokenId - Required for ERC-1155; ignored for ERC-721 collection balance
+     * @returns Balance as decimal string and detected standard
+     * @throws When ERC-1155 is detected but `tokenId` is omitted
+     */
+    getNftBalance(contractAddress: `0x${string}`, ownerAddress: `0x${string}`, tokenId?: string): Promise<{
+        network: "mainnet";
+        contractAddress: `0x${string}`;
+        ownerAddress: `0x${string}`;
+        tokenId: string | null;
+        balance: string;
+        standard: "ERC721";
+    } | {
+        network: "mainnet";
+        contractAddress: `0x${string}`;
+        ownerAddress: `0x${string}`;
+        tokenId: string;
+        balance: string;
+        standard: "ERC1155";
+    }>;
+}
+export {};

package/build/src/services/nft.service.js

@@ -0,0 +1,222 @@
+/**
+ * ERC-721 and ERC-1155 NFT reads on Celo mainnet (metadata via token URI / IPFS).
+ */
+import { erc1155Abi, erc165Abi, erc721Abi, ERC1155_INTERFACE_ID, ERC721_INTERFACE_ID, } from "../abis/nft.js";
+import { normalizeAddress } from "../utils/normalize-address.js";
+function rewriteIpfsUri(uri) {
+    if (uri.startsWith("ipfs://")) {
+        return uri.replace("ipfs://", "https://ipfs.io/ipfs/");
+    }
+    return uri;
+}
+async function fetchMetadata(uri) {
+    if (!uri)
+        return null;
+    try {
+        const url = rewriteIpfsUri(uri);
+        const response = await fetch(url, { signal: AbortSignal.timeout(10_000) });
+        if (!response.ok)
+            return null;
+        return (await response.json());
+    }
+    catch {
+        return null;
+    }
+}
+/** ERC-721 / ERC-1155 collection and balance reads with optional metadata fetch. */
+export class NftService {
+    clientFactory;
+    constructor(clientFactory) {
+        this.clientFactory = clientFactory;
+    }
+    async assertIsContract(address) {
+        const { public: client } = this.clientFactory.getClients();
+        const bytecode = await client.getBytecode({ address });
+        if (!bytecode || bytecode === "0x") {
+            throw new Error(`${address} is not an NFT contract on Celo mainnet (no contract bytecode). ` +
+                "Verify the address is a deployed ERC-721 or ERC-1155 collection.");
+        }
+    }
+    async detectStandard(contractAddress) {
+        const { public: client } = this.clientFactory.getClients();
+        try {
+            const supports1155 = await client.readContract({
+                address: contractAddress,
+                abi: erc165Abi,
+                functionName: "supportsInterface",
+                args: [ERC1155_INTERFACE_ID],
+            });
+            if (supports1155)
+                return "ERC1155";
+        }
+        catch {
+            // fall through
+        }
+        try {
+            const supports721 = await client.readContract({
+                address: contractAddress,
+                abi: erc165Abi,
+                functionName: "supportsInterface",
+                args: [ERC721_INTERFACE_ID],
+            });
+            if (supports721)
+                return "ERC721";
+        }
+        catch {
+            // fall through
+        }
+        throw new Error(`${contractAddress} does not implement ERC-721 or ERC-1155 (ERC-165 check failed).`);
+    }
+    /**
+     * Collection and token metadata for an ERC-721 or ERC-1155 contract.
+     * @param contractAddress - NFT collection contract
+     * @param tokenId - Token id as decimal string
+     * @returns Standard, owner, collection info, and fetched JSON metadata when available
+     * @throws When the address is not a deployed NFT contract
+     */
+    async getNftInfo(contractAddress, tokenId) {
+        const contract = normalizeAddress(contractAddress, "contract address");
+        const { public: client } = this.clientFactory.getClients();
+        await this.assertIsContract(contract);
+        const standard = await this.detectStandard(contract);
+        const id = BigInt(tokenId);
+        let name;
+        let symbol;
+        let totalSupply;
+        let owner = null;
+        let metadataUri = null;
+        if (standard === "ERC721") {
+            const [collectionName, collectionSymbol, supply] = await Promise.all([
+                client
+                    .readContract({
+                    address: contract,
+                    abi: erc721Abi,
+                    functionName: "name",
+                })
+                    .catch(() => undefined),
+                client
+                    .readContract({
+                    address: contract,
+                    abi: erc721Abi,
+                    functionName: "symbol",
+                })
+                    .catch(() => undefined),
+                client
+                    .readContract({
+                    address: contract,
+                    abi: erc721Abi,
+                    functionName: "totalSupply",
+                })
+                    .catch(() => undefined),
+            ]);
+            name = collectionName;
+            symbol = collectionSymbol;
+            totalSupply = supply?.toString();
+            owner = await client
+                .readContract({
+                address: contract,
+                abi: erc721Abi,
+                functionName: "ownerOf",
+                args: [id],
+            })
+                .catch(() => null);
+            metadataUri = await client
+                .readContract({
+                address: contract,
+                abi: erc721Abi,
+                functionName: "tokenURI",
+                args: [id],
+            })
+                .catch(() => null);
+        }
+        else {
+            metadataUri = await client
+                .readContract({
+                address: contract,
+                abi: erc1155Abi,
+                functionName: "uri",
+                args: [id],
+            })
+                .catch(() => null);
+        }
+        const metadata = metadataUri ? await fetchMetadata(metadataUri) : null;
+        const image = typeof metadata?.image === "string"
+            ? rewriteIpfsUri(metadata.image)
+            : undefined;
+        return {
+            network: "mainnet",
+            contractAddress: contract,
+            tokenId,
+            standard,
+            owner,
+            collection: {
+                name: name ?? `Unknown Collection (${contract.slice(0, 8)}...)`,
+                symbol: symbol ?? "UNKNOWN",
+                totalSupply,
+            },
+            name: (typeof metadata?.name === "string" ? metadata.name : undefined) ??
+                `Token #${tokenId}`,
+            description: typeof metadata?.description === "string"
+                ? metadata.description
+                : undefined,
+            image,
+            metadataUri,
+            metadata,
+            attributes: metadata?.attributes ?? [],
+        };
+    }
+    /**
+     * NFT balance for an owner (ERC-721 collection total or ERC-1155 id-specific balance).
+     * @param contractAddress - NFT collection contract
+     * @param ownerAddress - Holder wallet address
+     * @param tokenId - Required for ERC-1155; ignored for ERC-721 collection balance
+     * @returns Balance as decimal string and detected standard
+     * @throws When ERC-1155 is detected but `tokenId` is omitted
+     */
+    async getNftBalance(contractAddress, ownerAddress, tokenId) {
+        const contract = normalizeAddress(contractAddress, "contract address");
+        const owner = normalizeAddress(ownerAddress, "owner address");
+        const { public: client } = this.clientFactory.getClients();
+        await this.assertIsContract(contract);
+        const standard = await this.detectStandard(contract);
+        if (standard === "ERC721") {
+            try {
+                const balance = await client.readContract({
+                    address: contract,
+                    abi: erc721Abi,
+                    functionName: "balanceOf",
+                    args: [owner],
+                });
+                return {
+                    network: "mainnet",
+                    contractAddress: contract,
+                    ownerAddress: owner,
+                    tokenId: tokenId ?? null,
+                    balance: balance.toString(),
+                    standard,
+                };
+            }
+            catch (error) {
+                throw new Error(`Could not read ERC-721 balance for ${contract}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        if (!tokenId) {
+            throw new Error("Token ID is required for ERC1155 balance queries");
+        }
+        const balance = await client.readContract({
+            address: contract,
+            abi: erc1155Abi,
+            functionName: "balanceOf",
+            args: [owner, BigInt(tokenId)],
+        });
+        return {
+            network: "mainnet",
+            contractAddress: contract,
+            ownerAddress: owner,
+            tokenId,
+            balance: balance.toString(),
+            standard,
+        };
+    }
+}
+//# sourceMappingURL=nft.service.js.map

package/build/src/services/nft.service.js.map

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

package/build/src/services/self-session-store.d.ts

@@ -0,0 +1,19 @@
+import type { SelfDeregistrationSession, SelfRefreshSession, SelfRegistrationSession } from "../clients/self-api.js";
+export type SelfSessionKind = "registration" | "refresh" | "deregistration";
+export type StoredSelfSession = {
+    kind: "registration";
+    session: SelfRegistrationSession;
+    createdAt: number;
+} | {
+    kind: "refresh";
+    session: SelfRefreshSession;
+    createdAt: number;
+} | {
+    kind: "deregistration";
+    session: SelfDeregistrationSession;
+    createdAt: number;
+};
+export declare function storeSelfSession(sessionToken: string, entry: StoredSelfSession): void;
+export declare function getSelfSession(sessionToken: string): StoredSelfSession | undefined;
+export declare function deleteSelfSession(sessionToken: string): void;
+export declare function clearSelfSessionsForTests(): void;