arc402-cli 1.8.6 → 1.8.8

package/dist/commands/telegram.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerTelegramCommands(program: Command): void;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/commands/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/commands/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoDpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6G/D"}

package/dist/commands/telegram.js

@@ -0,0 +1,147 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTelegramCommands = registerTelegramCommands;
+const prompts_1 = __importDefault(require("prompts"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../config");
+const colors_1 = require("../ui/colors");
+async function telegramApi(botToken, method, body) {
+    const res = await fetch(`https://api.telegram.org/bot${botToken}/${method}`, {
+        method: body ? "POST" : "GET",
+        headers: body ? { "Content-Type": "application/json" } : undefined,
+        body: body ? JSON.stringify(body) : undefined,
+        signal: AbortSignal.timeout(15000),
+    });
+    const json = await res.json();
+    return json;
+}
+async function validateBotToken(botToken) {
+    try {
+        const res = await telegramApi(botToken, "getMe");
+        if (!res.ok)
+            return { ok: false, error: res.description ?? "Telegram rejected the bot token." };
+        return { ok: true, username: res.result?.username };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+async function sendTestMessage(botToken, chatId, threadId) {
+    try {
+        const res = await telegramApi(botToken, "sendMessage", {
+            chat_id: chatId,
+            ...(threadId !== undefined ? { message_thread_id: threadId } : {}),
+            text: "🔧 ARC-402 CLI Telegram delivery test — approval prompts can be sent here.",
+        });
+        if (!res.ok || !res.result)
+            return { ok: false, error: res.description ?? "Telegram rejected the test message." };
+        return { ok: true, messageId: res.result.message_id };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+function registerTelegramCommands(program) {
+    const telegram = program.command("telegram").description("Configure Telegram delivery for WalletConnect approval prompts");
+    telegram.command("show")
+        .description("Show current Telegram delivery settings")
+        .action(() => {
+        const cfg = (0, config_1.loadConfig)();
+        console.log(JSON.stringify({
+            telegramBotToken: cfg.telegramBotToken ? "***configured***" : undefined,
+            telegramChatId: cfg.telegramChatId,
+            telegramThreadId: cfg.telegramThreadId,
+        }, null, 2));
+    });
+    telegram.command("init")
+        .description("Interactive setup for Telegram approval-button delivery")
+        .option("--bot-token <token>", "Telegram bot token from BotFather")
+        .option("--chat-id <id>", "Telegram chat ID, e.g. 123456789 or -100... for groups")
+        .option("--thread-id <id>", "Telegram topic/thread ID for forum groups")
+        .option("--skip-test", "Skip sending a Telegram test message")
+        .action(async (opts) => {
+        const existing = (0, config_1.loadConfig)();
+        console.log();
+        console.log(chalk_1.default.white("Telegram approval-button setup"));
+        console.log(chalk_1.default.dim("  1. Create a bot with @BotFather"));
+        console.log(chalk_1.default.dim("  2. Add that bot to the target chat/group"));
+        console.log(chalk_1.default.dim("  3. Paste the bot token + chat ID below"));
+        console.log(chalk_1.default.dim("  4. Optional: add a forum topic/thread ID"));
+        console.log();
+        const answers = await (0, prompts_1.default)([
+            {
+                type: opts.botToken ? null : "text",
+                name: "botToken",
+                message: "Telegram bot token",
+                initial: existing.telegramBotToken,
+                validate: (value) => value.trim().length > 20 ? true : "Enter a valid bot token from BotFather.",
+            },
+            {
+                type: opts.chatId ? null : "text",
+                name: "chatId",
+                message: "Telegram chat ID",
+                initial: existing.telegramChatId,
+                validate: (value) => value.trim() ? true : "Chat ID is required.",
+            },
+            {
+                type: opts.threadId !== undefined ? null : "text",
+                name: "threadId",
+                message: "Telegram thread/topic ID (optional)",
+                initial: existing.telegramThreadId !== undefined ? String(existing.telegramThreadId) : undefined,
+                validate: (value) => !value.trim() || /^\d+$/.test(value.trim()) ? true : "Thread ID must be numeric.",
+            },
+        ], {
+            onCancel: () => {
+                console.log(chalk_1.default.red("✗ Telegram setup cancelled"));
+                return true;
+            },
+        });
+        const botToken = (opts.botToken ?? answers.botToken ?? existing.telegramBotToken ?? "").trim();
+        const chatId = (opts.chatId ?? answers.chatId ?? existing.telegramChatId ?? "").trim();
+        const threadRaw = (opts.threadId ?? answers.threadId ?? "").trim();
+        const threadId = threadRaw ? Number(threadRaw) : undefined;
+        if (!botToken || !chatId) {
+            console.log(chalk_1.default.red("✗ Telegram setup incomplete"));
+            return;
+        }
+        process.stdout.write("Validating bot token… ");
+        const botCheck = await validateBotToken(botToken);
+        if (!botCheck.ok) {
+            console.log(chalk_1.default.red("failed"));
+            console.log(chalk_1.default.red(`  ${botCheck.error}`));
+            console.log(chalk_1.default.dim("  Fix the bot token first, then rerun `arc402 telegram init`."));
+            return;
+        }
+        console.log(chalk_1.default.green(`✓ ${botCheck.username ? `@${botCheck.username}` : "bot ok"}`));
+        const cfg = {
+            ...existing,
+            telegramBotToken: botToken,
+            telegramChatId: chatId,
+            ...(threadId !== undefined ? { telegramThreadId: threadId } : {}),
+        };
+        if (threadId === undefined)
+            delete cfg.telegramThreadId;
+        (0, config_1.saveConfig)(cfg);
+        console.log();
+        console.log(" " + colors_1.c.success + colors_1.c.white(" Telegram delivery saved"));
+        console.log(chalk_1.default.dim("  Chat ID          ") + chalk_1.default.white(chatId));
+        console.log(chalk_1.default.dim("  Thread ID        ") + chalk_1.default.white(threadId !== undefined ? String(threadId) : "(none)"));
+        console.log();
+        if (!opts.skipTest) {
+            process.stdout.write("Sending test message… ");
+            const test = await sendTestMessage(botToken, chatId, threadId);
+            if (!test.ok) {
+                console.log(chalk_1.default.red("failed"));
+                console.log(chalk_1.default.red(`  ${test.error}`));
+                console.log(chalk_1.default.dim("  The config is saved, but Telegram delivery will not work until the bot can message that chat/topic."));
+                return;
+            }
+            console.log(chalk_1.default.green(`✓ message ${test.messageId}`));
+        }
+        console.log(chalk_1.default.dim("  Next: any WalletConnect-backed ARC-402 CLI command can now send approval prompts here."));
+    });
+}
+//# sourceMappingURL=telegram.js.map

package/dist/commands/telegram.js.map

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

package/dist/commands/wallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/commands/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0qBpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4tG7D"}
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/commands/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwrBpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuuG7D"}

package/dist/commands/wallet.js

@@ -158,6 +158,13 @@ function getWalletAddressFromFactoryLogs(factoryInterface, logs) {
     }
     return null;
 }
+async function assertAddressHasCode(provider, address, label) {
+    const code = await provider.getCode(address);
+    if (code !== "0x")
+        return;
+    throw new Error(`${label} ${address} has no contract code. ` +
+        `This usually means an owner EOA was saved instead of the deployed ARC402Wallet contract.`);
+}
 // Standard onboarding categories required for a newly deployed wallet.
 // These cover the full ARC-402 flow: spending, hiring, compute, research, protocol ops.
 const ONBOARDING_CATEGORIES = [
@@ -1100,6 +1107,7 @@ function registerWalletCommands(program) {
                 console.error("UserOperation failed on-chain.");
                 process.exit(1);
             }
+            await assertAddressHasCode(provider, senderAddress, "Deployed wallet");
             config.walletContractAddress = senderAddress;
             config.ownerAddress = ownerAddress;
             (0, config_1.saveConfig)(config);
@@ -1229,6 +1237,7 @@ function registerWalletCommands(program) {
                     console.error("Could not find WalletDeployed/WalletCreated event in receipt. Check the transaction on-chain.");
                     process.exit(1);
                 }
+                await assertAddressHasCode(provider, deployedWallet, "Deployed wallet");
                 walletAddress = deployedWallet;
                 // ── Step 1 complete: save wallet + owner immediately ─────────────────
                 config.walletContractAddress = walletAddress;
@@ -1269,6 +1278,7 @@ function registerWalletCommands(program) {
                 deploySpinner.fail("Could not find WalletDeployed/WalletCreated event in receipt. Check the transaction on-chain.");
                 process.exit(1);
             }
+            await assertAddressHasCode(provider, walletAddress, "Deployed wallet");
             deploySpinner.succeed("Wallet deployed");
             // Generate guardian key (separate from hot key) and call setGuardian
             const guardianWallet = ethers_1.ethers.Wallet.createRandom();
@@ -1327,6 +1337,14 @@ function registerWalletCommands(program) {
         const policyAddress = resolvePolicyEngineAddress(config);
         const chainId = config.network === "base-mainnet" ? 8453 : 84532;
         const provider = new ethers_1.ethers.JsonRpcProvider(config.rpcUrl);
+        try {
+            await assertAddressHasCode(provider, walletAddress, "Configured walletContractAddress");
+        }
+        catch (error) {
+            console.error(colors_1.c.failure + " " + colors_1.c.red(error instanceof Error ? error.message : String(error)));
+            console.error(colors_1.c.dim("Tip: use the deployed wallet contract address, not the owner EOA, then rerun onboarding."));
+            process.exit(1);
+        }
         // Resolve protocol contracts to whitelist
         const handshakeAddress = config.handshakeAddress ??
             config_1.NETWORK_DEFAULTS[config.network]?.handshakeAddress ??