@kasarlabs/contract-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kasar Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# Snak - Contract Plugin
+
+The Contract Plugin provides comprehensive tools for declaring, deploying, and managing Starknet smart contracts.
+
+## Features
+
+This plugin adds the following tools:
+
+- **declare_contract**: Declare a Starknet contract using sierra and casm file paths.
+- **deploy_contract**: Deploy a declared Starknet contract using sierra and casm file paths.
+- **get_constructor_params**: Get constructor parameters from a contract sierra file.
+
+## Usage
+
+The Contract Plugin is used internally by the Starknet Agent and doesn't need to be called directly. When the agent is initialized, it automatically registers these tools, making them available for use.
+
+## Example
+
+When asking the agent to perform contract-related tasks, it will use the appropriate tool from this plugin:
+
+```
+"Declare my contract using these files..."  // Uses declare_contract
+"Deploy the contract at class hash 0x..."  // Uses deploy_contract
+"What are the constructor parameters for this contract?"  // Uses get_constructor_params
+```
+
+## Development
+
+To extend this plugin, add new tools in the `src/tools` directory and register them in the `registerTools` function in `src/index.ts`.

package/bin/contract-mcp.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const buildPath = join(__dirname, '..', 'build', 'index.js');
+
+if (!existsSync(buildPath)) {
+  console.error('Build not found. Run: npm run build');
+  process.exit(1);
+}
+
+await import(buildPath);

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare const RegisterToolInServer: () => Promise<void>;

package/build/index.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import dotenv from 'dotenv';
+import { registerToolsWithServer } from '@kasarlabs/ask-starknet-core';
+import { declareContract } from './tools/declareContract.js';
+import { deployContract } from './tools/deployContract.js';
+import { getConstructorParams } from './tools/getConstructorParams.js';
+import { declareContractSchema, deployContractSchema, getConstructorParamsSchema, } from './schemas/index.js';
+dotenv.config();
+const server = new McpServer({
+    name: 'starknet-contract-mcp',
+    version: '0.0.1',
+});
+const registerTools = (ContractToolRegistry) => {
+    ContractToolRegistry.push({
+        name: 'declare_contract',
+        description: 'Declare a Starknet contract using sierra and casm file paths',
+        schema: declareContractSchema,
+        execute: declareContract,
+    });
+    ContractToolRegistry.push({
+        name: 'deploy_contract',
+        description: 'Deploy a declared Starknet contract using sierra and casm file paths',
+        schema: deployContractSchema,
+        execute: deployContract,
+    });
+    ContractToolRegistry.push({
+        name: 'get_constructor_params',
+        description: 'Get constructor parameters from a contract sierra file',
+        schema: getConstructorParamsSchema,
+        execute: getConstructorParams,
+    });
+};
+export const RegisterToolInServer = async () => {
+    const tools = [];
+    registerTools(tools);
+    await registerToolsWithServer(server, tools);
+};
+const checkEnv = () => {
+    const accountAddress = process.env.STARKNET_ACCOUNT_ADDRESS;
+    const privateKey = process.env.STARKNET_PRIVATE_KEY;
+    const rpcUrl = process.env.STARKNET_RPC_URL;
+    if (!accountAddress || !privateKey || !rpcUrl) {
+        console.error('Missing required environment variables: STARKNET_ACCOUNT_ADDRESS, STARKNET_PRIVATE_KEY, STARKNET_RPC_URL');
+        return false;
+    }
+    return true;
+};
+async function main() {
+    const transport = new StdioServerTransport();
+    if (!checkEnv()) {
+        console.error('Failed to initialize Contract Manager - missing environment variables');
+        process.exit(1);
+    }
+    await RegisterToolInServer();
+    await server.connect(transport);
+    console.error('Starknet Contract MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error in main():', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAW,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,oBAA+B,EAAE,EAAE;IACxD,oBAAoB,CAAC,IAAI,CAAC;QACxB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,8DAA8D;QAC3E,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;IAEH,oBAAoB,CAAC,IAAI,CAAC;QACxB,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,sEAAsE;QACxE,MAAM,EAAE,oBAAoB;QAC5B,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,oBAAoB,CAAC,IAAI,CAAC;QACxB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,wDAAwD;QACrE,MAAM,EAAE,0BAA0B;QAClC,OAAO,EAAE,oBAAoB;KAC9B,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,IAAI,EAAE;IAC7C,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,aAAa,CAAC,KAAK,CAAC,CAAC;IACrB,MAAM,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,GAAY,EAAE;IAC7B,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAE5C,IAAI,CAAC,cAAc,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9C,OAAO,CAAC,KAAK,CACX,0GAA0G,CAC3G,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CACX,uEAAuE,CACxE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,oBAAoB,EAAE,CAAC;IAC7B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACjE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/lib/index.d.ts

@@ -0,0 +1 @@
+export * from './utils/index.js';

package/build/lib/index.js

@@ -0,0 +1,2 @@
+export * from './utils/index.js';
+//# sourceMappingURL=index.js.map

package/build/lib/index.js.map

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

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

@@ -0,0 +1,27 @@
+import { Account, RawArgs, CompiledSierra, CompiledSierraCasm, Abi } from 'starknet';
+export declare class ContractManager {
+    account: Account;
+    compiledSierra: CompiledSierra;
+    compiledCasm: CompiledSierraCasm;
+    abi: Abi;
+    constructor(account: Account);
+    loadContractCompilationFiles(sierraPath: string, casmPath: string): Promise<void>;
+    setAbi(abi: Abi): void;
+    loadAbiFile(abiPath?: string): Promise<void>;
+    isContractDeclared(): Promise<{
+        isDeclared: boolean;
+        classHash?: string;
+    }>;
+    declareContract(): Promise<any>;
+    deployContract(classHash: string, constructorArgs?: RawArgs): Promise<any>;
+    declareAndDeployContract(constructorArgs?: RawArgs): Promise<any>;
+    extractConstructorParams(): Array<{
+        name: string;
+        type: string;
+    }>;
+    convertConstructorArgs(paramDefs: Array<{
+        name: string;
+        type: string;
+    }>, argsStrings: string[]): RawArgs;
+    convertStringToType(value: string, type: string): any;
+}

package/build/lib/utils/contractManager.js

@@ -0,0 +1,189 @@
+import { CallData, hash, cairo, } from 'starknet';
+import * as fs from 'fs';
+export class ContractManager {
+    constructor(account) {
+        this.account = account;
+    }
+    async loadContractCompilationFiles(sierraPath, casmPath) {
+        try {
+            this.compiledSierra = JSON.parse(fs.readFileSync(sierraPath).toString('ascii'));
+            this.compiledCasm = JSON.parse(fs.readFileSync(casmPath).toString('ascii'));
+        }
+        catch (error) {
+            throw new Error(`Failed to load contract files: ${error.message}`);
+        }
+    }
+    setAbi(abi) {
+        this.abi = abi;
+    }
+    async loadAbiFile(abiPath) {
+        try {
+            if (abiPath)
+                this.abi = JSON.parse(fs.readFileSync(abiPath).toString('ascii'));
+            else
+                this.abi = this.compiledSierra.abi;
+        }
+        catch (error) {
+            throw new Error(`Failed to load ABI file: ${error.message}`);
+        }
+    }
+    async isContractDeclared() {
+        try {
+            const contractHash = hash.computeContractClassHash(this.compiledSierra);
+            await this.account.getClassByHash(contractHash);
+            return { isDeclared: true, classHash: contractHash };
+        }
+        catch (error) {
+            return { isDeclared: false };
+        }
+    }
+    async declareContract() {
+        const { isDeclared, classHash } = await this.isContractDeclared();
+        if (isDeclared && classHash) {
+            return {
+                transaction_hash: '',
+                class_hash: classHash,
+            };
+        }
+        try {
+            const declarePayload = {
+                contract: this.compiledSierra,
+                casm: this.compiledCasm,
+            };
+            const declareResponse = await this.account.declare(declarePayload);
+            await this.account.waitForTransaction(declareResponse.transaction_hash);
+            return {
+                transaction_hash: declareResponse.transaction_hash,
+                class_hash: declareResponse.class_hash,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to declare contract: ${error.message}`);
+        }
+    }
+    async deployContract(classHash, constructorArgs = []) {
+        try {
+            const contractCallData = new CallData(this.abi);
+            const constructorCalldata = contractCallData.compile('constructor', constructorArgs);
+            const deployPayload = {
+                classHash,
+                constructorCalldata: constructorCalldata,
+            };
+            const deployResponse = await this.account.deployContract(deployPayload);
+            await this.account.waitForTransaction(deployResponse.transaction_hash);
+            return {
+                transaction_hash: deployResponse.transaction_hash,
+                contract_address: deployResponse.contract_address,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to deploy contract: ${error.message}`);
+        }
+    }
+    async declareAndDeployContract(constructorArgs = []) {
+        try {
+            const contractCallData = new CallData(this.compiledSierra.abi);
+            const constructorCalldata = contractCallData.compile('constructor', constructorArgs);
+            const declareAndDeployPayload = {
+                contract: this.compiledSierra,
+                casm: this.compiledCasm,
+                constructorCalldata: constructorCalldata,
+            };
+            const response = await this.account.declareAndDeploy(declareAndDeployPayload);
+            await this.account.waitForTransaction(response.deploy.transaction_hash);
+            return {
+                declare: {
+                    transaction_hash: response.declare.transaction_hash,
+                    class_hash: response.declare.class_hash.toString(),
+                },
+                deploy: {
+                    transaction_hash: response.deploy.transaction_hash,
+                    contract_address: response.deploy.contract_address,
+                },
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to declare and deploy contract: ${error.message}`);
+        }
+    }
+    extractConstructorParams() {
+        const constructorDef = this.abi.find((item) => item.type === 'constructor');
+        if (!constructorDef ||
+            !constructorDef.inputs ||
+            !Array.isArray(constructorDef.inputs)) {
+            return [];
+        }
+        return constructorDef.inputs.map((input) => ({
+            name: input.name,
+            type: input.type,
+        }));
+    }
+    convertConstructorArgs(paramDefs, argsStrings) {
+        if (!argsStrings || argsStrings.length === 0) {
+            return [];
+        }
+        if (paramDefs.length !== argsStrings.length) {
+            throw new Error(`Expected ${paramDefs.length} constructor arguments but got ${argsStrings.length}`);
+        }
+        const typedArgs = [];
+        for (let i = 0; i < paramDefs.length; i++) {
+            const param = paramDefs[i];
+            const argString = argsStrings[i];
+            typedArgs.push(this.convertStringToType(argString, param.type));
+        }
+        return typedArgs;
+    }
+    convertStringToType(value, type) {
+        if (value === undefined || value === null) {
+            throw new Error(`Missing value for type ${type}`);
+        }
+        const simpleType = type.includes('::') ? type.split('::').pop() : type;
+        switch (true) {
+            case simpleType === 'felt252' ||
+                /^u(8|16|32|64|128)$/.test(simpleType || ''):
+                return BigInt(value);
+            case simpleType === 'u256':
+                try {
+                    return cairo.uint256(value);
+                }
+                catch (error) {
+                    try {
+                        const parsed = JSON.parse(value);
+                        if (parsed.low !== undefined && parsed.high !== undefined) {
+                            return {
+                                low: BigInt(parsed.low),
+                                high: BigInt(parsed.high),
+                            };
+                        }
+                        throw new Error(`Invalid u256 format: ${value}`);
+                    }
+                    catch {
+                        throw error;
+                    }
+                }
+            case simpleType === 'bool':
+                return value.toLowerCase() === 'true' || value === '1';
+            case simpleType === 'ContractAddress' ||
+                simpleType === 'EthAddress' ||
+                simpleType === 'ClassHash':
+                return value.startsWith('0x') ? value : `0x${value}`;
+            case simpleType === 'ByteArray' || simpleType === 'bytearray':
+                return value;
+            case type.includes('Array'):
+                if (value.includes(',')) {
+                    const elements = value.split(',').map((item) => item.trim());
+                    return elements;
+                }
+                try {
+                    if (value.startsWith('[') && value.endsWith(']')) {
+                        return JSON.parse(value);
+                    }
+                }
+                catch { }
+                return value;
+            default:
+                return value;
+        }
+    }
+}
+//# sourceMappingURL=contractManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contractManager.js","sourceRoot":"","sources":["../../../src/lib/utils/contractManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAER,IAAI,EAIJ,KAAK,GACN,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAKzB,MAAM,OAAO,eAAe;IAK1B,YAAmB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAQvC,KAAK,CAAC,4BAA4B,CAAC,UAAkB,EAAE,QAAgB;QACrE,IAAI,CAAC;YACH,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,CAC9B,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC9C,CAAC;YAEF,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAC5B,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC5C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,MAAM,CAAC,GAAQ;QACb,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAgB;QAChC,IAAI,CAAC;YACH,IAAI,OAAO;gBACT,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;;gBAC/D,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAMD,KAAK,CAAC,kBAAkB;QAItB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACxE,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;YAChD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAOD,KAAK,CAAC,eAAe;QACnB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAElE,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;YAC5B,OAAO;gBACL,gBAAgB,EAAE,EAAE;gBACpB,UAAU,EAAE,SAAS;aACtB,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,cAAc,GAAG;gBACrB,QAAQ,EAAE,IAAI,CAAC,cAAc;gBAC7B,IAAI,EAAE,IAAI,CAAC,YAAY;aACxB,CAAC;YAEF,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACnE,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;YAExE,OAAO;gBACL,gBAAgB,EAAE,eAAe,CAAC,gBAAgB;gBAClD,UAAU,EAAE,eAAe,CAAC,UAAU;aACvC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IASD,KAAK,CAAC,cAAc,CAClB,SAAiB,EACjB,kBAA2B,EAAE;QAE7B,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChD,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,OAAO,CAClD,aAAa,EACb,eAAe,CAChB,CAAC;YAEF,MAAM,aAAa,GAAG;gBACpB,SAAS;gBACT,mBAAmB,EAAE,mBAAmB;aACzC,CAAC;YAEF,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YACxE,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;YAEvE,OAAO;gBACL,gBAAgB,EAAE,cAAc,CAAC,gBAAgB;gBACjD,gBAAgB,EAAE,cAAc,CAAC,gBAAgB;aAClD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAQD,KAAK,CAAC,wBAAwB,CAAC,kBAA2B,EAAE;QAC1D,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAC/D,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,OAAO,CAClD,aAAa,EACb,eAAe,CAChB,CAAC;YAEF,MAAM,uBAAuB,GAAG;gBAC9B,QAAQ,EAAE,IAAI,CAAC,cAAc;gBAC7B,IAAI,EAAE,IAAI,CAAC,YAAY;gBACvB,mBAAmB,EAAE,mBAAmB;aACzC,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAClD,uBAAuB,CACxB,CAAC;YACF,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAExE,OAAO;gBACL,OAAO,EAAE;oBACP,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,gBAAgB;oBACnD,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE;iBACnD;gBACD,MAAM,EAAE;oBACN,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB;oBAClD,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB;iBACnD;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,0CAA0C,KAAK,CAAC,OAAO,EAAE,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IAOD,wBAAwB;QACtB,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAClC,CAAC,IAAsB,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CACxD,CAAC;QAEF,IACE,CAAC,cAAc;YACf,CAAC,cAAc,CAAC,MAAM;YACtB,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EACrC,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,cAAc,CAAC,MAAM,CAAC,GAAG,CAC9B,CAAC,KAAqC,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CACH,CAAC;IACJ,CAAC;IAQD,sBAAsB,CACpB,SAAgD,EAChD,WAAqB;QAErB,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,YAAY,SAAS,CAAC,MAAM,kCAAkC,WAAW,CAAC,MAAM,EAAE,CACnF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAY,EAAE,CAAC;QAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YACjC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAQD,mBAAmB,CAAC,KAAa,EAAE,IAAY;QAC7C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAEvE,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,UAAU,KAAK,SAAS;gBAC3B,qBAAqB,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;gBAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YACvB,KAAK,UAAU,KAAK,MAAM;gBACxB,IAAI,CAAC;oBACH,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;wBACjC,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;4BAC1D,OAAO;gCACL,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;gCACvB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;6BAC1B,CAAC;wBACJ,CAAC;wBACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;oBACnD,CAAC;oBAAC,MAAM,CAAC;wBACP,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;YACH,KAAK,UAAU,KAAK,MAAM;gBACxB,OAAO,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC;YACzD,KAAK,UAAU,KAAK,iBAAiB;gBACnC,UAAU,KAAK,YAAY;gBAC3B,UAAU,KAAK,WAAW;gBAC1B,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;YACvD,KAAK,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,WAAW;gBAC3D,OAAO,KAAK,CAAC;YACf,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC7D,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,IAAI,CAAC;oBACH,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBACjD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC3B,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;gBAEV,OAAO,KAAK,CAAC;YACf;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,9 @@
+export { ContractManager } from './contractManager.js';
+export interface StarknetCredentials {
+    accountAddress: string;
+    accountPrivateKey: string;
+    rpcUrl: string;
+}
+export declare function getStarknetCredentials(): StarknetCredentials;
+export declare function validateFilePaths(sierraPath: string, casmPath: string): Promise<void>;
+export declare function formatContractError(error: any): string;

package/build/lib/utils/index.js

@@ -0,0 +1,34 @@
+export { ContractManager } from './contractManager.js';
+export function getStarknetCredentials() {
+    const accountAddress = process.env.STARKNET_ACCOUNT_ADDRESS;
+    const accountPrivateKey = process.env.STARKNET_PRIVATE_KEY;
+    const rpcUrl = process.env.STARKNET_RPC_URL;
+    if (!accountAddress || !accountPrivateKey || !rpcUrl) {
+        throw new Error('Missing required environment variables: STARKNET_ACCOUNT_ADDRESS, STARKNET_PRIVATE_KEY, STARKNET_RPC_URL');
+    }
+    return {
+        accountAddress,
+        accountPrivateKey,
+        rpcUrl,
+    };
+}
+export async function validateFilePaths(sierraPath, casmPath) {
+    const fs = await import('fs/promises');
+    try {
+        await fs.access(sierraPath, fs.constants.R_OK);
+        await fs.access(casmPath, fs.constants.R_OK);
+    }
+    catch (error) {
+        throw new Error(`File validation failed: ${error}`);
+    }
+}
+export function formatContractError(error) {
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error?.message) {
+        return error.message;
+    }
+    return 'Unknown contract operation error';
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAWvD,MAAM,UAAU,sBAAsB;IACpC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAC5D,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAE5C,IAAI,CAAC,cAAc,IAAI,CAAC,iBAAiB,IAAI,CAAC,MAAM,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAC;IACJ,CAAC;IAED,OAAO;QACL,cAAc;QACd,iBAAiB;QACjB,MAAM;KACP,CAAC;AACJ,CAAC;AAKD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,QAAgB;IAEhB,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,mBAAmB,CAAC,KAAU;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,EAAE,OAAO,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,kCAAkC,CAAC;AAC5C,CAAC"}

package/build/schemas/index.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+export declare const declareContractSchema: z.ZodObject<{
+    sierraFilePath: z.ZodString;
+    casmFilePath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sierraFilePath: string;
+    casmFilePath: string;
+}, {
+    sierraFilePath: string;
+    casmFilePath: string;
+}>;
+export declare const deployContractSchema: z.ZodObject<{
+    sierraFilePath: z.ZodString;
+    casmFilePath: z.ZodString;
+    classHash: z.ZodString;
+    constructorArgs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    sierraFilePath: string;
+    casmFilePath: string;
+    classHash: string;
+    constructorArgs?: string[] | undefined;
+}, {
+    sierraFilePath: string;
+    casmFilePath: string;
+    classHash: string;
+    constructorArgs?: string[] | undefined;
+}>;
+export declare const getConstructorParamsSchema: z.ZodObject<{
+    sierraFilePath: z.ZodString;
+    casmFilePath: z.ZodString;
+    classHash: z.ZodString;
+    constructorArgs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    sierraFilePath: string;
+    casmFilePath: string;
+    classHash: string;
+    constructorArgs?: string[] | undefined;
+}, {
+    sierraFilePath: string;
+    casmFilePath: string;
+    classHash: string;
+    constructorArgs?: string[] | undefined;
+}>;

package/build/schemas/index.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export const declareContractSchema = z.object({
+    sierraFilePath: z.string().describe('Path to the sierra JSON file'),
+    casmFilePath: z.string().describe('Path to the casm JSON file'),
+});
+export const deployContractSchema = z.object({
+    sierraFilePath: z.string().describe('Path to the sierra JSON file'),
+    casmFilePath: z.string().describe('Path to the casm JSON file'),
+    classHash: z
+        .string()
+        .describe('Class hash of the declared contract to deploy'),
+    constructorArgs: z
+        .array(z.string())
+        .optional()
+        .describe('OPTIONAL: Arguments for the contract constructor'),
+});
+export const getConstructorParamsSchema = z.object({
+    sierraFilePath: z.string().describe('Path to the sierra JSON file'),
+    casmFilePath: z.string().describe('Path to the casm JSON file'),
+    classHash: z.string().describe('Class hash of the declared contract'),
+    constructorArgs: z
+        .array(z.string())
+        .optional()
+        .describe('OPTIONAL: Arguments for the contract constructor that need to be ordered'),
+});
+//# 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,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACnE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CAChE,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACnE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC/D,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,eAAe,EAAE,CAAC;SACf,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACnE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACrE,eAAe,EAAE,CAAC;SACf,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,0EAA0E,CAC3E;CACJ,CAAC,CAAC"}

package/build/tools/declareContract.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { declareContractSchema } from '../schemas/index.js';
+export declare const declareContract: (params: z.infer<typeof declareContractSchema>) => Promise<{
+    status: string;
+    transactionHash: any;
+    classHash: any;
+    sierraFilePath: string;
+    casmFilePath: string;
+    message: string;
+    error?: undefined;
+    step?: undefined;
+} | {
+    status: string;
+    error: string;
+    step: string;
+    sierraFilePath: string;
+    casmFilePath: string;
+    transactionHash?: undefined;
+    classHash?: undefined;
+    message?: undefined;
+}>;

package/build/tools/declareContract.js

@@ -0,0 +1,33 @@
+import { getOnchainWrite } from '@kasarlabs/ask-starknet-core';
+import { validateFilePaths, formatContractError, ContractManager, } from '../lib/index.js';
+export const declareContract = async (params) => {
+    try {
+        await validateFilePaths(params.sierraFilePath, params.casmFilePath);
+        const { provider, account } = getOnchainWrite();
+        const contractManager = new ContractManager(account);
+        await contractManager.loadContractCompilationFiles(params.sierraFilePath, params.casmFilePath);
+        const declareResponse = await contractManager.declareContract();
+        const contractManagerForHash = new ContractManager(account);
+        await contractManagerForHash.loadContractCompilationFiles(params.sierraFilePath, params.casmFilePath);
+        const { classHash: calculatedClassHash } = await contractManagerForHash.isContractDeclared();
+        return {
+            status: 'success',
+            transactionHash: declareResponse.transaction_hash || '',
+            classHash: declareResponse.class_hash || calculatedClassHash,
+            sierraFilePath: params.sierraFilePath,
+            casmFilePath: params.casmFilePath,
+            message: 'Contract declared successfully',
+        };
+    }
+    catch (error) {
+        const errorMessage = formatContractError(error);
+        return {
+            status: 'failure',
+            error: errorMessage,
+            step: 'contract declaration',
+            sierraFilePath: params.sierraFilePath,
+            casmFilePath: params.casmFilePath,
+        };
+    }
+};
+//# sourceMappingURL=declareContract.js.map

package/build/tools/declareContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declareContract.js","sourceRoot":"","sources":["../../src/tools/declareContract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAOzB,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,MAA6C,EAC7C,EAAE;IACF,IAAI,CAAC;QAEH,MAAM,iBAAiB,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAGpE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;QAGhD,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,eAAe,CAAC,4BAA4B,CAChD,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,YAAY,CACpB,CAAC;QAEF,MAAM,eAAe,GAAG,MAAM,eAAe,CAAC,eAAe,EAAE,CAAC;QAGhE,MAAM,sBAAsB,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,sBAAsB,CAAC,4BAA4B,CACvD,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,YAAY,CACpB,CAAC;QACF,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,GACtC,MAAM,sBAAsB,CAAC,kBAAkB,EAAE,CAAC;QAEpD,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,eAAe,EAAE,eAAe,CAAC,gBAAgB,IAAI,EAAE;YACvD,SAAS,EAAE,eAAe,CAAC,UAAU,IAAI,mBAAmB;YAC5D,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,OAAO,EAAE,gCAAgC;SAC1C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,sBAAsB;YAC5B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/build/tools/deployContract.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { deployContractSchema } from '../schemas/index.js';
+export declare const deployContract: (params: z.infer<typeof deployContractSchema>) => Promise<{
+    status: string;
+    transactionHash: any;
+    contractAddress: any;
+    classHash: string;
+    constructorArgs: string[];
+    sierraFilePath: string;
+    casmFilePath: string;
+    message: string;
+    error?: undefined;
+    step?: undefined;
+} | {
+    status: string;
+    error: string;
+    step: string;
+    classHash: string;
+    constructorArgs: string[];
+    sierraFilePath: string;
+    casmFilePath: string;
+    transactionHash?: undefined;
+    contractAddress?: undefined;
+    message?: undefined;
+}>;

package/build/tools/deployContract.js

@@ -0,0 +1,34 @@
+import { getOnchainWrite } from '@kasarlabs/ask-starknet-core';
+import { formatContractError, ContractManager, } from '../lib/index.js';
+export const deployContract = async (params) => {
+    try {
+        const { provider, account } = getOnchainWrite();
+        const contractManager = new ContractManager(account);
+        await contractManager.loadContractCompilationFiles(params.sierraFilePath, params.casmFilePath);
+        await contractManager.loadAbiFile();
+        const deployResponse = await contractManager.deployContract(params.classHash, params.constructorArgs || []);
+        return {
+            status: 'success',
+            transactionHash: deployResponse.transaction_hash,
+            contractAddress: deployResponse.contract_address,
+            classHash: params.classHash,
+            constructorArgs: params.constructorArgs || [],
+            sierraFilePath: params.sierraFilePath,
+            casmFilePath: params.casmFilePath,
+            message: 'Contract deployed successfully',
+        };
+    }
+    catch (error) {
+        const errorMessage = formatContractError(error);
+        return {
+            status: 'failure',
+            error: errorMessage,
+            step: 'contract deployment',
+            classHash: params.classHash,
+            constructorArgs: params.constructorArgs || [],
+            sierraFilePath: params.sierraFilePath,
+            casmFilePath: params.casmFilePath,
+        };
+    }
+};
+//# sourceMappingURL=deployContract.js.map

package/build/tools/deployContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployContract.js","sourceRoot":"","sources":["../../src/tools/deployContract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAEL,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAMzB,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,MAA4C,EAC5C,EAAE;IACF,IAAI,CAAC;QAKH,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;QAGhD,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,eAAe,CAAC,4BAA4B,CAChD,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,YAAY,CACpB,CAAC;QACF,MAAM,eAAe,CAAC,WAAW,EAAE,CAAC;QAEpC,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC,cAAc,CACzD,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,eAAe,IAAI,EAAE,CAC7B,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,eAAe,EAAE,cAAc,CAAC,gBAAgB;YAChD,eAAe,EAAE,cAAc,CAAC,gBAAgB;YAChD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE;YAC7C,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,OAAO,EAAE,gCAAgC;SAC1C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,qBAAqB;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE;YAC7C,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/build/tools/getConstructorParams.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { getConstructorParamsSchema } from '../schemas/index.js';
+export declare const getConstructorParams: (params: z.infer<typeof getConstructorParamsSchema>) => Promise<{
+    status: string;
+    classHash: string;
+    sierraFilePath: string;
+    message: string;
+    parameterCount: number;
+    parameters: {
+        index: number;
+        name: any;
+        type: any;
+    }[];
+    error?: undefined;
+    step?: undefined;
+    providedArgs?: undefined;
+} | {
+    status: string;
+    error: string;
+    step: string;
+    classHash: string;
+    sierraFilePath: string;
+    providedArgs: string[];
+    message?: undefined;
+    parameterCount?: undefined;
+    parameters?: undefined;
+}>;

package/build/tools/getConstructorParams.js

@@ -0,0 +1,38 @@
+import { validateFilePaths, formatContractError, ContractManager, } from '../lib/index.js';
+import { Account, RpcProvider } from 'starknet';
+export const getConstructorParams = async (params) => {
+    try {
+        await validateFilePaths(params.sierraFilePath, params.casmFilePath);
+        const provider = new RpcProvider({
+            nodeUrl: 'https://starknet-mainnet.public.blastapi.io',
+        });
+        const dummyAccount = new Account(provider, '0x1', '0x1');
+        const contractManager = new ContractManager(dummyAccount);
+        await contractManager.loadContractCompilationFiles(params.sierraFilePath, params.casmFilePath);
+        const constructorParams = contractManager.extractConstructorParams();
+        return {
+            status: 'success',
+            classHash: params.classHash,
+            sierraFilePath: params.sierraFilePath,
+            message: 'Constructor parameters retrieved successfully',
+            parameterCount: constructorParams.length,
+            parameters: constructorParams.map((param, index) => ({
+                index,
+                name: param.name,
+                type: param.type,
+            })),
+        };
+    }
+    catch (error) {
+        const errorMessage = formatContractError(error);
+        return {
+            status: 'failure',
+            error: errorMessage,
+            step: 'getting constructor parameters',
+            classHash: params.classHash,
+            sierraFilePath: params.sierraFilePath,
+            providedArgs: params.constructorArgs || [],
+        };
+    }
+};
+//# sourceMappingURL=getConstructorParams.js.map

package/build/tools/getConstructorParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConstructorParams.js","sourceRoot":"","sources":["../../src/tools/getConstructorParams.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAOhD,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,MAAkD,EAClD,EAAE;IACF,IAAI,CAAC;QAEH,MAAM,iBAAiB,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAGpE,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC;YAC/B,OAAO,EAAE,6CAA6C;SACvD,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAEzD,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,YAAY,CAAC,CAAC;QAC1D,MAAM,eAAe,CAAC,4BAA4B,CAChD,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,YAAY,CACpB,CAAC;QAEF,MAAM,iBAAiB,GAAG,eAAe,CAAC,wBAAwB,EAAE,CAAC;QAErE,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,OAAO,EAAE,+CAA+C;YACxD,cAAc,EAAE,iBAAiB,CAAC,MAAM;YACxC,UAAU,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,KAAa,EAAE,EAAE,CAAC,CAAC;gBAChE,KAAK;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,gCAAgC;YACtC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,YAAY,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE;SAC3C,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@kasarlabs/contract-mcp",
+  "version": "0.1.0",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "contract-mcp": "./bin/contract-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": {
+    "@kasarlabs/ask-starknet-core": "0.1.0",
+    "@modelcontextprotocol/sdk": "^1.11.2",
+    "dotenv": "^16.4.7",
+    "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",
+    "contract"
+  ],
+  "author": "kasarlabs",
+  "license": "MIT",
+  "description": "MCP server for Starknet contract operations including declaration and deployment.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "2239ec60f8e369abd318807cecd22fe97c0ab917"
+}