movehat 0.0.1-alpha.0

package/dist/templates/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "resolveJsonModule": true,
+    "outDir": "./dist"
+  },
+  "include": ["tests/**/*", "scripts/**/*", "movehat.config.ts"],
+  "exclude": ["node_modules", "dist", "move"]
+}

package/dist/templates/types/movehat.d.ts

@@ -0,0 +1,104 @@
+// Type declarations for movehat package
+// This file is only for IDE support during template development
+// It will NOT be copied to user projects
+
+declare module 'movehat' {
+  import { Aptos, Account } from '@aptos-labs/ts-sdk';
+
+  export interface NetworkInfo {
+    name: string;
+    rpc: string;
+    chainId?: string;
+  }
+
+  export interface MovehatConfig {
+    network: string;
+    rpc: string;
+    privateKey: string;
+    profile: string;
+    moveDir: string;
+    account: string;
+    namedAddresses?: Record<string, string>;
+  }
+
+  export interface DeploymentInfo {
+    address: string;
+    moduleName: string;
+    network: string;
+    deployer: string;
+    timestamp: number;
+    txHash?: string;
+    blockNumber?: string;
+  }
+
+  export interface MovehatRuntime {
+    config: MovehatConfig;
+    network: NetworkInfo;
+    aptos: Aptos;
+    account: Account;
+    accounts: Account[];
+    getContract: (address: string, moduleName: string) => any;
+    deployContract: (
+      moduleName: string,
+      options?: {
+        packageDir?: string;
+      }
+    ) => Promise<DeploymentInfo>;
+    getDeployment: (moduleName: string) => DeploymentInfo | null;
+    getDeployments: () => Record<string, DeploymentInfo>;
+    getDeploymentAddress: (moduleName: string) => string | null;
+    createAccount: () => Account;
+    getAccount: (privateKey: string) => Account;
+    getAccountByIndex: (index: number) => Account;
+    switchNetwork: (networkName: string) => Promise<void>;
+  }
+
+  export function getMovehat(): Promise<MovehatRuntime>;
+  export function initRuntime(configOverride?: Partial<MovehatConfig>): Promise<MovehatRuntime>;
+  export function getRuntime(): MovehatRuntime;
+
+  export const mh: {
+    readonly runtime: MovehatRuntime;
+  };
+}
+
+declare module 'movehat/helpers' {
+  import { Account, Aptos } from '@aptos-labs/ts-sdk';
+
+  export interface TestEnvironment {
+    aptos: Aptos;
+    account: Account;
+    config: any;
+  }
+
+  export class MoveContract {
+    constructor(aptos: Aptos, address: string, moduleName: string);
+    call(sender: Account, functionName: string, args: any[]): Promise<any>;
+    view<T>(functionName: string, args: any[]): Promise<T>;
+  }
+
+  export interface TransactionResult {
+    hash: string;
+    success: boolean;
+  }
+
+  export interface DeploymentInfo {
+    address: string;
+    moduleName: string;
+    network: string;
+    deployer: string;
+    timestamp: number;
+    txHash?: string;
+    blockNumber?: string;
+  }
+
+  export function setupTestEnvironment(): Promise<TestEnvironment>;
+  export function createTestAccount(): Account;
+  export function getContract(aptos: Aptos, address: string, moduleName: string): MoveContract;
+  export function assertTransactionSuccess(result: TransactionResult): void;
+  export function assertTransactionFailed(result: TransactionResult): void;
+  export function saveDeployment(deployment: DeploymentInfo): void;
+  export function loadDeployment(network: string, moduleName: string): DeploymentInfo | null;
+  export function getAllDeployments(network: string): Record<string, DeploymentInfo>;
+  export function getDeployedAddress(network: string, moduleName: string): string | null;
+}

package/dist/types/config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Configuration for a single network
+ */
+export interface NetworkConfig {
+    url: string;
+    accounts?: string[];
+    chainId?: string;
+    profile?: string;
+    namedAddresses?: Record<string, string>;
+}
+/**
+ * User configuration (what users write in movehat.config.ts)
+ */
+export interface MovehatUserConfig {
+    defaultNetwork?: string;
+    networks: Record<string, NetworkConfig>;
+    accounts?: string[];
+    moveDir?: string;
+    namedAddresses?: Record<string, string>;
+}
+/**
+ * Resolved configuration (internal use - what runtime uses)
+ */
+export interface MovehatConfig {
+    network: string;
+    rpc: string;
+    privateKey: string;
+    allAccounts: string[];
+    profile: string;
+    moveDir: string;
+    account: string;
+    namedAddresses: Record<string, string>;
+    networkConfig: NetworkConfig;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;CAChC"}

package/dist/types/config.js

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

package/dist/types/config.js.map

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

package/dist/types/fork.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Fork system types for MoveHat
+ */
+export interface ForkMetadata {
+    network: string;
+    nodeUrl: string;
+    chainId: number;
+    ledgerVersion: string;
+    timestamp: string;
+    epoch: string;
+    blockHeight: string;
+    createdAt: string;
+}
+export interface AccountState {
+    sequenceNumber: string;
+    authenticationKey: string;
+}
+export interface LedgerInfo {
+    chain_id: number;
+    epoch: string;
+    ledger_version: string;
+    oldest_ledger_version: string;
+    ledger_timestamp: string;
+    node_role: string;
+    oldest_block_height: string;
+    block_height: string;
+    git_hash?: string;
+}
+export interface AccountData {
+    sequence_number: string;
+    authentication_key: string;
+}
+export interface AccountResource {
+    type: string;
+    data: any;
+}
+//# sourceMappingURL=fork.d.ts.map

package/dist/types/fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../src/types/fork.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC;CACX"}

package/dist/types/fork.js

@@ -0,0 +1,5 @@
+/**
+ * Fork system types for MoveHat
+ */
+export {};
+//# sourceMappingURL=fork.js.map

package/dist/types/fork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.js","sourceRoot":"","sources":["../../src/types/fork.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/runtime.d.ts

@@ -0,0 +1,28 @@
+import { Aptos, Account } from "@aptos-labs/ts-sdk";
+import { MovehatConfig } from "./config.js";
+import { MoveContract } from "../core/contract.js";
+import { DeploymentInfo } from "../core/deployments.js";
+export interface NetworkInfo {
+    name: string;
+    rpc: string;
+    chainId?: string;
+}
+export interface MovehatRuntime {
+    config: MovehatConfig;
+    network: NetworkInfo;
+    aptos: Aptos;
+    account: Account;
+    accounts: Account[];
+    getContract: (address: string, moduleName: string) => MoveContract;
+    deployContract: (moduleName: string, options?: {
+        packageDir?: string;
+    }) => Promise<DeploymentInfo>;
+    getDeployment: (moduleName: string) => DeploymentInfo | null;
+    getDeployments: () => Record<string, DeploymentInfo>;
+    getDeploymentAddress: (moduleName: string) => string | null;
+    createAccount: () => Account;
+    getAccount: (privateKey: string) => Account;
+    getAccountByIndex: (index: number) => Account;
+    switchNetwork: (networkName: string) => Promise<void>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/types/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAE7B,MAAM,EAAE,aAAa,CAAC;IAGtB,OAAO,EAAE,WAAW,CAAC;IAGrB,KAAK,EAAE,KAAK,CAAC;IAGb,OAAO,EAAE,OAAO,CAAC;IAGjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IAGpB,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,YAAY,CAAC;IAGnE,cAAc,EAAE,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KACE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,cAAc,GAAG,IAAI,CAAC;IAC7D,cAAc,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrD,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAG5D,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAG9C,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD"}

package/dist/types/runtime.js

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

package/dist/types/runtime.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "movehat",
+  "version": "0.0.1-alpha.0",
+  "type": "module",
+  "description": "Hardhat-like development framework for Movement L1 and Aptos Move smart contracts",
+  "bin": {
+    "movehat": "./bin/movehat.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./helpers": {
+      "types": "./dist/helpers/index.d.ts",
+      "import": "./dist/helpers/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc && npm run copy-templates",
+    "copy-templates": "cp -r src/templates dist/",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "src",
+    "bin"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gilbertsahumada/movehat.git"
+  },
+  "homepage": "https://github.com/gilbertsahumada/movehat#readme",
+  "bugs": {
+    "url": "https://github.com/gilbertsahumada/movehat/issues"
+  },
+  "keywords": [
+    "move",
+    "aptos",
+    "movement",
+    "blockchain",
+    "smart-contracts",
+    "hardhat",
+    "framework",
+    "web3",
+    "dapp"
+  ],
+  "author": "Gilberts Ahumada",
+  "license": "MIT",
+  "dependencies": {
+    "@aptos-labs/ts-sdk": "^5.1.5",
+    "commander": "^14.0.2",
+    "dotenv": "^17.2.3",
+    "js-yaml": "^4.1.1",
+    "prompts": "^2.4.2",
+    "tsx": "^4.7.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^24.10.1",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.9.3"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,106 @@
+#!/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: string): number {
+  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);

package/src/commands/compile.ts

@@ -0,0 +1,84 @@
+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: string, cwd: string) {
+  return new Promise<void>((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: any) {
+    console.error("❌ Compilation failed:", err.message ?? err);
+    process.exit(1);
+  }
+}

package/src/commands/fork/create.ts

@@ -0,0 +1,70 @@
+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';
+
+interface ForkCreateOptions {
+  network?: string;
+  path?: string;
+  name?: string;
+}
+
+/**
+ * Fork create command: Create a local fork of a Movement/Aptos network
+ */
+export default async function forkCreateCommand(options: ForkCreateOptions = {}) {
+  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: any) {
+    console.error(`\n❌ Error: ${error.message}\n`);
+    process.exit(1);
+  }
+}

package/src/commands/fork/fund.ts

@@ -0,0 +1,57 @@
+import { join } from 'path';
+import { ForkManager } from '../../fork/manager.js';
+
+interface ForkFundOptions {
+  fork?: string;
+  account: string;
+  amount: string;
+  coinType?: string;
+}
+
+/**
+ * Fork fund command: Fund an account in the fork
+ */
+export default async function forkFundCommand(options: ForkFundOptions) {
+  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: any) {
+    console.error(`\n❌ Error: ${error.message}\n`);
+    process.exit(1);
+  }
+}