finlayer-cli 1.2.0 → 1.2.2

package/index.js

@@ -27,7 +27,7 @@ const showHelp = () => {
     console.log(divider);
     console.log(chalk.white.bold('  USAGE'));
     console.log(divider);
-    console.log(chalk.yellow('  0ngn <command> [options]\n'));
+    console.log(chalk.yellow('  finlayer <command> [options]\n'));
     console.log(divider);
     console.log(chalk.white.bold('  COMMANDS'));
     console.log(divider);
@@ -43,8 +43,8 @@ const showHelp = () => {
         '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');
+    cmd('create-account', '[--register] [-o <file>]',
+        'Generate a new Ed25519 keypair locally, or use --register to create & register on the ledger');
     console.log(divider);
     console.log(chalk.white.bold('  OPTIONS'));
     console.log(divider);
@@ -62,13 +62,15 @@ const showHelp = () => {
     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.cyan('  finlayer info\n'));
     console.log(chalk.gray('  # Query a balance'));
-    console.log(chalk.cyan('  0ngn balance 4410520adbebcffa68899f7bcddeaf8f\n'));
+    console.log(chalk.cyan('  finlayer balance 4410520adbebcffa68899f7bcddeaf8f\n'));
     console.log(chalk.gray('  # Look up a transaction'));
-    console.log(chalk.cyan('  0ngn tx e27ff5a046f317a1c62e4f9a6d7c55620b7fd0602891cc7c45554b112c394b9f\n'));
+    console.log(chalk.cyan('  finlayer 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(chalk.cyan('  finlayer transfer -s <from_id> -r <to_id> -a 100000 -k <priv_key> -m "Invoice #001"'));
+    console.log(chalk.gray('\n  # Create a new account keypair'));
+    console.log(chalk.cyan('  finlayer create-account'));
     console.log(divider);
     console.log();
 };
@@ -118,6 +120,12 @@ program.command('info')
             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(chalk.green('  GET STARTED'));
+            console.log(divider);
+            console.log(label('New Account') + chalk.cyan('finlayer create-account --register'));
+            console.log(label('Check Balance') + chalk.cyan('finlayer balance <account_id>'));
+            console.log(label('Send 0NGN') + chalk.cyan('finlayer transfer -s <id> -r <id> -a <kubo> -k <key>'));
+            console.log(divider);
             console.log();
         } catch (e) {
             console.log(chalk.red(`\n  [ERROR] Network unreachable — ${e.message}\n`));
@@ -308,31 +316,53 @@ program.command('transfer')
 
 // ── CREATE ACCOUNT ────────────────────────────────────────────────────
 program.command('create-account')
-    .description('Generate a new Ed25519 keypair and save to keypair.json')
+    .description('Generate a new Ed25519 keypair and save to ~/keypair.json')
     .option('-o, --output <file>', 'Output file path', join(homedir(), 'keypair.json'))
-    .action((opts) => {
+    .option('--register', 'Register the account on the 0NGN ledger')
+    .option('--rpc <url>', 'Target RPC Node', API)
+    .action(async (opts) => {
+        if (opts.register) {
+            process.stdout.write(chalk.gray('\n  Registering account on ledger...'));
+            const res = await fetch(`${opts.rpc}/account/create`, { method: 'POST' });
+            const j = await res.json();
+            if (!j.data?.account_id) {
+                console.log(chalk.red('\n  [ERROR] Registration failed.\n'));
+                return;
+            }
+            const keypair = {
+                account_id: j.data.account_id,
+                public_key: j.data.public_key,
+                private_key: j.data.private_key,
+                created_at: j.data.created_at
+            };
+            writeFileSync(opts.output, JSON.stringify(keypair, null, 2));
+            console.log('\n');
+            console.log(divider);
+            console.log(chalk.green('  ACCOUNT REGISTERED ON LEDGER'));
+            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'));
+            return;
+        }
+
         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'));
@@ -341,6 +371,7 @@ program.command('create-account')
         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('  To register on the ledger run: finlayer create-account --register'));
         console.log(chalk.gray('  Keep your keypair.json safe. Never share your private_key.\n'));
     });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "finlayer-cli",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Command Line Interface for the 0NGN FinLayer Nigerian Digital Currency Network",
   "main": "index.js",
   "type": "module",