@kasarlabs/argent-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,110 @@
+# Snak - ArgentX Plugin
+
+A collection of Starknet tools for creating and deploying Argent accounts through the Kasarlabs ecosystem.
+
+## Overview
+
+This package provides Starknet tools that allow developers to easily create and deploy Argent accounts on the Starknet network. These tools integrate with the Kasarlabs core framework to streamline account management operations.
+
+## Features
+
+- Create new Argent accounts
+- Deploy existing Argent accounts
+- Manage account details securely
+
+## Installation
+
+```bash
+npm install @snakagent/argent-plugins
+```
+
+## Usage
+
+### Registering the Tools
+
+Import and register the Argent tools in your application:
+
+```javascript
+import { registerTools } from '@snakagent/argent-plugins';
+import { StarknetTool, SnakAgentInterface } from '@snakagent/core';
+
+// Initialize your tools registry
+const StarknetToolRegistry = [];
+
+// Optional: Your agent implementation
+const agent = yourSnakAgent;
+
+// Register the Argent tools
+registerTools(StarknetToolRegistry, agent);
+```
+
+### Creating a New Argent Account
+
+Once registered, you can use the tools to create a new Argent account:
+
+```javascript
+// Assuming you have an agent instance
+const result = await agent.execute('create_new_argent_account');
+
+console.log('New Argent Account:', result);
+// Output will include privateKey, publicKey, and contractAddress
+```
+
+### Deploying an Existing Argent Account
+
+To deploy an existing account:
+
+```javascript
+const accountDetails = {
+  privateKey: 'your_private_key',
+  // Other required account details according to accountDetailsSchema
+};
+
+const deploymentResult = await agent.execute(
+  'deploy_existing_argent_account',
+  accountDetails
+);
+
+console.log('Deployed Account:', deploymentResult);
+```
+
+## Tool Descriptions
+
+### create_new_argent_account
+
+Creates a new Argent account and returns essential account information.
+
+- **Name**: `create_new_argent_account`
+- **Description**: Creates a new Argent account and returns the privateKey/publicKey/contractAddress
+- **Plugin**: `argent`
+- **Parameters**: None
+- **Returns**: Object containing account information (wrapped by `wrapAccountCreationResponse`)
+
+### deploy_existing_argent_account
+
+Deploys an existing Argent account using provided account details.
+
+- **Name**: `deploy_existing_argent_account`
+- **Description**: Deploy an existing Argent Account and return the privateKey/publicKey/contractAddress
+- **Plugin**: `argent`
+- **Schema**: Uses `accountDetailsSchema` for validation
+- **Parameters**: Account details according to the schema
+- **Returns**: Deployment information including account details
+
+## Schema Information
+
+The package uses `accountDetailsSchema` to validate account details for deployment. Refer to the schema documentation for the exact format and required fields.
+
+## Dependencies
+
+- `@snakagent/core`: Core framework for Starknet tools and agent interfaces
+- Account management utilities from '../utils/AccountManager.js'
+- Account creation and deployment actions
+
+## License
+
+MIT License - see the LICENSE file for details.
+
+---
+
+For detailed documentation visit [docs.kasar.io](https://docs.kasar.io)

package/bin/argent-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../build/index.js').catch(console.error);

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,48 @@
+#!/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 { CreateArgentAccount } from './tools/createAccount.js';
+import { DeployArgentAccount } from './tools/deployAccount.js';
+import { accountDetailsSchema } from './schemas/schema.js';
+import { registerToolsWithServer, getOnchainRead, } from '@kasarlabs/ask-starknet-core';
+dotenv.config();
+const server = new McpServer({
+    name: 'starknet-argent-mcp',
+    version: '0.0.1',
+});
+const registerTools = (ArgentToolRegistry) => {
+    ArgentToolRegistry.push({
+        name: 'create_new_argent_account',
+        description: 'Creates a new Argent account and return the privateKey/publicKey/contractAddress',
+        execute: async () => {
+            const onchainRead = getOnchainRead();
+            return await CreateArgentAccount(onchainRead);
+        },
+    });
+    ArgentToolRegistry.push({
+        name: 'deploy_existing_argent_account',
+        description: 'Deploy an existing Argent Account return the privateKey/publicKey/contractAddress',
+        schema: accountDetailsSchema,
+        execute: async (params) => {
+            const onchainRead = getOnchainRead();
+            return await DeployArgentAccount(onchainRead, params);
+        },
+    });
+};
+export const RegisterToolInServer = async () => {
+    const tools = [];
+    registerTools(tools);
+    await registerToolsWithServer(server, tools);
+};
+async function main() {
+    const transport = new StdioServerTransport();
+    await RegisterToolInServer();
+    await server.connect(transport);
+    console.error('Starknet Argent 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,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAEL,uBAAuB,EACvB,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,kBAA6B,EAAE,EAAE;IACtD,kBAAkB,CAAC,IAAI,CAAC;QACtB,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,kFAAkF;QACpF,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;YACrC,OAAO,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC;KACF,CAAC,CAAC;IAEH,kBAAkB,CAAC,IAAI,CAAC;QACtB,IAAI,EAAE,gCAAgC;QACtC,WAAW,EACT,mFAAmF;QACrF,MAAM,EAAE,oBAAoB;QAC5B,OAAO,EAAE,KAAK,EAAE,MAAW,EAAE,EAAE;YAC7B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;YACrC,OAAO,MAAM,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;KACF,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,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,oBAAoB,EAAE,CAAC;IAC7B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;AAC/D,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/interfaces/index.d.ts

@@ -0,0 +1 @@
+export {};

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/lib/abis/argentAbi.d.ts

@@ -0,0 +1,92 @@
+export declare const ARGENT_ACCOUNT_ABI: ({
+    type: string;
+    name: string;
+    interface_name: string;
+    members?: undefined;
+    items?: undefined;
+    variants?: undefined;
+    inputs?: undefined;
+    kind?: undefined;
+} | {
+    type: string;
+    name: string;
+    members: {
+        name: string;
+        type: string;
+    }[];
+    interface_name?: undefined;
+    items?: undefined;
+    variants?: undefined;
+    inputs?: undefined;
+    kind?: undefined;
+} | {
+    type: string;
+    name: string;
+    items: {
+        type: string;
+        name: string;
+        inputs: {
+            name: string;
+            type: string;
+        }[];
+        outputs: {
+            type: string;
+        }[];
+        state_mutability: string;
+    }[];
+    interface_name?: undefined;
+    members?: undefined;
+    variants?: undefined;
+    inputs?: undefined;
+    kind?: undefined;
+} | {
+    type: string;
+    name: string;
+    variants: {
+        name: string;
+        type: string;
+    }[];
+    interface_name?: undefined;
+    members?: undefined;
+    items?: undefined;
+    inputs?: undefined;
+    kind?: undefined;
+} | {
+    type: string;
+    name: string;
+    inputs: {
+        name: string;
+        type: string;
+    }[];
+    interface_name?: undefined;
+    members?: undefined;
+    items?: undefined;
+    variants?: undefined;
+    kind?: undefined;
+} | {
+    type: string;
+    name: string;
+    kind: string;
+    members: {
+        name: string;
+        type: string;
+        kind: string;
+    }[];
+    interface_name?: undefined;
+    items?: undefined;
+    variants?: undefined;
+    inputs?: undefined;
+} | {
+    type: string;
+    name: string;
+    kind: string;
+    variants: {
+        name: string;
+        type: string;
+        kind: string;
+    }[];
+    interface_name?: undefined;
+    members?: undefined;
+    items?: undefined;
+    inputs?: undefined;
+})[];