movehat 0.0.1-alpha.0

package/dist/fork/storage.js

@@ -0,0 +1,183 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+/**
+ * Sanitize address to create a safe filename
+ * Prevents path traversal by encoding the address
+ */
+function sanitizeAddressForFilename(address) {
+    // Remove any path separators and normalize
+    const normalized = address.toLowerCase().replace(/^0x/, '');
+    // Validate that it's a valid hex string
+    if (!/^[0-9a-f]+$/.test(normalized)) {
+        throw new Error(`Invalid address format: ${address}. Expected hexadecimal string.`);
+    }
+    // Encode to prevent any path traversal
+    // Use the normalized hex string directly as it's safe
+    const safe = `0x${normalized}`;
+    // Validate no path separators in result
+    if (safe.includes('/') || safe.includes('\\') || safe.includes('..')) {
+        throw new Error(`Address contains invalid characters: ${address}`);
+    }
+    return safe;
+}
+/**
+ * Storage system for fork state
+ * Manages the file structure and I/O for fork data
+ */
+export class ForkStorage {
+    forkPath;
+    constructor(forkPath) {
+        this.forkPath = forkPath;
+    }
+    /**
+     * Get safe resource file path for an address
+     * Prevents path traversal attacks
+     */
+    getResourceFilePath(address) {
+        const safeFilename = sanitizeAddressForFilename(address);
+        return join(this.forkPath, 'resources', `${safeFilename}.json`);
+    }
+    /**
+     * Initialize fork directory structure
+     */
+    initialize() {
+        // Create main fork directory
+        if (!existsSync(this.forkPath)) {
+            mkdirSync(this.forkPath, { recursive: true });
+        }
+        // Create subdirectories
+        const resourcesDir = join(this.forkPath, 'resources');
+        if (!existsSync(resourcesDir)) {
+            mkdirSync(resourcesDir, { recursive: true });
+        }
+        const cacheDir = join(this.forkPath, 'cache');
+        if (!existsSync(cacheDir)) {
+            mkdirSync(cacheDir, { recursive: true });
+        }
+        // Create .gitignore for cache
+        const gitignorePath = join(cacheDir, '.gitignore');
+        if (!existsSync(gitignorePath)) {
+            writeFileSync(gitignorePath, '*\n!.gitignore\n');
+        }
+        // Initialize accounts.json if it doesn't exist
+        const accountsPath = join(this.forkPath, 'accounts.json');
+        if (!existsSync(accountsPath)) {
+            writeFileSync(accountsPath, JSON.stringify({}, null, 2));
+        }
+    }
+    /**
+     * Check if fork exists
+     */
+    exists() {
+        return existsSync(this.forkPath) && existsSync(join(this.forkPath, 'metadata.json'));
+    }
+    /**
+     * Save fork metadata
+     */
+    saveMetadata(metadata) {
+        const metadataPath = join(this.forkPath, 'metadata.json');
+        writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
+    }
+    /**
+     * Load fork metadata
+     */
+    loadMetadata() {
+        const metadataPath = join(this.forkPath, 'metadata.json');
+        if (!existsSync(metadataPath)) {
+            throw new Error(`Fork metadata not found at ${metadataPath}`);
+        }
+        const data = readFileSync(metadataPath, 'utf-8');
+        return JSON.parse(data);
+    }
+    /**
+     * Get account state
+     */
+    getAccount(address) {
+        const accountsPath = join(this.forkPath, 'accounts.json');
+        if (!existsSync(accountsPath)) {
+            return null;
+        }
+        const accounts = JSON.parse(readFileSync(accountsPath, 'utf-8'));
+        return accounts[address] || null;
+    }
+    /**
+     * Save account state
+     */
+    saveAccount(address, state) {
+        const accountsPath = join(this.forkPath, 'accounts.json');
+        let accounts = {};
+        if (existsSync(accountsPath)) {
+            accounts = JSON.parse(readFileSync(accountsPath, 'utf-8'));
+        }
+        accounts[address] = state;
+        writeFileSync(accountsPath, JSON.stringify(accounts, null, 2));
+    }
+    /**
+     * Get resource for an account
+     */
+    getResource(address, resourceType) {
+        const resourceFilePath = this.getResourceFilePath(address);
+        if (!existsSync(resourceFilePath)) {
+            return null;
+        }
+        const resources = JSON.parse(readFileSync(resourceFilePath, 'utf-8'));
+        return resources[resourceType] || null;
+    }
+    /**
+     * Get all resources for an account
+     */
+    getAllResources(address) {
+        const resourceFilePath = this.getResourceFilePath(address);
+        if (!existsSync(resourceFilePath)) {
+            return {};
+        }
+        return JSON.parse(readFileSync(resourceFilePath, 'utf-8'));
+    }
+    /**
+     * Save resource for an account
+     */
+    saveResource(address, resourceType, data) {
+        const resourceFilePath = this.getResourceFilePath(address);
+        // Ensure resources directory exists
+        const resourcesDir = join(this.forkPath, 'resources');
+        if (!existsSync(resourcesDir)) {
+            mkdirSync(resourcesDir, { recursive: true });
+        }
+        let resources = {};
+        if (existsSync(resourceFilePath)) {
+            resources = JSON.parse(readFileSync(resourceFilePath, 'utf-8'));
+        }
+        resources[resourceType] = data;
+        writeFileSync(resourceFilePath, JSON.stringify(resources, null, 2));
+    }
+    /**
+     * Save all resources for an account
+     */
+    saveAllResources(address, resources) {
+        const resourceFilePath = this.getResourceFilePath(address);
+        // Ensure resources directory exists
+        const resourcesDir = join(this.forkPath, 'resources');
+        if (!existsSync(resourcesDir)) {
+            mkdirSync(resourcesDir, { recursive: true });
+        }
+        writeFileSync(resourceFilePath, JSON.stringify(resources, null, 2));
+    }
+    /**
+     * Check if resource is cached
+     */
+    hasResource(address, resourceType) {
+        return this.getResource(address, resourceType) !== null;
+    }
+    /**
+     * List all accounts in the fork
+     */
+    listAccounts() {
+        const accountsPath = join(this.forkPath, 'accounts.json');
+        if (!existsSync(accountsPath)) {
+            return [];
+        }
+        const accounts = JSON.parse(readFileSync(accountsPath, 'utf-8'));
+        return Object.keys(accounts);
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/fork/storage.js.map

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

package/dist/fork/test.d.ts

@@ -0,0 +1,75 @@
+export interface SnapshotOptions {
+    path?: string;
+    name?: string;
+}
+export interface ForkInfo {
+    path: string;
+    networkVersion?: number;
+    nodeUrl?: string;
+    exists: boolean;
+}
+/**
+ * Create a snapshot (fork) of the current network state
+ * Useful for debugging test failures or inspecting state after tests
+ *
+ * @param options - Snapshot configuration
+ * @returns Path to the created snapshot
+ *
+ * @example
+ * ```typescript
+ * // In your test
+ * after(async () => {
+ *   const snapshotPath = await snapshot({ name: 'after-counter-test' });
+ *   console.log(`Snapshot saved to ${snapshotPath}`);
+ * });
+ * ```
+ */
+export declare function snapshot(options?: SnapshotOptions): Promise<string>;
+/**
+ * Get information about a fork/snapshot
+ *
+ * @param path - Path to the fork directory
+ * @returns Fork information
+ */
+export declare function getForkInfo(path: string): Promise<ForkInfo>;
+/**
+ * View a resource from a fork/snapshot
+ * Useful for inspecting state without modifying it
+ *
+ * @param sessionPath - Path to the fork session
+ * @param account - Account address
+ * @param resourceType - Full resource type (e.g., '0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>')
+ * @returns Resource data
+ *
+ * @example
+ * ```typescript
+ * const balance = await viewForkResource(
+ *   '.movehat/snapshots/test-snapshot',
+ *   '0x123...',
+ *   '0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>'
+ * );
+ * console.log(`Balance: ${balance.coin.value}`);
+ * ```
+ */
+export declare function viewForkResource(sessionPath: string, account: string, resourceType: string): Promise<any>;
+/**
+ * Compare a resource between current network state and a fork
+ * Useful for verifying state changes after tests
+ *
+ * @param forkPath - Path to the fork
+ * @param account - Account address
+ * @param resourceType - Resource type to compare
+ * @param currentValue - Current value from network (pass from your test)
+ * @returns Comparison result
+ */
+export declare function compareForkState(forkPath: string, account: string, resourceType: string, currentValue: any): Promise<{
+    fork: any;
+    current: any;
+    changed: boolean;
+}>;
+/**
+ * List all snapshots in the project
+ * @returns Array of snapshot paths
+ */
+export declare function listSnapshots(): Promise<string[]>;
+//# sourceMappingURL=test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/fork/test.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B7E;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA2BjE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,GAAG,CAAC,CAyBd;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,GAAG,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAQxD;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAavD"}

package/dist/fork/test.js

@@ -0,0 +1,157 @@
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { join } from 'path';
+import { existsSync } from 'fs';
+const execFileAsync = promisify(execFile);
+/**
+ * Create a snapshot (fork) of the current network state
+ * Useful for debugging test failures or inspecting state after tests
+ *
+ * @param options - Snapshot configuration
+ * @returns Path to the created snapshot
+ *
+ * @example
+ * ```typescript
+ * // In your test
+ * after(async () => {
+ *   const snapshotPath = await snapshot({ name: 'after-counter-test' });
+ *   console.log(`Snapshot saved to ${snapshotPath}`);
+ * });
+ * ```
+ */
+export async function snapshot(options = {}) {
+    const name = options.name || `snapshot-${Date.now()}`;
+    const snapshotPath = options.path || join(process.cwd(), '.movehat', 'snapshots', name);
+    console.log(`📸 Creating snapshot: ${name}...`);
+    try {
+        // Initialize fork/snapshot using aptos CLI
+        // Use execFile with argument array to prevent command injection
+        const { stdout, stderr } = await execFileAsync('aptos', [
+            'move',
+            'sim',
+            'init',
+            '--path',
+            snapshotPath
+        ]);
+        if (stderr && !stderr.includes('Success')) {
+            throw new Error(stderr);
+        }
+        if (!existsSync(snapshotPath)) {
+            throw new Error('Snapshot directory was not created');
+        }
+        console.log(`   ✓ Snapshot created at ${snapshotPath}`);
+        return snapshotPath;
+    }
+    catch (error) {
+        throw new Error(`Failed to create snapshot: ${error.message}`);
+    }
+}
+/**
+ * Get information about a fork/snapshot
+ *
+ * @param path - Path to the fork directory
+ * @returns Fork information
+ */
+export async function getForkInfo(path) {
+    const configPath = join(path, 'config.json');
+    if (!existsSync(configPath)) {
+        return {
+            path,
+            exists: false
+        };
+    }
+    try {
+        const fs = await import('fs/promises');
+        const configContent = await fs.readFile(configPath, 'utf-8');
+        const config = JSON.parse(configContent);
+        return {
+            path,
+            exists: true,
+            networkVersion: config.base?.Remote?.network_version,
+            nodeUrl: config.base?.Remote?.node_url
+        };
+    }
+    catch (error) {
+        return {
+            path,
+            exists: false
+        };
+    }
+}
+/**
+ * View a resource from a fork/snapshot
+ * Useful for inspecting state without modifying it
+ *
+ * @param sessionPath - Path to the fork session
+ * @param account - Account address
+ * @param resourceType - Full resource type (e.g., '0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>')
+ * @returns Resource data
+ *
+ * @example
+ * ```typescript
+ * const balance = await viewForkResource(
+ *   '.movehat/snapshots/test-snapshot',
+ *   '0x123...',
+ *   '0x1::coin::CoinStore<0x1::aptos_coin::AptosCoin>'
+ * );
+ * console.log(`Balance: ${balance.coin.value}`);
+ * ```
+ */
+export async function viewForkResource(sessionPath, account, resourceType) {
+    try {
+        // Use execFile with argument array to prevent command injection
+        const { stdout } = await execFileAsync('aptos', [
+            'move',
+            'sim',
+            'view-resource',
+            '--session',
+            sessionPath,
+            '--account',
+            account,
+            '--resource',
+            resourceType
+        ]);
+        const result = JSON.parse(stdout);
+        if (result.Error) {
+            throw new Error(result.Error);
+        }
+        return result.Result;
+    }
+    catch (error) {
+        throw new Error(`Failed to view resource: ${error.message}`);
+    }
+}
+/**
+ * Compare a resource between current network state and a fork
+ * Useful for verifying state changes after tests
+ *
+ * @param forkPath - Path to the fork
+ * @param account - Account address
+ * @param resourceType - Resource type to compare
+ * @param currentValue - Current value from network (pass from your test)
+ * @returns Comparison result
+ */
+export async function compareForkState(forkPath, account, resourceType, currentValue) {
+    const forkValue = await viewForkResource(forkPath, account, resourceType);
+    return {
+        fork: forkValue,
+        current: currentValue,
+        changed: JSON.stringify(forkValue) !== JSON.stringify(currentValue)
+    };
+}
+/**
+ * List all snapshots in the project
+ * @returns Array of snapshot paths
+ */
+export async function listSnapshots() {
+    const snapshotsDir = join(process.cwd(), '.movehat', 'snapshots');
+    if (!existsSync(snapshotsDir)) {
+        return [];
+    }
+    const fs = await import('fs/promises');
+    const entries = await fs.readdir(snapshotsDir, { withFileTypes: true });
+    return entries
+        .filter(entry => entry.isDirectory())
+        .map(entry => join(snapshotsDir, entry.name));
+}
+//# sourceMappingURL=test.js.map

package/dist/fork/test.js.map

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

package/dist/helpers/assertions.d.ts

@@ -0,0 +1,7 @@
+import { type TransactionResult } from "../core/contract.js";
+/**
+ * Assert that a transaction was successful
+ */
+export declare function assertTransactionSuccess(result: TransactionResult): void;
+export declare function assertTransactionFailed(result: TransactionResult, expectedError?: string): void;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/helpers/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../src/helpers/assertions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAMxE;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,EACzB,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAYN"}

package/dist/helpers/assertions.js

@@ -0,0 +1,17 @@
+/**
+ * Assert that a transaction was successful
+ */
+export function assertTransactionSuccess(result) {
+    if (!result.success) {
+        throw new Error(`Transaction failed with status: ${result.vm_status}\nHash: ${result.hash}`);
+    }
+}
+export function assertTransactionFailed(result, expectedError) {
+    if (result.success) {
+        throw new Error(`Transaction was expected to fail but succeeded.\nHash: ${result.hash}`);
+    }
+    if (expectedError && !result.vm_status.includes(expectedError)) {
+        throw new Error(`Transaction failed with unexpected error.\nExpected to include: ${expectedError}\nActual status: ${result.vm_status}\nHash: ${result.hash}`);
+    }
+}
+//# sourceMappingURL=assertions.js.map

package/dist/helpers/assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../../src/helpers/assertions.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAyB;IAChE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,mCAAmC,MAAM,CAAC,SAAS,WAAW,MAAM,CAAC,IAAI,EAAE,CAC5E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAAyB,EACzB,aAAsB;IAEtB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,0DAA0D,MAAM,CAAC,IAAI,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,IAAG,aAAa,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,mEAAmE,aAAa,oBAAoB,MAAM,CAAC,SAAS,WAAW,MAAM,CAAC,IAAI,EAAE,CAC7I,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/helpers/banner.d.ts

@@ -0,0 +1,3 @@
+export declare const renderMovehatBanner: () => string;
+export declare const printMovehatBanner: () => void;
+//# sourceMappingURL=banner.d.ts.map

package/dist/helpers/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/helpers/banner.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,mBAAmB,cAO/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAE9B,CAAC"}

package/dist/helpers/banner.js

@@ -0,0 +1,38 @@
+// Warm yellow-to-amber palette for a subtle gradient.
+const gradientPalette = [
+    [255, 239, 150],
+    [255, 223, 88],
+    [255, 207, 64],
+    [255, 181, 45],
+    [255, 160, 30],
+];
+const bannerLines = [
+    " ███╗   ███╗ ██████╗ ██╗   ██╗███████╗██╗  ██╗ █████╗ ████████╗",
+    " ████╗ ████║██╔═══██╗██║   ██║██╔════╝██║  ██║██╔══██╗╚══██╔══╝",
+    " ██╔████╔██║██║   ██║██║   ██║█████╗  ███████║███████║   ██║   ",
+    " ██║╚██╔╝██║██║   ██║╚██╗ ██╔╝██╔══╝  ██╔══██║██╔══██║   ██║   ",
+    " ██║ ╚═╝ ██║╚██████╔╝ ╚████╔╝ ███████╗██║  ██║██║  ██║   ██║   ",
+    " ╚═╝     ╚═╝ ╚═════╝   ╚═══╝  ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝   ",
+];
+const reset = "\x1b[0m";
+const shouldColorize = () => process.env.NO_COLOR === undefined && Boolean(process.stdout.isTTY);
+const toAnsi = ([r, g, b]) => `\x1b[38;2;${r};${g};${b}m`;
+const applyGradient = (line, offset) => {
+    let painted = "";
+    for (let i = 0; i < line.length; i++) {
+        const color = gradientPalette[(i + offset) % gradientPalette.length];
+        painted += `${toAnsi(color)}${line[i]}`;
+    }
+    return painted;
+};
+export const renderMovehatBanner = () => {
+    if (!shouldColorize()) {
+        return bannerLines.join("\n");
+    }
+    const coloredLines = bannerLines.map((line, idx) => applyGradient(line, idx * 2));
+    return `${coloredLines.join("\n")}${reset}`;
+};
+export const printMovehatBanner = () => {
+    console.log(renderMovehatBanner());
+};
+//# sourceMappingURL=banner.js.map

package/dist/helpers/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/helpers/banner.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,MAAM,eAAe,GAAU;IAC7B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACf,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;IACd,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;IACd,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;IACd,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,WAAW,GAAG;IAClB,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;CAClE,CAAC;AAEF,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEjG,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAM,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAE/D,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,EAAE;IACrD,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACrE,OAAO,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE;IACtC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAClF,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAAC;AACrC,CAAC,CAAC"}

package/dist/helpers/index.d.ts

@@ -0,0 +1,11 @@
+export { setupTestEnvironment, createTestAccount } from "./setup.js";
+export type { TestEnvironment } from "./setup.js";
+export { MoveContract, getContract } from "../core/contract.js";
+export type { TransactionResult } from "../core/contract.js";
+export { assertTransactionSuccess, assertTransactionFailed, } from "./assertions.js";
+export { saveDeployment, loadDeployment, getAllDeployments, getDeployedAddress, } from "../core/deployments.js";
+export type { DeploymentInfo } from "../core/deployments.js";
+export { snapshot, getForkInfo, viewForkResource, compareForkState, listSnapshots, } from "../fork/test.js";
+export type { SnapshotOptions, ForkInfo } from "../fork/test.js";
+export type { MovehatConfig } from "../types/config.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEjE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/helpers/index.js

@@ -0,0 +1,7 @@
+// Re-export all helpers
+export { setupTestEnvironment, createTestAccount } from "./setup.js";
+export { MoveContract, getContract } from "../core/contract.js";
+export { assertTransactionSuccess, assertTransactionFailed, } from "./assertions.js";
+export { saveDeployment, loadDeployment, getAllDeployments, getDeployedAddress, } from "../core/deployments.js";
+export { snapshot, getForkInfo, viewForkResource, compareForkState, listSnapshots, } from "../fork/test.js";
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/helpers/setup.d.ts

@@ -0,0 +1,10 @@
+import { Account, Aptos } from "@aptos-labs/ts-sdk";
+import { MovehatConfig } from "../types/config.js";
+export interface TestEnvironment {
+    aptos: Aptos;
+    account: Account;
+    config: MovehatConfig;
+}
+export declare function setupTestEnvironment(networkName?: string): Promise<TestEnvironment>;
+export declare function createTestAccount(): Account;
+//# sourceMappingURL=setup.d.ts.map

package/dist/helpers/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/helpers/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,EAIN,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,wBAAsB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA0BzF;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/helpers/setup.js

@@ -0,0 +1,28 @@
+import { Account, Aptos, AptosConfig, Ed25519PrivateKey, } from "@aptos-labs/ts-sdk";
+import { loadUserConfig, resolveNetworkConfig } from "../core/config.js";
+export async function setupTestEnvironment(networkName) {
+    // Load and resolve config for selected network
+    const userConfig = await loadUserConfig();
+    const network = networkName || process.env.MH_CLI_NETWORK;
+    const config = await resolveNetworkConfig(userConfig, network);
+    const aptosConfig = new AptosConfig({
+        network: config.network,
+        fullnode: config.rpc,
+    });
+    const aptos = new Aptos(aptosConfig);
+    const privateKey = new Ed25519PrivateKey(config.privateKey);
+    const account = Account.fromPrivateKey({ privateKey });
+    console.log(`✅ Test environment ready`);
+    console.log(`   Account: ${account.accountAddress.toString()}`);
+    console.log(`   Network: ${config.network}`);
+    console.log(`   RPC: ${config.rpc}\n`);
+    return {
+        aptos,
+        account,
+        config,
+    };
+}
+export function createTestAccount() {
+    return Account.generate();
+}
+//# sourceMappingURL=setup.js.map

package/dist/helpers/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/helpers/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,EACL,WAAW,EACX,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AASzE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAoB;IAC7D,+CAA+C;IAC/C,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAE/D,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;QAClC,OAAO,EAAE,MAAM,CAAC,OAAkB;QAClC,QAAQ,EAAE,MAAM,CAAC,GAAG;KACrB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;IAErC,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAEvD,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC,OAAO;QACL,KAAK;QACL,OAAO;QACP,MAAM;KACP,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC7B,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./helpers/index.js";
+export type { MovehatConfig } from "./types/config.js";
+export { initRuntime, getRuntime, getMovehat, mh } from "./runtime.js";
+export type { MovehatRuntime, NetworkInfo } from "./types/runtime.js";
+export { ForkManager } from "./fork/manager.js";
+export { MovementApiClient } from "./fork/api.js";
+export { ForkStorage } from "./fork/storage.js";
+export { ForkServer } from "./fork/server.js";
+export type { ForkMetadata, AccountState, LedgerInfo, AccountData, AccountResource } from "./types/fork.js";
+export { ModuleAlreadyDeployedError } from "./errors.js";
+//# 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":"AACA,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG5G,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// Export all helpers for end users
+export * from "./helpers/index.js";
+// Export Movehat Runtime Environment
+export { initRuntime, getRuntime, getMovehat, mh } from "./runtime.js";
+// Export Fork system
+export { ForkManager } from "./fork/manager.js";
+export { MovementApiClient } from "./fork/api.js";
+export { ForkStorage } from "./fork/storage.js";
+export { ForkServer } from "./fork/server.js";
+// Export custom errors
+export { ModuleAlreadyDeployedError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,cAAc,oBAAoB,CAAC;AAGnC,qCAAqC;AACrC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAGvE,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,uBAAuB;AACvB,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}