arc402-cli 0.2.0

package/dist/ui/format.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Truncate an address to 0x1234...abcd format (first 6 + last 4 chars).
+ * Full address is preserved in --json output only.
+ */
+export declare function formatAddress(address: string): string;
+/**
+ * Format a single token value: "0.024 ETH" or "150 USDC"
+ */
+export declare function formatValue(amount: string | number, token: string): string;
+/**
+ * Format a combined ETH + token balance: "0.024 ETH · 150 USDC"
+ */
+export declare function formatBalance(ethAmount: string | number, tokenAmount?: string | number, tokenSymbol?: string): string;
+/**
+ * Format a unix timestamp (seconds) as a relative "time ago" string.
+ */
+export declare function formatTimeAgo(timestampSeconds: number): string;
+/**
+ * Format seconds-until-expiry as "61h 14m" or "2d 3h".
+ */
+export declare function formatDuration(seconds: number): string;
+/**
+ * Format a unix timestamp (seconds) as a locale date/time string.
+ */
+export declare function formatTimestamp(timestampSeconds: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/ui/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/ui/format.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrD;AAID;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAC7B,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAMR;AAID;;GAEG;AACH,wBAAgB,aAAa,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAe9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/ui/format.js

@@ -0,0 +1,77 @@
+"use strict";
+// ─── Address Formatting ───────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAddress = formatAddress;
+exports.formatValue = formatValue;
+exports.formatBalance = formatBalance;
+exports.formatTimeAgo = formatTimeAgo;
+exports.formatDuration = formatDuration;
+exports.formatTimestamp = formatTimestamp;
+/**
+ * Truncate an address to 0x1234...abcd format (first 6 + last 4 chars).
+ * Full address is preserved in --json output only.
+ */
+function formatAddress(address) {
+    if (address.length <= 12)
+        return address;
+    return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+// ─── Value Formatting ─────────────────────────────────────────────────────────
+/**
+ * Format a single token value: "0.024 ETH" or "150 USDC"
+ */
+function formatValue(amount, token) {
+    return `${amount} ${token}`;
+}
+/**
+ * Format a combined ETH + token balance: "0.024 ETH · 150 USDC"
+ */
+function formatBalance(ethAmount, tokenAmount, tokenSymbol) {
+    const eth = `${ethAmount} ETH`;
+    if (tokenAmount !== undefined && tokenSymbol) {
+        return `${eth} · ${tokenAmount} ${tokenSymbol}`;
+    }
+    return eth;
+}
+// ─── Timestamp Formatting ─────────────────────────────────────────────────────
+/**
+ * Format a unix timestamp (seconds) as a relative "time ago" string.
+ */
+function formatTimeAgo(timestampSeconds) {
+    const now = Math.floor(Date.now() / 1000);
+    const delta = now - timestampSeconds;
+    if (delta < 60)
+        return "just now";
+    if (delta < 3600) {
+        const m = Math.floor(delta / 60);
+        return `${m}m ago`;
+    }
+    if (delta < 86400) {
+        const h = Math.floor(delta / 3600);
+        return `${h}h ago`;
+    }
+    const d = Math.floor(delta / 86400);
+    return `${d}d ago`;
+}
+/**
+ * Format seconds-until-expiry as "61h 14m" or "2d 3h".
+ */
+function formatDuration(seconds) {
+    if (seconds <= 0)
+        return "expired";
+    const d = Math.floor(seconds / 86400);
+    const h = Math.floor((seconds % 86400) / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    if (d > 0)
+        return h > 0 ? `${d}d ${h}h` : `${d}d`;
+    if (h > 0)
+        return m > 0 ? `${h}h ${m}m` : `${h}h`;
+    return `${m}m`;
+}
+/**
+ * Format a unix timestamp (seconds) as a locale date/time string.
+ */
+function formatTimestamp(timestampSeconds) {
+    return new Date(timestampSeconds * 1000).toLocaleString();
+}
+//# sourceMappingURL=format.js.map

package/dist/ui/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/ui/format.ts"],"names":[],"mappings":";AAAA,iFAAiF;;AAMjF,sCAGC;AAOD,kCAEC;AAKD,sCAUC;AAOD,sCAeC;AAKD,wCASC;AAKD,0CAEC;AA1ED;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAe;IAC3C,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,iFAAiF;AAEjF;;GAEG;AACH,SAAgB,WAAW,CAAC,MAAuB,EAAE,KAAa;IAChE,OAAO,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAC3B,SAA0B,EAC1B,WAA6B,EAC7B,WAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,SAAS,MAAM,CAAC;IAC/B,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,EAAE,CAAC;QAC7C,OAAO,GAAG,GAAG,MAAM,WAAW,IAAI,WAAW,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iFAAiF;AAEjF;;GAEG;AACH,SAAgB,aAAa,CAAC,gBAAwB;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,GAAG,GAAG,gBAAgB,CAAC;IAErC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,UAAU,CAAC;IAClC,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QACnC,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC5C,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAE5C,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAClD,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAClD,OAAO,GAAG,CAAC,GAAG,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,gBAAwB;IACtD,OAAO,IAAI,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;AAC5D,CAAC"}

package/dist/ui/spinner.d.ts

@@ -0,0 +1,8 @@
+export interface ArcSpinner {
+    succeed(text?: string): void;
+    fail(text?: string): void;
+    update(text: string): void;
+    stop(): void;
+}
+export declare function startSpinner(text: string): ArcSpinner;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/ui/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CA8BrD"}

package/dist/ui/spinner.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startSpinner = startSpinner;
+const ora_1 = __importDefault(require("ora"));
+const chalk_1 = __importDefault(require("chalk"));
+const SPINNER_FRAMES = {
+    interval: 120,
+    frames: ["◈ ", "◉ ", "◎ ", "◉ "],
+};
+function startSpinner(text) {
+    const instance = (0, ora_1.default)({
+        text,
+        spinner: SPINNER_FRAMES,
+        color: "cyan",
+        prefixText: " ",
+    }).start();
+    return {
+        succeed(msg) {
+            instance.stopAndPersist({
+                symbol: chalk_1.default.green("✓"),
+                text: msg ?? instance.text,
+                prefixText: " ",
+            });
+        },
+        fail(msg) {
+            instance.stopAndPersist({
+                symbol: chalk_1.default.red("✗"),
+                text: msg ?? instance.text,
+                prefixText: " ",
+            });
+        },
+        update(text) {
+            instance.text = text;
+        },
+        stop() {
+            instance.stop();
+        },
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/ui/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":";;;;;AAeA,oCA8BC;AA7CD,8CAA+B;AAC/B,kDAA0B;AAE1B,MAAM,cAAc,GAAG;IACrB,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;CACjC,CAAC;AASF,SAAgB,YAAY,CAAC,IAAY;IACvC,MAAM,QAAQ,GAAQ,IAAA,aAAG,EAAC;QACxB,IAAI;QACJ,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,GAAG;KAChB,CAAC,CAAC,KAAK,EAAE,CAAC;IAEX,OAAO;QACL,OAAO,CAAC,GAAY;YAClB,QAAQ,CAAC,cAAc,CAAC;gBACtB,MAAM,EAAE,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC;gBACxB,IAAI,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI;gBAC1B,UAAU,EAAE,GAAG;aAChB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,GAAY;YACf,QAAQ,CAAC,cAAc,CAAC;gBACtB,MAAM,EAAE,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC;gBACtB,IAAI,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI;gBAC1B,UAAU,EAAE,GAAG;aAChB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,IAAY;YACjB,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,IAAI;YACF,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/format.d.ts

@@ -0,0 +1,10 @@
+import { AgreementStatus, IdentityTier, ReputationSignalType } from "@arc402/sdk";
+export declare const truncateAddress: (address: string) => string;
+export declare const formatDate: (timestamp: number) => string;
+export declare function getTrustTier(score: number): string;
+export declare function agreementStatusLabel(status: AgreementStatus): string;
+export declare function colourStatus(status: AgreementStatus): string;
+export declare const identityTierLabel: (tier: IdentityTier) => string;
+export declare const reputationSignalLabel: (signal: ReputationSignalType) => string;
+export declare function printTable(head: string[], rows: (string | number)[][]): void;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAElF,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,WAAqF,CAAC;AACrI,eAAO,MAAM,UAAU,GAAI,WAAW,MAAM,WAAgD,CAAC;AAE7F,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAEpE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAmB5D;AAED,eAAO,MAAM,iBAAiB,GAAI,MAAM,YAAY,WAAiC,CAAC;AACtF,eAAO,MAAM,qBAAqB,GAAI,QAAQ,oBAAoB,WAA8C,CAAC;AAEjH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,QAIrE"}

package/dist/utils/format.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reputationSignalLabel = exports.identityTierLabel = exports.formatDate = exports.truncateAddress = void 0;
+exports.getTrustTier = getTrustTier;
+exports.agreementStatusLabel = agreementStatusLabel;
+exports.colourStatus = colourStatus;
+exports.printTable = printTable;
+const chalk_1 = __importDefault(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const sdk_1 = require("@arc402/sdk");
+const truncateAddress = (address) => address.length <= 12 ? address : `${address.slice(0, 6)}...${address.slice(-4)}`;
+exports.truncateAddress = truncateAddress;
+const formatDate = (timestamp) => new Date(timestamp * 1000).toLocaleString();
+exports.formatDate = formatDate;
+function getTrustTier(score) {
+    if (score >= 800)
+        return "Autonomous";
+    if (score >= 600)
+        return "Elevated";
+    if (score >= 300)
+        return "Standard";
+    if (score >= 100)
+        return "Restricted";
+    return "Probationary";
+}
+function agreementStatusLabel(status) {
+    return sdk_1.AgreementStatus[status] ?? "UNKNOWN";
+}
+function colourStatus(status) {
+    const label = agreementStatusLabel(status);
+    switch (status) {
+        case sdk_1.AgreementStatus.PROPOSED:
+        case sdk_1.AgreementStatus.REVISION_REQUESTED:
+            return chalk_1.default.yellow(label);
+        case sdk_1.AgreementStatus.ACCEPTED:
+        case sdk_1.AgreementStatus.REVISED:
+        case sdk_1.AgreementStatus.PENDING_VERIFICATION:
+            return chalk_1.default.blue(label);
+        case sdk_1.AgreementStatus.FULFILLED:
+            return chalk_1.default.green(label);
+        case sdk_1.AgreementStatus.DISPUTED:
+        case sdk_1.AgreementStatus.ESCALATED_TO_HUMAN:
+        case sdk_1.AgreementStatus.ESCALATED_TO_ARBITRATION:
+            return chalk_1.default.red(label);
+        default:
+            return chalk_1.default.gray(label);
+    }
+}
+const identityTierLabel = (tier) => sdk_1.IdentityTier[tier] ?? "NONE";
+exports.identityTierLabel = identityTierLabel;
+const reputationSignalLabel = (signal) => sdk_1.ReputationSignalType[signal] ?? "UNKNOWN";
+exports.reputationSignalLabel = reputationSignalLabel;
+function printTable(head, rows) {
+    const table = new cli_table3_1.default({ head: head.map((value) => chalk_1.default.cyan(value)), style: { head: [], border: [] } });
+    rows.forEach((row) => table.push(row));
+    console.log(table.toString());
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

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

package/dist/utils/hash.d.ts

@@ -0,0 +1,3 @@
+export declare const hashFile: (filePath: string) => string;
+export declare const hashString: (value: string) => string;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,WAAgD,CAAC;AAC1F,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,WAAgD,CAAC"}

package/dist/utils/hash.js

@@ -0,0 +1,43 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashString = exports.hashFile = void 0;
+const fs = __importStar(require("fs"));
+const ethers_1 = require("ethers");
+const hashFile = (filePath) => ethers_1.ethers.keccak256(fs.readFileSync(filePath));
+exports.hashFile = hashFile;
+const hashString = (value) => ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(value));
+exports.hashString = hashString;
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,mCAAgC;AAEzB,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,eAAM,CAAC,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AAA7E,QAAA,QAAQ,YAAqE;AACnF,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,eAAM,CAAC,SAAS,CAAC,eAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AAA5E,QAAA,UAAU,cAAkE"}

package/dist/utils/time.d.ts

@@ -0,0 +1,3 @@
+export declare function parseDuration(duration: string): number;
+export declare function formatDeadline(deadline: number): string;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvD"}

package/dist/utils/time.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDuration = parseDuration;
+exports.formatDeadline = formatDeadline;
+function parseDuration(duration) {
+    const now = Math.floor(Date.now() / 1000);
+    const match = duration.match(/^(\d+)([hd])$/i);
+    if (!match)
+        throw new Error(`Invalid duration format: \"${duration}\". Use e.g. 2h, 24h, 7d`);
+    const value = Number(match[1]);
+    return now + (match[2].toLowerCase() === "d" ? value * 86400 : value * 3600);
+}
+function formatDeadline(deadline) {
+    const diff = deadline - Math.floor(Date.now() / 1000);
+    if (diff < 0)
+        return "EXPIRED";
+    const hours = Math.floor(diff / 3600);
+    const days = Math.floor(hours / 24);
+    return days > 0 ? `${days}d ${hours % 24}h remaining` : `${hours}h remaining`;
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":";;AAAA,sCAMC;AAED,wCAMC;AAdD,SAAgB,aAAa,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,0BAA0B,CAAC,CAAC;IAC9F,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED,SAAgB,cAAc,CAAC,QAAgB;IAC7C,MAAM,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,aAAa,CAAC;AAChF,CAAC"}

package/dist/wallet-router.d.ts

@@ -0,0 +1,25 @@
+import { ethers } from "ethers";
+import { Arc402Config } from "./config";
+/**
+ * Attempts to decode a known ARC402Wallet custom error from a thrown error.
+ * If a recognized error is found, prints a human-readable message and exits.
+ * Otherwise, rethrows the original error.
+ */
+export declare function handleWalletError(e: unknown): never;
+/**
+ * Decode a 4-byte ARC402Wallet custom error selector into a human-readable message.
+ * Returns null if the selector is not a known wallet error.
+ */
+export declare function decodeWalletError(errorData: string): string | null;
+export interface SenderInfo {
+    address: string;
+    useContract: boolean;
+}
+export declare function getEffectiveSender(config: Arc402Config): SenderInfo;
+export declare function printSenderInfo(config: Arc402Config): void;
+/**
+ * Route a write transaction through the ARC402Wallet's executeContractCall when deployed,
+ * otherwise encode calldata directly against the target contract using the provided ABI.
+ */
+export declare function executeContractWriteViaWallet(walletContractAddress: string, signer: ethers.Wallet, targetAddress: string, contractAbi: readonly string[], functionName: string, args: unknown[], value?: bigint, approvalToken?: string, maxApprovalAmount?: bigint): Promise<ethers.ContractTransactionResponse>;
+//# sourceMappingURL=wallet-router.d.ts.map

package/dist/wallet-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-router.d.ts","sourceRoot":"","sources":["../src/wallet-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA8CxC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAyCnD;AAgBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIlE;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAMnE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAS1D;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,qBAAqB,EAAE,MAAM,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,EAAE,EACf,KAAK,GAAE,MAAW,EAClB,aAAa,GAAE,MAA2B,EAC1C,iBAAiB,GAAE,MAAW,GAC7B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAoB7C"}

package/dist/wallet-router.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleWalletError = handleWalletError;
+exports.decodeWalletError = decodeWalletError;
+exports.getEffectiveSender = getEffectiveSender;
+exports.printSenderInfo = printSenderInfo;
+exports.executeContractWriteViaWallet = executeContractWriteViaWallet;
+const ethers_1 = require("ethers");
+const abis_1 = require("./abis");
+// ─── ARC402Wallet custom error decoder ─────────────────────────────────────
+const WALLET_CUSTOM_ERROR_IFACE = new ethers_1.ethers.Interface([
+    "error WVel()",
+    "error WCtx()",
+    "error WAtt()",
+    "error WAuth()",
+    "error WCall()",
+    "error WZero()",
+    "error WFrozen()",
+    "error WPending()",
+    "error WLock()",
+]);
+const WALLET_ERROR_HELP = {
+    WVel: "Velocity limit breached. Your wallet has been automatically frozen as a security measure.\n" +
+        "  To unfreeze: arc402 wallet unfreeze\n" +
+        "  To prevent this: check your spending velocity limits with arc402 wallet policy status",
+    WCtx: "Context error: either a context is already open, or no context is open when one is required.\n" +
+        "  Note: each context allows exactly one spend — a new context must be opened per payment.\n" +
+        "  Check context state:  arc402 wallet check-context\n" +
+        "  Close stale context:  arc402 wallet close-context",
+    WAtt: "Attestation invalid: not found, already consumed, expired, or parameters do not match.\n" +
+        "  Each attestation can only be used once. Create a new attestation for each spend.",
+    WAuth: "Machine key not authorized on this wallet.\n" +
+        "  Fix: arc402 wallet authorize-machine-key <your-machine-key-address>",
+    WCall: "External contract call failed. The target contract reverted. Check the target address and calldata.",
+    WZero: "Zero address not allowed for a required address parameter.",
+    WFrozen: "Wallet is frozen and cannot process transactions.\n" +
+        "  To unfreeze: arc402 wallet unfreeze (owner WalletConnect required)",
+    WPending: "A registry upgrade is already pending. Cancel it first: arc402 wallet cancel-registry-upgrade",
+    WLock: "Registry upgrade timelock has not elapsed yet. Check: arc402 wallet execute-registry-upgrade",
+};
+/**
+ * Attempts to decode a known ARC402Wallet custom error from a thrown error.
+ * If a recognized error is found, prints a human-readable message and exits.
+ * Otherwise, rethrows the original error.
+ */
+function handleWalletError(e) {
+    // Extract revert data from various ethers v6 error shapes
+    let errorData;
+    if (e && typeof e === "object") {
+        const err = e;
+        if (typeof err.data === "string") {
+            errorData = err.data;
+        }
+        else if (err.error && typeof err.error === "object") {
+            const inner = err.error;
+            if (typeof inner.data === "string")
+                errorData = inner.data;
+        }
+        // ethers v6 sometimes nests it in info.error.data
+        if (!errorData && err.info && typeof err.info === "object") {
+            const info = err.info;
+            if (info.error && typeof info.error === "object") {
+                const ie = info.error;
+                if (typeof ie.data === "string")
+                    errorData = ie.data;
+            }
+        }
+        // Fallback: parse from error message string
+        if (!errorData && typeof err.message === "string") {
+            const m = err.message.match(/"data"\s*:\s*"(0x[0-9a-fA-F]+)"/);
+            if (m)
+                errorData = m[1];
+        }
+    }
+    if (errorData && errorData.length >= 10) {
+        try {
+            const decoded = WALLET_CUSTOM_ERROR_IFACE.parseError(errorData);
+            if (decoded) {
+                const help = WALLET_ERROR_HELP[decoded.name];
+                if (help) {
+                    console.error(`\nError: ${decoded.name}()`);
+                    console.error(`  ${help.split("\n").join("\n  ")}`);
+                    process.exit(1);
+                }
+            }
+        }
+        catch { /* decoding failed — fall through to rethrow */ }
+    }
+    throw e;
+}
+// ─── Selector-based error decoder (J1-06) ────────────────────────────────────
+//
+// Maps known 4-byte selectors to human-readable messages for use in external error handling.
+const WALLET_ERROR_SELECTOR_MAP = {
+    "0x13af807f": "Context error: either a context is already open, or no context is open. Check with `arc402 wallet check-context`",
+    "0x88529d53": "Attestation error: attestation not found, already used, expired, or wrong parameters",
+    "0xd6636aaa": "Velocity limit breached — wallet is now frozen. Run `arc402 wallet unfreeze` to recover",
+    "0xbc34a075": "Unauthorized: this operation requires owner or machine key authorization",
+    "0xf5138cb6": "Contract call failed: the target contract reverted. Check that the target contract is working correctly",
+    "0xd92e233d": "Zero address error: a required address parameter was address(0)",
+    "0xb808d662": "Wallet is frozen. Run `arc402 wallet unfreeze` to recover (requires owner)",
+};
+/**
+ * Decode a 4-byte ARC402Wallet custom error selector into a human-readable message.
+ * Returns null if the selector is not a known wallet error.
+ */
+function decodeWalletError(errorData) {
+    if (!errorData || errorData.length < 10)
+        return null;
+    const selector = errorData.slice(0, 10).toLowerCase();
+    return WALLET_ERROR_SELECTOR_MAP[selector] ?? null;
+}
+function getEffectiveSender(config) {
+    if (config.walletContractAddress) {
+        return { address: config.walletContractAddress, useContract: true };
+    }
+    const wallet = new ethers_1.ethers.Wallet(config.privateKey);
+    return { address: wallet.address, useContract: false };
+}
+function printSenderInfo(config) {
+    if (config.walletContractAddress) {
+        console.log(`Using ARC402Wallet: ${config.walletContractAddress}`);
+        console.log(`Policy enforcement active — transaction subject to configured limits`);
+    }
+    else {
+        const wallet = new ethers_1.ethers.Wallet(config.privateKey);
+        console.log(`Using EOA wallet: ${wallet.address}`);
+        console.log(`Tip: run \`arc402 wallet deploy\` to enable spending limits and policy enforcement`);
+    }
+}
+/**
+ * Route a write transaction through the ARC402Wallet's executeContractCall when deployed,
+ * otherwise encode calldata directly against the target contract using the provided ABI.
+ */
+async function executeContractWriteViaWallet(walletContractAddress, signer, targetAddress, contractAbi, functionName, args, value = 0n, approvalToken = ethers_1.ethers.ZeroAddress, maxApprovalAmount = 0n) {
+    const iface = new ethers_1.ethers.Interface(contractAbi);
+    const data = iface.encodeFunctionData(functionName, args);
+    const walletContract = new ethers_1.ethers.Contract(walletContractAddress, abis_1.ARC402_WALLET_EXECUTE_ABI, signer);
+    try {
+        return await walletContract.executeContractCall({
+            target: targetAddress,
+            data,
+            value,
+            minReturnValue: 0n,
+            maxApprovalAmount,
+            approvalToken,
+        });
+    }
+    catch (e) {
+        handleWalletError(e);
+    }
+}
+//# sourceMappingURL=wallet-router.js.map

package/dist/wallet-router.js.map

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

package/dist/walletconnect-session.d.ts

@@ -0,0 +1,12 @@
+import { Arc402Config } from "./config";
+export interface WCSessionData {
+    topic: string;
+    expiry: number;
+    account: string;
+    chainId: number;
+}
+/** Returns null if no session, expired, or wrong chainId. */
+export declare function loadWCSession(config: Arc402Config, requiredChainId: number): WCSessionData | null;
+export declare function saveWCSession(config: Arc402Config, session: WCSessionData): void;
+export declare function clearWCSession(config: Arc402Config): void;
+//# sourceMappingURL=walletconnect-session.d.ts.map

package/dist/walletconnect-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletconnect-session.d.ts","sourceRoot":"","sources":["../src/walletconnect-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAc,MAAM,UAAU,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAMjG;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAGhF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAGzD"}

package/dist/walletconnect-session.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadWCSession = loadWCSession;
+exports.saveWCSession = saveWCSession;
+exports.clearWCSession = clearWCSession;
+const config_1 = require("./config");
+/** Returns null if no session, expired, or wrong chainId. */
+function loadWCSession(config, requiredChainId) {
+    if (!config.wcSession)
+        return null;
+    const now = Math.floor(Date.now() / 1000);
+    if (config.wcSession.expiry <= now)
+        return null;
+    if (config.wcSession.chainId !== requiredChainId)
+        return null;
+    return config.wcSession;
+}
+function saveWCSession(config, session) {
+    config.wcSession = session;
+    (0, config_1.saveConfig)(config);
+}
+function clearWCSession(config) {
+    delete config.wcSession;
+    (0, config_1.saveConfig)(config);
+}
+//# sourceMappingURL=walletconnect-session.js.map

package/dist/walletconnect-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletconnect-session.js","sourceRoot":"","sources":["../src/walletconnect-session.ts"],"names":[],"mappings":";;AAUA,sCAMC;AAED,sCAGC;AAED,wCAGC;AA1BD,qCAAoD;AASpD,6DAA6D;AAC7D,SAAgB,aAAa,CAAC,MAAoB,EAAE,eAAuB;IACzE,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,MAAM,CAAC,SAA0B,CAAC;AAC3C,CAAC;AAED,SAAgB,aAAa,CAAC,MAAoB,EAAE,OAAsB;IACxE,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC;IAC3B,IAAA,mBAAU,EAAC,MAAM,CAAC,CAAC;AACrB,CAAC;AAED,SAAgB,cAAc,CAAC,MAAoB;IACjD,OAAO,MAAM,CAAC,SAAS,CAAC;IACxB,IAAA,mBAAU,EAAC,MAAM,CAAC,CAAC;AACrB,CAAC"}

package/dist/walletconnect.d.ts

@@ -0,0 +1,46 @@
+import { SignClient } from "@walletconnect/sign-client";
+import { Arc402Config } from "./config";
+export type TelegramOpts = {
+    botToken: string;
+    chatId: string;
+    threadId?: number;
+};
+type SignClientT = Awaited<ReturnType<typeof SignClient.init>>;
+type WCSession = ReturnType<SignClientT["session"]["get"]>;
+/**
+ * Step 1 of the two-step flow: connect the phone wallet (or resume a valid session).
+ * On fresh connect, shows deep links + QR and waits for WC approval.
+ * Saves session to config after a successful fresh pairing.
+ */
+export declare function connectPhoneWallet(projectId: string, chainId: number, config: Arc402Config, opts?: {
+    telegramOpts?: TelegramOpts;
+    prompt?: string;
+    hardware?: boolean;
+}): Promise<{
+    client: SignClientT;
+    session: WCSession;
+    account: string;
+}>;
+/**
+ * Step 2 of the two-step flow: send a transaction with an established session.
+ * Returns the transaction hash.
+ */
+export declare function sendTransactionWithSession(client: SignClientT, session: WCSession, account: string, chainId: number, tx: {
+    to: string;
+    data: string;
+    value?: string;
+}): Promise<string>;
+/**
+ * Convenience wrapper: connect + send in one call.
+ * Used by commands that haven't been split into two steps (e.g. policy set-limit).
+ */
+export declare function requestPhoneWalletSignature(projectId: string, chainId: number, buildTx: (account: string) => {
+    to: string;
+    data: string;
+    value?: string;
+}, prompt: string, telegramOpts?: TelegramOpts, config?: Arc402Config): Promise<{
+    txHash: string;
+    account: string;
+}>;
+export {};
+//# sourceMappingURL=walletconnect.d.ts.map