jaelis-node 2.0.0 → 2.1.0

package/README.md

@@ -16,6 +16,17 @@ Official external node software for the **JAELIS Blockchain** network. Run your
 
 This is similar to running `geth --syncmode light` for Ethereum.
 
+## AI Agent Quick Start
+
+Get a named node running in 2 commands:
+
+```bash
+npm install -g jaelis-node
+jaelis-node --name "MY-AGENT" --network testnet
+```
+
+Your agent node will sync with the JAELIS testnet, expose a local RPC at `http://localhost:8545`, and persist its name across restarts.
+
 ## Quick Start
 
 ### Install Globally
@@ -33,6 +44,9 @@ jaelis-node
 # Start on mainnet
 jaelis-node --network mainnet
 
+# Name your node (persists across restarts)
+jaelis-node --name MARBIT
+
 # Custom RPC port
 jaelis-node --port 8546
 
@@ -80,6 +94,7 @@ const balance = await jaelis.getBalance('jae1qwertyuiop...'); // JAELIS native a
 | `-n, --network <network>` | Network to connect to (`testnet` or `mainnet`) | `testnet` |
 | `-p, --port <port>` | Local RPC server port | `8545` |
 | `-d, --data-dir <dir>` | Data directory for block storage | `./jaelis-data/<network>` |
+| `--name <name>` | Custom node name (e.g., `MARBIT`, `my-agent`) | Auto-generated ID |
 | `--no-rpc` | Disable local RPC server | Enabled |
 
 ## Programmatic Usage
@@ -92,6 +107,7 @@ async function main() {
         network: 'testnet',
         rpcPort: 8545,
         dataDir: './my-jaelis-data',
+        nodeName: 'MY-AGENT',    // Name your node
         enableRpc: true
     });
 

package/bin/jaelis-node.js

@@ -10,8 +10,9 @@
  *   jaelis-node --network mainnet    # Start on mainnet
  *   jaelis-node --port 8546          # Custom RPC port
  *   jaelis-node --data-dir ./mydata  # Custom data directory
+ *   jaelis-node --name MARBIT        # Name your node
  *
- * @version 2.0.0
+ * @version 2.1.0
  */
 
 'use strict';
@@ -20,7 +21,7 @@ const { Command } = require('commander');
 const { JaelisNode } = require('../lib/node');
 
 // Version check - notify if update available
-const VERSION = '2.0.0';
+const VERSION = '2.1.0';
 checkForUpdates();
 
 // CLI setup
@@ -33,6 +34,7 @@ program
     .option('-n, --network <network>', 'Network to connect to (testnet or mainnet)', 'testnet')
     .option('-p, --port <port>', 'Local RPC port', '8545')
     .option('-d, --data-dir <dir>', 'Data directory for local storage')
+    .option('--name <name>', 'Custom node name (e.g., MARBIT, my-agent)')
     .option('--no-rpc', 'Disable local RPC server')
     .parse(process.argv);
 
@@ -44,6 +46,7 @@ async function main() {
         network: options.network,
         rpcPort: parseInt(options.port, 10),
         dataDir: options.dataDir,
+        nodeName: options.name || null,
         enableRpc: options.rpc !== false
     });
 
@@ -66,7 +69,8 @@ async function main() {
         // Print status every 30 seconds
         setInterval(() => {
             const status = node.getStatus();
-            console.log(`[STATUS] Block: ${status.currentBlock} | Uptime: ${status.uptimeFormatted} | RPC Requests: ${status.stats.rpcRequests}`);
+            const nameTag = status.nodeName ? `${status.nodeName} | ` : '';
+            console.log(`[STATUS] ${nameTag}Block: ${status.currentBlock} | Uptime: ${status.uptimeFormatted} | RPC Requests: ${status.stats.rpcRequests}`);
         }, 30000);
 
     } catch (error) {

package/lib/node.js

@@ -5,7 +5,7 @@
  * Does NOT contain any internal JAELIS blockchain code.
  * Only implements the network protocol for syncing and RPC.
  *
- * @version 2.0.0
+ * @version 2.1.0
  */
 
 'use strict';
@@ -41,6 +41,7 @@ class JaelisNode extends EventEmitter {
      * @param {string} options.dataDir - Data directory for local storage
      * @param {number} options.rpcPort - Local RPC port (default: 8545)
      * @param {boolean} options.enableRpc - Enable local RPC server (default: true)
+     * @param {string} options.nodeName - Custom node name (e.g., 'MARBIT')
      */
     constructor(options = {}) {
         super();
@@ -56,8 +57,9 @@ class JaelisNode extends EventEmitter {
         this.rpcPort = options.rpcPort || 8545;
         this.enableRpc = options.enableRpc !== false;
 
-        // Node state
+        // Node identity
         this.nodeId = this._generateNodeId();
+        this.nodeName = options.nodeName || this._loadNodeName();
         this.startTime = null;
         this.isRunning = false;
         this.isSyncing = false;
@@ -84,6 +86,35 @@ class JaelisNode extends EventEmitter {
         return 'jaelis_' + crypto.randomBytes(8).toString('hex');
     }
 
+    /**
+     * Load persisted node name from data directory
+     */
+    _loadNodeName() {
+        try {
+            const fs = require('fs');
+            const path = require('path');
+            const nameFile = path.join(this.dataDir, 'node-name.json');
+            const data = JSON.parse(fs.readFileSync(nameFile, 'utf8'));
+            return data.name || null;
+        } catch (e) {
+            return null;
+        }
+    }
+
+    /**
+     * Persist node name to data directory
+     */
+    _saveNodeName() {
+        if (!this.nodeName) return;
+        try {
+            const fs = require('fs');
+            const path = require('path');
+            fs.mkdirSync(this.dataDir, { recursive: true });
+            const nameFile = path.join(this.dataDir, 'node-name.json');
+            fs.writeFileSync(nameFile, JSON.stringify({ name: this.nodeName, setAt: Date.now() }));
+        } catch (e) {}
+    }
+
     /**
      * Start the node
      */
@@ -92,10 +123,16 @@ class JaelisNode extends EventEmitter {
             throw new Error('Node is already running');
         }
 
+        // Persist node name if provided
+        this._saveNodeName();
+
         console.log('');
         console.log('═══════════════════════════════════════════════════════════════');
-        console.log('                    JAELIS EXTERNAL NODE v2.0.0');
+        console.log('                    JAELIS EXTERNAL NODE v2.1.0');
         console.log('═══════════════════════════════════════════════════════════════');
+        if (this.nodeName) {
+        console.log(`   Node Name:  ${this.nodeName}`);
+        }
         console.log(`   Network:    ${this.networkConfig.name}`);
         console.log(`   Chain ID:   ${this.networkConfig.chainId}`);
         console.log(`   Node ID:    ${this.nodeId}`);
@@ -215,6 +252,7 @@ class JaelisNode extends EventEmitter {
 
         return {
             nodeId: this.nodeId,
+            nodeName: this.nodeName || null,
             network: this.network,
             chainId: this.networkConfig.chainId,
             isRunning: this.isRunning,
@@ -223,7 +261,7 @@ class JaelisNode extends EventEmitter {
             uptimeFormatted: this._formatUptime(uptime),
             currentBlock: this.storage?.getLatestBlockNumber() || 0,
             stats: this.stats,
-            version: '2.0.0',
+            version: '2.1.0',
             rpcPort: this.enableRpc ? this.rpcPort : null
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaelis-node",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Official JAELIS Blockchain External Node - Connect to the JAELIS network, sync blocks, and expose local RPC for your dApps. Zero gas fees, multi-chain interop.",
   "main": "lib/index.js",
   "bin": {