awal 1.0.0

package/dist/utils/serverManager.js

@@ -0,0 +1,167 @@
+import envPaths from 'env-paths';
+import { spawn, execSync } from 'child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync } from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { getPrimaryProcessPid } from './processCheck.js';
+const paths = envPaths('awal');
+// This will be updated by the build script
+const BUNDLE_VERSION = '1.0.0';
+function getServerPaths() {
+    const dataDir = paths.data;
+    const bundleDir = path.join(dataDir, 'server');
+    // Electron binary location depends on platform
+    const electronBinName = process.platform === 'win32' ? 'electron.cmd' : 'electron';
+    return {
+        dataDir,
+        bundleDir,
+        versionFile: path.join(bundleDir, '.version'),
+        electronBin: path.join(bundleDir, 'node_modules', '.bin', electronBinName),
+        bundleElectron: path.join(bundleDir, 'bundle-electron.js'),
+    };
+}
+/**
+ * Checks if the server bundle is installed and up to date
+ */
+async function isServerInstalled() {
+    const { versionFile, electronBin, bundleElectron } = getServerPaths();
+    // Check all required files exist
+    if (!existsSync(versionFile) || !existsSync(electronBin) || !existsSync(bundleElectron)) {
+        return false;
+    }
+    // Check version matches
+    try {
+        const installedVersion = readFileSync(versionFile, 'utf-8').trim();
+        return installedVersion === BUNDLE_VERSION;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Gets the path to the bundled server files within the npm package
+ */
+function getPackageBundleDir() {
+    // This file is at dist/utils/serverManager.js
+    // Server bundle is at server-bundle/
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    return path.join(__dirname, '..', '..', 'server-bundle');
+}
+/**
+ * Installs the server bundle to the user's data directory
+ */
+async function installServer(onProgress) {
+    const { bundleDir, versionFile, dataDir } = getServerPaths();
+    const packageBundleDir = getPackageBundleDir();
+    // Verify package bundle exists
+    if (!existsSync(packageBundleDir)) {
+        throw new Error(`Server bundle not found at ${packageBundleDir}. Package may be corrupted.`);
+    }
+    // Create data directory if needed
+    if (!existsSync(dataDir)) {
+        mkdirSync(dataDir, { recursive: true, mode: 0o700 });
+    }
+    // Copy bundled server files from package
+    onProgress?.('Copying server bundle...');
+    // Remove existing bundle if present
+    if (existsSync(bundleDir)) {
+        // Use rm -rf for cross-platform removal
+        try {
+            execSync(`rm -rf "${bundleDir}"`, { stdio: 'pipe' });
+        }
+        catch {
+            // Fallback: try to overwrite
+        }
+    }
+    cpSync(packageBundleDir, bundleDir, { recursive: true });
+    // Install Electron (the heavy dependency)
+    onProgress?.('Installing Electron runtime (one-time setup, may take a minute)...');
+    await new Promise((resolve, reject) => {
+        const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+        const child = spawn(npmCmd, ['install', '--omit=dev'], {
+            cwd: bundleDir,
+            stdio: 'inherit',
+            shell: process.platform === 'win32',
+        });
+        child.on('error', (err) => reject(new Error(`npm install failed: ${err.message}`)));
+        child.on('exit', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`npm install failed with exit code ${code}`));
+            }
+        });
+    });
+    // Write version marker
+    writeFileSync(versionFile, BUNDLE_VERSION, { mode: 0o600 });
+}
+/**
+ * Spawns the Electron server process in the background
+ */
+async function spawnServer() {
+    const { electronBin, bundleElectron } = getServerPaths();
+    // Verify electron exists
+    if (!existsSync(electronBin)) {
+        throw new Error(`Electron not found at ${electronBin}. Try reinstalling with: rm -rf ~/.local/share/awal && awal status`);
+    }
+    const child = spawn(electronBin, [bundleElectron], {
+        detached: true,
+        stdio: 'ignore',
+        env: {
+            ...process.env,
+            STARTED_BY_CLI: 'true',
+            WALLET_STANDALONE: 'true',
+        },
+    });
+    // Don't wait for child, detach it
+    child.unref();
+    // Wait for server to initialize (poll for lock file)
+    const maxWaitMs = 30000;
+    const pollIntervalMs = 500;
+    const startTime = Date.now();
+    while (Date.now() - startTime < maxWaitMs) {
+        await new Promise(r => setTimeout(r, pollIntervalMs));
+        if (getPrimaryProcessPid() !== null) {
+            // Server is running, give it time to fully initialize
+            // (Electron + React app + IPC handlers)
+            await new Promise(r => setTimeout(r, 8000));
+            return;
+        }
+    }
+    throw new Error('Server failed to start within timeout');
+}
+/**
+ * Ensures the server is running, installing if needed
+ * @returns true if server is running, false on failure
+ */
+export async function ensureServerRunning(onInstalling, onStarting) {
+    // Check if already running
+    if (getPrimaryProcessPid() !== null) {
+        return true;
+    }
+    try {
+        // Install if needed
+        if (!(await isServerInstalled())) {
+            onInstalling?.();
+            await installServer((msg) => {
+                // Progress messages are logged by the install process via stdio: 'inherit'
+            });
+        }
+        // Start server
+        onStarting?.();
+        await spawnServer();
+        return getPrimaryProcessPid() !== null;
+    }
+    catch (error) {
+        console.error('Failed to start server:', error instanceof Error ? error.message : error);
+        return false;
+    }
+}
+/**
+ * Checks if the wallet is running
+ */
+export function isWalletRunning() {
+    return getPrimaryProcessPid() !== null;
+}
+//# sourceMappingURL=serverManager.js.map

package/dist/utils/serverManager.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "awal",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Coinbase Wallet CLI for payments and crypto",
+  "bin": "./dist/index.js",
+  "files": [
+    "dist/",
+    "server-bundle/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write src/**/*.ts"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "env-paths": "^3.0.0",
+    "ora": "^8.0.0",
+    "viem": "^2.37.3",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.57",
+    "tsx": "^4.20.3",
+    "typescript": "5.8.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/coinbase/awal"
+  },
+  "keywords": [
+    "wallet",
+    "coinbase",
+    "crypto",
+    "payments",
+    "x402",
+    "usdc",
+    "cli"
+  ],
+  "author": "Coinbase",
+  "license": "Apache-2.0"
+}

package/server-bundle/assets/fallback.html

@@ -0,0 +1,112 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Payments MCP - Connection Error</title>
+    <style>
+      * {
+        margin: 0;
+        padding: 0;
+        box-sizing: border-box;
+      }
+
+      body {
+        font-family: -apple-system, Inter, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+        background: rgb(255, 255, 255);
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        min-height: 100vh;
+        padding: 32px;
+        text-align: center;
+      }
+
+      .icon {
+        width: 60px;
+        height: 60px;
+        margin: 0 auto 24px;
+        border-radius: 50%;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        font-size: 40px;
+      }
+
+      h1 {
+        color: #1f2937;
+        font-size: 24px;
+        margin-bottom: 12px;
+        font-weight: 600;
+      }
+
+      p {
+        color: rgb(91, 97, 110);
+        font-size: 16px;
+        font-weight: 400;
+        line-height: 24px;
+        margin-bottom: 24px;
+      }
+
+      .button {
+        background: rgb(0, 82, 255);
+        border-radius: 56px;
+        border: none;
+        color: white;
+        cursor: pointer;
+        font-size: 16px;
+        font-weight: 600;
+        height: 56px;
+        line-height: 24px;
+        padding: 0 32px;
+        transition: all 0.2s;
+        width: 100%;
+      }
+
+      .button:hover {
+        background: rgb(0, 72, 224);
+      }
+
+      .button:active {
+        background: rgb(0, 67, 209);
+        transform: scale(0.98);
+      }
+    </style>
+  </head>
+  <body>
+    <div>
+      <div class="icon">⚠️</div>
+      <h1>Connection Error</h1>
+      <p>
+        Unable to connect to the Payments MCP service.
+        <br />
+        Please check your connection and try again.
+      </p>
+
+      <button class="button" onclick="retryConnection()">Retry connection</button>
+    </div>
+
+    <script>
+      function retryConnection() {
+        const button = document.querySelector('.button');
+
+        button.disabled = true;
+        button.textContent = 'Retrying...';
+
+        // Add a minimum delay so the "Retrying..." state is visible and doesn't feel buggy
+        setTimeout(() => {
+          // Tell Electron to reload the wallet URL
+          if (window.electron && window.electron.sendIPC) {
+            // Send IPC message to reload the wallet URL
+            // If successful, Electron will navigate to the wallet
+            // If it fails, the did-fail-load handler will show this fallback page again
+            window.electron.sendIPC('reload-wallet-url');
+          } else {
+            // If not in Electron, just reload the page to retry connection
+            window.location.reload();
+          }
+        }, 1000);
+      }
+    </script>
+  </body>
+</html>