movehat 0.0.1-alpha.0

package/dist/runtime.d.ts

@@ -0,0 +1,26 @@
+import { MovehatRuntime } from "./types/runtime.js";
+import { MovehatUserConfig } from "./types/config.js";
+export interface InitRuntimeOptions {
+    network?: string;
+    accountIndex?: number;
+    configOverride?: Partial<MovehatUserConfig>;
+}
+/**
+ * Initialize the Movehat Runtime Environment
+ * This function loads the configuration and creates the runtime context
+ */
+export declare function initRuntime(options?: InitRuntimeOptions): Promise<MovehatRuntime>;
+/**
+ * Get the current Movehat Runtime Environment
+ * Throws error if runtime hasn't been initialized
+ */
+export declare function getRuntime(): MovehatRuntime;
+/**
+ * Get or initialize the Movehat Runtime Environment
+ * This is a convenience function that initializes if needed
+ */
+export declare function getMovehat(): Promise<MovehatRuntime>;
+export declare const mh: {
+    readonly runtime: MovehatRuntime;
+};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAe,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAetD,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,cAAc,CAAC,CA+PzB;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAO3C;AAED;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC,CAK1D;AAGD,eAAO,MAAM,EAAE;;CAId,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,247 @@
+import { Account, Aptos, AptosConfig, Ed25519PrivateKey, } from "@aptos-labs/ts-sdk";
+import { loadUserConfig, resolveNetworkConfig } from "./core/config.js";
+import { getContract } from "./core/contract.js";
+import { saveDeployment, loadDeployment, getAllDeployments, getDeployedAddress, validateSafeName, } from "./core/deployments.js";
+import { ModuleAlreadyDeployedError } from "./errors.js";
+let cachedRuntime = null;
+/**
+ * Initialize the Movehat Runtime Environment
+ * This function loads the configuration and creates the runtime context
+ */
+export async function initRuntime(options = {}) {
+    // Load user config from movehat.config.ts
+    const userConfig = await loadUserConfig();
+    // Apply config override if provided
+    const mergedUserConfig = options.configOverride
+        ? { ...userConfig, ...options.configOverride }
+        : userConfig;
+    // Resolve configuration for selected network
+    const config = await resolveNetworkConfig(mergedUserConfig, options.network);
+    // Setup Aptos client
+    const aptosConfig = new AptosConfig({
+        network: config.network,
+        fullnode: config.rpc,
+    });
+    const aptos = new Aptos(aptosConfig);
+    // Setup accounts
+    const accountIndex = options.accountIndex || 0;
+    const accounts = config.allAccounts.map((pk) => {
+        const privateKey = new Ed25519PrivateKey(pk);
+        return Account.fromPrivateKey({ privateKey });
+    });
+    // Primary account (accounts[0] or selected index)
+    const account = accounts[accountIndex];
+    if (!account) {
+        throw new Error(`Account index ${accountIndex} not found. Only ${accounts.length} accounts configured.`);
+    }
+    // Update config.account with derived address
+    config.account = account.accountAddress.toString();
+    // Network info
+    const network = {
+        name: config.network,
+        rpc: config.rpc,
+    };
+    // Helper functions
+    const getContractHelper = (address, moduleName) => {
+        return getContract(aptos, address, moduleName);
+    };
+    const deployContract = async (moduleName, options) => {
+        // Validate moduleName early
+        validateSafeName(moduleName, "module");
+        const { exec } = await import("child_process");
+        const { promisify } = await import("util");
+        const { existsSync, mkdirSync, writeFileSync, chmodSync } = await import("fs");
+        const { join } = await import("path");
+        const { homedir } = await import("os");
+        const yaml = await import("js-yaml");
+        const { validateAndEscapePath, validateAndEscapeProfile } = await import("./core/shell.js");
+        const execAsync = promisify(exec);
+        // Check if --redeploy flag was passed via CLI
+        const forceRedeploy = process.env.MH_CLI_REDEPLOY === 'true';
+        // Check if already deployed
+        const existingDeployment = loadDeployment(config.network, moduleName);
+        if (existingDeployment && !forceRedeploy) {
+            // Build detailed error message with all deployment info
+            const errorDetails = [
+                `Module "${moduleName}" is already deployed on ${config.network}`,
+                `Address: ${existingDeployment.address}`,
+                `Deployed at: ${new Date(existingDeployment.timestamp).toLocaleString()}`,
+                existingDeployment.txHash ? `Transaction: ${existingDeployment.txHash}` : null,
+                `\nTo redeploy, run with the --redeploy flag:`,
+                `movehat run <script> --network ${config.network} --redeploy`,
+            ].filter(Boolean).join('\n');
+            // Log formatted error message for user
+            const formattedMessage = [
+                `\n❌ Module "${moduleName}" is already deployed on ${config.network}`,
+                `   Address: ${existingDeployment.address}`,
+                `   Deployed at: ${new Date(existingDeployment.timestamp).toLocaleString()}`,
+                existingDeployment.txHash ? `   Transaction: ${existingDeployment.txHash}` : null,
+                `\n💡 To redeploy, run with the --redeploy flag:`,
+                `   movehat run <script> --network ${config.network} --redeploy\n`,
+            ].filter(Boolean).join('\n');
+            console.error(formattedMessage);
+            // Throw custom error with complete context for programmatic handling
+            throw new ModuleAlreadyDeployedError(errorDetails, moduleName, config.network, existingDeployment.address, existingDeployment.timestamp, existingDeployment.txHash);
+        }
+        if (forceRedeploy && existingDeployment) {
+            console.log(`🔄 Redeploying module "${moduleName}" on ${config.network}...`);
+        }
+        const dir = options?.packageDir || config.moveDir;
+        const profile = config.profile || "default";
+        // Validate and escape to prevent command injection
+        const safeDir = validateAndEscapePath(dir, "package directory");
+        const safeProfile = validateAndEscapeProfile(profile);
+        console.log(`📦 Publishing module "${moduleName}" from ${dir}...`);
+        try {
+            // Ensure Movement CLI config exists
+            const aptosConfigDir = join(homedir(), ".aptos");
+            const aptosConfigPath = join(aptosConfigDir, "config.yaml");
+            if (!existsSync(aptosConfigPath)) {
+                console.log("⚙️  Creating Movement CLI configuration...");
+                if (!existsSync(aptosConfigDir)) {
+                    mkdirSync(aptosConfigDir, { recursive: true });
+                }
+                // Create minimal config.yaml using js-yaml to prevent YAML injection
+                const configData = {
+                    profiles: {
+                        [profile]: {
+                            private_key: config.privateKey,
+                            public_key: account.publicKey.toString(),
+                            account: account.accountAddress.toString(),
+                            rest_url: config.rpc,
+                        },
+                    },
+                };
+                const configContent = yaml.dump(configData);
+                writeFileSync(aptosConfigPath, configContent, "utf-8");
+                // Restrict file permissions to owner only (600) for security
+                // This prevents other users from reading the private key
+                try {
+                    chmodSync(aptosConfigPath, 0o600);
+                }
+                catch (error) {
+                    // chmod may fail on Windows, but that's okay
+                    // Windows has different permission model (ACLs)
+                    console.warn("⚠️  Could not set file permissions (this is normal on Windows)");
+                }
+            }
+            // Build first
+            console.log("🔨 Building package...");
+            const buildCmd = `movement move build --package-dir ${safeDir}`;
+            const { stdout: buildOut } = await execAsync(buildCmd);
+            if (buildOut)
+                console.log(buildOut.trim());
+            // Publish
+            console.log("📤 Publishing to blockchain...");
+            const publishCmd = `movement move publish --profile ${safeProfile} --package-dir ${safeDir} --assume-yes`;
+            const { stdout: publishOut } = await execAsync(publishCmd);
+            if (publishOut)
+                console.log(publishOut.trim());
+            // Extract transaction hash from output
+            // Look for patterns like "Transaction hash: 0x..." or "Txn: 0x..." or just a 64-char hex
+            // The regex tries to match with context first, then falls back to any 64-char hex
+            let txHash;
+            const txHashMatchWithContext = publishOut.match(/(?:transaction\s*(?:hash)?|txn\s*(?:hash)?|hash):\s*(0x[a-fA-F0-9]{64})\b/i);
+            if (txHashMatchWithContext) {
+                txHash = txHashMatchWithContext[1];
+            }
+            else {
+                // Fallback: try to find any 64-char hex string (exactly, not more)
+                const txHashMatch = publishOut.match(/\b(0x[a-fA-F0-9]{64})\b/);
+                if (txHashMatch) {
+                    txHash = txHashMatch[1];
+                }
+            }
+            console.log(`✅ Module published successfully!`);
+            // Create deployment info
+            const deployment = {
+                address: account.accountAddress.toString(),
+                moduleName,
+                network: config.network,
+                deployer: account.accountAddress.toString(),
+                timestamp: Date.now(),
+                txHash,
+            };
+            // Save deployment
+            saveDeployment(deployment);
+            return deployment;
+        }
+        catch (error) {
+            console.error(`❌ Failed to publish module: ${error.message}`);
+            throw error;
+        }
+    };
+    const getDeployment = (moduleName) => {
+        return loadDeployment(config.network, moduleName);
+    };
+    const getDeployments = () => {
+        return getAllDeployments(config.network);
+    };
+    const getDeploymentAddress = (moduleName) => {
+        return getDeployedAddress(config.network, moduleName);
+    };
+    const createAccount = () => {
+        return Account.generate();
+    };
+    const getAccountHelper = (privateKeyHex) => {
+        const pk = new Ed25519PrivateKey(privateKeyHex);
+        return Account.fromPrivateKey({ privateKey: pk });
+    };
+    const getAccountByIndex = (index) => {
+        if (index < 0 || index >= accounts.length) {
+            throw new Error(`Account index ${index} out of range. Available accounts: 0-${accounts.length - 1}`);
+        }
+        return accounts[index];
+    };
+    const switchNetwork = async (networkName) => {
+        // Clear cache and reinitialize with new network
+        cachedRuntime = null;
+        await initRuntime({ ...options, network: networkName });
+    };
+    // Build runtime object
+    const runtime = {
+        config,
+        network,
+        aptos,
+        account,
+        accounts,
+        getContract: getContractHelper,
+        deployContract,
+        getDeployment,
+        getDeployments,
+        getDeploymentAddress,
+        createAccount,
+        getAccount: getAccountHelper,
+        getAccountByIndex,
+        switchNetwork,
+    };
+    cachedRuntime = runtime;
+    return runtime;
+}
+/**
+ * Get the current Movehat Runtime Environment
+ * Throws error if runtime hasn't been initialized
+ */
+export function getRuntime() {
+    if (!cachedRuntime) {
+        throw new Error("Movehat Runtime not initialized. Call initRuntime() first or use getMovehat().");
+    }
+    return cachedRuntime;
+}
+/**
+ * Get or initialize the Movehat Runtime Environment
+ * This is a convenience function that initializes if needed
+ */
+export async function getMovehat() {
+    if (cachedRuntime) {
+        return cachedRuntime;
+    }
+    return initRuntime();
+}
+// Export a default instance getter for convenience
+export const mh = {
+    get runtime() {
+        return getRuntime();
+    },
+};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/templates/.env.example

@@ -0,0 +1,9 @@
+# Private Key (used for all networks - Hardhat-style)
+# This is your wallet's private key that will be used to deploy and interact with contracts
+PRIVATE_KEY=your_private_key_here
+
+# Optional: Override RPC URL (useful for custom endpoints)
+# MOVEMENT_RPC_URL=https://custom-testnet.movementnetwork.xyz/v1
+
+# Optional: Override default network from config
+# MH_DEFAULT_NETWORK=testnet

package/dist/templates/.mocharc.json

@@ -0,0 +1,8 @@
+{
+  "node-option": ["import=tsx"],
+  "extensions": ["ts"],
+  "spec": ["tests/**/*.test.ts"],
+  "timeout": 30000,
+  "color": true,
+  "reporter": "spec"
+}

package/dist/templates/README.md

@@ -0,0 +1,92 @@
+# {{PROJECT_NAME}}
+
+A Move smart contract project built with Movehat.
+
+## Prerequisites
+
+- Node.js v18+
+- [Movement CLI](https://docs.movementnetwork.xyz/devs/movementCLI)
+
+## Getting Started
+
+### 1. Install dependencies
+
+```bash
+npm install
+```
+
+### 2. Configure environment
+
+Copy `.env.example` to `.env` and fill in your credentials:
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env`:
+```
+MH_PRIVATE_KEY=your_private_key_here
+MH_ACCOUNT=your_account_address_here
+MH_NETWORK=testnet
+```
+
+### 3. Update Move.toml
+
+Edit `move/Move.toml` and set the `counter` address to your account address:
+
+```toml
+[addresses]
+counter = "0xYOUR_ACCOUNT_ADDRESS"
+```
+
+### 4. Compile contracts
+
+```bash
+npm run compile
+```
+
+### 5. Deploy
+
+```bash
+npx tsx scripts/deploy-counter.ts
+```
+
+Or use the Movement CLI directly:
+```bash
+movement move publish --package-dir ./move --profile default --assume-yes
+```
+
+### 6. Run tests
+
+```bash
+npm test
+```
+
+## Project Structure
+
+```
+{{PROJECT_NAME}}/
+├── move/                   # Move smart contracts
+│   ├── sources/
+│   │   └── Counter.move
+│   └── Move.toml
+├── scripts/                # Deployment scripts
+│   └── deploy-counter.ts
+├── tests/                  # Integration tests
+│   └── Counter.test.ts
+├── movehat.config.ts       # Movehat configuration
+└── .env                    # Environment variables (git-ignored)
+```
+
+## Available Commands
+
+- `npm run compile` - Compile Move contracts
+- `npm test` - Run integration tests
+- `npm run test:watch` - Run tests in watch mode
+- `npx tsx scripts/deploy-counter.ts` - Deploy and initialize counter
+
+## Learn More
+
+- [Movement Documentation](https://docs.movementnetwork.xyz)
+- [Aptos Move Book](https://move-language.github.io/move/)
+- [Movehat GitHub](https://github.com/gilbertsahumada/movehat)

package/dist/templates/move/Counter.move

@@ -0,0 +1,64 @@
+module counter::counter {
+    use std::signer;
+    use aptos_framework::event;
+    use aptos_framework::account;
+
+    struct Counter has key {
+        value: u64,
+        increment_events: event::EventHandle<IncrementEvent>,
+    }
+
+    struct IncrementEvent has drop, store {
+        old_value: u64,
+        new_value: u64,
+    }
+
+    /// Initialize counter for an account
+    public entry fun init(account: &signer) {
+        let account_addr = signer::address_of(account);
+        
+        if (!exists<Counter>(account_addr)) {
+            move_to(account, Counter {
+                value: 0,
+                increment_events: account::new_event_handle<IncrementEvent>(account),
+            });
+        }
+    }
+
+    /// Increment the counter
+    public entry fun increment(account: &signer) acquires Counter {
+        let account_addr = signer::address_of(account);
+        assert!(exists<Counter>(account_addr), 1);
+        
+        let counter = borrow_global_mut<Counter>(account_addr);
+        let old_value = counter.value;
+        counter.value = old_value + 1;
+        
+        event::emit_event(&mut counter.increment_events, IncrementEvent {
+            old_value,
+            new_value: counter.value,
+        });
+    }
+
+    /// Get counter value
+    #[view]
+    public fun get(addr: address): u64 acquires Counter {
+        assert!(exists<Counter>(addr), 1);
+        borrow_global<Counter>(addr).value
+    }
+
+    #[test(account = @0x1)]
+    public fun test_increment(account: &signer) acquires Counter {
+        let addr = signer::address_of(account);
+        aptos_framework::account::create_account_for_test(addr);
+        
+        init(account);
+        assert!(get(addr) == 0, 0);
+        
+        increment(account);
+        assert!(get(addr) == 1, 1);
+        
+        increment(account);
+        assert!(get(addr) == 2, 2);
+    }
+}

package/dist/templates/move/Move.toml

@@ -0,0 +1,16 @@
+[package]
+name = "{{PROJECT_NAME}}"
+version = "1.0.0"
+authors = []
+
+[addresses]
+counter = "_"
+
+[dev-addresses]
+
+[dependencies.AptosFramework]
+git = "https://github.com/movementlabsxyz/aptos-core.git"
+rev = "movement"
+subdir = "aptos-move/framework/aptos-framework"
+
+[dev-dependencies]

package/dist/templates/movehat.config.ts

@@ -0,0 +1,37 @@
+import dotenv from "dotenv";
+dotenv.config();
+
+export default {
+  // Default network to use when no --network flag is provided
+  defaultNetwork: "testnet",
+
+  // Network configurations
+  networks: {
+    testnet: {
+      url: process.env.MOVEMENT_RPC_URL || "https://testnet.movementnetwork.xyz/v1",
+      chainId: "testnet",
+    },
+    mainnet: {
+      url: "https://mainnet.movementnetwork.xyz/v1",
+      chainId: "mainnet",
+    },
+    local: {
+      url: "http://localhost:8080/v1",
+      chainId: "local",
+    },
+  },
+
+  // Global accounts configuration (Hardhat-style)
+  // Uses PRIVATE_KEY from .env by default
+  // You can also specify accounts here directly:
+  // accounts: ["0x1234..."],
+  accounts: process.env.PRIVATE_KEY ? [process.env.PRIVATE_KEY] : [],
+
+  // Global settings
+  moveDir: "./move",
+
+  // Named addresses (can be overridden per-network in network config)
+  namedAddresses: {
+    // Example: counter: "0x1234...",
+  },
+};

package/dist/templates/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "{{projectName}}",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "test": "mocha",
+    "test:watch": "mocha --watch",
+    "deploy": "movehat run scripts/deploy-counter.ts"
+  },
+  "dependencies": {
+    "movehat": "^0.0.1-alpha.0",
+    "@aptos-labs/ts-sdk": "^5.1.5",
+    "dotenv": "^17.2.3"
+  },
+  "devDependencies": {
+    "@types/chai": "^5.2.3",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^24.10.1",
+    "chai": "^6.2.1",
+    "mocha": "^11.7.5",
+    "tsx": "^4.7.0",
+    "typescript": "^5.9.3"
+  }
+}

package/dist/templates/scripts/deploy-counter.ts

@@ -0,0 +1,48 @@
+import { getMovehat, ModuleAlreadyDeployedError } from "movehat";
+
+async function main() {
+  console.log("🚀 Deploying Counter contract...\n");
+
+  // Get the Movehat Runtime Environment
+  const mh = await getMovehat();
+
+  console.log(`✅ Runtime initialized`);
+  console.log(`   Account: ${mh.account.accountAddress.toString()}`);
+  console.log(`   Network: ${mh.network.name}`);
+  console.log(`   RPC: ${mh.network.rpc}\n`);
+
+  // Deploy (publish) the module
+  // Automatically checks if already deployed and suggests --redeploy if needed
+  const deployment = await mh.deployContract("counter");
+
+  console.log(`\n✅ Module deployed at: ${deployment.address}::counter`);
+  if (deployment.txHash) {
+    console.log(`   Transaction: ${deployment.txHash}`);
+  }
+
+  // Get contract instance
+  const counter = mh.getContract(deployment.address, "counter");
+
+  // Initialize the counter
+  console.log("\n📝 Initializing counter...");
+  const txResult = await counter.call(mh.account, "init", []);
+
+  console.log(`✅ Transaction hash: ${txResult.hash}`);
+  console.log(`✅ Counter initialized successfully!`);
+
+  // Verify
+  const value = await counter.view<number>("get", [
+    mh.account.accountAddress.toString()
+  ]);
+
+  console.log(`\n📊 Initial counter value: ${value}`);
+}
+
+main().catch((error) => {
+  // ModuleAlreadyDeployedError is already logged with full details by deployContract()
+  // For other errors, show the message
+  if (!(error instanceof ModuleAlreadyDeployedError)) {
+    console.error("❌ Deployment failed:", error?.message || error);
+  }
+  process.exit(1);
+});

package/dist/templates/tests/Counter.test.ts

@@ -0,0 +1,75 @@
+import { describe, it, before, after } from "mocha";
+import { expect } from "chai";
+import { getMovehat, type MovehatRuntime } from "movehat";
+import type { MoveContract } from "movehat/helpers";
+import { assertTransactionSuccess, snapshot } from "movehat/helpers";
+
+describe("Counter Contract", () => {
+  let mh: MovehatRuntime;
+  let counter: MoveContract;
+
+  before(async function () {
+    this.timeout(30000);
+
+    // Initialize Movehat Runtime Environment
+    mh = await getMovehat();
+
+    console.log(`\n✅ Testing on ${mh.network.name}`);
+    console.log(`   Account: ${mh.account.accountAddress.toString()}\n`);
+
+    // Get counter contract instance
+    counter = mh.getContract(
+      mh.account.accountAddress.toString(),
+      "counter"
+    );
+  });
+
+  describe("Counter functionality", () => {
+    it("should initialize counter", async function () {
+      this.timeout(30000);
+
+      const txResult = await counter.call(mh.account, "init", []);
+      assertTransactionSuccess(txResult);
+
+      const value = await counter.view<number>("get", [
+        mh.account.accountAddress.toString()
+      ]);
+
+      expect(value).to.equal(0);
+      console.log(`   ✓ Counter initialized with value: ${value}`);
+    });
+
+    it("should increment counter", async function () {
+      this.timeout(30000);
+
+      const initialValue = await counter.view<number>("get", [
+        mh.account.accountAddress.toString()
+      ]);
+
+      const txResult = await counter.call(mh.account, "increment", []);
+      assertTransactionSuccess(txResult);
+
+      const newValue = await counter.view<number>("get", [
+        mh.account.accountAddress.toString()
+      ]);
+
+      expect(newValue).to.equal(initialValue + 1);
+      console.log(`   ✓ Counter incremented: ${initialValue} → ${newValue}`);
+    });
+  });
+
+  // Optional: Create a snapshot after tests for debugging
+  // Uncomment to enable
+  /*
+  after(async function () {
+    this.timeout(30000);
+
+    const snapshotPath = await snapshot({
+      name: 'counter-test-final'
+    });
+
+    console.log(`\n📸 Snapshot created: ${snapshotPath}`);
+    console.log(`   Use 'aptos move sim view-resource --session ${snapshotPath}' to inspect state\n`);
+  });
+  */
+});