@kasarlabs/starknet-rpc-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,38 @@
+# Snak - RPC Plugin
+
+The RPC Plugin provides tools for interacting directly with the Starknet blockchain via RPC (Remote Procedure Call) methods, enabling access to blockchain data and state.
+
+## Features
+
+This plugin adds the following RPC tools:
+
+- **get_chain_id**: Retrieve the unique identifier (chain ID) of the Starknet network.
+- **get_syncing_status**: Retrieve the syncing status of the Starknet node.
+- **get_class_hash**: Retrieve the unique class hash for a contract at a specific address.
+- **get_spec_version**: Get the current spec version from the Starknet RPC provider.
+- **get_block_with_tx_hashes**: Retrieve block details including transaction hashes.
+- **get_block_with_receipts**: Fetch block details with transaction receipts.
+- **get_transaction_status**: Fetch transaction status by hash.
+- **get_block_number**: Get the current block number from the Starknet network.
+- **get_block_transaction_count**: Get the number of transactions in a specific block.
+- **get_storage_at**: Get the storage value at a specific slot for a contract.
+- **get_class**: Retrieve the complete class definition of a contract.
+- **get_class_at**: Fetch the class definition of a contract at a specific address.
+
+## Usage
+
+The RPC 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 RPC-related tasks, it will use the appropriate tool from this plugin:
+
+```
+"What's the current block number?"  // Uses get_block_number
+"Show me the status of transaction 0x1234..."  // Uses get_transaction_status
+"What's the chain ID of the current network?"  // Uses get_chain_id
+```
+
+## Development
+
+To extend this plugin, add new tools in the `src/tools` directory and register them in the `registerTools` function in `src/tools/index.ts`.

package/bin/starknet-rpc-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,169 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerToolsWithServer, getOnchainRead, } from '@kasarlabs/ask-starknet-core';
+import dotenv from 'dotenv';
+import { getSpecVersion } from './tools/getSpecVersion.js';
+import { getBlockWithTxHashes } from './tools/getBlockWithTxHashes.js';
+import { getBlockWithReceipts } from './tools/getBlockWithReceipts.js';
+import { getTransactionStatus } from './tools/getTransactionStatus.js';
+import { getClass } from './tools/getClass.js';
+import { getChainId } from './tools/getChainId.js';
+import { getSyncingStats } from './tools/getSyncingStats.js';
+import { getBlockNumber } from './tools/getBlockNumber.js';
+import { getBlockTransactionCount } from './tools/getBlockTransactionCount.js';
+import { getStorageAt } from './tools/getStorageAt.js';
+import { getClassAt } from './tools/getClassAt.js';
+import { getClassHashAt } from './tools/getClassHashAt.js';
+import { getStorageAtSchema, blockIdSchema, blockIdAndContractAddressSchema, getClassAtSchema, getClassHashAtSchema, transactionHashSchema, } from './schemas/index.js';
+dotenv.config();
+const server = new McpServer({
+    name: 'starknet-rpc',
+    version: '0.0.1',
+});
+const registerTools = (RpcToolRegistry) => {
+    RpcToolRegistry.push({
+        name: 'get_chain_id',
+        description: 'Retrieve the unique identifier (chain ID) of the Starknet network',
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getChainId(provider);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_syncing_status',
+        description: 'Retrieve the syncing status of the Starknet node',
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getSyncingStats(provider);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_class_hash',
+        description: 'Retrieve the unique class hash for a contract at a specific address',
+        schema: getClassHashAtSchema,
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getClassHashAt(provider, params);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_spec_version',
+        description: 'Get the current spec version from the Starknet RPC provider',
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getSpecVersion(provider);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_block_with_tx_hashes',
+        description: 'Retrieve the details of a block, including transaction hashes',
+        schema: blockIdSchema,
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getBlockWithTxHashes(provider, params);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_block_with_receipts',
+        description: 'Fetch block details with transaction receipts',
+        schema: blockIdSchema,
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getBlockWithReceipts(provider, params);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_transaction_status',
+        description: 'Fetch transaction status by hash',
+        schema: transactionHashSchema,
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getTransactionStatus(provider, params);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_block_number',
+        description: 'Get the current block number from the Starknet network',
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getBlockNumber(provider);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_block_transaction_count',
+        description: 'Get the number of transactions in a specific block',
+        schema: blockIdSchema,
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getBlockTransactionCount(provider, params);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_storage_at',
+        description: 'Get the storage value at a specific slot for a contract',
+        schema: getStorageAtSchema,
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getStorageAt(provider, params);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_class',
+        description: 'Retrieve the complete class definition of a contract at a specified address and block',
+        schema: blockIdAndContractAddressSchema,
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getClass(provider, params);
+        },
+    });
+    RpcToolRegistry.push({
+        name: 'get_class_at',
+        description: 'Fetch the class definition of a contract at a specific address in the latest state',
+        schema: getClassAtSchema,
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            const provider = onchainRead.provider;
+            return await getClassAt(provider, params);
+        },
+    });
+};
+export const RegisterToolInServer = async () => {
+    const tools = [];
+    registerTools(tools);
+    await registerToolsWithServer(server, tools);
+};
+const checkEnv = () => {
+    const rpcUrl = process.env.STARKNET_RPC_URL;
+    if (!rpcUrl) {
+        console.error('Missing required environment variable: STARKNET_RPC_URL');
+        return false;
+    }
+    return true;
+};
+async function main() {
+    const transport = new StdioServerTransport();
+    if (!checkEnv()) {
+        console.error('Failed to initialize RPC Provider');
+        process.exit(1);
+    }
+    await RegisterToolInServer();
+    await server.connect(transport);
+    console.error('Starknet RPC 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":"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"}

package/build/lib/types/index.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/types/index.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=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":"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/schemas/index.d.ts

@@ -0,0 +1,88 @@
+import z from 'zod';
+export declare const contractAddressSchema: z.ZodObject<{
+    contractAddress: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    contractAddress: string;
+}, {
+    contractAddress: string;
+}>;
+export declare const blockIdSchema: z.ZodObject<{
+    blockId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+}, "strip", z.ZodTypeAny, {
+    blockId: string | number;
+}, {
+    blockId: string | number;
+}>;
+export declare const blockIdAndContractAddressSchema: z.ZodObject<{
+    blockId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    classHash: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    classHash: string;
+    blockId: string | number;
+}, {
+    classHash: string;
+    blockId: string | number;
+}>;
+export declare const getStorageAtSchema: z.ZodObject<{
+    blockId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    contractAddress: z.ZodString;
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    blockId: string | number;
+    contractAddress: string;
+}, {
+    key: string;
+    blockId: string | number;
+    contractAddress: string;
+}>;
+export declare const getClassAtSchema: z.ZodObject<{
+    blockId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    contractAddress: z.ZodString;
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    blockId: string | number;
+    contractAddress: string;
+}, {
+    key: string;
+    blockId: string | number;
+    contractAddress: string;
+}>;
+export declare const getClassHashAtSchema: z.ZodObject<{
+    blockId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    contractAddress: z.ZodString;
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    blockId: string | number;
+    contractAddress: string;
+}, {
+    key: string;
+    blockId: string | number;
+    contractAddress: string;
+}>;
+export declare const getTransactionByBlockIdAndIndexSchema: z.ZodObject<{
+    blockId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    transactionIndex: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    blockId: string | number;
+    transactionIndex: number;
+}, {
+    blockId: string | number;
+    transactionIndex: number;
+}>;
+export declare const transactionHashSchema: z.ZodObject<{
+    transactionHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    transactionHash: string;
+}, {
+    transactionHash: string;
+}>;
+export type GetStorageParams = z.infer<typeof getStorageAtSchema>;
+export type GetClassAtParams = z.infer<typeof getClassAtSchema>;
+export type BlockIdParams = z.infer<typeof blockIdSchema>;
+export type BlockIdAndContractAddressParams = z.infer<typeof blockIdAndContractAddressSchema>;
+export type GetTransactionByBlockIdAndIndexParams = z.infer<typeof getTransactionByBlockIdAndIndexSchema>;
+export type ContractAddressParams = z.infer<typeof contractAddressSchema>;
+export type TransactionHashParams = z.infer<typeof transactionHashSchema>;

package/build/schemas/index.js

@@ -0,0 +1,78 @@
+import z from 'zod';
+export const contractAddressSchema = z.object({
+    contractAddress: z.string().describe('The address of the contract'),
+});
+export const blockIdSchema = z.object({
+    blockId: z.union([
+        z
+            .string()
+            .describe("The block identifier. Can be 'latest', 'pending', or a block hash."),
+        z.number().describe('A block number.'),
+    ]),
+});
+export const blockIdAndContractAddressSchema = z
+    .object({
+    blockId: z.union([
+        z
+            .string()
+            .describe("The block identifier. Can be 'latest', 'pending', or a block hash."),
+        z.number().describe('A block number.'),
+    ]),
+    classHash: z.string().describe('The class hash of the contract'),
+})
+    .strict();
+export const getStorageAtSchema = z.object({
+    blockId: z.union([
+        z
+            .string()
+            .describe("The block identifier. Can be 'latest', 'pending', or a block hash."),
+        z.number().describe('A block number.'),
+    ]),
+    contractAddress: z.string().describe('The address of the contract'),
+    key: z
+        .string()
+        .describe('The key to the storage value for the given contract'),
+});
+export const getClassAtSchema = z.object({
+    blockId: z.union([
+        z
+            .string()
+            .describe("The block identifier. Can be 'latest', 'pending', or a block hash."),
+        z.number().describe('A block number.'),
+    ]),
+    contractAddress: z.string().describe('The address of the contract'),
+    key: z
+        .string()
+        .describe('The class for the given contract at the given block'),
+});
+export const getClassHashAtSchema = z.object({
+    blockId: z.union([
+        z
+            .string()
+            .describe("The block identifier. Can be 'latest', 'pending', or a block hash."),
+        z.number().describe('A block number.'),
+    ]),
+    contractAddress: z.string().describe('The address of the contract'),
+    key: z
+        .string()
+        .describe('The class hash for the given contract at the given block need to be a real class hash'),
+});
+export const getTransactionByBlockIdAndIndexSchema = z.object({
+    blockId: z.union([
+        z
+            .string()
+            .describe("The block identifier. Can be 'latest', 'pending', or a block hash."),
+        z.number().describe('A block number.'),
+    ]),
+    transactionIndex: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe('The index of the transaction within the block.'),
+});
+export const transactionHashSchema = z.object({
+    transactionHash: z
+        .string()
+        .describe('The hash of the requested transaction.'),
+});
+//# 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":"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"}

package/build/tools/getBlockLatestAccepted.d.ts

@@ -0,0 +1,10 @@
+import { RpcProvider } from 'starknet';
+export declare const getBlockLatestAccepted: (provider: RpcProvider) => Promise<{
+    status: string;
+    blockHashAndNumber: any;
+    error?: undefined;
+} | {
+    status: string;
+    error: string;
+    blockHashAndNumber?: undefined;
+}>;

package/build/tools/getBlockLatestAccepted.js

@@ -0,0 +1,16 @@
+export const getBlockLatestAccepted = async (provider) => {
+    try {
+        const blockHashAndNumber = await provider.getBlockLatestAccepted();
+        return {
+            status: 'success',
+            blockHashAndNumber: blockHashAndNumber,
+        };
+    }
+    catch (error) {
+        return {
+            status: 'failure',
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+};
+//# sourceMappingURL=getBlockLatestAccepted.js.map

package/build/tools/getBlockLatestAccepted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBlockLatestAccepted.js","sourceRoot":"","sources":["../../src/tools/getBlockLatestAccepted.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,QAAqB,EAAE,EAAE;IACpE,IAAI,CAAC;QACH,MAAM,kBAAkB,GAAG,MAAM,QAAQ,CAAC,sBAAsB,EAAE,CAAC;QAEnE,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,kBAAkB,EAAE,kBAAyB;SAC9C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/build/tools/getBlockNumber.d.ts

@@ -0,0 +1,10 @@
+import { RpcProvider } from 'starknet';
+export declare const getBlockNumber: (provider: RpcProvider) => Promise<{
+    status: string;
+    blockNumber: number;
+    error?: undefined;
+} | {
+    status: string;
+    error: string;
+    blockNumber?: undefined;
+}>;

package/build/tools/getBlockNumber.js

@@ -0,0 +1,16 @@
+export const getBlockNumber = async (provider) => {
+    try {
+        const blockNumber = await provider.getBlockNumber();
+        return {
+            status: 'success',
+            blockNumber,
+        };
+    }
+    catch (error) {
+        return {
+            status: 'failure',
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+};
+//# sourceMappingURL=getBlockNumber.js.map

package/build/tools/getBlockNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBlockNumber.js","sourceRoot":"","sources":["../../src/tools/getBlockNumber.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,QAAqB,EAAE,EAAE;IAC5D,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,CAAC;QAEpD,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,WAAW;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/build/tools/getBlockStateUpdate.d.ts

@@ -0,0 +1,12 @@
+import { RpcProvider } from 'starknet';
+export declare const getBlockStateUpdate: (provider: RpcProvider, params: {
+    blockId: string;
+}) => Promise<{
+    status: string;
+    blockStateUpdate: import("starknet").StateUpdateResponse;
+    error?: undefined;
+} | {
+    status: string;
+    error: string;
+    blockStateUpdate?: undefined;
+}>;