jaelis-node 1.4.1 → 1.7.0

package/README.md

@@ -13,7 +13,36 @@ JAELIS is a next-generation blockchain with a **Universal Virtual Machine** that
 
 ## Universal VM - Core Innovation
 
-The JAELIS Universal VM executes contracts from multiple ecosystems natively:
+JAELIS provides **TWO deployment systems** for maximum flexibility:
+
+### Option 1: Unified VM (Cross-Language Magic)
+
+Compile **MULTIPLE contracts from MULTIPLE languages** into **ONE unified bytecode bundle** with **ONE ABI**:
+
+```javascript
+// Deploy unified bundle - ALL languages compile to ONE bytecode!
+const result = await jaelis.deployUnified({
+    from: '0x...',
+    sources: [
+        { code: solidityCode, language: 'solidity', name: 'Token' },
+        { code: rustCode, language: 'rust', name: 'DeFi' },
+        { code: moveCode, language: 'move', name: 'NFT' }
+    ]
+});
+// ALL contracts share memory and can call each other DIRECTLY!
+```
+
+### Option 2: Multi-VM (Native Compatibility)
+
+Deploy to **native VMs** for exact compatibility with original chain behavior:
+
+```javascript
+await jaelis.deploySolanaProgram({ bytecode, programId, owner });  // → SVM
+await jaelis.deployMoveModule({ bytecode, moduleName, owner });    // → MoveVM
+await jaelis.deployTonContract({ code, data, owner });             // → TVM
+```
+
+### Language Support Matrix
 
 | Language | Ecosystem | Status |
 |----------|-----------|--------|
@@ -24,12 +53,10 @@ The JAELIS Universal VM executes contracts from multiple ecosystems natively:
 | **Cairo** | StarkNet | Production |
 | **Vyper** | Ethereum (Python-like) | Production |
 
-### Cross-Language Contract Calls
-
-A Solidity contract can call a Rust contract. A Move module can interact with FunC. All native, all on-chain:
+### Cross-Language Contract Calls (NO BRIDGES!)
 
 ```javascript
-// Solidity contract calling a Rust program
+// Solidity → Rust call - DIRECT, no bridges needed!
 await jaelis.crossContractCall({
     from: solidityContract,
     to: rustProgram,
@@ -140,6 +167,54 @@ Options:
   --reward-recipient <address>   Wallet address for node rewards (ANY chain!)
 ```
 
+## Block Sync & Node Status
+
+Your node automatically syncs with the JAELIS network:
+
+```bash
+# Check sync status
+curl -X POST http://localhost:8545 \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","method":"jaelis_syncing","params":[],"id":1}'
+
+# Response when syncing:
+{
+  "currentBlock": "0x1a4",
+  "highestBlock": "0x2f8",
+  "syncedBlocks": 420,
+  "remainingBlocks": 340,
+  "percentComplete": "55.26%"
+}
+
+# Response when fully synced:
+false
+```
+
+### Node Registry & Lifetime Tracking
+
+When your node connects, it registers with the JAELIS network. Your contributions are tracked **forever** - even across restarts:
+
+```bash
+# See all connected nodes (run on main RPC)
+curl -X POST https://rpc.jaelis.io \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","method":"jaelis_node_getNodes","params":[],"id":1}'
+
+# Get network-wide node stats
+curl -X POST https://rpc.jaelis.io \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","method":"jaelis_node_getStats","params":[],"id":1}'
+
+# Response:
+{
+  "lifetimeNodes": 142,      # All nodes that EVER connected
+  "activeNodes": 23,         # Currently online
+  "validators": 8,           # Opted-in validators
+  "totalUptime": "45d 12h",  # Cumulative network uptime
+  "byAddressType": { "evm": 89, "solana": 31, "bitcoin": 22 }
+}
+```
+
 ## RPC Methods
 
 Your node exposes standard JSON-RPC plus JAELIS-specific methods:
@@ -148,9 +223,10 @@ Your node exposes standard JSON-RPC plus JAELIS-specific methods:
 | Method | Description |
 |--------|-------------|
 | `jaelis_getSupportedLanguages` | Returns: `['solidity', 'rust', 'move', 'func', 'cairo', 'vyper']` |
-| `jaelis_deployContract` | Deploy contract in any supported language |
+| `jaelis_deployUnified` | Deploy unified bundle (multiple languages → ONE bytecode!) |
+| `jaelis_deployContract` | Deploy single contract in any supported language |
 | `jaelis_executeContract` | Execute contract method |
-| `jaelis_crossContractCall` | Call between contracts of different languages |
+| `jaelis_crossContractCall` | Call between contracts of different languages (NO BRIDGES!) |
 
 ### Cross-Chain Settlement Methods
 | Method | Description |