awal 2.8.2 → 2.12.0

package/dist/utils/__tests__/cliError.test.js

@@ -0,0 +1,192 @@
+import { CliErrorCode } from '../errorCodes.js';
+import { cliError, cliErrorFromCatch } from '../cliError.js';
+import { WalletError } from '../errors.js';
+describe('cliError', () => {
+    let mockExit;
+    let mockConsoleLog;
+    let mockConsoleError;
+    beforeEach(() => {
+        mockExit = jest.spyOn(process, 'exit').mockImplementation((() => {
+            throw new Error('process.exit called');
+        }));
+        mockConsoleLog = jest.spyOn(console, 'log').mockImplementation(() => { });
+        mockConsoleError = jest.spyOn(console, 'error').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        mockExit.mockRestore();
+        mockConsoleLog.mockRestore();
+        mockConsoleError.mockRestore();
+    });
+    describe('JSON mode', () => {
+        it('outputs structured JSON to stdout', () => {
+            expect(() => cliError({
+                code: CliErrorCode.INVALID_AMOUNT,
+                message: 'Amount must be positive',
+                jsonMode: true,
+            })).toThrow('process.exit called');
+            expect(mockConsoleLog).toHaveBeenCalledTimes(1);
+            const output = JSON.parse(mockConsoleLog.mock.calls[0][0]);
+            expect(output).toEqual({
+                success: false,
+                error: {
+                    code: 'INVALID_AMOUNT',
+                    message: 'Amount must be positive',
+                },
+            });
+        });
+        it('does not write to stderr', () => {
+            expect(() => cliError({
+                code: CliErrorCode.AUTH_REQUIRED,
+                message: 'Not signed in',
+                jsonMode: true,
+            })).toThrow();
+            expect(mockConsoleError).not.toHaveBeenCalled();
+        });
+        it('stops spinner silently in JSON mode', () => {
+            const spinner = { stop: jest.fn(), fail: jest.fn() };
+            expect(() => cliError({
+                spinner,
+                code: CliErrorCode.BALANCE_FETCH_FAILED,
+                message: 'Fetch failed',
+                jsonMode: true,
+            })).toThrow();
+            expect(spinner.stop).toHaveBeenCalled();
+            expect(spinner.fail).not.toHaveBeenCalled();
+        });
+        it('exits with code 1', () => {
+            expect(() => cliError({
+                code: CliErrorCode.TRANSACTION_FAILED,
+                message: 'tx failed',
+                jsonMode: true,
+            })).toThrow();
+            expect(mockExit).toHaveBeenCalledWith(1);
+        });
+    });
+    describe('text mode', () => {
+        it('writes error to stderr', () => {
+            expect(() => cliError({
+                code: CliErrorCode.INVALID_RECIPIENT,
+                message: 'Invalid address format',
+                jsonMode: false,
+            })).toThrow();
+            expect(mockConsoleError).toHaveBeenCalledTimes(1);
+            // chalk.red wraps the message
+            expect(mockConsoleError.mock.calls[0][0]).toContain('Invalid address format');
+        });
+        it('does not write JSON to stdout', () => {
+            expect(() => cliError({
+                code: CliErrorCode.INVALID_RECIPIENT,
+                message: 'Invalid address format',
+                jsonMode: false,
+            })).toThrow();
+            expect(mockConsoleLog).not.toHaveBeenCalled();
+        });
+        it('fails spinner with spinnerText if provided', () => {
+            const spinner = { stop: jest.fn(), fail: jest.fn() };
+            expect(() => cliError({
+                spinner,
+                code: CliErrorCode.SWAP_FAILED,
+                message: 'Detailed error message',
+                jsonMode: false,
+                spinnerText: 'Swap failed',
+            })).toThrow();
+            expect(spinner.fail).toHaveBeenCalledWith('Swap failed');
+            expect(spinner.stop).not.toHaveBeenCalled();
+        });
+        it('fails spinner with message when no spinnerText', () => {
+            const spinner = { stop: jest.fn(), fail: jest.fn() };
+            expect(() => cliError({
+                spinner,
+                code: CliErrorCode.REVOKE_FAILED,
+                message: 'Revoke operation failed',
+                jsonMode: false,
+            })).toThrow();
+            expect(spinner.fail).toHaveBeenCalledWith('Revoke operation failed');
+        });
+        it('exits with code 1', () => {
+            expect(() => cliError({
+                code: CliErrorCode.QUIT_TIMEOUT,
+                message: 'Process still running',
+            })).toThrow();
+            expect(mockExit).toHaveBeenCalledWith(1);
+        });
+        it('works without spinner', () => {
+            expect(() => cliError({
+                code: CliErrorCode.INVALID_OTP,
+                message: 'OTP must be 6 digits',
+                jsonMode: false,
+            })).toThrow();
+            expect(mockConsoleError).toHaveBeenCalledTimes(1);
+            expect(mockExit).toHaveBeenCalledWith(1);
+        });
+    });
+});
+describe('cliErrorFromCatch', () => {
+    let mockExit;
+    let mockConsoleLog;
+    let mockConsoleError;
+    beforeEach(() => {
+        mockExit = jest.spyOn(process, 'exit').mockImplementation((() => {
+            throw new Error('process.exit called');
+        }));
+        mockConsoleLog = jest.spyOn(console, 'log').mockImplementation(() => { });
+        mockConsoleError = jest.spyOn(console, 'error').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        mockExit.mockRestore();
+        mockConsoleLog.mockRestore();
+        mockConsoleError.mockRestore();
+    });
+    it('extracts message from Error instances', () => {
+        expect(() => cliErrorFromCatch({
+            code: CliErrorCode.REQUEST_FAILED,
+            error: new Error('Connection refused'),
+            jsonMode: true,
+        })).toThrow();
+        const output = JSON.parse(mockConsoleLog.mock.calls[0][0]);
+        expect(output.error.message).toBe('Error: Connection refused');
+        expect(output.error.code).toBe('REQUEST_FAILED');
+    });
+    it('uses getDisplayMessage for custom error classes', () => {
+        expect(() => cliErrorFromCatch({
+            code: CliErrorCode.SWAP_FAILED,
+            error: new WalletError('Insufficient funds'),
+            jsonMode: true,
+        })).toThrow();
+        const output = JSON.parse(mockConsoleLog.mock.calls[0][0]);
+        expect(output.error.message).toBe('Insufficient funds');
+    });
+    it('handles non-Error values', () => {
+        expect(() => cliErrorFromCatch({
+            code: CliErrorCode.DISCOVERY_FAILED,
+            error: 'string error',
+            jsonMode: true,
+        })).toThrow();
+        const output = JSON.parse(mockConsoleLog.mock.calls[0][0]);
+        expect(output.error.message).toBe('Unknown error: string error');
+    });
+    it('passes through spinner and spinnerText to cliError', () => {
+        const spinner = { stop: jest.fn(), fail: jest.fn() };
+        expect(() => cliErrorFromCatch({
+            spinner,
+            code: CliErrorCode.BAZAAR_FETCH_FAILED,
+            error: new Error('timeout'),
+            jsonMode: false,
+            spinnerText: 'Fetch failed',
+        })).toThrow();
+        expect(spinner.fail).toHaveBeenCalledWith('Fetch failed');
+    });
+});
+describe('CliErrorCode', () => {
+    it('has unique values for each key', () => {
+        const values = Object.values(CliErrorCode);
+        const unique = new Set(values);
+        expect(unique.size).toBe(values.length);
+    });
+    it('key equals value for all entries', () => {
+        for (const [key, value] of Object.entries(CliErrorCode)) {
+            expect(key).toBe(value);
+        }
+    });
+});
+//# sourceMappingURL=cliError.test.js.map

package/dist/utils/__tests__/cliError.test.js.map

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

package/dist/utils/chainValidation.d.ts

@@ -3,6 +3,11 @@
  */
 export declare function isSolanaChain(chain?: string): boolean;
 export declare function isPolygonChain(chain?: string): boolean;
+/**
+ * Checks whether a chain name is in the set of supported chains.
+ * Returns an error message if invalid, or undefined if valid.
+ */
+export declare function validateChain(chain: string): string | undefined;
 /**
  * Checks whether an asset is supported on the given chain.
  * Returns an error message if incompatible, or undefined if valid.

package/dist/utils/chainValidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chainValidation.d.ts","sourceRoot":"","sources":["../../src/utils/chainValidation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWnF"}
+{"version":3,"file":"chainValidation.d.ts","sourceRoot":"","sources":["../../src/utils/chainValidation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM/D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWnF"}

package/dist/utils/chainValidation.js

@@ -1,7 +1,7 @@
 /**
  * Chain validation utilities for the AWAL CLI.
  */
-import { SOLANA_CHAINS, POLYGON_CHAINS } from '../constants.js';
+import { SOLANA_CHAINS, POLYGON_CHAINS, SUPPORTED_CHAINS } from '../constants.js';
 export function isSolanaChain(chain) {
     if (!chain)
         return false;
@@ -12,6 +12,17 @@ export function isPolygonChain(chain) {
         return false;
     return POLYGON_CHAINS.has(chain);
 }
+/**
+ * Checks whether a chain name is in the set of supported chains.
+ * Returns an error message if invalid, or undefined if valid.
+ */
+export function validateChain(chain) {
+    if (!SUPPORTED_CHAINS.has(chain)) {
+        const valid = Array.from(SUPPORTED_CHAINS).join(', ');
+        return `Invalid chain "${chain}". Must be one of: ${valid}`;
+    }
+    return undefined;
+}
 /**
  * Checks whether an asset is supported on the given chain.
  * Returns an error message if incompatible, or undefined if valid.

package/dist/utils/chainValidation.js.map

@@ -1 +1 @@
-{"version":3,"file":"chainValidation.js","sourceRoot":"","sources":["../../src/utils/chainValidation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,KAAa;IAC7D,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEpC,IAAI,KAAK,KAAK,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,OAAO,wDAAwD,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,KAAK,KAAK,IAAI,MAAM,EAAE,CAAC;QAC9B,OAAO,mDAAmD,CAAC;IAC7D,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"chainValidation.js","sourceRoot":"","sources":["../../src/utils/chainValidation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAElF,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,OAAO,kBAAkB,KAAK,sBAAsB,KAAK,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,KAAa;IAC7D,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEpC,IAAI,KAAK,KAAK,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,OAAO,wDAAwD,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,KAAK,KAAK,IAAI,MAAM,EAAE,CAAC;QAC9B,OAAO,mDAAmD,CAAC;IAC7D,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/cliError.d.ts

@@ -0,0 +1,41 @@
+import type { Ora } from 'ora';
+import type { CliErrorCode } from './errorCodes.js';
+interface CliErrorOptions {
+    /** Active spinner instance (optional — some exits happen before spinner starts). */
+    spinner?: Ora;
+    /** Machine-readable error code. */
+    code: CliErrorCode;
+    /** Human-readable error message. */
+    message: string;
+    /** Whether --json flag is set. */
+    jsonMode?: boolean;
+    /** Label for spinner.fail() in text mode (defaults to message). */
+    spinnerText?: string;
+}
+interface CliErrorFromCatchOptions {
+    /** Active spinner instance (optional). */
+    spinner?: Ora;
+    /** Machine-readable error code. */
+    code: CliErrorCode;
+    /** The caught error value. */
+    error: unknown;
+    /** Whether --json flag is set. */
+    jsonMode?: boolean;
+    /** Label for spinner.fail() in text mode. */
+    spinnerText?: string;
+}
+/**
+ * Exits the CLI with a structured error.
+ *
+ * - JSON mode: stops spinner silently, writes JSON to stdout, exits 1.
+ * - Text mode: fails spinner with label, writes chalk-red message to stderr, exits 1.
+ */
+export declare function cliError(opts: CliErrorOptions): never;
+/**
+ * Convenience wrapper for catch blocks.
+ * Extracts the display message from the caught error via formatError(),
+ * then delegates to cliError().
+ */
+export declare function cliErrorFromCatch(opts: CliErrorFromCatchOptions): never;
+export {};
+//# sourceMappingURL=cliError.d.ts.map

package/dist/utils/cliError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliError.d.ts","sourceRoot":"","sources":["../../src/utils/cliError.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,UAAU,eAAe;IACvB,oFAAoF;IACpF,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,wBAAwB;IAChC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,KAAK,CAmBrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,KAAK,CAIvE"}

package/dist/utils/cliError.js

@@ -0,0 +1,46 @@
+/**
+ * Central error exit utility for CLI commands.
+ *
+ * When --json is active, outputs structured JSON to stdout so scripts can
+ * parse errors reliably. When --json is not active, outputs chalk-colored
+ * text to stderr (preserving the existing human-readable behavior).
+ *
+ * Return type is `never` so TypeScript flags unreachable code after a call.
+ */
+import chalk from 'chalk';
+import { formatJson } from '../formatters/output.js';
+import { formatError } from './errors.js';
+/**
+ * Exits the CLI with a structured error.
+ *
+ * - JSON mode: stops spinner silently, writes JSON to stdout, exits 1.
+ * - Text mode: fails spinner with label, writes chalk-red message to stderr, exits 1.
+ */
+export function cliError(opts) {
+    const { spinner, code, message, jsonMode, spinnerText } = opts;
+    if (jsonMode) {
+        spinner?.stop();
+        console.log(formatJson({
+            success: false,
+            error: { code, message },
+        }));
+    }
+    else {
+        if (spinner) {
+            spinner.fail(spinnerText ?? message);
+        }
+        console.error(chalk.red(message));
+    }
+    process.exit(1);
+}
+/**
+ * Convenience wrapper for catch blocks.
+ * Extracts the display message from the caught error via formatError(),
+ * then delegates to cliError().
+ */
+export function cliErrorFromCatch(opts) {
+    const { error, ...rest } = opts;
+    const message = formatError(error);
+    return cliError({ ...rest, message });
+}
+//# sourceMappingURL=cliError.js.map

package/dist/utils/cliError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliError.js","sourceRoot":"","sources":["../../src/utils/cliError.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA6B1C;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAqB;IAC5C,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAE/D,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CACT,UAAU,CAAC;YACT,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SACzB,CAAC,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA8B;IAC9D,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAChC,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/utils/errorCodes.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Machine-readable error codes for CLI JSON output.
+ * Used with --json flag to produce structured error responses.
+ */
+export declare const CliErrorCode: {
+    readonly INVALID_AMOUNT: "INVALID_AMOUNT";
+    readonly INVALID_RECIPIENT: "INVALID_RECIPIENT";
+    readonly INVALID_TOKEN: "INVALID_TOKEN";
+    readonly INVALID_SWAP: "INVALID_SWAP";
+    readonly INVALID_SLIPPAGE: "INVALID_SLIPPAGE";
+    readonly INVALID_CHAIN_CONFIG: "INVALID_CHAIN_CONFIG";
+    readonly INVALID_JSON_OPTION: "INVALID_JSON_OPTION";
+    readonly INVALID_OTP: "INVALID_OTP";
+    readonly INVALID_ADDRESS: "INVALID_ADDRESS";
+    readonly INVALID_SCHEME: "INVALID_SCHEME";
+    readonly INVALID_MAX_PRICE: "INVALID_MAX_PRICE";
+    readonly AUTH_LOGIN_FAILED: "AUTH_LOGIN_FAILED";
+    readonly AUTH_FLOW_MISSING: "AUTH_FLOW_MISSING";
+    readonly AUTH_VERIFY_FAILED: "AUTH_VERIFY_FAILED";
+    readonly AUTH_LOGOUT_FAILED: "AUTH_LOGOUT_FAILED";
+    readonly AUTH_REQUIRED: "AUTH_REQUIRED";
+    readonly TRANSACTION_FAILED: "TRANSACTION_FAILED";
+    readonly SWAP_FAILED: "SWAP_FAILED";
+    readonly REVOKE_FAILED: "REVOKE_FAILED";
+    readonly REQUEST_FAILED: "REQUEST_FAILED";
+    readonly DISCOVERY_FAILED: "DISCOVERY_FAILED";
+    readonly NO_PAYMENT_REQUIREMENTS: "NO_PAYMENT_REQUIREMENTS";
+    readonly ENS_RESOLUTION_FAILED: "ENS_RESOLUTION_FAILED";
+    readonly BALANCE_FETCH_FAILED: "BALANCE_FETCH_FAILED";
+    readonly ADDRESS_FETCH_FAILED: "ADDRESS_FETCH_FAILED";
+    readonly STATUS_CHECK_FAILED: "STATUS_CHECK_FAILED";
+    readonly BAZAAR_FETCH_FAILED: "BAZAAR_FETCH_FAILED";
+    readonly BAZAAR_SEARCH_FAILED: "BAZAAR_SEARCH_FAILED";
+    readonly QUIT_FAILED: "QUIT_FAILED";
+    readonly QUIT_TIMEOUT: "QUIT_TIMEOUT";
+    readonly WALLET_REFRESHING: "WALLET_REFRESHING";
+};
+export type CliErrorCode = (typeof CliErrorCode)[keyof typeof CliErrorCode];
+//# sourceMappingURL=errorCodes.d.ts.map

package/dist/utils/errorCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCodes.d.ts","sourceRoot":"","sources":["../../src/utils/errorCodes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCf,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

package/dist/utils/errorCodes.js

@@ -0,0 +1,42 @@
+/**
+ * Machine-readable error codes for CLI JSON output.
+ * Used with --json flag to produce structured error responses.
+ */
+export const CliErrorCode = {
+    // Validation errors
+    INVALID_AMOUNT: 'INVALID_AMOUNT',
+    INVALID_RECIPIENT: 'INVALID_RECIPIENT',
+    INVALID_TOKEN: 'INVALID_TOKEN',
+    INVALID_SWAP: 'INVALID_SWAP',
+    INVALID_SLIPPAGE: 'INVALID_SLIPPAGE',
+    INVALID_CHAIN_CONFIG: 'INVALID_CHAIN_CONFIG',
+    INVALID_JSON_OPTION: 'INVALID_JSON_OPTION',
+    INVALID_OTP: 'INVALID_OTP',
+    INVALID_ADDRESS: 'INVALID_ADDRESS',
+    INVALID_SCHEME: 'INVALID_SCHEME',
+    INVALID_MAX_PRICE: 'INVALID_MAX_PRICE',
+    // Auth errors
+    AUTH_LOGIN_FAILED: 'AUTH_LOGIN_FAILED',
+    AUTH_FLOW_MISSING: 'AUTH_FLOW_MISSING',
+    AUTH_VERIFY_FAILED: 'AUTH_VERIFY_FAILED',
+    AUTH_LOGOUT_FAILED: 'AUTH_LOGOUT_FAILED',
+    AUTH_REQUIRED: 'AUTH_REQUIRED',
+    // Operation errors
+    TRANSACTION_FAILED: 'TRANSACTION_FAILED',
+    SWAP_FAILED: 'SWAP_FAILED',
+    REVOKE_FAILED: 'REVOKE_FAILED',
+    REQUEST_FAILED: 'REQUEST_FAILED',
+    DISCOVERY_FAILED: 'DISCOVERY_FAILED',
+    NO_PAYMENT_REQUIREMENTS: 'NO_PAYMENT_REQUIREMENTS',
+    ENS_RESOLUTION_FAILED: 'ENS_RESOLUTION_FAILED',
+    // Infrastructure errors
+    BALANCE_FETCH_FAILED: 'BALANCE_FETCH_FAILED',
+    ADDRESS_FETCH_FAILED: 'ADDRESS_FETCH_FAILED',
+    STATUS_CHECK_FAILED: 'STATUS_CHECK_FAILED',
+    BAZAAR_FETCH_FAILED: 'BAZAAR_FETCH_FAILED',
+    BAZAAR_SEARCH_FAILED: 'BAZAAR_SEARCH_FAILED',
+    QUIT_FAILED: 'QUIT_FAILED',
+    QUIT_TIMEOUT: 'QUIT_TIMEOUT',
+    WALLET_REFRESHING: 'WALLET_REFRESHING',
+};
+//# sourceMappingURL=errorCodes.js.map

package/dist/utils/errorCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorCodes.js","sourceRoot":"","sources":["../../src/utils/errorCodes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,oBAAoB;IACpB,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,gBAAgB,EAAE,kBAAkB;IACpC,oBAAoB,EAAE,sBAAsB;IAC5C,mBAAmB,EAAE,qBAAqB;IAC1C,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;IAEtC,cAAc;IACd,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,aAAa,EAAE,eAAe;IAE9B,mBAAmB;IACnB,kBAAkB,EAAE,oBAAoB;IACxC,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,uBAAuB,EAAE,yBAAyB;IAClD,qBAAqB,EAAE,uBAAuB;IAE9C,wBAAwB;IACxB,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,sBAAsB;IAC5C,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC"}

package/dist/utils/logging.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fire-and-forget analytics event for CLI commands.
+ * Mirrors the safeLog* naming convention from the wallet UI's logging.ts.
+ * Events are routed through the track-analytics-event IPC channel to the
+ * renderer, where @cbhq/client-analytics processes them.
+ *
+ * Silently drops events when:
+ * - The user has disabled telemetry via `awal telemetry disable`
+ * - The wallet server is not already running (never auto-starts for analytics)
+ */
+export declare function safeLogEvent(event: string, properties?: Record<string, unknown>): void;
+//# sourceMappingURL=logging.d.ts.map

package/dist/utils/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKtF"}

package/dist/utils/logging.js

@@ -0,0 +1,22 @@
+import { sendIpcRequest } from '../ipcClient.js';
+import { readConfig } from './configManager.js';
+import { getPrimaryProcessPid } from './processCheck.js';
+/**
+ * Fire-and-forget analytics event for CLI commands.
+ * Mirrors the safeLog* naming convention from the wallet UI's logging.ts.
+ * Events are routed through the track-analytics-event IPC channel to the
+ * renderer, where @cbhq/client-analytics processes them.
+ *
+ * Silently drops events when:
+ * - The user has disabled telemetry via `awal telemetry disable`
+ * - The wallet server is not already running (never auto-starts for analytics)
+ */
+export function safeLogEvent(event, properties) {
+    const { telemetryDisabled } = readConfig();
+    if (telemetryDisabled)
+        return;
+    if (getPrimaryProcessPid() === null)
+        return;
+    sendIpcRequest('track-analytics-event', { event, properties }).catch(() => { });
+}
+//# sourceMappingURL=logging.js.map

package/dist/utils/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAAoC;IAC9E,MAAM,EAAE,iBAAiB,EAAE,GAAG,UAAU,EAAE,CAAC;IAC3C,IAAI,iBAAiB;QAAE,OAAO;IAC9B,IAAI,oBAAoB,EAAE,KAAK,IAAI;QAAE,OAAO;IAC5C,cAAc,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACjF,CAAC"}

package/dist/utils/processCheck.js

@@ -5,7 +5,7 @@ const LOCK_FILE = '/tmp/payments-mcp-ui.lock';
 /**
  * Checks if a PID represents a running payments-mcp process
  */
-function isPaymentsMcpProcessRunning(pid) {
+function isAgenticWalletMcpProcessRunning(pid) {
     try {
         // Check if process exists
         process.kill(pid, 0);
@@ -34,7 +34,7 @@ export function verifyPrimaryProcessRunning() {
     }
     try {
         const lockPid = parseInt(fs.readFileSync(LOCK_FILE, 'utf8').trim(), 10);
-        if (!isPaymentsMcpProcessRunning(lockPid)) {
+        if (!isAgenticWalletMcpProcessRunning(lockPid)) {
             throw new WalletNotRunningError();
         }
     }
@@ -56,7 +56,7 @@ export function getPrimaryProcessPid() {
     }
     try {
         const lockPid = parseInt(fs.readFileSync(LOCK_FILE, 'utf8').trim(), 10);
-        if (isPaymentsMcpProcessRunning(lockPid)) {
+        if (isAgenticWalletMcpProcessRunning(lockPid)) {
             return lockPid;
         }
     }

package/dist/utils/processCheck.js.map

@@ -1 +1 @@
-{"version":3,"file":"processCheck.js","sourceRoot":"","sources":["../../src/utils/processCheck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,SAAS,GAAG,2BAA2B,CAAC;AAE9C;;GAEG;AACH,SAAS,2BAA2B,CAAC,GAAW;IAC9C,IAAI,CAAC;QACH,0BAA0B;QAC1B,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAErB,iEAAiE;QACjE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,GAAG,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACzF,OAAO,CACL,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC;gBACtC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBACnC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC3B,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBACpC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CACnC,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,qBAAqB,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,qBAAqB,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;YAC3C,MAAM,KAAK,CAAC;QACd,CAAC;QACD,0CAA0C;QAC1C,MAAM,IAAI,qBAAqB,EAAE,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"processCheck.js","sourceRoot":"","sources":["../../src/utils/processCheck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,SAAS,GAAG,2BAA2B,CAAC;AAE9C;;GAEG;AACH,SAAS,gCAAgC,CAAC,GAAW;IACnD,IAAI,CAAC;QACH,0BAA0B;QAC1B,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAErB,iEAAiE;QACjE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,GAAG,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACzF,OAAO,CACL,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC;gBACtC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBACnC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC3B,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBACpC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CACnC,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,qBAAqB,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,gCAAgC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,qBAAqB,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;YAC3C,MAAM,KAAK,CAAC;QACd,CAAC;QACD,0CAA0C;QAC1C,MAAM,IAAI,qBAAqB,EAAE,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,gCAAgC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/serverManager.js

@@ -6,7 +6,7 @@ import { fileURLToPath } from 'url';
 import { getPrimaryProcessPid } from './processCheck.js';
 const paths = envPaths('awal');
 // This will be updated by the build script
-const BUNDLE_VERSION = '2.8.2';
+const BUNDLE_VERSION = '2.12.0';
 function getServerPaths() {
     const dataDir = paths.data;
     const bundleDir = path.join(dataDir, 'server');

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "awal",
-  "version": "2.8.2",
+  "version": "2.12.0",
   "type": "module",
-  "description": "Coinbase Wallet CLI for payments and crypto",
+  "description": "Coinbase Agentic Wallet CLI for payments and crypto",
   "bin": "dist/index.js",
   "files": [
     "dist/",
@@ -18,8 +18,8 @@
     "test": "jest --config jest.config.cjs"
   },
   "dependencies": {
-    "@x402/core": "^2.4.0",
-    "@x402/extensions": "^2.4.0",
+    "@x402/core": "^2.11.0",
+    "@x402/extensions": "^2.11.0",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "env-paths": "^3.0.0",

package/server-bundle/assets/fallback.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Payments MCP - Connection Error</title>
+    <title>Agentic Wallet - Connection Error</title>
     <style>
       * {
         margin: 0;
@@ -78,7 +78,7 @@
       <div class="icon">⚠️</div>
       <h1>Connection Error</h1>
       <p>
-        Unable to connect to the Payments MCP service.
+        Unable to connect to the Agentic Wallet service.
         <br />
         Please check your connection and try again.
       </p>