@kasarlabs/avnu-mcp 0.1.0

package/build/lib/dependances/types.d.ts

@@ -0,0 +1,85 @@
+import { RpcProvider } from 'starknet';
+import { SystemMessage } from '@langchain/core/messages';
+import { z as Zod } from 'zod';
+export interface StarknetTool<P = unknown> {
+    name: string;
+    plugins: string;
+    description: string;
+    schema?: Zod.AnyZodObject;
+    responseFormat?: string;
+    execute: (agent: SnakAgentInterface, params: P, plugins_manager?: any) => Promise<unknown>;
+}
+export interface SignatureTool<P = any> {
+    name: string;
+    categorie?: string;
+    description: string;
+    schema?: object;
+    execute: (params: P) => Promise<unknown>;
+}
+export declare enum AgentMode {
+    INTERACTIVE = "interactive",
+    AUTONOMOUS = "autonomous",
+    HYBRID = "hybrid"
+}
+export interface RawAgentConfig {
+    name: string;
+    group: string;
+    description: string;
+    lore: string[];
+    objectives: string[];
+    knowledge: string[];
+    interval: number;
+    plugins: string[];
+    memory: MemoryConfig;
+    rag?: RagConfig;
+    mcpServers?: Record<string, any>;
+    mode: AgentMode;
+}
+export interface MemoryConfig {
+    enabled?: boolean;
+    shortTermMemorySize?: number;
+    memorySize?: number;
+    maxIterations?: number;
+    embeddingModel?: string;
+}
+export interface RagConfig {
+    enabled?: boolean;
+    topK?: number;
+    embeddingModel?: string;
+}
+export interface AgentConfig {
+    id: string;
+    name: string;
+    group: string;
+    description: string;
+    interval: number;
+    chatId: string;
+    plugins: string[];
+    memory: MemoryConfig;
+    rag?: RagConfig;
+    mcpServers?: Record<string, any>;
+    mode: AgentMode;
+    maxIterations: number;
+    prompt: SystemMessage;
+}
+export interface DatabaseCredentials {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+}
+export interface SnakAgentInterface {
+    getAccountCredentials: () => {
+        accountPublicKey: string;
+        accountPrivateKey: string;
+    };
+    getDatabaseCredentials: () => DatabaseCredentials;
+    getSignature: () => {
+        signature: string;
+    };
+    getProvider: () => RpcProvider;
+    getAgentConfig: () => AgentConfig;
+}
+import winston from 'winston';
+export declare const logger: winston.Logger;

package/build/lib/dependances/types.js

@@ -0,0 +1,51 @@
+export var AgentMode;
+(function (AgentMode) {
+    AgentMode["INTERACTIVE"] = "interactive";
+    AgentMode["AUTONOMOUS"] = "autonomous";
+    AgentMode["HYBRID"] = "hybrid";
+})(AgentMode || (AgentMode = {}));
+import winston from 'winston';
+const levels = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    http: 3,
+    debug: 4,
+};
+const colors = {
+    error: 'red',
+    warn: 'yellow',
+    info: 'green',
+    http: 'magenta',
+    debug: 'blue',
+};
+winston.addColors(colors);
+const level = () => {
+    if (process.env.LOG_LEVEL) {
+        return process.env.LOG_LEVEL.toLowerCase();
+    }
+    const env = process.env.NODE_ENV || 'production';
+    return env === 'development' ? 'debug' : 'info';
+};
+const format = winston.format.combine(winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston.format.colorize({ all: true }), winston.format.printf((info) => `${info.timestamp} ${info.level}: ${info.message}`));
+let transports;
+try {
+    transports = [
+        new winston.transports.Console(),
+        new winston.transports.File({
+            filename: 'logs/error.log',
+            level: 'error',
+        }),
+        new winston.transports.File({ filename: 'logs/combined.log' }),
+    ];
+}
+catch (error) {
+    transports = [new winston.transports.Console()];
+}
+export const logger = winston.createLogger({
+    level: level(),
+    levels,
+    format,
+    transports,
+});
+//# sourceMappingURL=types.js.map

package/build/lib/dependances/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/dependances/types.ts"],"names":[],"mappings":"AAqCA,MAAM,CAAN,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,wCAA2B,CAAA;IAC3B,sCAAyB,CAAA;IACzB,8BAAiB,CAAA;AACnB,CAAC,EAJW,SAAS,KAAT,SAAS,QAIpB;AAoFD,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,MAAM;CACd,CAAC;AAEF,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAE1B,MAAM,KAAK,GAAG,GAAG,EAAE;IAEjB,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IAC7C,CAAC;IAGD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,YAAY,CAAC;IACjD,OAAO,GAAG,KAAK,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CACnC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,EAC3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EACtC,OAAO,CAAC,MAAM,CAAC,MAAM,CACnB,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,OAAO,EAAE,CAC7D,CACF,CAAC;AACF,IAAI,UAAU,CAAC;AACf,IAAI,CAAC;IACH,UAAU,GAAG;QACX,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE;QAEhC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC1B,QAAQ,EAAE,gBAAgB;YAC1B,KAAK,EAAE,OAAO;SACf,CAAC;QAEF,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,UAAU,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACzC,KAAK,EAAE,KAAK,EAAE;IACd,MAAM;IACN,MAAM;IACN,UAAU;CACX,CAAC,CAAC"}

package/build/lib/types/index.d.ts

@@ -0,0 +1,51 @@
+import { Token as AvnuToken } from '@avnu/avnu-sdk';
+import { ProviderInterface } from 'starknet';
+export interface SwapParams {
+    sellTokenSymbol: string;
+    buyTokenSymbol: string;
+    sellAmount: number;
+}
+export interface Token {
+    name: string;
+    address: string;
+    symbol: string;
+    decimals: number;
+    logoUri: string | null;
+    lastDailyVolumeUsd: number;
+    extensions: {
+        [key: string]: string;
+    };
+    tags: string[];
+}
+export interface TokenResponse {
+    content: AvnuToken[];
+    size: number;
+    number: number;
+    totalElements: number;
+    totalPages: number;
+}
+export interface SwapResult {
+    status: 'success' | 'failure';
+    message?: string;
+    error?: string;
+    transactionHash?: string;
+    sellAmount?: number;
+    sellToken?: string;
+    buyToken?: string;
+    amountReceived?: string;
+    receipt?: any;
+    events?: any[];
+}
+export interface BaseUtilityClass {
+    provider: ProviderInterface;
+}
+export interface ContractDeployResult {
+    transactionHash: string;
+    contractAddress: string | string[];
+}
+export interface TransactionResult {
+    status: 'success' | 'failure';
+    transactionHash?: string;
+    contractAddress?: string;
+    error?: string;
+}

package/build/lib/types/index.js

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

package/build/lib/types/index.js.map

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

package/build/lib/utils/contractInteractor.d.ts

@@ -0,0 +1,16 @@
+import { Account, Contract, Call, EstimateFee } from 'starknet';
+import { BaseUtilityClass, ContractDeployResult, TransactionResult } from '../types/index.js';
+export declare class ContractInteractor implements BaseUtilityClass {
+    provider: any;
+    constructor(provider: any);
+    deployContract(account: Account, classHash: string, constructorCalldata?: any[], salt?: string): Promise<ContractDeployResult>;
+    estimateContractDeploy(account: Account, classHash: string, constructorCalldata?: any[], salt?: string): Promise<EstimateFee>;
+    multicall(account: Account, calls: Call[]): Promise<TransactionResult>;
+    estimateMulticall(account: Account, calls: Call[]): Promise<EstimateFee>;
+    createContract(abi: any[], address: string, account?: Account): Contract;
+    readContract(contract: Contract, method: string, args?: any[]): Promise<any>;
+    writeContract(contract: Contract, method: string, args?: any[]): Promise<TransactionResult>;
+    estimateContractWrite(contract: Contract, method: string, args?: any[]): Promise<EstimateFee>;
+    formatTokenAmount(amount: string | number, decimals?: number): string;
+    parseTokenAmount(amount: string, decimals?: number): string;
+}

package/build/lib/utils/contractInteractor.js

@@ -0,0 +1,114 @@
+import { Contract, CallData, hash } from 'starknet';
+export class ContractInteractor {
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async deployContract(account, classHash, constructorCalldata = [], salt) {
+        try {
+            const deployPayload = {
+                classHash,
+                constructorCalldata: CallData.compile(constructorCalldata),
+                salt: salt || hash.getSelectorFromName(Math.random().toString()),
+            };
+            const { transaction_hash, contract_address } = await account.deploy(deployPayload);
+            await this.provider.waitForTransaction(transaction_hash);
+            return {
+                transactionHash: transaction_hash,
+                contractAddress: contract_address,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to deploy contract: ${error.message}`);
+        }
+    }
+    async estimateContractDeploy(account, classHash, constructorCalldata = [], salt) {
+        try {
+            const deployPayload = {
+                classHash,
+                constructorCalldata: CallData.compile(constructorCalldata),
+                salt: salt || hash.getSelectorFromName(Math.random().toString()),
+            };
+            return account.estimateDeployFee(deployPayload);
+        }
+        catch (error) {
+            throw new Error(`Failed to estimate contract deploy: ${error.message}`);
+        }
+    }
+    async multicall(account, calls) {
+        try {
+            const { transaction_hash } = await account.execute(calls);
+            await this.provider.waitForTransaction(transaction_hash);
+            return {
+                status: 'success',
+                transactionHash: transaction_hash,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'failure',
+                error: error.message,
+            };
+        }
+    }
+    async estimateMulticall(account, calls) {
+        try {
+            return account.estimateInvokeFee(calls);
+        }
+        catch (error) {
+            throw new Error(`Failed to estimate multicall: ${error.message}`);
+        }
+    }
+    createContract(abi, address, account) {
+        return new Contract(abi, address, account || this.provider);
+    }
+    async readContract(contract, method, args = []) {
+        try {
+            return await contract.call(method, args);
+        }
+        catch (error) {
+            throw new Error(`Failed to read contract: ${error.message}`);
+        }
+    }
+    async writeContract(contract, method, args = []) {
+        try {
+            const { transaction_hash } = await contract.invoke(method, args);
+            await this.provider.waitForTransaction(transaction_hash);
+            return {
+                status: 'success',
+                transactionHash: transaction_hash,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'failure',
+                error: error.message,
+            };
+        }
+    }
+    async estimateContractWrite(contract, method, args = []) {
+        if (!contract.account) {
+            throw new Error('Contract must be connected to an account to estimate fees');
+        }
+        try {
+            return await contract.estimate(method, args);
+        }
+        catch (error) {
+            throw new Error(`Failed to estimate contract write: ${error.message}`);
+        }
+    }
+    formatTokenAmount(amount, decimals = 18) {
+        const value = typeof amount === 'string' ? amount : amount.toString();
+        const [whole, fraction = ''] = value.split('.');
+        const paddedFraction = fraction.padEnd(decimals, '0');
+        return whole + paddedFraction;
+    }
+    parseTokenAmount(amount, decimals = 18) {
+        const amountBigInt = BigInt(amount);
+        const divisor = BigInt(10) ** BigInt(decimals);
+        const wholePart = amountBigInt / divisor;
+        const fractionPart = amountBigInt % divisor;
+        const paddedFraction = fractionPart.toString().padStart(decimals, '0');
+        return `${wholePart}.${paddedFraction}`;
+    }
+}
+//# sourceMappingURL=contractInteractor.js.map

package/build/lib/utils/contractInteractor.js.map

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

package/build/lib/utils/transactionMonitor.d.ts

@@ -0,0 +1,11 @@
+import { BaseUtilityClass } from '../types/index.js';
+import { TransactionStatus, TransactionReceipt } from 'starknet';
+export declare class TransactionMonitor implements BaseUtilityClass {
+    provider: any;
+    private readonly pollingInterval;
+    constructor(provider: any, pollingInterval?: number);
+    waitForTransaction(txHash: string, callback?: (status: TransactionStatus) => void): Promise<TransactionReceipt>;
+    getTransactionEvents(txHash: string): Promise<Event[]>;
+    watchEvents(fromBlock: number, toBlock: number | "latest" | undefined, callback: (events: Event[]) => void): Promise<void>;
+    getTransactionStatus(txHash: string): Promise<TransactionStatus>;
+}

package/build/lib/utils/transactionMonitor.js

@@ -0,0 +1,82 @@
+export class TransactionMonitor {
+    constructor(provider, pollingInterval = 5000) {
+        this.provider = provider;
+        this.pollingInterval = pollingInterval;
+    }
+    async waitForTransaction(txHash, callback) {
+        let receipt;
+        while (true) {
+            try {
+                receipt = await this.provider.getTransactionReceipt(txHash);
+                if (callback) {
+                    const status = await this.provider.getTransactionStatus(txHash);
+                    callback(status);
+                }
+                if (receipt.finality_status === 'ACCEPTED_ON_L2' ||
+                    receipt.finality_status === 'ACCEPTED_ON_L1') {
+                    break;
+                }
+                if (receipt.execution_status === 'REVERTED') {
+                    throw new Error(`Transaction ${txHash} was reverted`);
+                }
+                await new Promise((resolve) => setTimeout(resolve, this.pollingInterval));
+            }
+            catch (error) {
+                if (error.message.includes('Transaction hash not found')) {
+                    await new Promise((resolve) => setTimeout(resolve, this.pollingInterval));
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return receipt;
+    }
+    async getTransactionEvents(txHash) {
+        try {
+            const receipt = await this.provider.getTransactionReceipt(txHash);
+            return receipt.events || [];
+        }
+        catch (error) {
+            throw new Error(`Failed to get transaction events: ${error.message}`);
+        }
+    }
+    async watchEvents(fromBlock, toBlock = 'latest', callback) {
+        let currentBlock = fromBlock;
+        while (true) {
+            try {
+                const latestBlock = toBlock === 'latest' ? await this.provider.getBlockNumber() : toBlock;
+                if (currentBlock > latestBlock) {
+                    break;
+                }
+                const block = await this.provider.getBlockWithTxs(currentBlock);
+                const events = [];
+                for (const tx of block.transactions) {
+                    if (tx.transaction_hash) {
+                        const receipt = await this.provider.getTransactionReceipt(tx.transaction_hash);
+                        if (receipt.events) {
+                            events.push(...receipt.events);
+                        }
+                    }
+                }
+                if (events.length > 0) {
+                    callback(events);
+                }
+                currentBlock++;
+                await new Promise((resolve) => setTimeout(resolve, this.pollingInterval));
+            }
+            catch (error) {
+                console.error('Error watching events:', error);
+                await new Promise((resolve) => setTimeout(resolve, this.pollingInterval));
+            }
+        }
+    }
+    async getTransactionStatus(txHash) {
+        try {
+            return await this.provider.getTransactionStatus(txHash);
+        }
+        catch (error) {
+            throw new Error(`Failed to get transaction status: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=transactionMonitor.js.map

package/build/lib/utils/transactionMonitor.js.map

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

package/build/lib/utils/utils.d.ts

@@ -0,0 +1,6 @@
+import { Call, Account } from 'starknet';
+export interface ExecuteV3Args {
+    call: Call;
+    account: Account;
+}
+export declare const executeV3Transaction: ({ call, account, }: ExecuteV3Args) => Promise<string>;

package/build/lib/utils/utils.js

@@ -0,0 +1,9 @@
+export const executeV3Transaction = async ({ call, account, }) => {
+    const { transaction_hash } = await account.execute(call);
+    const receipt = await account.waitForTransaction(transaction_hash);
+    if (!receipt.isSuccess()) {
+        throw new Error('Transaction confirmed but failed');
+    }
+    return transaction_hash;
+};
+//# sourceMappingURL=utils.js.map

package/build/lib/utils/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/lib/utils/utils.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,EACzC,IAAI,EACJ,OAAO,GACO,EAAmB,EAAE;IACnC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IACnE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC,CAAC"}

package/build/schemas/index.d.ts

@@ -0,0 +1,28 @@
+import z from 'zod';
+export declare const swapSchema: z.ZodObject<{
+    sellTokenSymbol: z.ZodString;
+    buyTokenSymbol: z.ZodString;
+    sellAmount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    sellTokenSymbol: string;
+    buyTokenSymbol: string;
+    sellAmount: number;
+}, {
+    sellTokenSymbol: string;
+    buyTokenSymbol: string;
+    sellAmount: number;
+}>;
+export declare const routeSchema: z.ZodObject<{
+    sellTokenSymbol: z.ZodString;
+    buyTokenSymbol: z.ZodString;
+    sellAmount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    sellTokenSymbol: string;
+    buyTokenSymbol: string;
+    sellAmount: number;
+}, {
+    sellTokenSymbol: string;
+    buyTokenSymbol: string;
+    sellAmount: number;
+}>;
+export type RouteSchemaType = z.infer<typeof routeSchema>;

package/build/schemas/index.js

@@ -0,0 +1,20 @@
+import z from 'zod';
+export const swapSchema = z.object({
+    sellTokenSymbol: z
+        .string()
+        .describe("Symbol of the token to sell (e.g., 'ETH', 'USDC')"),
+    buyTokenSymbol: z
+        .string()
+        .describe("Symbol of the token to buy (e.g., 'ETH', 'USDC')"),
+    sellAmount: z.number().positive().describe('Amount of tokens to sell'),
+});
+export const routeSchema = z.object({
+    sellTokenSymbol: z
+        .string()
+        .describe("Symbol of the token to sell (e.g., 'ETH', 'USDC')"),
+    buyTokenSymbol: z
+        .string()
+        .describe("Symbol of the token to buy (e.g., 'ETH', 'USDC')"),
+    sellAmount: z.number().positive().describe('Amount of tokens to sell'),
+});
+//# sourceMappingURL=index.js.map

package/build/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,CAAC,mDAAmD,CAAC;IAChE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CACvE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,CAAC,mDAAmD,CAAC;IAChE,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CACvE,CAAC,CAAC"}

package/build/tools/approval.d.ts

@@ -0,0 +1,8 @@
+import { Account } from 'starknet';
+import { onchainWrite } from '@kasarlabs/ask-starknet-core';
+export declare class ApprovalService {
+    private env;
+    constructor(env: onchainWrite);
+    private safeStringify;
+    checkAndApproveToken(account: Account, tokenAddress: string, spenderAddress: string, amount: string): Promise<void>;
+}

package/build/tools/approval.js

@@ -0,0 +1,46 @@
+import { uint256 } from 'starknet';
+import { ERC20_ABI } from '../lib/abis/erc20Abi.js';
+import { ContractInteractor } from '../lib/utils/contractInteractor.js';
+import { TransactionMonitor } from '../lib/utils/transactionMonitor.js';
+export class ApprovalService {
+    constructor(env) {
+        this.env = env;
+    }
+    safeStringify(obj) {
+        return JSON.stringify(obj, (_, value) => (typeof value === 'bigint' ? value.toString() : value), 2);
+    }
+    async checkAndApproveToken(account, tokenAddress, spenderAddress, amount) {
+        try {
+            const contractInteractor = new ContractInteractor(this.env.provider);
+            const transactionMonitor = new TransactionMonitor(this.env.provider);
+            const contract = contractInteractor.createContract(ERC20_ABI, tokenAddress, account);
+            const allowanceResult = await contract.allowance(account.address, spenderAddress);
+            let currentAllowance;
+            if (Array.isArray(allowanceResult)) {
+                currentAllowance = BigInt(allowanceResult[0].toString());
+            }
+            else if (typeof allowanceResult === 'object' &&
+                allowanceResult !== null) {
+                const value = Object.values(allowanceResult)[0];
+                currentAllowance = BigInt(value.toString());
+            }
+            else {
+                currentAllowance = BigInt(allowanceResult.toString());
+            }
+            const requiredAmount = BigInt(amount);
+            if (currentAllowance < requiredAmount) {
+                contract.connect(account);
+                const approveCall = await contract.approve(spenderAddress, uint256.bnToUint256(amount));
+                console.error('Approve transaction sent:', this.safeStringify(approveCall));
+                if (!approveCall?.transaction_hash) {
+                    throw new Error('No transaction hash in approve result');
+                }
+                await transactionMonitor.waitForTransaction(approveCall.transaction_hash, (status) => console.error('Approve status:', status));
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to approve token: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+//# sourceMappingURL=approval.js.map

package/build/tools/approval.js.map

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

package/build/tools/fetchRoute.d.ts

@@ -0,0 +1,13 @@
+import { onchainRead, onchainWrite } from '@kasarlabs/ask-starknet-core';
+import { RouteSchemaType } from '../schemas/index.js';
+import { RouteResult } from '../interfaces/index.js';
+export declare class RouteFetchService {
+    private tokenService;
+    constructor();
+    initialize(): Promise<void>;
+    fetchRoute(params: RouteSchemaType, env: onchainRead, accountAddress: string): Promise<RouteResult>;
+}
+export declare const getRoute: (env: onchainWrite, params: RouteSchemaType) => Promise<string | {
+    status: string;
+    error: string;
+}>;