movehat 0.0.1-alpha.0

package/README.md

@@ -0,0 +1,236 @@
+# Movehat
+
+> Hardhat-like development framework for Movement L1 and Aptos Move smart contracts
+
+[![npm version](https://badge.fury.io/js/movehat.svg)](https://www.npmjs.com/package/movehat)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **Quick Start** - Scaffold new Move projects in seconds
+- **TypeScript Testing** - Write integration tests with familiar tools (Mocha, Chai)
+- **Built-in Helpers** - Interact with contracts easily
+- **Movement CLI Integration** - Seamless compilation and deployment
+- **Hot Reload** - Test changes instantly with watch mode
+
+## Installation
+
+```bash
+npm install -g movehat
+# or
+pnpm add -g movehat
+```
+
+## Quick Start
+
+```bash
+# Create a new project
+npx movehat init my-move-project
+
+# Navigate to project
+cd my-move-project
+
+# Install dependencies
+npm install
+
+# Compile contracts
+npx movehat compile
+
+# Deploy contracts
+npx movehat deploy
+
+# Run tests
+npm test
+```
+
+## Project Structure
+
+```
+my-move-project/
+├── move/                   # Move smart contracts
+│   ├── sources/
+│   │   └── Counter.move
+│   └── Move.toml
+├── scripts/                # Deployment scripts
+│   └── deploy-counter.ts
+├── tests/                  # Integration tests
+│   └── Counter.test.ts
+├── movehat.config.ts       # Configuration
+└── .env                    # Environment variables
+```
+
+## Configuration
+
+Edit `movehat.config.ts`:
+
+```typescript
+export default {
+  network: "movement-testnet",
+  rpc: "https://testnet.movementnetwork.xyz/v1",
+  account: process.env.MH_ACCOUNT || "",
+  privateKey: process.env.MH_PRIVATE_KEY || "",
+  moveDir: "./move",
+  namedAddresses: {
+    counter: process.env.MH_ACCOUNT ?? "0x0",
+  },
+};
+```
+
+Set up your environment variables in `.env`:
+
+```bash
+MH_PRIVATE_KEY=your_private_key_here
+MH_ACCOUNT=your_account_address_here
+MH_NETWORK=testnet
+```
+
+## Writing Tests
+
+```typescript
+import { describe, it, before } from "mocha";
+import { expect } from "chai";
+import { setupTestEnvironment, getContract, assertTransactionSuccess } from "movehat/helpers";
+import type { TestEnvironment, MoveContract } from "movehat/helpers";
+
+describe("Counter Contract", () => {
+  let env: TestEnvironment;
+  let counter: MoveContract;
+
+  before(async function () {
+    this.timeout(30000);
+    env = await setupTestEnvironment();
+    counter = getContract(
+      env.aptos,
+      env.account.accountAddress.toString(),
+      "counter"
+    );
+  });
+
+  it("should increment counter", async function () {
+    this.timeout(30000);
+    
+    const tx = await counter.call(env.account, "increment", []);
+    assertTransactionSuccess(tx);
+    
+    const value = await counter.view<number>("get", [
+      env.account.accountAddress.toString()
+    ]);
+    
+    expect(value).to.be.greaterThan(0);
+  });
+});
+```
+
+## Writing Deployment Scripts
+
+```typescript
+import { setupTestEnvironment, getContract } from "movehat/helpers";
+
+async function main() {
+  console.log("Deploying Counter contract...\n");
+
+  const env = await setupTestEnvironment();
+  
+  const counter = getContract(
+    env.aptos,
+    env.account.accountAddress.toString(),
+    "counter"
+  );
+
+  console.log(`Contract address: ${env.account.accountAddress.toString()}::counter`);
+  
+  // Initialize the counter
+  console.log("\nInitializing counter...");
+  const txResult = await counter.call(env.account, "init", []);
+  
+  console.log(`Transaction hash: ${txResult.hash}`);
+  console.log(`Counter initialized successfully!`);
+  
+  // Verify
+  const value = await counter.view<number>("get", [
+    env.account.accountAddress.toString()
+  ]);
+  
+  console.log(`Initial counter value: ${value}`);
+}
+
+main().catch((error) => {
+  console.error("Deployment failed:", error);
+  process.exit(1);
+});
+```
+
+## API Reference
+
+### Helpers
+
+#### `setupTestEnvironment()`
+
+Sets up the test environment with Aptos client and account.
+
+```typescript
+const env = await setupTestEnvironment();
+// Returns: { aptos: Aptos, account: Account, config: MovehatConfig }
+```
+
+#### `getContract(aptos, moduleAddress, moduleName)`
+
+Creates a contract wrapper for easy interaction.
+
+```typescript
+const counter = getContract(aptos, accountAddress, "counter");
+```
+
+#### `contract.call(signer, functionName, args, typeArgs)`
+
+Executes an entry function (transaction).
+
+```typescript
+const tx = await counter.call(account, "increment", []);
+```
+
+#### `contract.view(functionName, args, typeArgs)`
+
+Reads data from a view function (no transaction).
+
+```typescript
+const value = await counter.view<number>("get", [address]);
+```
+
+#### `assertTransactionSuccess(result)`
+
+Asserts that a transaction was successful.
+
+```typescript
+assertTransactionSuccess(txResult);
+```
+
+## Available Commands
+
+```bash
+npx movehat compile          # Compile Move contracts
+npx movehat deploy          # Deploy contracts
+npx movehat test            # Run tests
+```
+
+## Prerequisites
+
+- Node.js v18+
+- [Movement CLI](https://docs.movementnetwork.xyz/devs/movementCLI) installed and configured
+
+## Documentation
+
+Visit [GitHub Repository](https://github.com/gilbertsahumada/movehat) for full documentation and examples.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT © 
+## Links
+
+- [Movement Network](https://movementnetwork.xyz)
+- [Aptos Move Documentation](https://aptos.dev/move/move-on-aptos/)
+- [GitHub Issues](https://github.com/gilbertsahumada/movehat/issues)

package/bin/movehat.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Get the path to the TypeScript CLI file
+const cliPath = join(__dirname, '..', 'src', 'cli.ts');
+
+// Execute the CLI with tsx
+const child = spawn('tsx', [cliPath, ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  shell: false,
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { Command, InvalidOptionArgumentError } from 'commander';
+import testCommand from './commands/test.js';
+import compileCommand from './commands/compile.js';
+import initCommand from './commands/init.js';
+import runCommand from './commands/run.js';
+import forkCreateCommand from './commands/fork/create.js';
+import forkViewResourceCommand from './commands/fork/view-resource.js';
+import forkFundCommand from './commands/fork/fund.js';
+import forkListCommand from './commands/fork/list.js';
+import forkServeCommand from './commands/fork/serve.js';
+/**
+ * Parse and validate port number
+ */
+function parsePort(value) {
+    const port = Number.parseInt(value, 10);
+    if (isNaN(port) || port < 1 || port > 65535) {
+        throw new InvalidOptionArgumentError('Port must be an integer between 1 and 65535');
+    }
+    return port;
+}
+const program = new Command();
+program
+    .name('movehat')
+    .description('A CLI tool for managing Move smart contracts')
+    .version('0.0.1')
+    .option('--network <name>', 'Network to use (testnet, mainnet, local, etc.)')
+    .option('--redeploy', 'Force redeploy even if already deployed')
+    .hook('preAction', (thisCommand) => {
+    // Store network option in environment for commands to access
+    const options = thisCommand.opts();
+    if (options.network) {
+        process.env.MH_CLI_NETWORK = options.network;
+    }
+    if (options.redeploy) {
+        process.env.MH_CLI_REDEPLOY = 'true';
+    }
+});
+program
+    .command('init [project-name]')
+    .description('Initialize a new Move project in the current directory')
+    .action((projectName) => {
+    initCommand(projectName);
+});
+program
+    .command('compile')
+    .description('Compile Move smart contracts using Movement CLI')
+    .action(compileCommand);
+program
+    .command('run <script>')
+    .description('Run a TypeScript/JavaScript script (e.g., deployment script)')
+    .action(runCommand);
+program
+    .command('test')
+    .description('Run TypeScript tests with Mocha')
+    .action(testCommand);
+// Fork commands
+const fork = program
+    .command('fork')
+    .description('Manage local forks of Movement/Aptos networks');
+fork
+    .command('create')
+    .description('Create a new fork from a network')
+    .option('-n, --name <name>', 'Name for the fork')
+    .option('-p, --path <path>', 'Custom path for the fork')
+    .action((options) => forkCreateCommand(options));
+fork
+    .command('view-resource')
+    .description('View a resource from the fork')
+    .option('-f, --fork <path>', 'Path to the fork')
+    .requiredOption('-a, --account <address>', 'Account address')
+    .requiredOption('-r, --resource <type>', 'Resource type')
+    .action((options) => forkViewResourceCommand(options));
+fork
+    .command('fund')
+    .description('Fund an account in the fork')
+    .option('-f, --fork <path>', 'Path to the fork')
+    .requiredOption('-a, --account <address>', 'Account address')
+    .requiredOption('--amount <amount>', 'Amount to fund')
+    .option('--coin-type <type>', 'Coin type', '0x1::aptos_coin::AptosCoin')
+    .action((options) => forkFundCommand(options));
+fork
+    .command('list')
+    .description('List all available forks')
+    .action(() => forkListCommand());
+fork
+    .command('serve')
+    .description('Start a local RPC server serving the fork')
+    .option('-f, --fork <path>', 'Path to the fork')
+    .option('-p, --port <port>', 'Port to listen on (default: 8080)', parsePort, 8080)
+    .action((options) => forkServeCommand(options));
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAC7C,OAAO,cAAc,MAAM,uBAAuB,CAAC;AACnD,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAC7C,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAC3C,OAAO,iBAAiB,MAAM,2BAA2B,CAAC;AAC1D,OAAO,uBAAuB,MAAM,kCAAkC,CAAC;AACvE,OAAO,eAAe,MAAM,yBAAyB,CAAC;AACtD,OAAO,eAAe,MAAM,yBAAyB,CAAC;AACtD,OAAO,gBAAgB,MAAM,0BAA0B,CAAC;AAExD;;GAEG;AACH,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QAC5C,MAAM,IAAI,0BAA0B,CAAC,6CAA6C,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,kBAAkB,EAAE,gDAAgD,CAAC;KAC5E,MAAM,CAAC,YAAY,EAAE,yCAAyC,CAAC;KAC/D,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;IACjC,6DAA6D;IAC7D,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC;IACvC,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACF,OAAO,CAAC,qBAAqB,CAAC;KAC9B,WAAW,CAAC,wDAAwD,CAAC;KACrE,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE;IACpB,WAAW,CAAC,WAAW,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEP,OAAO;KACF,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,iDAAiD,CAAC;KAC9D,MAAM,CAAC,cAAc,CAAC,CAAC;AAE5B,OAAO;KACF,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,8DAA8D,CAAC;KAC3E,MAAM,CAAC,UAAU,CAAC,CAAC;AAExB,OAAO;KACF,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,iCAAiC,CAAC;KAC9C,MAAM,CAAC,WAAW,CAAC,CAAC;AAEzB,gBAAgB;AAChB,MAAM,IAAI,GAAG,OAAO;KACf,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,+CAA+C,CAAC,CAAC;AAElE,IAAI;KACC,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;KAChD,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;KACvD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;AAErD,IAAI;KACC,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,+BAA+B,CAAC;KAC5C,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;KAC/C,cAAc,CAAC,yBAAyB,EAAE,iBAAiB,CAAC;KAC5D,cAAc,CAAC,uBAAuB,EAAE,eAAe,CAAC;KACxD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;AAE3D,IAAI;KACC,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;KAC/C,cAAc,CAAC,yBAAyB,EAAE,iBAAiB,CAAC;KAC5D,cAAc,CAAC,mBAAmB,EAAE,gBAAgB,CAAC;KACrD,MAAM,CAAC,oBAAoB,EAAE,WAAW,EAAE,4BAA4B,CAAC;KACvE,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;AAEnD,IAAI;KACC,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;AAErC,IAAI;KACC,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;KAC/C,MAAM,CAAC,mBAAmB,EAAE,mCAAmC,EAAE,SAAS,EAAE,IAAI,CAAC;KACjF,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AAEpD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/commands/compile.d.ts

@@ -0,0 +1,2 @@
+export default function compileCommand(): Promise<void>;
+//# sourceMappingURL=compile.d.ts.map

package/dist/commands/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/commands/compile.ts"],"names":[],"mappings":"AAoBA,wBAA8B,cAAc,kBA+D3C"}

package/dist/commands/compile.js

@@ -0,0 +1,71 @@
+import fs from "fs";
+import path from "path";
+import { exec } from "child_process";
+import { loadUserConfig } from "../core/config.js";
+import { validateAndEscapePath, escapeShellArg } from "../core/shell.js";
+function run(command, cwd) {
+    return new Promise((resolve, reject) => {
+        exec(command, { cwd }, (error, stdout, stderr) => {
+            if (stdout)
+                console.log(stdout.trim());
+            if (stderr)
+                console.error(stderr.trim());
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export default async function compileCommand() {
+    try {
+        // Compile is network-independent - only uses global config
+        const userConfig = await loadUserConfig();
+        console.log("📦 Compiling Move contracts (network-independent)...");
+        const moveDir = path.resolve(process.cwd(), userConfig.moveDir || "./move");
+        if (!fs.existsSync(moveDir)) {
+            console.error(`❌ Move directory not found: ${moveDir}`);
+            console.error(`   Update movehat.config.ts -> moveDir`);
+            return;
+        }
+        // Validate and escape to prevent command injection
+        const safeMoveDir = validateAndEscapePath(moveDir, "Move directory");
+        // Use global named addresses for compilation
+        const namedAddresses = userConfig.namedAddresses ?? {};
+        let namedAddressesArg = "";
+        if (Object.keys(namedAddresses).length > 0) {
+            // Validate and escape each address name and value
+            const escapedAddresses = Object.entries(namedAddresses)
+                .map(([k, v]) => {
+                // Validate address name (alphanumeric, underscore only)
+                if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(k)) {
+                    throw new Error(`Invalid named address "${k}". ` +
+                        `Names must start with a letter or underscore and contain only alphanumeric characters and underscores.`);
+                }
+                // Validate address value (should be hex address)
+                if (!/^0x[a-fA-F0-9]+$/.test(v)) {
+                    throw new Error(`Invalid address value for "${k}": "${v}". ` +
+                        `Address values must be hex strings starting with "0x".`);
+                }
+                // No need to escape since we validated the format
+                return `${k}=${v}`;
+            })
+                .join(",");
+            namedAddressesArg = `--named-addresses ${escapeShellArg(escapedAddresses)}`;
+        }
+        const command = `movement move build --package-dir ${safeMoveDir} ${namedAddressesArg}`.trim();
+        console.log(`   Move directory: ${moveDir}`);
+        if (Object.keys(namedAddresses).length > 0) {
+            console.log(`   Named addresses: ${Object.keys(namedAddresses).join(", ")}`);
+        }
+        console.log();
+        await run(command, moveDir);
+        console.log("✅ Compilation finished successfully.");
+    }
+    catch (err) {
+        console.error("❌ Compilation failed:", err.message ?? err);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=compile.js.map

package/dist/commands/compile.js.map

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

package/dist/commands/fork/create.d.ts

@@ -0,0 +1,11 @@
+interface ForkCreateOptions {
+    network?: string;
+    path?: string;
+    name?: string;
+}
+/**
+ * Fork create command: Create a local fork of a Movement/Aptos network
+ */
+export default function forkCreateCommand(options?: ForkCreateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/fork/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/fork/create.ts"],"names":[],"mappings":"AAMA,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAA8B,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,iBAsD9E"}

package/dist/commands/fork/create.js

@@ -0,0 +1,56 @@
+import { join } from 'path';
+import { existsSync } from 'fs';
+import prompts from 'prompts';
+import { loadUserConfig, resolveNetworkConfig } from '../../core/config.js';
+import { ForkManager } from '../../fork/manager.js';
+/**
+ * Fork create command: Create a local fork of a Movement/Aptos network
+ */
+export default async function forkCreateCommand(options = {}) {
+    try {
+        // Load MoveHat config
+        const userConfig = await loadUserConfig();
+        const networkName = options.network || process.env.MH_CLI_NETWORK || userConfig.defaultNetwork || 'testnet';
+        const networkConfig = await resolveNetworkConfig(userConfig, networkName);
+        // Determine fork name and path
+        const forkName = options.name || `${networkName}-fork`;
+        const forkPath = options.path || join(process.cwd(), '.movehat', 'forks', forkName);
+        console.log(`\n📦 Creating fork of ${networkName}`);
+        console.log(`   Network: ${networkConfig.rpc}`);
+        console.log(`   Fork path: ${forkPath}`);
+        // Check if fork already exists
+        if (existsSync(forkPath)) {
+            const { overwrite } = await prompts({
+                type: 'confirm',
+                name: 'overwrite',
+                message: `Fork already exists at ${forkPath}. Overwrite?`,
+                initial: false,
+            });
+            if (!overwrite) {
+                console.log('❌ Fork creation cancelled');
+                return;
+            }
+        }
+        // Create fork manager
+        const forkManager = new ForkManager(forkPath);
+        // Initialize fork
+        console.log(`\n⚙️  Initializing fork...`);
+        await forkManager.initialize(networkConfig.rpc, networkName);
+        const metadata = forkManager.getMetadata();
+        console.log(`\n✅ Fork created successfully!\n`);
+        console.log(`Fork Details:`);
+        console.log(`  Chain ID: ${metadata.chainId}`);
+        console.log(`  Ledger Version: ${metadata.ledgerVersion}`);
+        console.log(`  Block Height: ${metadata.blockHeight}`);
+        console.log(`  Epoch: ${metadata.epoch}`);
+        console.log(`\nUsage:`);
+        console.log(`  movehat fork view-resource --fork ${forkPath} --account <ADDRESS> --resource <TYPE>`);
+        console.log(`  movehat fork fund --fork ${forkPath} --account <ADDRESS> --amount <AMOUNT>`);
+        console.log(`  movehat fork list\n`);
+    }
+    catch (error) {
+        console.error(`\n❌ Error: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/fork/create.js.map

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

package/dist/commands/fork/fund.d.ts

@@ -0,0 +1,12 @@
+interface ForkFundOptions {
+    fork?: string;
+    account: string;
+    amount: string;
+    coinType?: string;
+}
+/**
+ * Fork fund command: Fund an account in the fork
+ */
+export default function forkFundCommand(options: ForkFundOptions): Promise<void>;
+export {};
+//# sourceMappingURL=fund.d.ts.map

package/dist/commands/fork/fund.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fund.d.ts","sourceRoot":"","sources":["../../../src/commands/fork/fund.ts"],"names":[],"mappings":"AAGA,UAAU,eAAe;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAA8B,eAAe,CAAC,OAAO,EAAE,eAAe,iBA2CrE"}

package/dist/commands/fork/fund.js

@@ -0,0 +1,42 @@
+import { join } from 'path';
+import { ForkManager } from '../../fork/manager.js';
+/**
+ * Fork fund command: Fund an account in the fork
+ */
+export default async function forkFundCommand(options) {
+    try {
+        if (!options.account) {
+            throw new Error('--account is required');
+        }
+        if (!options.amount) {
+            throw new Error('--amount is required');
+        }
+        const amount = parseInt(options.amount, 10);
+        if (isNaN(amount) || amount <= 0) {
+            throw new Error('--amount must be a positive number');
+        }
+        // Determine fork path
+        const forkPath = options.fork || join(process.cwd(), '.movehat', 'forks', 'testnet-fork');
+        const coinType = options.coinType || '0x1::aptos_coin::AptosCoin';
+        console.log(`\n💰 Funding account in fork`);
+        console.log(`   Fork: ${forkPath}`);
+        console.log(`   Account: ${options.account}`);
+        console.log(`   Amount: ${amount}`);
+        console.log(`   Coin Type: ${coinType}\n`);
+        // Load fork
+        const forkManager = new ForkManager(forkPath);
+        forkManager.load();
+        // Fund account
+        await forkManager.fundAccount(options.account, amount, coinType);
+        // Verify
+        const resourceType = `0x1::coin::CoinStore<${coinType}>`;
+        const coinStore = await forkManager.getResource(options.account, resourceType);
+        console.log(`\n✅ Account funded successfully!`);
+        console.log(`   New balance: ${coinStore.coin.value}\n`);
+    }
+    catch (error) {
+        console.error(`\n❌ Error: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=fund.js.map

package/dist/commands/fork/fund.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fund.js","sourceRoot":"","sources":["../../../src/commands/fork/fund.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AASpD;;GAEG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,eAAe,CAAC,OAAwB;IACpE,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,sBAAsB;QACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QAC1F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,4BAA4B,CAAC;QAElE,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,IAAI,CAAC,CAAC;QAE3C,YAAY;QACZ,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC9C,WAAW,CAAC,IAAI,EAAE,CAAC;QAEnB,eAAe;QACf,MAAM,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEjE,SAAS;QACT,MAAM,YAAY,GAAG,wBAAwB,QAAQ,GAAG,CAAC;QACzD,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAE/E,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,mBAAmB,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAE3D,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/fork/list.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Fork list command: List all available forks
+ */
+export default function forkListCommand(): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/fork/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/fork/list.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAA8B,eAAe,kBA2D5C"}

package/dist/commands/fork/list.js

@@ -0,0 +1,61 @@
+import { join } from 'path';
+import { existsSync, readdirSync, statSync } from 'fs';
+import { ForkStorage } from '../../fork/storage.js';
+/**
+ * Fork list command: List all available forks
+ */
+export default async function forkListCommand() {
+    try {
+        const forksDir = join(process.cwd(), '.movehat', 'forks');
+        if (!existsSync(forksDir)) {
+            console.log('\n📂 No forks found\n');
+            console.log('Create a fork with:');
+            console.log('  movehat fork create --network testnet\n');
+            return;
+        }
+        const entries = readdirSync(forksDir);
+        const forkDirs = entries.filter((entry) => {
+            const fullPath = join(forksDir, entry);
+            return statSync(fullPath).isDirectory();
+        });
+        if (forkDirs.length === 0) {
+            console.log('\n📂 No forks found\n');
+            return;
+        }
+        console.log(`\n📂 Found ${forkDirs.length} fork(s):\n`);
+        for (const forkDir of forkDirs) {
+            const forkPath = join(forksDir, forkDir);
+            const storage = new ForkStorage(forkPath);
+            try {
+                if (storage.exists()) {
+                    const metadata = storage.loadMetadata();
+                    const accounts = storage.listAccounts();
+                    console.log(`  ${forkDir}`);
+                    console.log(`    Path: ${forkPath}`);
+                    console.log(`    Network: ${metadata.network}`);
+                    console.log(`    Chain ID: ${metadata.chainId}`);
+                    console.log(`    Ledger Version: ${metadata.ledgerVersion}`);
+                    console.log(`    Cached Accounts: ${accounts.length}`);
+                    console.log(`    Created: ${new Date(metadata.createdAt).toLocaleString()}`);
+                    console.log('');
+                }
+                else {
+                    console.log(`  ${forkDir} (invalid - missing metadata)`);
+                    console.log('');
+                }
+            }
+            catch (error) {
+                console.log(`  ${forkDir} (error reading metadata)`);
+                console.log('');
+            }
+        }
+        console.log('Usage:');
+        console.log('  movehat fork view-resource --fork <PATH> --account <ADDR> --resource <TYPE>');
+        console.log('  movehat fork fund --fork <PATH> --account <ADDR> --amount <AMOUNT>\n');
+    }
+    catch (error) {
+        console.error(`\n❌ Error: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=list.js.map