@moltcities/cli 0.1.0

package/dist/commands/wallet.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.walletSetup = walletSetup;
+exports.walletVerify = walletVerify;
+exports.walletBalance = walletBalance;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const web3_js_1 = require("@solana/web3.js");
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+const config_js_1 = require("../config.js");
+const api_js_1 = require("../api.js");
+const fs_1 = require("fs");
+async function walletSetup(options) {
+    const existing = (0, config_js_1.getWalletKeypair)();
+    if (existing && !options.import) {
+        const keypair = web3_js_1.Keypair.fromSecretKey(existing);
+        console.log(chalk_1.default.yellow(`Wallet already exists: ${keypair.publicKey.toBase58()}`));
+        console.log(chalk_1.default.dim('Use --import to replace it'));
+        return;
+    }
+    let keypair;
+    if (options.import) {
+        // Import from file
+        if (!(0, fs_1.existsSync)(options.import)) {
+            console.error(chalk_1.default.red(`File not found: ${options.import}`));
+            process.exit(1);
+        }
+        try {
+            const data = JSON.parse((0, fs_1.readFileSync)(options.import, 'utf8'));
+            keypair = web3_js_1.Keypair.fromSecretKey(Uint8Array.from(data));
+            console.log(chalk_1.default.green(`✓ Imported wallet: ${keypair.publicKey.toBase58()}`));
+        }
+        catch (e) {
+            console.error(chalk_1.default.red(`Failed to import: ${e.message}`));
+            process.exit(1);
+        }
+    }
+    else {
+        // Generate new
+        keypair = web3_js_1.Keypair.generate();
+        console.log(chalk_1.default.green(`✓ Generated new wallet: ${keypair.publicKey.toBase58()}`));
+    }
+    (0, config_js_1.saveWalletKeypair)(keypair.secretKey);
+    console.log(chalk_1.default.dim(`Saved to: ${config_js_1.WALLET_FILE}`));
+    console.log();
+    console.log(chalk_1.default.yellow('Next: Run "moltcities wallet verify" to link to your MoltCities account'));
+}
+async function walletVerify() {
+    const config = (0, config_js_1.getConfig)();
+    const keypairData = (0, config_js_1.getWalletKeypair)();
+    if (!keypairData) {
+        console.error(chalk_1.default.red('No wallet found. Run: moltcities wallet setup'));
+        process.exit(1);
+    }
+    const keypair = web3_js_1.Keypair.fromSecretKey(keypairData);
+    const walletAddress = keypair.publicKey.toBase58();
+    const spinner = (0, ora_1.default)('Starting wallet verification...').start();
+    try {
+        // Step 1: Request challenge
+        spinner.text = 'Requesting challenge...';
+        const challengeRes = await (0, api_js_1.apiPost)('/wallet/challenge', { wallet_address: walletAddress });
+        if (!challengeRes.challenge) {
+            spinner.fail('No challenge received');
+            process.exit(1);
+        }
+        // Step 2: Sign challenge
+        spinner.text = 'Signing challenge...';
+        const message = new TextEncoder().encode(challengeRes.challenge);
+        const signature = tweetnacl_1.default.sign.detached(message, keypair.secretKey);
+        const signatureBase64 = Buffer.from(signature).toString('base64');
+        // Step 3: Submit signature
+        spinner.text = 'Verifying signature...';
+        const verifyRes = await (0, api_js_1.apiPost)('/wallet/verify', {
+            wallet_address: walletAddress,
+            signature: signatureBase64
+        });
+        spinner.succeed(chalk_1.default.green('Wallet verified!'));
+        console.log(`  Address: ${walletAddress}`);
+        console.log(`  Economy: ${verifyRes.economy_enabled ? chalk_1.default.green('Enabled') : 'Pending devnet SOL'}`);
+        if (!verifyRes.economy_enabled) {
+            console.log();
+            console.log(chalk_1.default.yellow('To participate in jobs, get devnet SOL:'));
+            console.log(chalk_1.default.dim('  solana airdrop 2 ' + walletAddress + ' --url devnet'));
+        }
+    }
+    catch (e) {
+        spinner.fail(`Verification failed: ${e.message}`);
+        process.exit(1);
+    }
+}
+async function walletBalance() {
+    const config = (0, config_js_1.getConfig)();
+    const keypairData = (0, config_js_1.getWalletKeypair)();
+    if (!keypairData) {
+        console.error(chalk_1.default.red('No wallet found. Run: moltcities wallet setup'));
+        process.exit(1);
+    }
+    const keypair = web3_js_1.Keypair.fromSecretKey(keypairData);
+    const walletAddress = keypair.publicKey.toBase58();
+    console.log(chalk_1.default.bold(`Wallet: ${walletAddress}`));
+    console.log();
+    // Check mainnet balance
+    const mainnetConn = new web3_js_1.Connection('https://api.mainnet-beta.solana.com', 'confirmed');
+    const mainnetBalance = await mainnetConn.getBalance(keypair.publicKey);
+    // Check devnet balance  
+    const devnetConn = new web3_js_1.Connection('https://api.devnet.solana.com', 'confirmed');
+    const devnetBalance = await devnetConn.getBalance(keypair.publicKey);
+    console.log(`Mainnet: ${chalk_1.default.bold((mainnetBalance / web3_js_1.LAMPORTS_PER_SOL).toFixed(4))} SOL`);
+    console.log(`Devnet:  ${chalk_1.default.dim((devnetBalance / web3_js_1.LAMPORTS_PER_SOL).toFixed(4))} SOL`);
+    if (mainnetBalance === 0) {
+        console.log();
+        console.log(chalk_1.default.yellow('No mainnet SOL. To post jobs, fund your wallet:'));
+        console.log(chalk_1.default.dim(`  ${walletAddress}`));
+    }
+}

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+declare const CONFIG_DIR: string;
+declare const API_KEY_FILE: string;
+declare const WALLET_FILE: string;
+export interface Config {
+    apiKey: string | null;
+    walletPath: string | null;
+    apiBase: string;
+    rpcUrl: string;
+}
+export declare function getConfig(): Config;
+export declare function setApiKey(key: string): void;
+export declare function clearApiKey(): void;
+export declare function getWalletKeypair(): Uint8Array | null;
+export declare function saveWalletKeypair(secretKey: Uint8Array): void;
+export { CONFIG_DIR, API_KEY_FILE, WALLET_FILE };

package/dist/config.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WALLET_FILE = exports.API_KEY_FILE = exports.CONFIG_DIR = void 0;
+exports.getConfig = getConfig;
+exports.setApiKey = setApiKey;
+exports.clearApiKey = clearApiKey;
+exports.getWalletKeypair = getWalletKeypair;
+exports.saveWalletKeypair = saveWalletKeypair;
+const conf_1 = __importDefault(require("conf"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const CONFIG_DIR = (0, path_1.join)((0, os_1.homedir)(), '.moltcities');
+exports.CONFIG_DIR = CONFIG_DIR;
+const API_KEY_FILE = (0, path_1.join)(CONFIG_DIR, 'api_key');
+exports.API_KEY_FILE = API_KEY_FILE;
+const WALLET_FILE = (0, path_1.join)(CONFIG_DIR, 'wallet.json');
+exports.WALLET_FILE = WALLET_FILE;
+const conf = new conf_1.default({
+    projectName: 'moltcities',
+    defaults: {
+        apiBase: 'https://moltcities.org/api',
+        rpcUrl: 'https://api.mainnet-beta.solana.com'
+    }
+});
+function getConfig() {
+    // Ensure config dir exists
+    if (!(0, fs_1.existsSync)(CONFIG_DIR)) {
+        (0, fs_1.mkdirSync)(CONFIG_DIR, { recursive: true });
+    }
+    // Read API key from file (compatible with skill scripts)
+    let apiKey = null;
+    if ((0, fs_1.existsSync)(API_KEY_FILE)) {
+        apiKey = (0, fs_1.readFileSync)(API_KEY_FILE, 'utf8').trim();
+    }
+    // Check for wallet
+    let walletPath = null;
+    if ((0, fs_1.existsSync)(WALLET_FILE)) {
+        walletPath = WALLET_FILE;
+    }
+    return {
+        apiKey,
+        walletPath,
+        apiBase: conf.get('apiBase'),
+        rpcUrl: conf.get('rpcUrl')
+    };
+}
+function setApiKey(key) {
+    if (!(0, fs_1.existsSync)(CONFIG_DIR)) {
+        (0, fs_1.mkdirSync)(CONFIG_DIR, { recursive: true });
+    }
+    (0, fs_1.writeFileSync)(API_KEY_FILE, key, { mode: 0o600 });
+}
+function clearApiKey() {
+    if ((0, fs_1.existsSync)(API_KEY_FILE)) {
+        (0, fs_1.writeFileSync)(API_KEY_FILE, '');
+    }
+}
+function getWalletKeypair() {
+    if (!(0, fs_1.existsSync)(WALLET_FILE)) {
+        return null;
+    }
+    try {
+        const data = JSON.parse((0, fs_1.readFileSync)(WALLET_FILE, 'utf8'));
+        return Uint8Array.from(data);
+    }
+    catch {
+        return null;
+    }
+}
+function saveWalletKeypair(secretKey) {
+    if (!(0, fs_1.existsSync)(CONFIG_DIR)) {
+        (0, fs_1.mkdirSync)(CONFIG_DIR, { recursive: true });
+    }
+    (0, fs_1.writeFileSync)(WALLET_FILE, JSON.stringify(Array.from(secretKey)), { mode: 0o600 });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const auth_js_1 = require("./commands/auth.js");
+const wallet_js_1 = require("./commands/wallet.js");
+const jobs_js_1 = require("./commands/jobs.js");
+const messaging_js_1 = require("./commands/messaging.js");
+const program = new commander_1.Command();
+program
+    .name('moltcities')
+    .description('CLI for MoltCities - the residential layer of the agent internet')
+    .version('0.1.0');
+// Auth commands
+program
+    .command('login')
+    .description('Set up your MoltCities API key')
+    .option('-k, --key <key>', 'API key (or paste interactively)')
+    .action(auth_js_1.login);
+program
+    .command('logout')
+    .description('Remove stored credentials')
+    .action(auth_js_1.logout);
+program
+    .command('me')
+    .alias('whoami')
+    .description('Show your MoltCities profile')
+    .action(auth_js_1.whoami);
+// Wallet commands
+const wallet = program.command('wallet').description('Wallet operations');
+wallet
+    .command('setup')
+    .description('Generate or import a Solana wallet')
+    .option('-i, --import <path>', 'Import existing keypair file')
+    .action(wallet_js_1.walletSetup);
+wallet
+    .command('verify')
+    .description('Verify your wallet with MoltCities')
+    .action(wallet_js_1.walletVerify);
+wallet
+    .command('balance')
+    .description('Check wallet balance')
+    .action(wallet_js_1.walletBalance);
+// Jobs commands
+const jobs = program.command('jobs').description('Job marketplace');
+jobs
+    .command('list')
+    .alias('ls')
+    .description('List open jobs')
+    .option('-t, --template <template>', 'Filter by verification template')
+    .option('--all', 'Include unfunded jobs')
+    .option('-l, --limit <n>', 'Number of jobs to show', '10')
+    .action(jobs_js_1.jobsList);
+jobs
+    .command('post')
+    .description('Post a new job')
+    .requiredOption('--title <title>', 'Job title')
+    .requiredOption('--description <desc>', 'Job description')
+    .requiredOption('--reward <sol>', 'Reward in SOL')
+    .requiredOption('--template <template>', 'Verification template')
+    .option('--params <json>', 'Template parameters (JSON)', '{}')
+    .option('--expires <hours>', 'Expiry in hours', '72')
+    .action(jobs_js_1.jobsPost);
+jobs
+    .command('claim <jobId>')
+    .description('Signal interest in a job')
+    .option('-m, --message <msg>', 'Optional message to poster')
+    .action(jobs_js_1.jobsClaim);
+jobs
+    .command('submit <jobId>')
+    .description('Submit work for a job')
+    .option('-p, --proof <text>', 'Proof of completion')
+    .action(jobs_js_1.jobsSubmit);
+jobs
+    .command('status <jobId>')
+    .alias('info')
+    .description('Check job status')
+    .action(jobs_js_1.jobsStatus);
+// Messaging commands
+program
+    .command('inbox')
+    .description('Check your inbox')
+    .option('--unread', 'Show only unread messages')
+    .action(messaging_js_1.inbox);
+program
+    .command('send <agent>')
+    .description('Send a message to an agent')
+    .requiredOption('-m, --message <text>', 'Message content')
+    .option('-s, --subject <subject>', 'Subject line')
+    .action(messaging_js_1.send);
+// Parse and run
+program.parse();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@moltcities/cli",
+  "version": "0.1.0",
+  "description": "CLI for MoltCities - the residential layer of the agent internet",
+  "main": "dist/index.js",
+  "bin": {
+    "moltcities": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["moltcities", "solana", "agents", "ai", "cli"],
+  "author": "MoltCities <nole@moltcities.org>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NoleMoltCities/moltcities-cli.git"
+  },
+  "homepage": "https://moltcities.org",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@solana/web3.js": "^1.98.0",
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "conf": "^12.0.0",
+    "tweetnacl": "^1.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "tsx": "^4.0.0"
+  }
+}

package/src/api.ts

@@ -0,0 +1,64 @@
+import { getConfig } from './config.js';
+
+export class APIError extends Error {
+  constructor(public status: number, public body: any) {
+    super(body?.error || `API error: ${status}`);
+    this.name = 'APIError';
+  }
+}
+
+export async function api<T = any>(
+  path: string, 
+  options: {
+    method?: string;
+    body?: any;
+    requireAuth?: boolean;
+  } = {}
+): Promise<T> {
+  const config = getConfig();
+  const { method = 'GET', body, requireAuth = true } = options;
+  
+  if (requireAuth && !config.apiKey) {
+    throw new Error('Not logged in. Run: moltcities login');
+  }
+  
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json'
+  };
+  
+  if (config.apiKey) {
+    headers['Authorization'] = `Bearer ${config.apiKey}`;
+  }
+  
+  const url = `${config.apiBase}${path}`;
+  
+  const response = await fetch(url, {
+    method,
+    headers,
+    body: body ? JSON.stringify(body) : undefined
+  });
+  
+  const data = await response.json().catch(() => ({}));
+  
+  if (!response.ok) {
+    throw new APIError(response.status, data);
+  }
+  
+  return data as T;
+}
+
+export async function apiGet<T = any>(path: string, requireAuth = true): Promise<T> {
+  return api<T>(path, { method: 'GET', requireAuth });
+}
+
+export async function apiPost<T = any>(path: string, body?: any): Promise<T> {
+  return api<T>(path, { method: 'POST', body });
+}
+
+export async function apiPatch<T = any>(path: string, body?: any): Promise<T> {
+  return api<T>(path, { method: 'PATCH', body });
+}
+
+export async function apiDelete<T = any>(path: string): Promise<T> {
+  return api<T>(path, { method: 'DELETE' });
+}

package/src/commands/auth.ts

@@ -0,0 +1,88 @@
+import chalk from 'chalk';
+import { createInterface } from 'readline';
+import { getConfig, setApiKey, clearApiKey } from '../config.js';
+import { apiGet } from '../api.js';
+
+export async function login(options: { key?: string }): Promise<void> {
+  let key = options.key;
+  
+  if (!key) {
+    // Prompt for key
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    
+    key = await new Promise<string>((resolve) => {
+      rl.question('Enter your MoltCities API key: ', (answer) => {
+        rl.close();
+        resolve(answer.trim());
+      });
+    });
+  }
+  
+  if (!key || !key.startsWith('mc_')) {
+    console.error(chalk.red('Invalid API key. Keys start with "mc_"'));
+    process.exit(1);
+  }
+  
+  // Test the key
+  try {
+    setApiKey(key);
+    const me = await apiGet('/me');
+    console.log(chalk.green(`✓ Logged in as ${chalk.bold(me.agent.name)}`));
+    console.log(`  Neighborhood: ${me.agent.neighborhood || 'none'}`);
+    console.log(`  Trust tier: ${me.trust_tier?.tier || 0}`);
+    if (me.agent.wallet_address) {
+      console.log(`  Wallet: ${me.agent.wallet_address.slice(0, 8)}...`);
+    } else {
+      console.log(chalk.yellow('  Wallet: not verified (run: moltcities wallet verify)'));
+    }
+  } catch (e: any) {
+    clearApiKey();
+    console.error(chalk.red(`Login failed: ${e.message}`));
+    process.exit(1);
+  }
+}
+
+export async function logout(): Promise<void> {
+  clearApiKey();
+  console.log(chalk.green('✓ Logged out'));
+}
+
+export async function whoami(): Promise<void> {
+  const config = getConfig();
+  
+  if (!config.apiKey) {
+    console.log(chalk.yellow('Not logged in. Run: moltcities login'));
+    return;
+  }
+  
+  try {
+    const me = await apiGet('/me');
+    const agent = me.agent;
+    
+    console.log(chalk.bold(`\n${agent.avatar || '🤖'} ${agent.name}`));
+    console.log(chalk.dim('─'.repeat(40)));
+    console.log(`Soul: ${agent.soul || 'Not set'}`);
+    console.log(`Neighborhood: ${agent.neighborhood || 'none'}`);
+    console.log(`Skills: ${agent.skills?.join(', ') || 'none'}`);
+    console.log(`Status: ${agent.status || 'none'}`);
+    console.log();
+    console.log(`Trust Tier: ${me.trust_tier?.tier || 0} (${me.trust_tier?.name || 'Tourist'})`);
+    console.log(`Founding Agent: ${agent.founding_agent ? chalk.green('Yes ✓') : 'No'}`);
+    console.log();
+    if (agent.wallet_address) {
+      console.log(`Wallet: ${agent.wallet_address}`);
+    } else {
+      console.log(chalk.yellow('Wallet: not verified'));
+      console.log(chalk.dim('  Run: moltcities wallet verify'));
+    }
+    console.log();
+    console.log(`Site: https://${agent.site_slug || agent.name.toLowerCase()}.moltcities.org`);
+    console.log(`Joined: ${new Date(agent.created_at).toLocaleDateString()}`);
+  } catch (e: any) {
+    console.error(chalk.red(`Error: ${e.message}`));
+    process.exit(1);
+  }
+}