finlayer-cli 1.1.0

package/index.js

@@ -0,0 +1,361 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { generateKeyPairSync, createHash } from 'crypto';
+import { writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+const program = new Command();
+const API = 'https://api.devnet.zeromobile.site';
+
+const logo = `
+ ██████╗ ███╗   ██╗ ██████╗ ███╗   ██╗
+██╔═══██╗████╗  ██║██╔════╝ ████╗  ██║
+██║   ██║██╔██╗ ██║██║  ███╗██╔██╗ ██║
+██║   ██║██║╚██╗██║██║   ██║██║╚██╗██║
+╚██████╔╝██║ ╚████║╚██████╔╝██║ ╚████║
+ ╚═════╝ ╚═╝  ╚═══╝ ╚═════╝ ╚═╝  ╚═══╝`;
+
+const divider = chalk.gray('  ─────────────────────────────────────────────────────');
+const label = (k) => chalk.gray(`  ${(k + ' ').padEnd(16, '·')} `);
+
+const showHelp = () => {
+    console.log(chalk.green.bold(logo));
+    console.log(chalk.gray.bold('  FinLayer v1.0  ·  Nigerian Digital Currency System'));
+    console.log(chalk.gray('  Interact with the 0NGN ledger, query accounts, and broadcast transactions.\n'));
+    console.log(divider);
+    console.log(chalk.white.bold('  USAGE'));
+    console.log(divider);
+    console.log(chalk.yellow('  0ngn <command> [options]\n'));
+    console.log(divider);
+    console.log(chalk.white.bold('  COMMANDS'));
+    console.log(divider);
+    const cmd = (name, args, desc) => {
+        console.log(chalk.cyan.bold(`  ${name}`) + chalk.gray(` ${args}`));
+        console.log(chalk.gray(`    ${desc}\n`));
+    };
+    cmd('info', '[--rpc <url>]',
+        'Full network status — node health, ledger stats, token economics');
+    cmd('balance', '<account_id> [--rpc <url>]',
+        'Account balance, public key, nonce, and transaction count');
+    cmd('tx', '<tx_hash> [--rpc <url>]',
+        'Full transaction receipt — parties, amount, ed25519 sig, Solana L1 anchor');
+    cmd('transfer', '-s <id> -r <id> -a <kubo> -k <key> [-m <memo>] [--rpc <url>]',
+        'Broadcast a signed transfer and stream Solana Devnet confirmation');
+    cmd('create-account', '[-o <file>]',
+        'Generate a new Ed25519 keypair and save it to keypair.json');
+    console.log(divider);
+    console.log(chalk.white.bold('  OPTIONS'));
+    console.log(divider);
+    const opt = (flag, desc) => console.log(chalk.yellow(`  ${flag.padEnd(24)} `) + chalk.gray(desc));
+    opt('--rpc <url>', `Override the RPC node (default: ${API})`);
+    opt('-s, --sender', 'Sender Account ID  [transfer]');
+    opt('-r, --receiver', 'Receiver Account ID  [transfer]');
+    opt('-a, --amount', 'Amount in Kubo  (100 Kubo = ₦1 0NGN)  [transfer]');
+    opt('-k, --keypair', '64-byte Ed25519 Private Key hex  [transfer]');
+    opt('-m, --memo', 'Transaction memo / description  [transfer]');
+    opt('-V, --version', 'Print CLI version');
+    opt('-h, --help', 'Show this help screen');
+    console.log();
+    console.log(divider);
+    console.log(chalk.white.bold('  EXAMPLES'));
+    console.log(divider);
+    console.log(chalk.gray('  # Check network status'));
+    console.log(chalk.cyan('  0ngn info\n'));
+    console.log(chalk.gray('  # Query a balance'));
+    console.log(chalk.cyan('  0ngn balance 4410520adbebcffa68899f7bcddeaf8f\n'));
+    console.log(chalk.gray('  # Look up a transaction'));
+    console.log(chalk.cyan('  0ngn tx e27ff5a046f317a1c62e4f9a6d7c55620b7fd0602891cc7c45554b112c394b9f\n'));
+    console.log(chalk.gray('  # Send 1000 0NGN with a memo'));
+    console.log(chalk.cyan('  0ngn transfer -s <from_id> -r <to_id> -a 100000 -k <priv_key> -m "Invoice #001"'));
+    console.log(divider);
+    console.log();
+};
+
+
+program
+    .name('0ngn')
+    .description('0NGN FinLayer Blockchain Command Line Interface')
+    .version('1.0.0');
+
+// ── INFO ──────────────────────────────────────────────────────────────
+program.command('info')
+    .description('Full network status — RPC health, ledger stats, supply info')
+    .option('--rpc <url>', 'Target RPC Node', API)
+    .action(async (opts) => {
+        try {
+            const res = await fetch(`${opts.rpc}/health`);
+            const j = await res.json();
+            if (!j.success) throw new Error(j.error);
+            const d = j.data;
+
+            console.log(chalk.green.bold(logo));
+            console.log(chalk.gray.bold('  FinLayer v1.0  ·  Nigerian Digital Currency System'));
+            console.log(chalk.gray('  100 Kubo = 1 Naira  ·  Fixed Supply: 21,000,000 0NGN'));
+            console.log();
+            console.log(divider);
+            console.log(chalk.green('  NODE STATUS'));
+            console.log(divider);
+            console.log(label('Node') + chalk.green.bold('ONLINE'));
+            console.log(label('RPC Endpoint') + chalk.cyan(opts.rpc));
+            console.log(label('Network') + chalk.yellow('Devnet (Solana-Anchored)'));
+            console.log();
+            console.log(divider);
+            console.log(chalk.green('  LEDGER STATE'));
+            console.log(divider);
+            console.log(label('Genesis ID') + chalk.cyan.bold(d.genesis_id));
+            console.log(label('Chain Tip') + chalk.cyan(d.chain_tip));
+            console.log(label('Accounts') + chalk.yellow.bold(d.accounts));
+            console.log(label('Total TXs') + chalk.yellow.bold(d.transactions));
+            console.log();
+            console.log(divider);
+            console.log(chalk.green('  TOKEN ECONOMICS'));
+            console.log(divider);
+            console.log(label('Unit') + chalk.white('0NGN  (Nigerian Digital Currency)'));
+            console.log(label('Sub-unit') + chalk.white('Kubo  (1 0NGN = 100 Kubo)'));
+            console.log(label('Max Supply') + chalk.white('21,000,000 0NGN'));
+            console.log(label('L1 Anchor') + chalk.magenta('Solana Devnet via SPL Memo Program'));
+            console.log(label('Checkpoint') + chalk.magenta('Arweave / Irys  (daily state root)'));
+            console.log(divider);
+            console.log();
+        } catch (e) {
+            console.log(chalk.red(`\n  [ERROR] Network unreachable — ${e.message}\n`));
+        }
+    });
+
+// ── BALANCE ───────────────────────────────────────────────────────────
+program.command('balance <id>')
+    .description('Query the balance and metadata of a registered account')
+    .option('--rpc <url>', 'Target RPC Node', API)
+    .action(async (id, opts) => {
+        try {
+            process.stdout.write(chalk.gray(`\n  Fetching account ${id}...`));
+            const res = await fetch(`${opts.rpc}/explorer/account/${id}`);
+            const j = await res.json();
+
+            if (!j.success || !j.data) {
+                console.log(chalk.red('\n  [ERROR] Account not found on the ledger.\n'));
+                return;
+            }
+            const a = j.data;
+            const bal = (a.balance_kubo / 100).toLocaleString('en-NG', { minimumFractionDigits: 2 });
+            const stk = (a.stake_amount / 100).toLocaleString('en-NG', { minimumFractionDigits: 2 });
+
+            console.log('\n');
+            console.log(divider);
+            console.log(chalk.green('  ACCOUNT RECORD'));
+            console.log(divider);
+            console.log(label('Account ID') + chalk.cyan.bold(a.account_id));
+            console.log(label('Public Key') + chalk.cyan(a.public_key));
+            console.log(label('Created') + chalk.white(a.created_at));
+            console.log();
+            console.log(divider);
+            console.log(chalk.green('  BALANCES'));
+            console.log(divider);
+            console.log(label('Balance') + chalk.yellow.bold(`₦${bal} 0NGN`));
+            console.log(label('Kubo') + chalk.yellow(`${Number(a.balance_kubo).toLocaleString()} Kubo`));
+            console.log(label('Staked') + chalk.white(`₦${stk} 0NGN`));
+            console.log(label('Nonce') + chalk.white(`#${a.nonce || 0}`));
+            console.log(label('Total TXs') + chalk.white(`${(a.transactions || []).length}`));
+            console.log(divider);
+            console.log();
+        } catch (e) {
+            console.log(chalk.red(`\n  [ERROR] ${e.message}\n`));
+        }
+    });
+
+// ── TX ────────────────────────────────────────────────────────────────
+program.command('tx <hash>')
+    .description('Look up a transaction by its hash')
+    .option('--rpc <url>', 'Target RPC Node', API)
+    .action(async (hash, opts) => {
+        try {
+            process.stdout.write(chalk.gray(`\n  Fetching transaction ${hash}...`));
+            const res = await fetch(`${opts.rpc}/explorer/tx/${hash}`);
+            const j = await res.json();
+
+            if (!j.success || !j.data) {
+                console.log(chalk.red('\n  [ERROR] Transaction not found.\n'));
+                return;
+            }
+            const t = j.data;
+            const amount = (t.amount_kubo / 100).toLocaleString('en-NG', { minimumFractionDigits: 2 });
+
+            console.log('\n');
+            console.log(divider);
+            console.log(chalk.green('  TRANSACTION RECEIPT'));
+            console.log(divider);
+            console.log(label('Tx Hash') + chalk.cyan.bold(t.tx_hash));
+            console.log(label('Status') + chalk.green('CONFIRMED'));
+            console.log(label('Amount') + chalk.yellow.bold(`₦${amount} 0NGN  (${Number(t.amount_kubo).toLocaleString()} Kubo)`));
+            console.log(label('Gas Fee') + chalk.white(`${t.gas_fee} Kubo`));
+            console.log(label('Nonce') + chalk.white(`#${t.nonce}`));
+            console.log(label('Memo') + chalk.white(t.description || '—'));
+            console.log(label('Timestamp') + chalk.white(t.timestamp));
+            console.log();
+            console.log(divider);
+            console.log(chalk.green('  PARTIES'));
+            console.log(divider);
+            console.log(label('From') + chalk.cyan(t.sender_id));
+            console.log(label('To') + chalk.cyan(t.receiver_id));
+            console.log(label('Parent Tx') + chalk.gray(t.prev_tx_hash || 'GENESIS ROOT'));
+            console.log(label('Ed25519 Sig') + chalk.gray(t.signature ? t.signature.slice(0, 32) + '...' : '—'));
+            console.log();
+            console.log(divider);
+            console.log(chalk.green('  L1 ANCHORS'));
+            console.log(divider);
+            if (t.solana_sig) {
+                console.log(label('Solana') + chalk.magenta.bold(t.solana_sig));
+                console.log(label('Explorer') + chalk.cyan(`https://explorer.solana.com/tx/${t.solana_sig}?cluster=devnet`));
+            } else {
+                console.log(label('Solana') + chalk.yellow('PENDING  — relay awaiting confirmation'));
+            }
+            console.log(label('Arweave') + chalk.gray('Pending daily state checkpoint'));
+            console.log(divider);
+            console.log();
+        } catch (e) {
+            console.log(chalk.red(`\n  [ERROR] ${e.message}\n`));
+        }
+    });
+
+// ── TRANSFER ──────────────────────────────────────────────────────────
+program.command('transfer')
+    .description('Transfer 0NGN to another account')
+    .requiredOption('-s, --sender <id>', 'Sender Account ID')
+    .requiredOption('-r, --receiver <id>', 'Receiver Account ID')
+    .requiredOption('-a, --amount <kubo>', 'Amount in Kubo (100 Kubo = 1 0NGN)')
+    .requiredOption('-k, --keypair <key>', '64-byte Ed25519 Private Key Hex')
+    .option('-m, --memo <text>', 'Optional memo / transaction description', '0NGN CLI Transfer')
+    .option('--rpc <url>', 'Target RPC Node', API)
+    .action(async (options) => {
+        const payload = {
+            sender_id: options.sender,
+            receiver_id: options.receiver,
+            amount_kubo: parseInt(options.amount),
+            description: options.memo,
+            private_key: options.keypair
+        };
+
+        const amount = parseInt(options.amount);
+        const ngn = (amount / 100).toLocaleString('en-NG', { minimumFractionDigits: 2 });
+
+        console.log('\n');
+        console.log(divider);
+        console.log(chalk.white.bold('  0NGN TRANSFER BROADCAST'));
+        console.log(divider);
+        console.log(label('RPC') + chalk.cyan(options.rpc));
+        console.log(label('From') + chalk.cyan(options.sender));
+        console.log(label('To') + chalk.cyan(options.receiver));
+        console.log(label('Amount') + chalk.yellow.bold(`₦${ngn} 0NGN  (${amount.toLocaleString()} Kubo)`));
+        console.log(label('Memo') + chalk.white(options.memo));
+        console.log(divider);
+
+        try {
+            process.stdout.write(chalk.yellow('\n  [1/3] Submitting to 0NGN ledger...   '));
+            const res = await fetch(`${options.rpc}/transaction/send`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(payload)
+            });
+            const j = await res.json();
+
+            if (!j.success || !j.data?.tx_hash) {
+                console.log(chalk.red('FAILED'));
+                console.log(chalk.red(`\n  [ERROR] ${j.error || JSON.stringify(j)}\n`));
+                return;
+            }
+
+            const txHash = j.data.tx_hash;
+            console.log(chalk.green('CONFIRMED'));
+            console.log(label('Tx Hash') + chalk.cyan.bold(txHash));
+
+            process.stdout.write(chalk.yellow('\n  [2/3] Awaiting Solana broadcast...   '));
+            let solanaSig = null;
+            for (let i = 0; i < 12; i++) {
+                await new Promise(r => setTimeout(r, 3000));
+                try {
+                    const txRes = await fetch(`${options.rpc}/explorer/tx/${txHash}`);
+                    const txJ = await txRes.json();
+                    if (txJ.success && txJ.data?.solana_sig) {
+                        solanaSig = txJ.data.solana_sig;
+                        break;
+                    }
+                } catch { }
+                process.stdout.write(chalk.gray('.'));
+            }
+
+            if (solanaSig) {
+                console.log(chalk.green('ANCHORED'));
+                console.log(label('Solana Sig') + chalk.magenta(solanaSig));
+                console.log(label('Explorer') + chalk.cyan(`https://explorer.solana.com/tx/${solanaSig}?cluster=devnet`));
+            } else {
+                console.log(chalk.yellow('PENDING'));
+                console.log(chalk.gray('         Relay node is processing — run `0ngn tx <hash>` to check.'));
+            }
+
+            console.log(chalk.yellow('\n  [3/3] Finalizing             '));
+            console.log(label('Verify') + chalk.gray(`0ngn tx ${txHash}`));
+            console.log(chalk.green.bold('\n  TRANSFER COMPLETE'));
+            console.log(divider);
+            console.log();
+
+        } catch (e) {
+            console.log(chalk.red('FAILED'));
+            console.log(chalk.red(`\n  [ERROR] RPC unreachable — ${e.message}\n`));
+        }
+    });
+
+// ── CREATE ACCOUNT ────────────────────────────────────────────────────
+program.command('create-account')
+    .description('Generate a new Ed25519 keypair and save to keypair.json')
+    .option('-o, --output <file>', 'Output file path', join(homedir(), 'keypair.json'))
+    .action((opts) => {
+        const { privateKey, publicKey } = generateKeyPairSync('ed25519', {
+            privateKeyEncoding: { type: 'pkcs8', format: 'der' },
+            publicKeyEncoding: { type: 'spki', format: 'der' }
+        });
+
+        // Extract raw 32-byte keys from DER wrappers
+        const privRaw = privateKey.slice(-32);
+        const pubRaw = publicKey.slice(-32);
+        const fullKey = Buffer.concat([privRaw, pubRaw]);
+
+        // Derive a deterministic account_id from the public key
+        const accountId = createHash('md5').update(pubRaw).digest('hex');
+
+        const keypair = {
+            account_id: accountId,
+            public_key: pubRaw.toString('hex'),
+            private_key: fullKey.toString('hex'),
+            created_at: new Date().toISOString()
+        };
+
+        writeFileSync(opts.output, JSON.stringify(keypair, null, 2));
+
+        console.log('\n');
+        console.log(divider);
+        console.log(chalk.green('  NEW ACCOUNT CREATED'));
+        console.log(divider);
+        console.log(label('Account ID') + chalk.cyan.bold(keypair.account_id));
+        console.log(label('Public Key') + chalk.cyan(keypair.public_key));
+        console.log(label('Saved to') + chalk.yellow(opts.output));
+        console.log(divider);
+        console.log(chalk.gray('  Keep your keypair.json safe. Never share your private_key.\n'));
+    });
+
+program
+    .name('0ngn')
+    .description('0NGN FinLayer Blockchain Command Line Interface')
+    .version('1.0.0')
+    .helpOption(false)
+    .addHelpCommand(false)
+    .addOption(new (await import('commander')).Option('-h, --help', 'Show help').hideHelp())
+    .hook('preAction', () => { });
+
+if (process.argv.length <= 2 || process.argv.includes('--help') || process.argv.includes('-h') || process.argv[2] === 'help') {
+    showHelp();
+    process.exit(0);
+}
+
+await program.parseAsync(process.argv);

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "finlayer-cli",
+  "version": "1.1.0",
+  "description": "Command Line Interface for the 0NGN FinLayer Nigerian Digital Currency Network",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "finlayer": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "0ngn",
+    "finlayer",
+    "nigerian",
+    "digital-currency",
+    "blockchain",
+    "cli",
+    "solana",
+    "ed25519",
+    "ledger"
+  ],
+  "author": "0NGN FinLayer",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "0ngn-cli": "^1.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0"
+  }
+}