@conquest-eth/tools 0.0.0

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Implementation } from '@modelcontextprotocol/sdk/types.js';
+import { Chain } from 'viem';
+import { ServerOptions } from '@modelcontextprotocol/sdk/server';
+/**
+ * Create and configure an MCP server for Conquest.eth game interactions
+ *
+ * @param params - Configuration parameters for the server
+ * @param params.chain - The blockchain chain to connect to
+ * @param params.privateKey - Optional private key for signing transactions (wallet operations)
+ * @param params.gameContract - The game contract address
+ * @param options - Optional server configuration
+ * @param options.ethereum - Whether to include Ethereum MCP tools (default: false)
+ * @param options.rpcURL - Optional custom RPC URL
+ * @param options.serverOptions - Optional MCP server options
+ * @param options.serverInfo - Optional server metadata to override defaults
+ * @param options.storageConfig - Storage configuration for fleets and exits
+ * @param options.storageConfig.type - Storage type ('json' or 'sqlite')
+ * @param options.storageConfig.dataDir - Optional data directory path
+ * @returns Configured MCP server instance with Conquest game tools registered
+ */
+export declare function createServer(params: {
+    chain: Chain;
+    privateKey?: `0x${string}`;
+    gameContract: `0x${string}`;
+}, options?: {
+    ethereum?: boolean;
+    rpcURL?: string;
+    serverOptions?: ServerOptions;
+    serverInfo?: Implementation;
+    storageConfig?: {
+        type: 'json' | 'sqlite';
+        dataDir?: string;
+    };
+}): McpServer;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAElE,OAAO,EAAC,cAAc,EAAC,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAC,KAAK,EAAC,MAAM,MAAM,CAAC;AAC3B,OAAO,EAAC,aAAa,EAAC,MAAM,kCAAkC,CAAC;AAe/D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAC3B,MAAM,EAAE;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,KAAK,MAAM,EAAE,CAAA;CAAC,EAC/E,OAAO,CAAC,EAAE;IACT,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,aAAa,CAAC,EAAE;QAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;CAC5D,aAwID"}

package/dist/index.js

@@ -0,0 +1,143 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import pkg from '../package.json' with { type: 'json' };
+import { createServer as createMCPEthereumServer } from 'tools-ethereum';
+import { getClients } from 'tools-ethereum/helpers';
+import { createSpaceInfo } from './contracts/space-info.js';
+import { JsonFleetStorage } from './storage/json-storage.js';
+import { FleetManager } from './fleet/manager.js';
+import { PlanetManager } from './planet/manager.js';
+// Import refactored tools
+import * as tools from './tools/index.js';
+import { stringifyWithBigInt } from './helpers/index.js';
+import { Abi_IOuterSpace } from 'conquest-eth-v0-contracts/abis/IOuterSpace.js';
+/**
+ * Create and configure an MCP server for Conquest.eth game interactions
+ *
+ * @param params - Configuration parameters for the server
+ * @param params.chain - The blockchain chain to connect to
+ * @param params.privateKey - Optional private key for signing transactions (wallet operations)
+ * @param params.gameContract - The game contract address
+ * @param options - Optional server configuration
+ * @param options.ethereum - Whether to include Ethereum MCP tools (default: false)
+ * @param options.rpcURL - Optional custom RPC URL
+ * @param options.serverOptions - Optional MCP server options
+ * @param options.serverInfo - Optional server metadata to override defaults
+ * @param options.storageConfig - Storage configuration for fleets and exits
+ * @param options.storageConfig.type - Storage type ('json' or 'sqlite')
+ * @param options.storageConfig.dataDir - Optional data directory path
+ * @returns Configured MCP server instance with Conquest game tools registered
+ */
+export function createServer(params, options) {
+    const { gameContract: gameContractAddress, ...mcpEthereumParams } = params;
+    const clients = getClients(params, options);
+    const gameContract = {
+        address: gameContractAddress,
+        abi: Abi_IOuterSpace,
+    };
+    const name = `mcp-conquest-eth-v0`;
+    const server = options?.ethereum
+        ? createMCPEthereumServer(mcpEthereumParams, {
+            ...options,
+            serverInfo: { name, version: pkg.version, ...options?.serverInfo },
+        })
+        : new McpServer(options?.serverInfo || {
+            name,
+            version: pkg.version,
+        }, options?.serverOptions || { capabilities: { logging: {} } });
+    // Initialize SpaceInfo and contractConfig
+    let spaceInfo = null;
+    let contractConfig = null;
+    const initSpaceInfo = async () => {
+        if (!spaceInfo || !contractConfig) {
+            const result = await createSpaceInfo(clients, gameContract);
+            spaceInfo = result.spaceInfo;
+            contractConfig = result.contractConfig;
+        }
+        return { spaceInfo, contractConfig };
+    };
+    // Initialize storage
+    const storageConfig = options?.storageConfig || { type: 'json', dataDir: './data' };
+    const storage = new JsonFleetStorage(storageConfig.dataDir || './data');
+    // Initialize managers (will be initialized after spaceInfo is ready)
+    let fleetManager = null;
+    let planetManager = null;
+    // Helper to ensure managers are initialized
+    const ensureManagersInitialized = async () => {
+        const { spaceInfo: si, contractConfig: cc } = await initSpaceInfo();
+        // Initialize fleetManager even without walletClient for read-only operations
+        if (!fleetManager && si && cc) {
+            fleetManager = new FleetManager(clients, gameContract, si, cc, storage);
+        }
+        // Initialize planetManager even without walletClient for read-only operations
+        if (!planetManager && si && cc) {
+            planetManager = new PlanetManager(clients, gameContract, si, cc, storage);
+        }
+        if (!fleetManager) {
+            throw new Error('Fleet manager not initialized');
+        }
+        if (!planetManager) {
+            throw new Error('Planet manager not initialized');
+        }
+        return { fleetManager, planetManager };
+    };
+    // Auto-register all tools
+    for (const [name, tool] of Object.entries(tools)) {
+        // Skip the file that's not a tool
+        if (name === 'default')
+            continue;
+        server.registerTool(name, {
+            description: tool.description,
+            inputSchema: tool.schema,
+        }, async (args) => {
+            try {
+                const { fleetManager, planetManager } = await ensureManagersInitialized();
+                const env = {
+                    sendStatus: async (_message) => {
+                        // TODO: Implement progress notifications when sessionId is available
+                    },
+                    fleetManager,
+                    planetManager,
+                };
+                const result = await tool.execute(env, args);
+                // Convert ToolResult to CallToolResult
+                if (result.success === false) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: stringifyWithBigInt({
+                                    error: result.error,
+                                    ...(result.stack ? { stack: result.stack } : {}),
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: stringifyWithBigInt(result.result, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: stringifyWithBigInt({
+                                error: error instanceof Error ? error.message : String(error),
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    return server;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/planet/acquire.d.ts

@@ -0,0 +1,16 @@
+import { Clients, GameContract } from '../types.js';
+/**
+ * Acquire (stake) multiple planets
+ *
+ * @param clients - Viem clients (publicClient and walletClient)
+ * @param gameContract - The game contract instance with address and ABI
+ * @param planetIds - Array of planet location IDs to acquire
+ * @param amountToMint - Amount of native token to spend
+ * @param tokenAmount - Amount of staking token to spend
+ * @returns Transaction hash and list of planets acquired
+ */
+export declare function acquirePlanets(clients: Clients, gameContract: GameContract, planetIds: bigint[], amountToMint: bigint, tokenAmount: bigint): Promise<{
+    hash: `0x${string}`;
+    planetsAcquired: bigint[];
+}>;
+//# sourceMappingURL=acquire.d.ts.map

package/dist/planet/acquire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquire.d.ts","sourceRoot":"","sources":["../../src/planet/acquire.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AAElD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EAAE,EACnB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC;IAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAsB3D"}

package/dist/planet/acquire.js

@@ -0,0 +1,27 @@
+/**
+ * Acquire (stake) multiple planets
+ *
+ * @param clients - Viem clients (publicClient and walletClient)
+ * @param gameContract - The game contract instance with address and ABI
+ * @param planetIds - Array of planet location IDs to acquire
+ * @param amountToMint - Amount of native token to spend
+ * @param tokenAmount - Amount of staking token to spend
+ * @returns Transaction hash and list of planets acquired
+ */
+export async function acquirePlanets(clients, gameContract, planetIds, amountToMint, tokenAmount) {
+    const sender = clients.walletClient.account.address;
+    const nativeTokenAmount = (amountToMint * 1000000000000000000n) / 1000000000000000000000n; // TODO BigInt((PlayToken.linkedData as any).numTokensPerNativeTokenAt18Decimals);
+    console.log(`Acquiring ${planetIds.length} planets with ${amountToMint} native tokens and ${tokenAmount} staking tokens using ${nativeTokenAmount} native tokens`);
+    // Get the contract acquireMultipleViaNativeTokenAndStakingToken function signature
+    const simulation = await clients.publicClient.simulateContract({
+        ...gameContract,
+        functionName: 'acquireMultipleViaNativeTokenAndStakingToken',
+        args: [planetIds, amountToMint, tokenAmount],
+        account: sender,
+        value: nativeTokenAmount,
+    });
+    // Send the transaction
+    const hash = await clients.walletClient.writeContract(simulation.request);
+    return { hash, planetsAcquired: planetIds };
+}
+//# sourceMappingURL=acquire.js.map

package/dist/planet/acquire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquire.js","sourceRoot":"","sources":["../../src/planet/acquire.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAAgB,EAChB,YAA0B,EAC1B,SAAmB,EACnB,YAAoB,EACpB,WAAmB;IAEnB,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,OAAQ,CAAC,OAAO,CAAC;IAErD,MAAM,iBAAiB,GAAG,CAAC,YAAY,GAAG,oBAAoB,CAAC,GAAG,uBAAuB,CAAC,CAAC,kFAAkF;IAE7K,OAAO,CAAC,GAAG,CACV,aAAa,SAAS,CAAC,MAAM,iBAAiB,YAAY,sBAAsB,WAAW,yBAAyB,iBAAiB,gBAAgB,CACrJ,CAAC;IAEF,mFAAmF;IACnF,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC;QAC9D,GAAG,YAAY;QACf,YAAY,EAAE,8CAA8C;QAC5D,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC;QAC5C,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,iBAAiB;KACxB,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAE1E,OAAO,EAAC,IAAI,EAAE,eAAe,EAAE,SAAS,EAAC,CAAC;AAC3C,CAAC"}

package/dist/planet/exit.d.ts

@@ -0,0 +1,17 @@
+import type { FleetStorage } from '../storage/interface.js';
+import { Clients, GameContract } from '../types.js';
+/**
+ * Exit (unstake) multiple planets to retrieve staked tokens
+ *
+ * @param clients - Viem clients (publicClient and walletClient)
+ * @param gameContract - The game contract instance with address and ABI
+ * @param planetIds - Array of planet location IDs to exit
+ * @param exitDuration - Duration of the exit process in seconds (from contract config)
+ * @param storage - Storage instance for tracking pending exits
+ * @returns Transaction hash and list of planet IDs for which exits were initiated
+ */
+export declare function exitPlanets(clients: Clients, gameContract: GameContract, planetIds: bigint[], exitDuration: bigint, storage: FleetStorage): Promise<{
+    hash: `0x${string}`;
+    exitsInitiated: bigint[];
+}>;
+//# sourceMappingURL=exit.d.ts.map

package/dist/planet/exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.d.ts","sourceRoot":"","sources":["../../src/planet/exit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAC,OAAO,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAE/D;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAChC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EAAE,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC;IAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAkD1D"}

package/dist/planet/exit.js

@@ -0,0 +1,56 @@
+import { getCurrentTimestamp } from '../util/time.js';
+/**
+ * Exit (unstake) multiple planets to retrieve staked tokens
+ *
+ * @param clients - Viem clients (publicClient and walletClient)
+ * @param gameContract - The game contract instance with address and ABI
+ * @param planetIds - Array of planet location IDs to exit
+ * @param exitDuration - Duration of the exit process in seconds (from contract config)
+ * @param storage - Storage instance for tracking pending exits
+ * @returns Transaction hash and list of planet IDs for which exits were initiated
+ */
+export async function exitPlanets(clients, gameContract, planetIds, exitDuration, storage) {
+    const sender = clients.walletClient.account.address;
+    const currentTime = getCurrentTimestamp();
+    // Get planet states to verify ownership
+    const result = await clients.publicClient.readContract({
+        ...gameContract,
+        functionName: 'getPlanetStates',
+        args: [planetIds],
+    });
+    const states = result[0];
+    // Create pending exit records for each planet
+    const exitsInitiated = [];
+    for (let i = 0; i < planetIds.length; i++) {
+        const planetId = planetIds[i];
+        const state = states[i];
+        // Only create exit record for planets owned by the sender
+        if (state.owner && state.owner.toLowerCase() === sender.toLowerCase()) {
+            const exit = {
+                planetId,
+                player: sender,
+                exitStartTime: currentTime,
+                exitDuration: Number(exitDuration),
+                exitCompleteTime: currentTime + Number(exitDuration),
+                numSpaceships: state.numSpaceships,
+                owner: state.owner,
+                completed: false,
+                interrupted: false,
+                lastCheckedAt: currentTime,
+            };
+            await storage.savePendingExit(exit);
+            exitsInitiated.push(planetId);
+        }
+    }
+    // Get the contract exitMultipleFor function signature
+    const simulation = await clients.publicClient.simulateContract({
+        ...gameContract,
+        functionName: 'exitMultipleFor',
+        args: [sender, planetIds],
+        account: sender,
+    });
+    // Send the transaction
+    const hash = await clients.walletClient.writeContract(simulation.request);
+    return { hash, exitsInitiated };
+}
+//# sourceMappingURL=exit.js.map

package/dist/planet/exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../src/planet/exit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,iBAAiB,CAAC;AAIpD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,OAAgB,EAChB,YAA0B,EAC1B,SAAmB,EACnB,YAAoB,EACpB,OAAqB;IAErB,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,OAAQ,CAAC,OAAO,CAAC;IACrD,MAAM,WAAW,GAAG,mBAAmB,EAAE,CAAC;IAE1C,wCAAwC;IACxC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;QACtD,GAAG,YAAY;QACf,YAAY,EAAE,iBAAiB;QAC/B,IAAI,EAAE,CAAC,SAAS,CAAC;KACjB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAEzB,8CAA8C;IAC9C,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAExB,0DAA0D;QAC1D,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;YACvE,MAAM,IAAI,GAAgB;gBACzB,QAAQ;gBACR,MAAM,EAAE,MAAM;gBACd,aAAa,EAAE,WAAW;gBAC1B,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC;gBAClC,gBAAgB,EAAE,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC;gBACpD,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,SAAS,EAAE,KAAK;gBAChB,WAAW,EAAE,KAAK;gBAClB,aAAa,EAAE,WAAW;aAC1B,CAAC;YAEF,MAAM,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACpC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;IACF,CAAC;IAED,sDAAsD;IACtD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC;QAC9D,GAAG,YAAY;QACf,YAAY,EAAE,iBAAiB;QAC/B,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QACzB,OAAO,EAAE,MAAM;KACf,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAE1E,OAAO,EAAC,IAAI,EAAE,cAAc,EAAC,CAAC;AAC/B,CAAC"}

package/dist/planet/index.d.ts

@@ -0,0 +1,4 @@
+export { PlanetManager } from './manager.js';
+export { acquirePlanets } from './acquire.js';
+export { exitPlanets } from './exit.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/planet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planet/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,aAAa,EAAC,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAC,WAAW,EAAC,MAAM,WAAW,CAAC"}

package/dist/planet/index.js

@@ -0,0 +1,6 @@
+// Planet Manager and exports
+export { PlanetManager } from './manager.js';
+// Planet operations
+export { acquirePlanets } from './acquire.js';
+export { exitPlanets } from './exit.js';
+//# sourceMappingURL=index.js.map

package/dist/planet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/planet/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAC,aAAa,EAAC,MAAM,cAAc,CAAC;AAE3C,oBAAoB;AACpB,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAC,WAAW,EAAC,MAAM,WAAW,CAAC"}

package/dist/planet/manager.d.ts

@@ -0,0 +1,106 @@
+import { type Address } from 'viem';
+import type { SpaceInfo } from 'conquest-eth-v0-contracts';
+import type { PlanetInfo, PlanetState } from 'conquest-eth-v0-contracts';
+import type { FleetStorage } from '../storage/interface.js';
+import type { ClientsWithOptionalWallet, ContractConfig, ExternalPlanet, GameContract, PendingExit } from '../types.js';
+/**
+ * PlanetManager manages planet-related operations in the Conquest game
+ * including acquiring new planets and initiating exit processes
+ */
+export declare class PlanetManager {
+    private readonly clients;
+    private readonly gameContract;
+    private readonly spaceInfo;
+    private readonly contractConfig;
+    private readonly storage;
+    constructor(clients: ClientsWithOptionalWallet, gameContract: GameContract, spaceInfo: SpaceInfo, contractConfig: ContractConfig, storage: FleetStorage);
+    /**
+     * Ensure walletClient is available for operations that require it
+     */
+    private requireWalletClient;
+    /**
+     * Acquire (stake) multiple planets
+     */
+    acquire(planetIds: bigint[], amountToMint: bigint, tokenAmount: bigint): Promise<{
+        hash: `0x${string}`;
+        planetsAcquired: bigint[];
+    }>;
+    /**
+     * Acquire (stake) multiple planets with automatic cost calculation
+     */
+    acquireWithAutoCalc(planetIds: bigint[]): Promise<{
+        hash: `0x${string}`;
+        planetsAcquired: bigint[];
+        costs: {
+            amountToMint: bigint;
+            tokenAmount: bigint;
+        };
+    }>;
+    /**
+     * Calculate acquisition costs for planets based on their stats
+     *
+     * @param planetIds - Array of planet location IDs
+     * @returns Object with total amountToMint and tokenAmount
+     */
+    calculateAcquisitionCosts(planetIds: bigint[]): {
+        amountToMint: bigint;
+        tokenAmount: bigint;
+    };
+    /**
+     * Exit (unstake) multiple planets
+     */
+    exit(planetIds: bigint[]): Promise<{
+        hash: `0x${string}`;
+        exitsInitiated: bigint[];
+    }>;
+    /**
+     * Get planet info by location ID
+     */
+    getPlanetInfo(planetId: bigint): PlanetInfo | undefined;
+    /**
+     * Get planet ID by x,y coordinates
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @returns Planet location ID as bigint, or undefined if no planet exists at coordinates
+     */
+    getPlanetIdByCoordinates(x: number, y: number): bigint | undefined;
+    /**
+     * Get multiple planet infos
+     */
+    getPlanetInfos(planetIds: bigint[]): (PlanetInfo | undefined)[];
+    /**
+     * Get planets around a center point within a radius
+     */
+    getPlanetsAround(centerX: number, centerY: number, radius: number): Promise<{
+        info: PlanetInfo;
+        state: PlanetState;
+    }[]>;
+    /**
+     * Get my planets (owned by the current wallet)
+     */
+    getMyPlanets(radius?: number): Promise<Array<{
+        info: PlanetInfo;
+        state: ExternalPlanet;
+    }>>;
+    /**
+     * Get pending exits for the current player
+     */
+    getMyPendingExits(): Promise<PendingExit[]>;
+    /**
+     * Verify exit status for a planet
+     */
+    verifyExitStatus(planetId: bigint): Promise<{
+        exit: PendingExit;
+        interrupted: boolean;
+        newOwner?: Address;
+    }>;
+    /**
+     * Clean up old completed exits
+     */
+    cleanupOldCompletedExits(olderThanDays?: number): Promise<void>;
+    /**
+     * Calculate distance between two planets
+     */
+    calculateDistance(fromPlanetId: bigint, toPlanetId: bigint): number | undefined;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/planet/manager.d.ts.map

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