aavegotchi-cli 0.1.0

package/dist/tx-engine.js

@@ -0,0 +1,285 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeTxIntent = executeTxIntent;
+exports.getJournalEntryByIdempotency = getJournalEntryByIdempotency;
+exports.getJournalEntryByHash = getJournalEntryByHash;
+exports.getRecentJournalEntries = getRecentJournalEntries;
+exports.resumeTransaction = resumeTransaction;
+const crypto_1 = require("crypto");
+const chains_1 = require("./chains");
+const config_1 = require("./config");
+const errors_1 = require("./errors");
+const idempotency_1 = require("./idempotency");
+const journal_1 = require("./journal");
+const policy_1 = require("./policy");
+const rpc_1 = require("./rpc");
+const signer_1 = require("./signer");
+function toHexData(data) {
+    return (data || "0x");
+}
+function formatReceipt(receipt) {
+    return {
+        blockNumber: receipt.blockNumber.toString(),
+        gasUsed: receipt.gasUsed.toString(),
+        status: receipt.status,
+    };
+}
+function mapJournalToResult(entry) {
+    const receipt = entry.receiptJson ? JSON.parse(entry.receiptJson) : undefined;
+    return {
+        idempotencyKey: entry.idempotencyKey,
+        txHash: entry.txHash,
+        from: entry.fromAddress,
+        to: entry.toAddress,
+        nonce: entry.nonce,
+        gasLimit: entry.gasLimit,
+        maxFeePerGasWei: entry.maxFeePerGasWei || undefined,
+        maxPriorityFeePerGasWei: entry.maxPriorityFeePerGasWei || undefined,
+        status: entry.status === "confirmed" ? "confirmed" : "submitted",
+        receipt,
+    };
+}
+async function resolveNonce(intent, ctx, address) {
+    if (intent.noncePolicy === "manual") {
+        if (intent.nonce === undefined) {
+            throw new errors_1.CliError("MISSING_NONCE", "nonce-policy manual requires --nonce.", 2);
+        }
+        return intent.nonce;
+    }
+    if (intent.noncePolicy === "replace" && ctx.existing && ctx.existing.nonce >= 0) {
+        return ctx.existing.nonce;
+    }
+    const pendingNonce = await ctx.client.getTransactionCount({
+        address,
+        blockTag: "pending",
+    });
+    return pendingNonce;
+}
+async function waitForConfirmation(intent, ctx, txHash) {
+    const receipt = await ctx.client.waitForTransactionReceipt({
+        hash: txHash,
+        timeout: intent.timeoutMs,
+    });
+    const summary = {
+        blockNumber: receipt.blockNumber,
+        gasUsed: receipt.gasUsed,
+        status: receipt.status,
+    };
+    const formatted = formatReceipt(summary);
+    ctx.journal.markConfirmed(ctx.idempotencyKey, JSON.stringify(formatted));
+    return formatted;
+}
+async function executeTxIntent(intent, chain, customHome) {
+    const idempotencyKey = (0, idempotency_1.resolveIdempotencyKey)(intent);
+    const journal = new journal_1.JournalStore((0, config_1.resolveJournalPath)(customHome));
+    try {
+        const preflight = await (0, rpc_1.runRpcPreflight)(chain, intent.rpcUrl);
+        const existing = journal.getByIdempotencyKey(idempotencyKey);
+        if (existing && existing.status === "confirmed") {
+            return mapJournalToResult(existing);
+        }
+        if (existing && existing.status === "submitted" && existing.txHash) {
+            if (!intent.waitForReceipt) {
+                return mapJournalToResult(existing);
+            }
+            const receipt = await waitForConfirmation(intent, { client: preflight.client, journal, idempotencyKey, existing }, existing.txHash);
+            return {
+                ...mapJournalToResult(existing),
+                status: "confirmed",
+                receipt,
+            };
+        }
+        const viemChain = (0, chains_1.toViemChain)(chain, intent.rpcUrl);
+        const signerRuntime = await (0, signer_1.resolveSignerRuntime)(intent.signer, preflight.client, intent.rpcUrl, viemChain, customHome);
+        if (!signerRuntime.summary.canSign || !signerRuntime.sendTransaction || !signerRuntime.summary.address) {
+            throw new errors_1.CliError("READONLY_SIGNER", "Selected signer cannot submit transactions.", 2, {
+                signerType: signerRuntime.summary.signerType,
+                backendStatus: signerRuntime.summary.backendStatus,
+            });
+        }
+        const fromAddress = signerRuntime.summary.address;
+        const toAddress = intent.to;
+        const dataHex = toHexData(intent.data);
+        // Preflight simulation catches most runtime reverts before submit.
+        try {
+            await preflight.client.call({
+                account: fromAddress,
+                to: toAddress,
+                data: dataHex,
+                value: intent.valueWei,
+            });
+        }
+        catch (error) {
+            throw new errors_1.CliError("SIMULATION_REVERT", "Transaction simulation reverted.", 2, {
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+        const gasLimit = await preflight.client.estimateGas({
+            account: fromAddress,
+            to: toAddress,
+            data: dataHex,
+            value: intent.valueWei,
+        });
+        const feeEstimate = await preflight.client.estimateFeesPerGas();
+        const maxFeePerGas = feeEstimate.maxFeePerGas;
+        const maxPriorityFeePerGas = feeEstimate.maxPriorityFeePerGas;
+        const balanceWei = await preflight.client.getBalance({ address: fromAddress });
+        const requiredWei = (intent.valueWei || 0n) + gasLimit * (maxFeePerGas || 0n);
+        if (balanceWei < requiredWei) {
+            throw new errors_1.CliError("INSUFFICIENT_FUNDS_PRECHECK", "Account balance is below estimated transaction requirement.", 2, {
+                from: fromAddress,
+                balanceWei: balanceWei.toString(),
+                requiredWei: requiredWei.toString(),
+            });
+        }
+        (0, policy_1.enforcePolicy)({
+            policy: intent.policy,
+            to: toAddress,
+            valueWei: intent.valueWei,
+            gasLimit,
+            maxFeePerGasWei: maxFeePerGas,
+            maxPriorityFeePerGasWei: maxPriorityFeePerGas,
+        });
+        const ctx = {
+            client: preflight.client,
+            journal,
+            idempotencyKey,
+            existing,
+        };
+        const nonce = await resolveNonce(intent, ctx, fromAddress);
+        journal.upsertPrepared({
+            idempotencyKey,
+            profileName: intent.profileName,
+            chainId: intent.chainId,
+            command: intent.command,
+            toAddress,
+            fromAddress,
+            valueWei: intent.valueWei?.toString() || "0",
+            dataHex,
+            nonce,
+            gasLimit: gasLimit.toString(),
+            maxFeePerGasWei: maxFeePerGas?.toString() || "",
+            maxPriorityFeePerGasWei: maxPriorityFeePerGas?.toString() || "",
+            status: "prepared",
+        });
+        const txHash = await signerRuntime.sendTransaction({
+            chain: viemChain,
+            to: toAddress,
+            data: dataHex,
+            value: intent.valueWei,
+            gas: gasLimit,
+            nonce,
+            ...(maxFeePerGas ? { maxFeePerGas } : {}),
+            ...(maxPriorityFeePerGas ? { maxPriorityFeePerGas } : {}),
+        });
+        journal.markSubmitted({
+            idempotencyKey,
+            txHash,
+            status: "submitted",
+            errorCode: "",
+            errorMessage: "",
+        });
+        if (!intent.waitForReceipt) {
+            return {
+                idempotencyKey,
+                txHash,
+                from: fromAddress,
+                to: toAddress,
+                nonce,
+                gasLimit: gasLimit.toString(),
+                maxFeePerGasWei: maxFeePerGas?.toString(),
+                maxPriorityFeePerGasWei: maxPriorityFeePerGas?.toString(),
+                status: "submitted",
+            };
+        }
+        const receipt = await waitForConfirmation(intent, ctx, txHash);
+        return {
+            idempotencyKey,
+            txHash,
+            from: fromAddress,
+            to: toAddress,
+            nonce,
+            gasLimit: gasLimit.toString(),
+            maxFeePerGasWei: maxFeePerGas?.toString(),
+            maxPriorityFeePerGasWei: maxPriorityFeePerGas?.toString(),
+            status: "confirmed",
+            receipt,
+        };
+    }
+    catch (error) {
+        if (error instanceof errors_1.CliError) {
+            journal.markFailed(idempotencyKey, error.code, error.message);
+            throw error;
+        }
+        const unknown = new errors_1.CliError("TX_EXECUTION_FAILED", "Transaction execution failed.", 1, {
+            correlationId: (0, crypto_1.randomUUID)(),
+            message: error instanceof Error ? error.message : String(error),
+        });
+        journal.markFailed(idempotencyKey, unknown.code, unknown.message);
+        throw unknown;
+    }
+    finally {
+        journal.close();
+    }
+}
+function getJournalEntryByIdempotency(idempotencyKey, customHome) {
+    const journal = new journal_1.JournalStore((0, config_1.resolveJournalPath)(customHome));
+    try {
+        return journal.getByIdempotencyKey(idempotencyKey);
+    }
+    finally {
+        journal.close();
+    }
+}
+function getJournalEntryByHash(txHash, customHome) {
+    const journal = new journal_1.JournalStore((0, config_1.resolveJournalPath)(customHome));
+    try {
+        return journal.getByTxHash(txHash);
+    }
+    finally {
+        journal.close();
+    }
+}
+function getRecentJournalEntries(limit = 20, customHome) {
+    const journal = new journal_1.JournalStore((0, config_1.resolveJournalPath)(customHome));
+    try {
+        return journal.listRecent(limit);
+    }
+    finally {
+        journal.close();
+    }
+}
+async function resumeTransaction(idempotencyKey, chain, rpcUrl, timeoutMs = 120000, customHome) {
+    const journal = new journal_1.JournalStore((0, config_1.resolveJournalPath)(customHome));
+    try {
+        const entry = journal.getByIdempotencyKey(idempotencyKey);
+        if (!entry) {
+            throw new errors_1.CliError("TX_NOT_FOUND", `No transaction found for idempotency key '${idempotencyKey}'.`, 2);
+        }
+        if (!entry.txHash) {
+            throw new errors_1.CliError("TX_NOT_FOUND", `Transaction '${idempotencyKey}' has no submitted hash yet.`, 2);
+        }
+        if (entry.status === "confirmed") {
+            return mapJournalToResult(entry);
+        }
+        const preflight = await (0, rpc_1.runRpcPreflight)(chain, rpcUrl);
+        const receipt = await preflight.client.waitForTransactionReceipt({
+            hash: entry.txHash,
+            timeout: timeoutMs,
+        });
+        const receiptSummary = formatReceipt({
+            blockNumber: receipt.blockNumber,
+            gasUsed: receipt.gasUsed,
+            status: receipt.status,
+        });
+        journal.markConfirmed(idempotencyKey, JSON.stringify(receiptSummary));
+        return {
+            ...mapJournalToResult(entry),
+            status: "confirmed",
+            receipt: receiptSummary,
+        };
+    }
+    finally {
+        journal.close();
+    }
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "aavegotchi-cli",
+  "version": "0.1.0",
+  "description": "Agent-first CLI for automating Aavegotchi app and onchain workflows",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aavegotchi/aavegotchi-cli.git"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "ag": "dist/index.js",
+    "aavegotchi-cli": "dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "parity:check": "node scripts/check-parity.mjs",
+    "ag": "tsx src/index.ts",
+    "prepack": "npm run build",
+    "bootstrap:smoke": "AGCLI_HOME=/tmp/agcli-smoke tsx src/index.ts bootstrap --mode agent --profile smoke --chain base --signer readonly --json"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.8.1",
+    "pino": "^9.11.0",
+    "viem": "^2.39.3",
+    "yaml": "^2.8.1",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.13.10",
+    "tsx": "^4.20.5",
+    "typescript": "^5.8.2",
+    "vitest": "^4.0.18"
+  }
+}