@kasarlabs/ask-starknet-core 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/build/index.d.ts

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

package/build/index.js

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

package/build/index.js.map

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

package/build/interfaces/index.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { Account, RpcProvider } from 'starknet';
+export interface mcpTool {
+    name: string;
+    description: string;
+    schema?: z.ZodObject<any>;
+    execute: (params: any) => Promise<any>;
+}
+export interface onchainRead {
+    provider: RpcProvider;
+}
+export interface onchainWrite {
+    provider: RpcProvider;
+    account: Account;
+}

package/build/interfaces/index.js

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

package/build/interfaces/index.js.map

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

package/build/utils/index.d.ts

@@ -0,0 +1,4 @@
+import { mcpTool, onchainRead, onchainWrite } from '../interfaces/index.js';
+export declare const registerToolsWithServer: (server: any, tools: mcpTool[]) => Promise<void>;
+export declare const getOnchainRead: () => onchainRead;
+export declare const getOnchainWrite: () => onchainWrite;

package/build/utils/index.js

@@ -0,0 +1,54 @@
+import { Account, RpcProvider } from 'starknet';
+export const registerToolsWithServer = async (server, tools) => {
+    for (const tool of tools) {
+        if (!tool.schema) {
+            server.tool(tool.name, tool.description, async () => {
+                const result = await tool.execute({});
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result),
+                        },
+                    ],
+                };
+            });
+        }
+        else {
+            server.tool(tool.name, tool.description, tool.schema.shape, async (params, extra) => {
+                const result = await tool.execute(params);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result),
+                        },
+                    ],
+                };
+            });
+        }
+    }
+};
+export const getOnchainRead = () => {
+    if (!process.env.STARKNET_RPC_URL) {
+        throw new Error('Missing required environment variables: STARKNET_RPC_URL');
+    }
+    return {
+        provider: new RpcProvider({ nodeUrl: process.env.STARKNET_RPC_URL }),
+    };
+};
+export const getOnchainWrite = () => {
+    const rpcUrl = process.env.STARKNET_RPC_URL;
+    const privateKey = process.env.STARKNET_PRIVATE_KEY;
+    const accountAddress = process.env.STARKNET_ACCOUNT_ADDRESS;
+    if (!rpcUrl || !privateKey || !accountAddress) {
+        throw new Error('Missing required environment variables: STARKNET_RPC_URL, STARKNET_PRIVATE_KEY, STARKNET_ACCOUNT_ADDRESS');
+    }
+    const provider = new RpcProvider({ nodeUrl: rpcUrl });
+    const account = new Account(provider, accountAddress, privateKey);
+    return {
+        provider,
+        account,
+    };
+};
+//# sourceMappingURL=index.js.map

package/build/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAa,MAAM,UAAU,CAAC;AAO3D,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,MAAW,EACX,KAAgB,EACD,EAAE;IACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;gBAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACtC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;yBAC7B;qBACF;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,CAAC,KAAK,EACjB,KAAK,EAAE,MAAW,EAAE,KAAU,EAAE,EAAE;gBAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC1C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;yBAC7B;qBACF;iBACF,CAAC;YACJ,CAAC,CACF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAgB,EAAE;IAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,IAAI,WAAW,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,GAAiB,EAAE;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACpD,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAE5D,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;IAElE,OAAO;QACL,QAAQ;QACR,OAAO;KACR,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@kasarlabs/ask-starknet-core",
+  "version": "0.1.0",
+  "description": "Core utilities and shared functionality for the Ask Starknet MCP ecosystem",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf build",
+    "clean:all": "rm -rf build node_modules",
+    "dev": "tsc --watch",
+    "test": "jest"
+  },
+  "files": [
+    "build"
+  ],
+  "keywords": [
+    "starknet",
+    "mcp",
+    "core",
+    "utilities"
+  ],
+  "author": "kasarlabs",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "starknet": "^7.6.4",
+    "winston": "^3.17.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.0.0",
+    "@types/node": "^22.13.10",
+    "jest": "^29.0.0",
+    "typescript": "^5.8.2"
+  },
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "gitHead": "2239ec60f8e369abd318807cecd22fe97c0ab917"
+}