@andrewkimjoseph/celina 0.4.0 → 0.4.2

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

@@ -1,71 +0,0 @@
-import type { CeloClientFactory } from "../clients/celo-client.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 requireClients;
-    private getMentoClient;
-    private resolveMentoPair;
-    private fxOptions;
-    private formatFxError;
-    private toSendParams;
-    private estimateCallGas;
-    /**
-     * Swap gas estimation runs transferFrom; without on-chain approval that reverts.
-     * Simulate sufficient allowance via eth_estimateGas stateOverride.
-     */
-    private estimateSwapGasWithAllowance;
-    private executeCall;
-    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(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;
-    }>;
-    executeFx(tokenIn: string, tokenOut: string, amount: string, params?: MentoFxParams): Promise<{
-        from: `0x${string}`;
-        recipient: `0x${string}`;
-        amountOutMin: string;
-        approvalNeeded: boolean;
-        approvalHash: `0x${string}` | undefined;
-        hash: `0x${string}`;
-        status: "success" | "reverted";
-        slippageTolerance: number;
-        deadline: string;
-        deadlineMinutes: number;
-        protocol: "mento_fx";
-        network: "mainnet";
-        tokenIn: string;
-        tokenOut: string;
-        amountIn: string;
-        expectedOut: string;
-        routeHops: number;
-    }>;
-}

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

@@ -1,261 +0,0 @@
-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 { 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]);
-}
-export class MentoFxService {
-    clientFactory;
-    tokenService;
-    constructor(clientFactory) {
-        this.clientFactory = clientFactory;
-        this.tokenService = new TokenService(clientFactory);
-    }
-    requireClients() {
-        const clients = this.clientFactory.getClients();
-        if (!clients.wallet || !clients.accountAddress) {
-            throw new Error("No wallet configured. Set CELO_PRIVATE_KEY in the MCP server env.");
-        }
-        return clients;
-    }
-    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));
-    }
-    toSendParams(params) {
-        return {
-            to: params.to,
-            data: taggedCalldata(params.data),
-            value: BigInt(params.value),
-        };
-    }
-    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();
-    }
-    /**
-     * Swap gas estimation runs transferFrom; without on-chain approval that reverts.
-     * Simulate sufficient allowance via eth_estimateGas stateOverride.
-     */
-    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.");
-    }
-    async executeCall(wallet, publicClient, params) {
-        const account = wallet.account;
-        if (!account) {
-            throw new Error("Wallet account unavailable.");
-        }
-        const chain = publicClient.chain;
-        if (!chain) {
-            throw new Error("Chain configuration missing.");
-        }
-        const approve = parseErc20Approve(params);
-        if (approve) {
-            return wallet.writeContract({
-                chain,
-                account,
-                address: approve.token,
-                abi: erc20Abi,
-                functionName: "approve",
-                args: [approve.spender, approve.amount],
-                dataSuffix: CELINA_DATA_SUFFIX,
-            });
-        }
-        return wallet.sendTransaction({
-            chain,
-            account,
-            ...this.toSendParams(params),
-        });
-    }
-    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(tokenIn, tokenOut, amount, params) {
-        const { public: client, accountAddress: from } = this.requireClients();
-        if (!from) {
-            throw new Error("Wallet address unavailable.");
-        }
-        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);
-        try {
-            const mento = await this.getMentoClient(client);
-            const { approval, swap } = await mento.swap.buildSwapTransaction(mentoIn, mentoOut, amountInWei, recipient, from, { slippageTolerance, deadline });
-            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, resolvedIn.symbol, resolvedOut.symbol);
-        }
-    }
-    async executeFx(tokenIn, tokenOut, amount, params) {
-        const { public: client, wallet, accountAddress: from } = this.requireClients();
-        if (!wallet || !from) {
-            throw new Error("Wallet client unavailable. Set CELO_PRIVATE_KEY in the MCP server env.");
-        }
-        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);
-        try {
-            const mento = await this.getMentoClient(client);
-            const { approval, swap } = await mento.swap.buildSwapTransaction(mentoIn, mentoOut, amountInWei, recipient, from, { slippageTolerance, deadline });
-            let approvalHash;
-            if (approval) {
-                approvalHash = await this.executeCall(wallet, client, approval);
-                await client.waitForTransactionReceipt({ hash: approvalHash });
-            }
-            const hash = await this.executeCall(wallet, client, swap.params);
-            const receipt = await client.waitForTransactionReceipt({ hash });
-            return {
-                ...this.baseQuoteFields(resolvedIn, resolvedOut, amount, swap.expectedAmountOut, swap.route.path.length),
-                from,
-                recipient,
-                amountOutMin: formatUnits(swap.amountOutMin, resolvedOut.decimals),
-                approvalNeeded: approval !== null,
-                approvalHash,
-                hash,
-                status: receipt.status,
-                slippageTolerance,
-                deadline: deadline.toString(),
-                deadlineMinutes,
-            };
-        }
-        catch (error) {
-            this.formatFxError(error, resolvedIn.symbol, resolvedOut.symbol);
-        }
-    }
-}
-//# sourceMappingURL=mento-fx.service.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mento-fx.service.js","sourceRoot":"","sources":["../../src/services/mento-fx.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,WAAW,EAAY,MAAM,MAAM,CAAC;AACnF,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,KAAK,EACL,kBAAkB,EAClB,mBAAmB,GAEpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAsB,MAAM,oBAAoB,CAAC;AAQtE,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAQnC,SAAS,iBAAiB,CAAC,MAAkB;IAC3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACjC,GAAG,EAAE,QAAQ;YACb,IAAI,EAAE,MAAM,CAAC,IAAW;SACzB,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,EAAmB;YACjC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAkB;YACzC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAW;SAClC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAS;IAC/B,OAAO,MAAM,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,OAAO,cAAc;IAGI;IAFZ,YAAY,CAAe;IAE5C,YAA6B,aAAgC;QAAhC,kBAAa,GAAb,aAAa,CAAmB;QAC3D,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,aAAa,CAAC,CAAC;IACtD,CAAC;IAEO,cAAc;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,YAAmC;QAC9D,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;IAEO,gBAAgB,CAAC,OAAe,EAAE,QAAgB;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAE7D,OAAO;YACL,UAAU;YACV,WAAW;YACX,OAAO,EAAE,mBAAmB,CAAC,UAAU,CAAC,OAAO,CAAC;YAChD,QAAQ,EAAE,mBAAmB,CAAC,WAAW,CAAC,OAAO,CAAC;SACnD,CAAC;IACJ,CAAC;IAEO,SAAS,CAAC,MAAsB;QACtC,MAAM,iBAAiB,GAAG,MAAM,EAAE,iBAAiB,IAAI,gBAAgB,CAAC;QACxE,MAAM,eAAe,GAAG,MAAM,EAAE,eAAe,IAAI,wBAAwB,CAAC;QAE5E,OAAO;YACL,iBAAiB;YACjB,eAAe;YACf,QAAQ,EAAE,mBAAmB,CAAC,eAAe,CAAC;SAC/C,CAAC;IACJ,CAAC;IAEO,aAAa,CACnB,KAAc,EACd,OAAe,EACf,QAAgB;QAEhB,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,MAAM,QAAQ,GAAG,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,YAAY,KAAK,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,CAAC;IAEO,YAAY,CAAC,MAAkB;QACrC,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,EAAmB;YAC9B,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,IAAW,CAAC;YACxC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;SAC5B,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,MAA6B,EAC7B,IAAmB,EACnB,MAAkB;QAElB,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC;gBAC3C,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,OAAO,CAAC,KAAK;gBACtB,GAAG,EAAE,QAAQ;gBACb,YAAY,EAAE,SAAS;gBACvB,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;aACxC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxB,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;YACnC,OAAO,EAAE,IAAI;YACb,EAAE,EAAE,MAAM,CAAC,EAAmB;YAC9B,IAAI,EAAE,MAAM,CAAC,IAAW;YACxB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,4BAA4B,CACxC,MAA6B,EAC7B,IAAmB,EACnB,MAAkB,EAClB,OAAyB;QAEzB,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,IAAI;YACb,EAAE,EAAE,MAAM,CAAC,EAAmB;YAC9B,IAAI,EAAE,MAAM,CAAC,IAAW;YACxB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;SAC5B,CAAC;QAEF,KAAK,MAAM,WAAW,IAAI,uBAAuB,EAAE,CAAC;YAClD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;oBACnC,GAAG,OAAO;oBACV,aAAa,EAAE,2BAA2B,CACxC,OAAO,CAAC,KAAK,EACb,IAAI,EACJ,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,MAAM,EACd,WAAW,CACZ;iBACF,CAAC,CAAC;gBACH,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;YACxB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnC,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,MAA0C,EAC1C,YAAmC,EACnC,MAAkB;QAElB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;QACjC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,MAAM,CAAC,aAAa,CAAC;gBAC1B,KAAK;gBACL,OAAO;gBACP,OAAO,EAAE,OAAO,CAAC,KAAK;gBACtB,GAAG,EAAE,QAAQ;gBACb,YAAY,EAAE,SAAS;gBACvB,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;gBACvC,UAAU,EAAE,kBAAkB;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC,eAAe,CAAC;YAC5B,KAAK;YACL,OAAO;YACP,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;IAEO,eAAe,CACrB,UAAyB,EACzB,WAA0B,EAC1B,MAAc,EACd,cAAsB,EACtB,SAAiB;QAEjB,OAAO;YACL,QAAQ,EAAE,UAAmB;YAC7B,OAAO,EAAE,SAAkB;YAC3B,OAAO,EAAE,UAAU,CAAC,MAAM;YAC1B,QAAQ,EAAE,WAAW,CAAC,MAAM;YAC5B,QAAQ,EAAE,MAAM;YAChB,WAAW,EAAE,WAAW,CAAC,cAAc,EAAE,WAAW,CAAC,QAAQ,CAAC;YAC9D,SAAS;SACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,QAAgB,EAAE,MAAc;QAChE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;QAC3D,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,GAClD,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE3C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChD,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;gBACzD,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC;aAC1C,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC,eAAe,CACzB,UAAU,EACV,WAAW,EACX,MAAM,EACN,cAAc,EACd,KAAK,CAAC,IAAI,CAAC,MAAM,CAClB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CACd,OAAe,EACf,QAAgB,EAChB,MAAc,EACd,MAAsB;QAEtB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAEvE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,GAClD,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,IAAI,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC/E,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,QAAQ,EAAE,GACpD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAC9D,OAAO,EACP,QAAQ,EACR,WAAW,EACX,SAAS,EACT,IAAI,EACJ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAChC,CAAC;YAEF,MAAM,cAAc,GAAG,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAErE,MAAM,WAAW,GAAG,QAAQ;gBAC1B,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC;gBACpD,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,KAAK,GACT,cAAc,KAAK,IAAI;gBACrB,CAAC,CAAC,MAAM,IAAI,CAAC,4BAA4B,CACrC,MAAM,EACN,IAAI,EACJ,IAAI,CAAC,MAAM,EACX,cAAc,CACf;gBACH,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAE5D,OAAO;gBACL,GAAG,IAAI,CAAC,eAAe,CACrB,UAAU,EACV,WAAW,EACX,MAAM,EACN,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CACvB;gBACD,IAAI;gBACJ,SAAS;gBACT,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,QAAQ,CAAC;gBAClE,cAAc,EAAE,QAAQ,KAAK,IAAI;gBACjC,WAAW;gBACX,KAAK;gBACL,iBAAiB;gBACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;gBAC7B,eAAe;aAChB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CACb,OAAe,EACf,QAAgB,EAChB,MAAc,EACd,MAAsB;QAEtB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAE/E,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,GAClD,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,IAAI,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC/E,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,QAAQ,EAAE,GACpD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAC9D,OAAO,EACP,QAAQ,EACR,WAAW,EACX,SAAS,EACT,IAAI,EACJ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAChC,CAAC;YAEF,IAAI,YAAuC,CAAC;YAE5C,IAAI,QAAQ,EAAE,CAAC;gBACb,YAAY,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAChE,MAAM,MAAM,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACjE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAEjE,OAAO;gBACL,GAAG,IAAI,CAAC,eAAe,CACrB,UAAU,EACV,WAAW,EACX,MAAM,EACN,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CACvB;gBACD,IAAI;gBACJ,SAAS;gBACT,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,QAAQ,CAAC;gBAClE,cAAc,EAAE,QAAQ,KAAK,IAAI;gBACjC,YAAY;gBACZ,IAAI;gBACJ,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,iBAAiB;gBACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;gBAC7B,eAAe;aAChB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF"}

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

@@ -1,19 +0,0 @@
-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;

package/build/services/self-session-store.js

@@ -1,28 +0,0 @@
-import { SELF_MAX_SESSIONS, SELF_SESSION_TTL_MS } from "../config/self.js";
-const sessions = new Map();
-function pruneExpiredSessions() {
-    const now = Date.now();
-    for (const [key, entry] of sessions) {
-        if (now - entry.createdAt > SELF_SESSION_TTL_MS) {
-            sessions.delete(key);
-        }
-    }
-}
-export function storeSelfSession(sessionToken, entry) {
-    pruneExpiredSessions();
-    if (sessions.size >= SELF_MAX_SESSIONS) {
-        throw new Error("Too many active Self sessions. Wait for existing sessions to expire (10 minutes) or restart the server.");
-    }
-    sessions.set(sessionToken, entry);
-}
-export function getSelfSession(sessionToken) {
-    pruneExpiredSessions();
-    return sessions.get(sessionToken);
-}
-export function deleteSelfSession(sessionToken) {
-    sessions.delete(sessionToken);
-}
-export function clearSelfSessionsForTests() {
-    sessions.clear();
-}
-//# sourceMappingURL=self-session-store.js.map

package/build/services/self-session-store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"self-session-store.js","sourceRoot":"","sources":["../../src/services/self-session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA0B3E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEtD,SAAS,oBAAoB;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;QACpC,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,mBAAmB,EAAE,CAAC;YAChD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,YAAoB,EACpB,KAAwB;IAExB,oBAAoB,EAAE,CAAC;IAEvB,IAAI,QAAQ,CAAC,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,oBAAoB,EAAE,CAAC;IACvB,OAAO,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

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

@@ -1,247 +0,0 @@
-import { type Hex } from "viem";
-import type { SelfRegistrationMode } from "../config/self.js";
-import type { CeloClientFactory } from "../clients/celo-client.js";
-export interface VerifySelfAgentParams {
-    agentAddress: `0x${string}`;
-    requireAge?: 0 | 18 | 21;
-    requireOfac?: boolean;
-    requireSelfProvider?: boolean;
-}
-export interface VerifySelfRequestParams {
-    agentSignature: Hex;
-    agentTimestamp: string;
-    method: string;
-    path: string;
-    body?: string;
-    keytype?: string;
-    agentKey?: Hex;
-}
-export interface RegisterSelfAgentParams {
-    mode?: SelfRegistrationMode;
-    minimumAge?: 0 | 18 | 21;
-    ofac?: boolean;
-    humanAddress?: `0x${string}`;
-    agentName?: string;
-    agentDescription?: string;
-}
-export declare class SelfService {
-    private readonly clientFactory;
-    private readonly envSelfAgentPrivateKey?;
-    constructor(clientFactory: CeloClientFactory, envSelfAgentPrivateKey?: `0x${string}` | undefined);
-    private resolveAgentPrivateKey;
-    private registryClient;
-    private assertProofRefreshEligible;
-    verifyAgent(params: VerifySelfAgentParams): Promise<{
-        verified: boolean;
-        agent_address: `0x${string}`;
-        reason: string;
-        network: "mainnet";
-    } | {
-        verification_strength: string;
-        network: "mainnet";
-        sibling_agent_ids: number[];
-        proof_expires_at: string | null;
-        days_until_expiry: number;
-        is_expiring_soon: boolean;
-        verified: boolean;
-        agent_address: `0x${string}`;
-        agent_id: number;
-        reason: string;
-        credentials: {
-            nationality: string | undefined;
-            older_than: number;
-            ofac_clear: boolean;
-        };
-    } | {
-        verification_strength: string;
-        registered_at: number;
-        agent_count: number;
-        is_proof_fresh: boolean;
-        network: "mainnet";
-        sibling_agent_ids: number[];
-        proof_expires_at: string | null;
-        days_until_expiry: number;
-        is_expiring_soon: boolean;
-        verified: boolean;
-        agent_address: `0x${string}`;
-        agent_id: number;
-        credentials: {
-            nationality: string | undefined;
-            older_than: number;
-            ofac_clear: boolean;
-        };
-        reason?: undefined;
-    }>;
-    lookupAgent(agentId: number): Promise<{
-        is_expired: boolean;
-        network: "mainnet";
-        proof_expires_at: string | null;
-        days_until_expiry: number;
-        is_expiring_soon: boolean;
-        credentialsSummary: string;
-    }>;
-    verifyRequest(params: VerifySelfRequestParams): Promise<{
-        valid: boolean;
-        reason: string;
-        agent_address?: undefined;
-        agent_id?: undefined;
-        agent_count?: undefined;
-        nullifier?: undefined;
-        credentials?: undefined;
-        note?: undefined;
-    } | {
-        valid: boolean;
-        agent_address: `0x${string}`;
-        reason: string;
-        agent_id?: undefined;
-        agent_count?: undefined;
-        nullifier?: undefined;
-        credentials?: undefined;
-        note?: undefined;
-    } | {
-        valid: boolean;
-        agent_address: `0x${string}`;
-        agent_id: number;
-        reason: string;
-        agent_count?: undefined;
-        nullifier?: undefined;
-        credentials?: undefined;
-        note?: undefined;
-    } | {
-        valid: boolean;
-        agent_address: `0x${string}`;
-        agent_id: number;
-        agent_count: number;
-        nullifier: number;
-        credentials: {
-            nationality: string | undefined;
-            older_than: number;
-            ofac_clear: boolean;
-        };
-        note: string;
-        reason?: undefined;
-    }>;
-    private getAgentInfoFromKey;
-    getIdentity(): Promise<{
-        expiry_warning?: string | undefined;
-        is_expired: boolean;
-        sibling_agent_ids: number[];
-        network: "mainnet";
-        proof_expires_at: string | null;
-        days_until_expiry: number;
-        is_expiring_soon: boolean;
-        registered: true;
-        address: `0x${string}`;
-        agentKey: `0x${string}`;
-        agentId: number;
-        isVerified: boolean;
-        nullifier: number;
-        agentCount: number;
-        verificationStrength: string;
-        credentials_summary: string;
-    } | {
-        message: string;
-        registered: false;
-        address: `0x${string}`;
-        network: "mainnet";
-    }>;
-    registerAgent(params?: RegisterSelfAgentParams): Promise<{
-        session_id: string;
-        agent_address: string;
-        qr_url: string;
-        deep_link: string;
-        expires_at: string;
-        instructions: string;
-        next_step: string;
-    }>;
-    checkRegistration(sessionId: string): Promise<{
-        status: "deregistered";
-        message: string;
-        proof_expires_at?: undefined;
-        agent_id?: undefined;
-        agent_address?: undefined;
-        private_key_hex?: undefined;
-        tx_hash?: undefined;
-    } | {
-        status: "refreshed";
-        proof_expires_at: string;
-        message: string;
-        agent_id?: undefined;
-        agent_address?: undefined;
-        private_key_hex?: undefined;
-        tx_hash?: undefined;
-    } | {
-        status: "verified";
-        agent_id: number;
-        agent_address: string;
-        private_key_hex: string;
-        tx_hash: string | undefined;
-        message: string;
-        proof_expires_at?: undefined;
-    } | {
-        status: "pending";
-        message: string;
-        proof_expires_at?: undefined;
-        agent_id?: undefined;
-        agent_address?: undefined;
-        private_key_hex?: undefined;
-        tx_hash?: undefined;
-    } | {
-        status: "expired";
-        message: string;
-        proof_expires_at?: undefined;
-        agent_id?: undefined;
-        agent_address?: undefined;
-        private_key_hex?: undefined;
-        tx_hash?: undefined;
-    }>;
-    refreshProof(params?: {
-        agentId?: number;
-    }): Promise<{
-        next_step: string;
-        is_expired: boolean;
-        is_proof_fresh: false;
-        proof_expires_at: string | null;
-        days_until_expiry: number;
-        is_expiring_soon: boolean;
-        session_id: string;
-        agent_id: number;
-        qr_url: string;
-        deep_link: string;
-        expires_at: string;
-        instructions: string;
-    }>;
-    deregisterAgent(): Promise<{
-        session_id: string;
-        qr_url: string;
-        deep_link: string;
-        expires_at: string;
-        instructions: string;
-        warning: string;
-        next_step: string;
-    }>;
-    signRequest(params: {
-        method: string;
-        url: string;
-        body?: string;
-    }): Promise<{
-        headers: {
-            "x-self-agent-address": `0x${string}`;
-            "x-self-agent-signature": `0x${string}`;
-            "x-self-agent-timestamp": string;
-        };
-        instructions: string;
-    }>;
-    authenticatedFetch(params: {
-        method: string;
-        url: string;
-        body?: string;
-        contentType?: string;
-    }): Promise<{
-        status: number;
-        body: string;
-        truncated: boolean;
-    }>;
-    /** Reserved for future on-chain Self writes (e.g. metadata updates). */
-    protected taggedCalldata(data: Hex): Hex;
-}