@sequence0/blockclaw 2.0.0

package/dist/agent/config.js

@@ -0,0 +1,133 @@
+import fs from "node:fs";
+import TOML from "toml";
+import { AGENT_CONFIG, BLOCKCLAW_CONFIG, ensureBlockclawDir } from "../utils/paths.js";
+import { logger } from "../utils/logger.js";
+/** Read the agent's config.toml */
+export function readAgentConfig() {
+    return readToml(AGENT_CONFIG);
+}
+/** Current config schema version */
+const CURRENT_CONFIG_VERSION = 1;
+/** Read the BlockClaw config.toml, migrating old configs if needed */
+export function readBlockclawConfig() {
+    const config = readToml(BLOCKCLAW_CONFIG) ?? {};
+    // Migrate configs that lack a version (pre-versioning)
+    if (config.config_version === undefined) {
+        config.config_version = CURRENT_CONFIG_VERSION;
+        // Backfill missing defaults from v1
+        if (config.heartbeat_interval === undefined)
+            config.heartbeat_interval = 30;
+        // Persist the migrated config so migration only runs once
+        try {
+            writeBlockclawConfig(config);
+        }
+        catch { /* best-effort */ }
+    }
+    return config;
+}
+/** Write the BlockClaw config.toml */
+export function writeBlockclawConfig(config) {
+    ensureBlockclawDir();
+    // Always stamp the current config version
+    config.config_version = CURRENT_CONFIG_VERSION;
+    const lines = [
+        "# BlockClaw Configuration",
+        `# Generated by BlockClaw`,
+        "",
+    ];
+    for (const [key, value] of Object.entries(config)) {
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === "string") {
+            lines.push(`${key} = "${escapeTomlString(value)}"`);
+        }
+        else if (typeof value === "boolean") {
+            lines.push(`${key} = ${value}`);
+        }
+        else if (typeof value === "number") {
+            lines.push(`${key} = ${value}`);
+        }
+        else if (Array.isArray(value)) {
+            lines.push(`${key} = [${value.map(v => `"${escapeTomlString(String(v))}"`).join(", ")}]`);
+        }
+    }
+    fs.writeFileSync(BLOCKCLAW_CONFIG, lines.join("\n") + "\n", { encoding: "utf8", mode: 0o600 });
+}
+/** Set a single config value */
+export function setConfigValue(key, value) {
+    const config = readBlockclawConfig();
+    // Parse value type
+    if (value === "true" || value === "false") {
+        config[key] = value === "true";
+    }
+    else if (/^\d+$/.test(value)) {
+        config[key] = parseInt(value, 10);
+    }
+    else {
+        config[key] = value;
+    }
+    writeBlockclawConfig(config);
+    logger.success(`Set ${key} = ${value}`);
+}
+/** Get a single config value */
+export function getConfigValue(key) {
+    const config = readBlockclawConfig();
+    return config[key];
+}
+/** Initialize default BlockClaw config */
+export function initConfig(network = "mainnet") {
+    const config = {
+        api_port: 8080,
+        network,
+        auto_heal: true,
+        heartbeat_interval: 30,
+        max_restarts: 5,
+        restart_window: 300,
+        auto_update: false,
+        verbose: false,
+    };
+    writeBlockclawConfig(config);
+    logger.success(`Config initialized at ${BLOCKCLAW_CONFIG}`);
+}
+/** Merge agent config + blockclaw config into process options */
+export function mergeConfigs() {
+    const agent = readAgentConfig() ?? {};
+    const bc = readBlockclawConfig();
+    return {
+        network: bc.network ?? agent.network ?? "mainnet",
+        port: agent.port ?? 9000,
+        apiPort: bc.api_port ?? agent.api_port ?? 8080,
+        dataDir: agent.data_dir,
+        rpcUrl: agent.rpc_url,
+        registry: agent.registry,
+        walletFactory: agent.wallet_factory,
+        feeCollector: agent.fee_collector,
+        programRegistry: agent.program_registry,
+        delegationRegistry: agent.delegation_registry,
+        daemon: agent.daemon ?? true,
+        bootstrap: agent.bootstrap,
+        logLevel: agent.log_level ?? "info",
+        externalIp: agent.external_ip,
+        noRegistry: agent.no_registry ?? false,
+    };
+}
+/** Escape a string for safe TOML output */
+function escapeTomlString(value) {
+    return value
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+}
+/** Read and parse a TOML file */
+function readToml(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf8");
+        return TOML.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/agent/config.js.map

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

package/dist/agent/process.d.ts

@@ -0,0 +1,36 @@
+import { ChildProcess } from "node:child_process";
+export interface AgentProcessOptions {
+    binPath: string;
+    network?: string;
+    port?: number;
+    apiPort?: number;
+    dataDir?: string;
+    rpcUrl?: string;
+    registry?: string;
+    walletFactory?: string;
+    feeCollector?: string;
+    programRegistry?: string;
+    delegationRegistry?: string;
+    daemon?: boolean;
+    bootstrap?: string[];
+    logLevel?: string;
+    externalIp?: string;
+    noRegistry?: boolean;
+    configFile?: string;
+}
+/** Spawn the agent binary as a child process */
+export declare function spawnAgent(opts: AgentProcessOptions): ChildProcess;
+/** Check if the agent process is running by PID */
+export declare function isAgentRunning(): {
+    running: boolean;
+    pid: number | null;
+};
+/** Stop the agent process gracefully */
+export declare function stopAgent(apiPort?: number): Promise<boolean>;
+/** Find agent process by name (fallback if no PID file) */
+export declare function findAgentProcess(): Promise<number | null>;
+/** Check if a port is available */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+/** Find an available port starting from a given port */
+export declare function findAvailablePort(startPort: number): Promise<number>;
+//# sourceMappingURL=process.d.ts.map

package/dist/agent/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/agent/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,YAAY,EAAY,MAAM,oBAAoB,CAAC;AAQnE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,YAAY,CAqBlE;AAgCD,mDAAmD;AACnD,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAYzE;AAED,wCAAwC;AACxC,wBAAsB,SAAS,CAAC,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA4DxE;AAsCD,2DAA2D;AAC3D,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ/D;AAED,mCAAmC;AACnC,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED,wDAAwD;AACxD,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK1E"}

package/dist/agent/process.js

@@ -0,0 +1,208 @@
+import { spawn, execFile } from "node:child_process";
+import { promisify } from "node:util";
+import fs from "node:fs";
+import { AGENT_LOG, AGENT_PID_FILE, AGENT_SOCKET, ensureBlockclawDir } from "../utils/paths.js";
+import { logger } from "../utils/logger.js";
+const execFileAsync = promisify(execFile);
+/** Spawn the agent binary as a child process */
+export function spawnAgent(opts) {
+    const args = buildArgs(opts);
+    logger.debug(`Spawning: ${opts.binPath} ${args.join(" ")}`);
+    const logStream = fs.createWriteStream(AGENT_LOG, { flags: "a" });
+    const child = spawn(opts.binPath, args, {
+        stdio: ["ignore", "pipe", "pipe"],
+        detached: opts.daemon ?? false,
+    });
+    child.stdout?.pipe(logStream);
+    child.stderr?.pipe(logStream);
+    if (opts.daemon && child.pid) {
+        writePid(child.pid);
+        child.unref();
+    }
+    return child;
+}
+/** Build CLI arguments from options */
+function buildArgs(opts) {
+    const args = [];
+    if (opts.network)
+        args.push("--network", opts.network);
+    if (opts.port)
+        args.push("--port", String(opts.port));
+    if (opts.apiPort)
+        args.push("--api-port", String(opts.apiPort));
+    if (opts.dataDir)
+        args.push("--data-dir", opts.dataDir);
+    if (opts.rpcUrl)
+        args.push("--rpc-url", opts.rpcUrl);
+    if (opts.registry)
+        args.push("--registry", opts.registry);
+    if (opts.walletFactory)
+        args.push("--wallet-factory", opts.walletFactory);
+    if (opts.feeCollector)
+        args.push("--fee-collector", opts.feeCollector);
+    if (opts.programRegistry)
+        args.push("--program-registry", opts.programRegistry);
+    if (opts.delegationRegistry)
+        args.push("--delegation-registry", opts.delegationRegistry);
+    if (opts.daemon)
+        args.push("--daemon");
+    if (opts.logLevel)
+        args.push("--log-level", opts.logLevel);
+    if (opts.externalIp)
+        args.push("--external-ip", opts.externalIp);
+    if (opts.noRegistry)
+        args.push("--no-registry");
+    if (opts.configFile)
+        args.push("--config", opts.configFile);
+    // Always pass the socket path so the agent creates it
+    args.push("--socket", AGENT_SOCKET);
+    if (opts.bootstrap) {
+        for (const b of opts.bootstrap) {
+            args.push("--bootstrap", b);
+        }
+    }
+    return args;
+}
+/** Check if the agent process is running by PID */
+export function isAgentRunning() {
+    const pid = readPid();
+    if (!pid)
+        return { running: false, pid: null };
+    try {
+        process.kill(pid, 0); // Signal 0 = check existence
+        return { running: true, pid };
+    }
+    catch {
+        // Process not running, clean up stale PID file
+        removePid();
+        return { running: false, pid: null };
+    }
+}
+/** Stop the agent process gracefully */
+export async function stopAgent(apiPort = 8080) {
+    // Try graceful shutdown via Unix socket first (preferred)
+    if (fs.existsSync(AGENT_SOCKET)) {
+        try {
+            const http = await import("node:http");
+            await new Promise((resolve, reject) => {
+                const req = http.default.request({ socketPath: AGENT_SOCKET, path: "/shutdown", method: "POST" }, (res) => { res.resume(); res.on("end", () => resolve()); });
+                req.on("error", reject);
+                req.setTimeout(5000, () => { req.destroy(); reject(new Error("timeout")); });
+                req.end();
+            });
+            logger.debug("Graceful shutdown via Unix socket");
+            await waitForExit(3000);
+            removePid();
+            return true;
+        }
+        catch {
+            // Socket not responding, try TCP
+        }
+    }
+    // Try graceful shutdown via TCP (legacy fallback)
+    try {
+        const response = await fetch(`http://localhost:${apiPort}/shutdown`, {
+            method: "POST",
+            signal: AbortSignal.timeout(5000),
+        });
+        if (response.ok) {
+            logger.debug("Graceful shutdown via TCP fallback");
+            await waitForExit(3000);
+            removePid();
+            return true;
+        }
+    }
+    catch {
+        // API not responding, try SIGTERM
+    }
+    // Fall back to SIGTERM
+    const { running, pid } = isAgentRunning();
+    if (!running || !pid)
+        return false;
+    try {
+        process.kill(pid, "SIGTERM");
+        logger.debug(`Sent SIGTERM to PID ${pid}`);
+        await waitForExit(5000);
+        removePid();
+        return true;
+    }
+    catch {
+        // Force kill
+        try {
+            process.kill(pid, "SIGKILL");
+            logger.debug(`Sent SIGKILL to PID ${pid}`);
+            removePid();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/** Wait for the agent process to exit */
+async function waitForExit(timeoutMs) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        const { running } = isAgentRunning();
+        if (!running)
+            return;
+        await new Promise((r) => setTimeout(r, 200));
+    }
+}
+/** Write PID to file */
+function writePid(pid) {
+    ensureBlockclawDir();
+    fs.writeFileSync(AGENT_PID_FILE, String(pid), "utf8");
+}
+/** Read PID from file */
+function readPid() {
+    try {
+        const content = fs.readFileSync(AGENT_PID_FILE, "utf8").trim();
+        const pid = parseInt(content, 10);
+        return isNaN(pid) ? null : pid;
+    }
+    catch {
+        return null;
+    }
+}
+/** Remove PID file */
+function removePid() {
+    try {
+        fs.unlinkSync(AGENT_PID_FILE);
+    }
+    catch {
+        // File may not exist
+    }
+}
+/** Find agent process by name (fallback if no PID file) */
+export async function findAgentProcess() {
+    try {
+        const { stdout } = await execFileAsync("pgrep", ["-f", "sequence0-agent"], { timeout: 3000 });
+        const pids = stdout.trim().split("\n").map(Number).filter(Boolean);
+        return pids.length > 0 ? pids[0] : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Check if a port is available */
+export async function isPortAvailable(port) {
+    const net = await import("node:net");
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once("error", () => resolve(false));
+        server.once("listening", () => {
+            server.close(() => resolve(true));
+        });
+        server.listen(port, "127.0.0.1");
+    });
+}
+/** Find an available port starting from a given port */
+export async function findAvailablePort(startPort) {
+    for (let port = startPort; port < startPort + 100; port++) {
+        if (await isPortAvailable(port))
+            return port;
+    }
+    throw new Error(`No available port found in range ${startPort}-${startPort + 99}`);
+}
+//# sourceMappingURL=process.js.map

package/dist/agent/process.js.map

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

package/dist/agent/wallet.d.ts

@@ -0,0 +1,43 @@
+import { AgentClient, type WalletRecord } from "./client.js";
+/** Wallet operations wrapper around the agent IPC client */
+export declare class WalletManager {
+    private client;
+    constructor(client: AgentClient);
+    /** List all wallets */
+    list(): Promise<WalletRecord[]>;
+    /**
+     * Create a universal wallet that works on ALL supported chains.
+     *
+     * Internally creates two DKG wallets (secp256k1 + ed25519) and presents
+     * them as a single wallet to the user. The user never sees curve types.
+     */
+    createUniversal(opts: {
+        walletId: string;
+        participants?: string[];
+        threshold?: number;
+        creator?: string;
+    }): Promise<{
+        secp256k1Id: string;
+        ed25519Id: string;
+    }>;
+    /**
+     * Create a single-curve wallet (for power users who know what they want).
+     */
+    create(opts: {
+        walletId: string;
+        participants?: string[];
+        threshold?: number;
+        curve?: string;
+        creator?: string;
+    }): Promise<void>;
+    /** Get wallet info */
+    balance(walletId: string): Promise<WalletRecord>;
+    /**
+     * Check if a wallet pair exists (secp256k1 + ed25519 = universal wallet).
+     * Returns true if both `{name}` and `{name}-ed` exist.
+     */
+    isUniversalWallet(walletId: string, allWallets: WalletRecord[]): boolean;
+    /** Print wallet list — groups universal wallet pairs as single entries */
+    printList(): Promise<void>;
+}
+//# sourceMappingURL=wallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/agent/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAM7D,4DAA4D;AAC5D,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEvC,uBAAuB;IACjB,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIrC;;;;;OAKG;IACG,eAAe,CAAC,IAAI,EAAE;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAuCvD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBjB,sBAAsB;IAChB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAOtD;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO;IAKxE,0EAA0E;IACpE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAwDjC"}

package/dist/agent/wallet.js

@@ -0,0 +1,146 @@
+import { logger } from "../utils/logger.js";
+import { formatAddress } from "../utils/format.js";
+import { CHAINS } from "./chains.js";
+import pc from "picocolors";
+/** Wallet operations wrapper around the agent IPC client */
+export class WalletManager {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** List all wallets */
+    async list() {
+        return this.client.wallets();
+    }
+    /**
+     * Create a universal wallet that works on ALL supported chains.
+     *
+     * Internally creates two DKG wallets (secp256k1 + ed25519) and presents
+     * them as a single wallet to the user. The user never sees curve types.
+     */
+    async createUniversal(opts) {
+        // Get peer list if participants not provided
+        let participants = opts.participants;
+        if (!participants || participants.length === 0) {
+            const status = await this.client.status();
+            participants = [status.peer_id, ...status.connected_peer_ids];
+        }
+        if (!participants || participants.length < 2) {
+            throw new Error("Need at least 2 network members to create a wallet. Check your network connection.");
+        }
+        const threshold = opts.threshold ?? Math.ceil((participants.length * 2) / 3);
+        // Create secp256k1 wallet (Ethereum, Bitcoin, Polygon, etc.)
+        const secpId = opts.walletId;
+        await this.client.initiateDkg({
+            wallet_id: secpId,
+            participants,
+            threshold,
+            curve: "secp256k1",
+            creator: opts.creator,
+            timestamp: Date.now(),
+        });
+        // Create ed25519 wallet (Solana, Sui, Aptos, etc.)
+        const edId = `${opts.walletId}-ed`;
+        await this.client.initiateDkg({
+            wallet_id: edId,
+            participants,
+            threshold,
+            curve: "ed25519",
+            creator: opts.creator,
+            timestamp: Date.now(),
+        });
+        return { secp256k1Id: secpId, ed25519Id: edId };
+    }
+    /**
+     * Create a single-curve wallet (for power users who know what they want).
+     */
+    async create(opts) {
+        let participants = opts.participants;
+        if (!participants || participants.length === 0) {
+            const status = await this.client.status();
+            participants = [status.peer_id, ...status.connected_peer_ids];
+        }
+        if (!participants || participants.length < 2) {
+            throw new Error("Need at least 2 network members to create a wallet. Check your network connection.");
+        }
+        const threshold = opts.threshold ?? Math.ceil((participants.length * 2) / 3);
+        const curve = opts.curve ?? "secp256k1";
+        await this.client.initiateDkg({
+            wallet_id: opts.walletId,
+            participants,
+            threshold,
+            curve,
+            creator: opts.creator,
+            timestamp: Date.now(),
+        });
+    }
+    /** Get wallet info */
+    async balance(walletId) {
+        const wallets = await this.list();
+        const wallet = wallets.find((w) => w.wallet_id === walletId);
+        if (!wallet)
+            throw new Error(`Wallet not found: ${walletId}`);
+        return wallet;
+    }
+    /**
+     * Check if a wallet pair exists (secp256k1 + ed25519 = universal wallet).
+     * Returns true if both `{name}` and `{name}-ed` exist.
+     */
+    isUniversalWallet(walletId, allWallets) {
+        const edId = `${walletId}-ed`;
+        return allWallets.some((w) => w.wallet_id === edId);
+    }
+    /** Print wallet list — groups universal wallet pairs as single entries */
+    async printList() {
+        const wallets = await this.list();
+        if (wallets.length === 0) {
+            logger.info("No wallets found. Create one with: blockclaw wallet create");
+            return;
+        }
+        console.log();
+        console.log(`  ${pc.bold("Wallets")}`);
+        console.log();
+        const shown = new Set();
+        const secpCount = CHAINS.filter((c) => c.curve === "secp256k1").length;
+        const edCount = CHAINS.filter((c) => c.curve === "ed25519").length;
+        const totalChains = secpCount + edCount;
+        for (const w of wallets) {
+            if (shown.has(w.wallet_id))
+                continue;
+            // Check if this is part of a universal wallet pair
+            const edPair = wallets.find((x) => x.wallet_id === `${w.wallet_id}-ed`);
+            const isEdHalf = w.wallet_id.endsWith("-ed");
+            // Skip the -ed half — it's shown as part of the pair
+            if (isEdHalf) {
+                const baseName = w.wallet_id.slice(0, -3);
+                if (wallets.some((x) => x.wallet_id === baseName)) {
+                    shown.add(w.wallet_id);
+                    continue;
+                }
+            }
+            shown.add(w.wallet_id);
+            if (edPair) {
+                // Universal wallet — show as one entry
+                shown.add(edPair.wallet_id);
+                const addr = w.address ? formatAddress(w.address) : pc.dim("pending");
+                console.log(`  ${pc.cyan(w.wallet_id)}`);
+                console.log(`    ${pc.dim("Address:")}   ${addr}`);
+                console.log(`    ${pc.dim("Security:")}  ${w.threshold}-of-${w.participants.length}`);
+                console.log(`    ${pc.dim("Chains:")}    All ${totalChains} supported chains`);
+                console.log();
+            }
+            else {
+                // Single-curve wallet
+                const addr = w.address ? formatAddress(w.address) : pc.dim("pending");
+                const curve = w.chain ?? "secp256k1";
+                const chainCount = CHAINS.filter((c) => c.curve === curve).length;
+                console.log(`  ${pc.cyan(w.wallet_id)}`);
+                console.log(`    ${pc.dim("Address:")}   ${addr}`);
+                console.log(`    ${pc.dim("Security:")}  ${w.threshold}-of-${w.participants.length}`);
+                console.log(`    ${pc.dim("Chains:")}    ${chainCount} compatible chains`);
+                console.log();
+            }
+        }
+    }
+}
+//# sourceMappingURL=wallet.js.map

package/dist/agent/wallet.js.map

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

package/dist/ai/brain.d.ts

@@ -0,0 +1,21 @@
+import { AgentClient } from "../agent/client.js";
+import { Memory } from "../core/memory.js";
+type AIProvider = "claude" | "ollama" | "rules";
+/** AI Brain — orchestrates responses from rules engine or LLM */
+export declare class Brain {
+    private client;
+    private memory;
+    private rules;
+    private provider;
+    constructor(client: AgentClient, memory: Memory);
+    /** Process a query and return a response */
+    ask(question: string): Promise<string>;
+    getProvider(): AIProvider;
+    private detectProvider;
+    private gatherContext;
+    private callLLM;
+    private callClaude;
+    private callOllama;
+}
+export {};
+//# sourceMappingURL=brain.d.ts.map

package/dist/ai/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/ai/brain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAO3C,KAAK,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhD,iEAAiE;AACjE,qBAAa,KAAK;IAKd,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAa;gBAGnB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM;IAMxB,4CAA4C;IACtC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc5C,WAAW,IAAI,UAAU;IAIzB,OAAO,CAAC,cAAc;YAOR,aAAa;YA6Bb,OAAO;YAMP,UAAU;YAuBV,UAAU;CAoBzB"}