movehat 0.0.1-alpha.0

package/dist/fork/manager.js

@@ -0,0 +1,221 @@
+import { MovementApiClient } from './api.js';
+import { ForkStorage } from './storage.js';
+/**
+ * Manager for fork operations
+ * Orchestrates API client and storage
+ */
+export class ForkManager {
+    storage;
+    apiClient = null;
+    metadata = null;
+    constructor(forkPath) {
+        this.storage = new ForkStorage(forkPath);
+    }
+    /**
+     * Initialize a new fork from a network
+     */
+    async initialize(nodeUrl, networkName = 'custom') {
+        // Create API client
+        this.apiClient = new MovementApiClient(nodeUrl);
+        // Fetch network info
+        const ledgerInfo = await this.apiClient.getLedgerInfo();
+        // Create fork structure
+        this.storage.initialize();
+        // Save metadata
+        this.metadata = {
+            network: networkName,
+            nodeUrl,
+            chainId: ledgerInfo.chain_id,
+            ledgerVersion: ledgerInfo.ledger_version,
+            timestamp: ledgerInfo.ledger_timestamp,
+            epoch: ledgerInfo.epoch,
+            blockHeight: ledgerInfo.block_height,
+            createdAt: new Date().toISOString(),
+        };
+        this.storage.saveMetadata(this.metadata);
+        console.log(`✓ Fork initialized at ledger version ${ledgerInfo.ledger_version}`);
+    }
+    /**
+     * Load an existing fork
+     */
+    load() {
+        if (!this.storage.exists()) {
+            throw new Error('Fork does not exist. Run `initialize()` first.');
+        }
+        this.metadata = this.storage.loadMetadata();
+        this.apiClient = new MovementApiClient(this.metadata.nodeUrl);
+    }
+    /**
+     * Get fork metadata
+     */
+    getMetadata() {
+        if (!this.metadata) {
+            this.metadata = this.storage.loadMetadata();
+        }
+        return this.metadata;
+    }
+    /**
+     * Get account state (with lazy loading)
+     */
+    async getAccount(address) {
+        // Normalize address
+        const normalizedAddress = this.normalizeAddress(address);
+        // Check cache first
+        let accountState = this.storage.getAccount(normalizedAddress);
+        if (!accountState) {
+            // Fetch from network
+            if (!this.apiClient) {
+                throw new Error('Fork not initialized. Call initialize() or load() first.');
+            }
+            console.log(`  Fetching account ${normalizedAddress} from network...`);
+            const accountData = await this.apiClient.getAccount(normalizedAddress);
+            accountState = {
+                sequenceNumber: accountData.sequence_number,
+                authenticationKey: accountData.authentication_key,
+            };
+            // Cache it
+            this.storage.saveAccount(normalizedAddress, accountState);
+            console.log(`  ✓ Cached account ${normalizedAddress}`);
+        }
+        return accountState;
+    }
+    /**
+     * Get a specific resource (with lazy loading)
+     */
+    async getResource(address, resourceType) {
+        const normalizedAddress = this.normalizeAddress(address);
+        // Check cache first
+        let resource = this.storage.getResource(normalizedAddress, resourceType);
+        if (!resource) {
+            // Fetch from network
+            if (!this.apiClient) {
+                throw new Error('Fork not initialized. Call initialize() or load() first.');
+            }
+            console.log(`  Fetching resource ${resourceType} for ${normalizedAddress}...`);
+            try {
+                const resourceData = await this.apiClient.getAccountResource(normalizedAddress, resourceType);
+                resource = resourceData.data;
+                // Cache it
+                this.storage.saveResource(normalizedAddress, resourceType, resource);
+                console.log(`  ✓ Cached resource ${resourceType}`);
+            }
+            catch (error) {
+                if (error.message.includes('404')) {
+                    throw new Error(`Resource ${resourceType} not found for account ${normalizedAddress}`);
+                }
+                throw error;
+            }
+        }
+        return resource;
+    }
+    /**
+     * Get all resources for an account (with lazy loading)
+     */
+    async getAllResources(address) {
+        const normalizedAddress = this.normalizeAddress(address);
+        // Check if we have any cached resources
+        let resources = this.storage.getAllResources(normalizedAddress);
+        // If no cached resources, fetch all from network
+        if (Object.keys(resources).length === 0) {
+            if (!this.apiClient) {
+                throw new Error('Fork not initialized. Call initialize() or load() first.');
+            }
+            console.log(`  Fetching all resources for ${normalizedAddress}...`);
+            const resourcesList = await this.apiClient.getAccountResources(normalizedAddress);
+            resources = {};
+            for (const resource of resourcesList) {
+                resources[resource.type] = resource.data;
+            }
+            // Cache them
+            this.storage.saveAllResources(normalizedAddress, resources);
+            console.log(`  ✓ Cached ${Object.keys(resources).length} resources`);
+        }
+        return resources;
+    }
+    /**
+     * Set a resource value (for testing/mocking)
+     */
+    async setResource(address, resourceType, data) {
+        const normalizedAddress = this.normalizeAddress(address);
+        this.storage.saveResource(normalizedAddress, resourceType, data);
+        console.log(`  ✓ Updated resource ${resourceType} for ${normalizedAddress}`);
+    }
+    /**
+     * Fund an account with coins (adds to existing balance)
+     */
+    async fundAccount(address, amount, coinType = '0x1::aptos_coin::AptosCoin') {
+        const normalizedAddress = this.normalizeAddress(address);
+        const resourceType = `0x1::coin::CoinStore<${coinType}>`;
+        // Try to get existing coin store
+        let coinStore;
+        try {
+            coinStore = await this.getResource(normalizedAddress, resourceType);
+        }
+        catch (error) {
+            // Only catch "not found" errors, rethrow others (network, API, etc.)
+            if (!error.message || !error.message.includes('not found')) {
+                throw error;
+            }
+            // If doesn't exist, create new one
+            coinStore = {
+                coin: { value: '0' },
+                deposit_events: {
+                    counter: '0',
+                    guid: {
+                        id: {
+                            addr: normalizedAddress,
+                            creation_num: '0',
+                        },
+                    },
+                },
+                withdraw_events: {
+                    counter: '0',
+                    guid: {
+                        id: {
+                            addr: normalizedAddress,
+                            creation_num: '1',
+                        },
+                    },
+                },
+                frozen: false,
+            };
+        }
+        // Add to existing balance (instead of replacing it)
+        const currentBalance = BigInt(coinStore.coin.value ?? '0');
+        const newBalance = currentBalance + BigInt(amount);
+        coinStore.coin.value = newBalance.toString();
+        // Save
+        await this.setResource(normalizedAddress, resourceType, coinStore);
+        // Also ensure account exists
+        let account = this.storage.getAccount(normalizedAddress);
+        if (!account) {
+            account = {
+                sequenceNumber: '0',
+                authenticationKey: normalizedAddress.padEnd(66, '0'),
+            };
+            this.storage.saveAccount(normalizedAddress, account);
+        }
+        console.log(`  ✓ Funded ${normalizedAddress} with ${amount} coins`);
+    }
+    /**
+     * Normalize address format
+     */
+    normalizeAddress(address) {
+        let normalized = address.toLowerCase();
+        if (!normalized.startsWith('0x')) {
+            normalized = `0x${normalized}`;
+        }
+        // Pad to 66 characters (0x + 64 hex chars)
+        if (normalized.length < 66) {
+            normalized = '0x' + normalized.slice(2).padStart(64, '0');
+        }
+        return normalized;
+    }
+    /**
+     * List all accounts in the fork
+     */
+    listAccounts() {
+        return this.storage.listAccounts();
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/fork/manager.js.map

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

package/dist/fork/server.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Fork Server - Serves fork data via Movement/Aptos RPC API
+ * Emulates a Movement L1 node using local fork storage
+ */
+export declare class ForkServer {
+    private server;
+    private forkManager;
+    private port;
+    constructor(forkPath: string, port?: number);
+    /**
+     * Start the fork server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the fork server
+     */
+    stop(): Promise<void>;
+    /**
+     * Sanitize pathname for error messages to prevent log injection
+     */
+    private sanitizePathname;
+    /**
+     * Handle incoming HTTP requests
+     */
+    private handleRequest;
+    /**
+     * Handle GET /v1/ - Ledger info
+     */
+    private handleLedgerInfo;
+    /**
+     * Handle GET /v1/accounts/:address
+     */
+    private handleGetAccount;
+    /**
+     * Handle GET /v1/accounts/:address/resource/:resourceType
+     */
+    private handleGetResource;
+    /**
+     * Handle GET /v1/accounts/:address/resources
+     */
+    private handleGetResources;
+    /**
+     * Send JSON response
+     */
+    private sendJSON;
+    /**
+     * Send 404 error
+     */
+    private send404;
+    /**
+     * Send error response
+     */
+    private sendError;
+}
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/fork/server.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,IAAI,CAAS;gBAET,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAa;IAKjD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4D5B;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;YACW,aAAa;IAyD3B;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;YACW,gBAAgB;IAoB9B;;OAEG;YACW,iBAAiB;IAqB/B;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAiBhB;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;OAEG;IACH,OAAO,CAAC,SAAS;CAOlB"}

package/dist/fork/server.js

@@ -0,0 +1,274 @@
+import http from 'http';
+import { URL } from 'url';
+import { ForkManager } from './manager.js';
+/**
+ * Fork Server - Serves fork data via Movement/Aptos RPC API
+ * Emulates a Movement L1 node using local fork storage
+ */
+export class ForkServer {
+    server = null;
+    forkManager;
+    port;
+    constructor(forkPath, port = 8080) {
+        this.forkManager = new ForkManager(forkPath);
+        this.port = port;
+    }
+    /**
+     * Start the fork server
+     */
+    async start() {
+        // Load fork metadata
+        this.forkManager.load();
+        const metadata = this.forkManager.getMetadata();
+        console.log(`\nStarting Fork Server...`);
+        console.log(`  Network: ${metadata.network}`);
+        console.log(`  Chain ID: ${metadata.chainId}`);
+        console.log(`  Ledger Version: ${metadata.ledgerVersion}`);
+        console.log(`  Forked at: ${metadata.createdAt}`);
+        this.server = http.createServer((req, res) => {
+            this.handleRequest(req, res).catch((error) => {
+                // Log full error server-side for diagnostics
+                console.error(`Error handling request:`, error);
+                // Only send response if headers haven't been sent yet
+                if (!res.headersSent) {
+                    // Add CORS headers (same as in handleRequest)
+                    res.setHeader('Access-Control-Allow-Origin', '*');
+                    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+                    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+                    // Send generic error response (no internal details exposed)
+                    this.sendJSON(res, 500, {
+                        message: 'Internal server error',
+                        error_code: 'internal_error',
+                        vm_error_code: null
+                    });
+                }
+            });
+        });
+        return new Promise((resolve, reject) => {
+            // Handle server errors (port in use, permission denied, etc.)
+            const onError = (error) => {
+                if (error.code === 'EADDRINUSE') {
+                    reject(new Error(`Port ${this.port} is already in use. Please use a different port with --port <number>`));
+                }
+                else if (error.code === 'EACCES') {
+                    reject(new Error(`Permission denied to bind to port ${this.port}. Try using a port above 1024 or run with appropriate permissions.`));
+                }
+                else {
+                    reject(new Error(`Failed to start server: ${error.message}`));
+                }
+            };
+            // Listen for errors during startup
+            this.server.once('error', onError);
+            this.server.listen(this.port, () => {
+                // Remove error listener after successful start
+                this.server.removeListener('error', onError);
+                console.log(`\nFork Server listening on http://localhost:${this.port}`);
+                console.log(`  Ledger Info: http://localhost:${this.port}/v1/`);
+                console.log(`\nPress Ctrl+C to stop`);
+                resolve();
+            });
+        });
+    }
+    /**
+     * Stop the fork server
+     */
+    stop() {
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.close(() => {
+                    console.log('\nFork Server stopped');
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    /**
+     * Sanitize pathname for error messages to prevent log injection
+     */
+    sanitizePathname(pathname) {
+        // Remove control characters and newlines
+        const sanitized = pathname.replace(/[\x00-\x1F\x7F]/g, '');
+        // Truncate to reasonable length
+        return sanitized.length > 100 ? sanitized.substring(0, 100) + '...' : sanitized;
+    }
+    /**
+     * Handle incoming HTTP requests
+     */
+    async handleRequest(req, res) {
+        const url = new URL(req.url || '/', `http://localhost:${this.port}`);
+        const pathname = url.pathname;
+        // Log request
+        console.log(`[${new Date().toISOString()}] ${req.method} ${pathname}`);
+        // CORS headers
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+        // Handle OPTIONS for CORS preflight
+        if (req.method === 'OPTIONS') {
+            res.writeHead(200);
+            res.end();
+            return;
+        }
+        try {
+            // Route requests
+            if (pathname === '/v1' || pathname === '/v1/') {
+                await this.handleLedgerInfo(res);
+            }
+            else if (pathname.match(/^\/v1\/accounts\/0x[a-fA-F0-9]{1,64}$/)) {
+                const address = pathname.split('/').pop();
+                await this.handleGetAccount(address, res);
+            }
+            else if (pathname.match(/^\/v1\/accounts\/0x[a-fA-F0-9]{1,64}\/resource\/.+$/)) {
+                const parts = pathname.split('/');
+                const accountIndex = parts.indexOf('accounts') + 1;
+                const resourceIndex = parts.indexOf('resource') + 1;
+                const address = parts[accountIndex];
+                const resourceType = decodeURIComponent(parts.slice(resourceIndex).join('/'));
+                await this.handleGetResource(address, resourceType, res);
+            }
+            else {
+                // Use regex capture for resources endpoint
+                const resourcesMatch = pathname.match(/^\/v1\/accounts\/(0x[a-fA-F0-9]{1,64})\/resources$/);
+                if (resourcesMatch) {
+                    const address = resourcesMatch[1];
+                    await this.handleGetResources(address, res);
+                }
+                else {
+                    // Sanitize pathname to prevent log injection
+                    const safePath = this.sanitizePathname(pathname);
+                    this.send404(res, `Endpoint not found: ${safePath}`, 'endpoint_not_found');
+                }
+            }
+        }
+        catch (error) {
+            // Log full error server-side for diagnostics
+            console.error('Error handling request:', error);
+            // Send generic error to client (don't expose internal details)
+            this.sendError(res, 500, 'Internal server error');
+        }
+    }
+    /**
+     * Handle GET /v1/ - Ledger info
+     */
+    async handleLedgerInfo(res) {
+        const metadata = this.forkManager.getMetadata();
+        const ledgerInfo = {
+            chain_id: metadata.chainId,
+            epoch: metadata.epoch,
+            ledger_version: metadata.ledgerVersion,
+            oldest_ledger_version: "0",
+            ledger_timestamp: metadata.timestamp,
+            node_role: "full_node",
+            oldest_block_height: "0",
+            block_height: metadata.blockHeight,
+            git_hash: "movehat-fork"
+        };
+        this.sendJSON(res, 200, ledgerInfo, {
+            'x-aptos-chain-id': String(metadata.chainId),
+            'x-aptos-ledger-version': metadata.ledgerVersion,
+            'x-aptos-ledger-oldest-version': '0',
+            'x-aptos-ledger-timestampusec': metadata.timestamp,
+            'x-aptos-epoch': metadata.epoch,
+            'x-aptos-block-height': metadata.blockHeight,
+            'x-aptos-oldest-block-height': '0'
+        });
+    }
+    /**
+     * Handle GET /v1/accounts/:address
+     */
+    async handleGetAccount(address, res) {
+        try {
+            const account = await this.forkManager.getAccount(address);
+            this.sendJSON(res, 200, {
+                sequence_number: account.sequenceNumber,
+                authentication_key: account.authenticationKey
+            });
+        }
+        catch (error) {
+            if (error.message.includes('not found')) {
+                this.send404(res, `Account not found: ${address}`);
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Handle GET /v1/accounts/:address/resource/:resourceType
+     */
+    async handleGetResource(address, resourceType, res) {
+        try {
+            const resource = await this.forkManager.getResource(address, resourceType);
+            this.sendJSON(res, 200, {
+                type: resourceType,
+                data: resource
+            });
+        }
+        catch (error) {
+            if (error.message.includes('not found')) {
+                this.send404(res, `Resource not found: ${resourceType}`, 'resource_not_found');
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Handle GET /v1/accounts/:address/resources
+     */
+    async handleGetResources(address, res) {
+        try {
+            const resources = await this.forkManager.getAllResources(address);
+            // Convert to array format expected by Aptos API
+            const resourcesArray = Object.entries(resources).map(([type, data]) => ({
+                type,
+                data
+            }));
+            this.sendJSON(res, 200, resourcesArray);
+        }
+        catch (error) {
+            if (error.message.includes('not found')) {
+                this.send404(res, `Account not found: ${address}`);
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Send JSON response
+     */
+    sendJSON(res, status, data, extraHeaders = {}) {
+        const body = JSON.stringify(data, null, 2);
+        res.writeHead(status, {
+            'Content-Type': 'application/json',
+            'Content-Length': Buffer.byteLength(body),
+            ...extraHeaders
+        });
+        res.end(body);
+    }
+    /**
+     * Send 404 error
+     */
+    send404(res, message, errorCode = 'account_not_found') {
+        this.sendJSON(res, 404, {
+            message,
+            error_code: errorCode,
+            vm_error_code: null
+        });
+    }
+    /**
+     * Send error response
+     */
+    sendError(res, status, message) {
+        this.sendJSON(res, status, {
+            message,
+            error_code: 'internal_error',
+            vm_error_code: null
+        });
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/fork/server.js.map

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

package/dist/fork/storage.d.ts

@@ -0,0 +1,63 @@
+import type { ForkMetadata, AccountState } from '../types/fork.js';
+/**
+ * Storage system for fork state
+ * Manages the file structure and I/O for fork data
+ */
+export declare class ForkStorage {
+    private forkPath;
+    constructor(forkPath: string);
+    /**
+     * Get safe resource file path for an address
+     * Prevents path traversal attacks
+     */
+    private getResourceFilePath;
+    /**
+     * Initialize fork directory structure
+     */
+    initialize(): void;
+    /**
+     * Check if fork exists
+     */
+    exists(): boolean;
+    /**
+     * Save fork metadata
+     */
+    saveMetadata(metadata: ForkMetadata): void;
+    /**
+     * Load fork metadata
+     */
+    loadMetadata(): ForkMetadata;
+    /**
+     * Get account state
+     */
+    getAccount(address: string): AccountState | null;
+    /**
+     * Save account state
+     */
+    saveAccount(address: string, state: AccountState): void;
+    /**
+     * Get resource for an account
+     */
+    getResource(address: string, resourceType: string): any | null;
+    /**
+     * Get all resources for an account
+     */
+    getAllResources(address: string): Record<string, any>;
+    /**
+     * Save resource for an account
+     */
+    saveResource(address: string, resourceType: string, data: any): void;
+    /**
+     * Save all resources for an account
+     */
+    saveAllResources(address: string, resources: Record<string, any>): void;
+    /**
+     * Check if resource is cached
+     */
+    hasResource(address: string, resourceType: string): boolean;
+    /**
+     * List all accounts in the fork
+     */
+    listAccounts(): string[];
+}
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/fork/storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA2BnE;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,UAAU,IAAI,IAAI;IA8BlB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAK1C;;OAEG;IACH,YAAY,IAAI,YAAY;IAW5B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAWhD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAYvD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAW9D;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAUrD;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAkBpE;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAYvE;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAI3D;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;CAUzB"}