@kasarlabs/fibrous-mcp 0.1.0

package/build/tools/fetchTokens.d.ts

@@ -0,0 +1,10 @@
+import { Token } from 'fibrous-router-sdk';
+export declare class TokenService {
+    private tokens;
+    initializeTokens(): Promise<void>;
+    getToken(symbol: string): Token | undefined;
+    validateTokenPair(sellSymbol: string, buySymbol: string): {
+        sellToken: Token;
+        buyToken: Token;
+    };
+}

package/build/tools/fetchTokens.js

@@ -0,0 +1,26 @@
+import { Router as FibrousRouter } from 'fibrous-router-sdk';
+export class TokenService {
+    async initializeTokens() {
+        try {
+            const fibrous = new FibrousRouter();
+            const tokensRecord = await fibrous.supportedTokens('starknet');
+            this.tokens = new Map(Object.entries(tokensRecord));
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize tokens: ${error.message}`);
+        }
+    }
+    getToken(symbol) {
+        return this.tokens.get(symbol.toLowerCase());
+    }
+    validateTokenPair(sellSymbol, buySymbol) {
+        const sellToken = this.getToken(sellSymbol);
+        const buyToken = this.getToken(buySymbol);
+        if (!sellToken)
+            throw new Error(`Sell token ${sellSymbol} not supported`);
+        if (!buyToken)
+            throw new Error(`Buy token ${buySymbol} not supported`);
+        return { sellToken, buyToken };
+    }
+}
+//# sourceMappingURL=fetchTokens.js.map

package/build/tools/fetchTokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchTokens.js","sourceRoot":"","sources":["../../src/tools/fetchTokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,OAAO,YAAY;IAGvB,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;YACpC,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YAC/D,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,MAAc;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,iBAAiB,CACf,UAAkB,EAClB,SAAiB;QAKjB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAE1C,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,UAAU,gBAAgB,CAAC,CAAC;QAC1E,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,SAAS,gBAAgB,CAAC,CAAC;QAEvE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC;CACF"}

package/build/tools/swap.d.ts

@@ -0,0 +1,19 @@
+import { onchainWrite } from '@kasarlabs/ask-starknet-core';
+import { Router as FibrousRouter } from 'fibrous-router-sdk';
+import { SwapResult, SwapParams } from '../lib/types/index.js';
+export declare class SwapService {
+    private env;
+    private walletAddress;
+    private router;
+    private tokenService;
+    private approvalService;
+    constructor(env: onchainWrite, walletAddress: string, router: FibrousRouter);
+    initialize(): Promise<void>;
+    executeSwapTransaction(params: SwapParams): Promise<SwapResult>;
+    private monitorSwapStatus;
+}
+export declare const createSwapService: (env: onchainWrite, walletAddress?: string) => SwapService;
+export declare const swapTokensFibrous: (env: onchainWrite, params: SwapParams) => Promise<SwapResult | {
+    status: string;
+    error: string;
+}>;

package/build/tools/swap.js

@@ -0,0 +1,100 @@
+import { Account, constants } from 'starknet';
+import { ApprovalService } from './approval.js';
+import { SLIPPAGE_PERCENTAGE } from '../lib/constants/index.js';
+import { TokenService } from './fetchTokens.js';
+import { Router as FibrousRouter } from 'fibrous-router-sdk';
+import { BigNumber } from '@ethersproject/bignumber';
+import { getV3DetailsPayload } from '../lib/utils/utils.js';
+import { ContractInteractor } from '../lib/utils/contractInteractor.js';
+import { TransactionMonitor } from '../lib/utils/transactionMonitor.js';
+export class SwapService {
+    constructor(env, walletAddress, router) {
+        this.env = env;
+        this.walletAddress = walletAddress;
+        this.router = router;
+        this.tokenService = new TokenService();
+        this.approvalService = new ApprovalService();
+        this.router = new FibrousRouter();
+    }
+    async initialize() {
+        await this.tokenService.initializeTokens();
+    }
+    async executeSwapTransaction(params) {
+        try {
+            await this.initialize();
+            const provider = this.env.provider;
+            const contractInteractor = new ContractInteractor(provider);
+            const account = new Account(provider, this.walletAddress, this.env.account.signer, undefined, constants.TRANSACTION_VERSION.V3);
+            const { sellToken, buyToken } = this.tokenService.validateTokenPair(params.sellTokenSymbol, params.buyTokenSymbol);
+            const formattedAmount = BigNumber.from(contractInteractor.formatTokenAmount(params.sellAmount.toString(), sellToken.decimals));
+            const route = await this.router.getBestRoute(BigNumber.from(formattedAmount.toString()), sellToken.address, buyToken.address, 'starknet');
+            if (!route?.success) {
+                throw new Error('No routes available for this swap');
+            }
+            const destinationAddress = account.address;
+            const swapCall = await this.router.buildTransaction(formattedAmount, sellToken.address, buyToken.address, SLIPPAGE_PERCENTAGE, destinationAddress, 'starknet');
+            if (!swapCall) {
+                throw new Error('Calldata not available for this swap');
+            }
+            const approveCalldata = await this.approvalService.checkAndGetApproveToken(account, sellToken.address, this.router.STARKNET_ROUTER_ADDRESS, formattedAmount.toString());
+            let calldata = [];
+            if (approveCalldata) {
+                calldata = [approveCalldata, swapCall];
+            }
+            else {
+                calldata = [swapCall];
+            }
+            const swapResult = await account.execute(calldata, getV3DetailsPayload());
+            const { receipt, events } = await this.monitorSwapStatus(swapResult.transaction_hash);
+            return {
+                status: 'success',
+                message: `Successfully swapped ${params.sellAmount} ${params.sellTokenSymbol} for ${params.buyTokenSymbol}`,
+                transactionHash: swapResult.transaction_hash,
+                sellAmount: params.sellAmount,
+                sellToken: params.sellTokenSymbol,
+                buyToken: params.buyTokenSymbol,
+                receipt,
+                events,
+            };
+        }
+        catch (error) {
+            console.error('Detailed swap error:', error);
+            if (error instanceof Error) {
+                console.error('Error type:', error.constructor.name);
+                console.error('Error message:', error.message);
+                console.error('Error stack:', error.stack);
+            }
+            return {
+                status: 'failure',
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    async monitorSwapStatus(txHash) {
+        const transactionMonitor = new TransactionMonitor(this.env.provider);
+        const receipt = await transactionMonitor.waitForTransaction(txHash, (status) => console.error('Swap status:', status));
+        const events = await transactionMonitor.getTransactionEvents(txHash);
+        return { receipt, events };
+    }
+}
+export const createSwapService = (env, walletAddress) => {
+    if (!walletAddress) {
+        throw new Error('Wallet address not configured');
+    }
+    return new SwapService(env, walletAddress, new FibrousRouter());
+};
+export const swapTokensFibrous = async (env, params) => {
+    const accountAddress = env.account?.address;
+    try {
+        const swapService = createSwapService(env, accountAddress);
+        const result = await swapService.executeSwapTransaction(params);
+        return result;
+    }
+    catch (error) {
+        return {
+            status: 'failure',
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+};
+//# sourceMappingURL=swap.js.map

package/build/tools/swap.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@kasarlabs/fibrous-mcp",
+  "version": "0.1.0",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "fibrous-mcp": "./bin/fibrous-mcp.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod 755 build/index.js",
+    "clean": "rm -rf build",
+    "clean:all": "rm -rf build node_modules",
+    "start": "node build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "dependencies": {
+    "@ethersproject/bignumber": "^5.7.0",
+    "@kasarlabs/ask-starknet-core": "0.1.0",
+    "@langchain/core": "^0.3.42",
+    "@modelcontextprotocol/sdk": "^1.11.2",
+    "dotenv": "^16.4.7",
+    "fibrous-router-sdk": "0.4.3",
+    "starknet": "^7.6.4",
+    "winston": "^3.17.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2"
+  },
+  "keywords": [
+    "mcp",
+    "starknet",
+    "fibrous"
+  ],
+  "author": "kasarlabs",
+  "license": "MIT",
+  "description": "MCP server for interacting with the Fibrous decentralized exchange, enabling single and batch token swaps.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "2239ec60f8e369abd318807cecd22fe97c0ab917"
+}