jaelis-node 1.3.0 → 1.3.1

package/README.md

@@ -1,65 +1,84 @@
-# @jaelis/node
+# jaelis-node
 
-Official node software for the **JAELIS Blockchain** - run a full node, validator, or bootstrap node on the JAELIS network.
+Official node software for the **JAELIS Blockchain** - the first unified multi-language smart contract platform with cross-chain settlement.
 
-[![npm version](https://badge.fury.io/js/@jaelis%2Fnode.svg)](https://www.npmjs.com/package/@jaelis/node)
+[![npm version](https://badge.fury.io/js/jaelis-node.svg)](https://www.npmjs.com/package/jaelis-node)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## Features
+## What is JAELIS?
 
-- **Full Node** - Sync and validate the entire JAELIS blockchain
-- **Validator Node** - Participate in PoEC consensus and earn rewards
-- **Bootstrap Node** - Help with peer discovery on the network
-- **Zero Gas Fees** - LODE-based computational metering
-- **Multi-VM Support** - EVM, Solana, WASM, Bitcoin, Move, TON
-- **AI-Native** - Built-in MCP server and x402 payment protocol
-- **LevelDB Storage** - Fast, persistent blockchain storage
+JAELIS is a next-generation blockchain with a **Universal Virtual Machine** that natively executes smart contracts written in 6 different languages - all on the same chain, with direct cross-contract calls between them. No bridges. No wrapped tokens. No translation layers.
 
-## Installation
+**One chain. Six languages. Direct interoperability.**
 
-### Global Installation (Recommended)
+## Universal VM - Core Innovation
 
-```bash
-npm install -g @jaelis/node
-```
+The JAELIS Universal VM executes contracts from multiple ecosystems natively:
 
-### Local Installation
+| Language | Ecosystem | Status |
+|----------|-----------|--------|
+| **Solidity** | Ethereum, Polygon, Arbitrum, Base, etc. | Production |
+| **Rust** | Solana, NEAR, Polkadot | Production |
+| **Move** | Aptos, Sui, Movement | Production |
+| **FunC** | TON (Telegram's 900M+ users) | Production |
+| **Cairo** | StarkNet | Production |
+| **Vyper** | Ethereum (Python-like) | Production |
 
-```bash
-npm install @jaelis/node
-```
+### Cross-Language Contract Calls
 
-## Quick Start
+A Solidity contract can call a Rust contract. A Move module can interact with FunC. All native, all on-chain:
 
-### Start a Full Node
+```javascript
+// Solidity contract calling a Rust program
+await jaelis.crossContractCall({
+    from: solidityContract,
+    to: rustProgram,
+    method: 'process_payment',
+    args: [amount, recipient]
+});
+```
 
-```bash
-# Start on testnet (default)
-jaelis-node start
+## Cross-Chain Settlement (30+ Chains)
 
-# Start on testnet with custom ports
-jaelis-node start --rpc-port 8545 --p2p-port 30303
+JAELIS nodes run light clients for 30+ external blockchains, enabling trustless state verification:
 
-# Start on mainnet (when available)
-jaelis-node start --network mainnet
-```
+- **EVM Chains**: Ethereum, Polygon, Arbitrum, Optimism, Base, BSC, Avalanche, Fantom
+- **Non-EVM**: Solana, Cosmos, NEAR, Polkadot, Cardano, Algorand
+- **Bitcoin L2**: Lightning, Liquid, Stacks
+- **Emerging**: Aptos, Sui, TON, StarkNet, zkSync
 
-### Check Node Status
+Read external chain state directly in your JAELIS contracts - no oracles needed.
 
-```bash
-jaelis-node status
-```
+## Features
 
-### View Connected Peers
+- **Universal VM** - 6 languages, one chain, direct interop
+- **Cross-Chain Settlement** - Read state from 30+ chains trustlessly
+- **Zero Gas Fees** - LODE-based computational metering (users pay $0)
+- **Multi-Chain Wallets** - Receive rewards to ANY chain address
+- **No Staking Required** - JAELIS never holds your funds
+- **AI-Native** - Built-in MCP server and x402 payment protocol
+- **ERC-5792** - Atomic batch transactions
+- **EIP-7702** - Account abstraction (EOA → Smart Account)
+- **Address Safety** - Anti-phishing and poisoning protection
+- **Real P2P** - libp2p networking (same as Ethereum 2.0, IPFS)
+- **Lifetime Node Tracking** - Your contributions are recorded forever
+
+## Installation
 
 ```bash
-jaelis-node peers
+npm install -g jaelis-node
 ```
 
-### Display Node Info
+## Quick Start
 
 ```bash
-jaelis-node info
+# Start a node (zero config - auto-connects to testnet)
+jaelis-node start
+
+# Start with your reward wallet (use ANY chain address!)
+jaelis-node start --reward-recipient 0xYourEthAddress
+jaelis-node start --reward-recipient 9WzDX...YourSolanaAddress
+jaelis-node start --reward-recipient bc1q...YourBitcoinAddress
 ```
 
 ## Commands
@@ -67,11 +86,39 @@ jaelis-node info
 | Command | Description |
 |---------|-------------|
 | `start` | Start a full JAELIS node |
-| `validator` | Run as a validator node (PoEC) |
+| `validator` | Run as a validator node (bonus rewards) |
 | `bootstrap` | Run as a bootstrap/seed node |
 | `status` | Check local node status |
 | `peers` | List connected peers |
-| `info` | Display node information |
+| `info` | Display node and network information |
+
+## Wallet Commands
+
+JAELIS supports **any chain address** for receiving rewards. No staking. No lockups. Your keys, your wallet.
+
+```bash
+# Set your reward wallet (accepts ANY chain format)
+jaelis-node wallet:set-recipient 0x742d35cc6634C0532925a3b844Bc454e4438f44e    # EVM
+jaelis-node wallet:set-recipient 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM  # Solana
+jaelis-node wallet:set-recipient bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh   # Bitcoin
+jaelis-node wallet:set-recipient EQDrLq-X6jKZNHAScgghh0h1iog3StK71zn8dcmrOj0n  # TON
+
+# List configured wallets
+jaelis-node wallet:list
+
+# Add additional wallets
+jaelis-node wallet:add "trading" 0x456...
+
+# View node identity
+jaelis-node wallet:identity
+```
+
+**Supported Address Formats:**
+- EVM (Ethereum, Polygon, Arbitrum, Base, Optimism, etc.)
+- Solana (base58)
+- Bitcoin (Legacy: 1..., SegWit: 3..., Native SegWit: bc1...)
+- TON (base64url)
+- Move (Aptos/Sui: 0x + 64 hex chars)
 
 ## Start Options
 
@@ -79,64 +126,114 @@ jaelis-node info
 jaelis-node start [options]
 
 Options:
-  -n, --network <network>   Network: testnet or mainnet (default: testnet)
-  -r, --rpc-port <port>     RPC server port (default: 8545)
-  -p, --p2p-port <port>     P2P network port (default: 30303)
-  -d, --data-dir <path>     Data directory (default: ./jaelis-data)
-  --rpc-host <host>         RPC host (default: 0.0.0.0)
-  --no-rpc                  Disable RPC server
-  --sync-mode <mode>        Sync mode: full, light, archive (default: full)
+  -n, --network <network>        Network: testnet or mainnet (default: testnet)
+  -r, --rpc-port <port>          RPC server port (default: 8545)
+  -p, --p2p-port <port>          P2P network port (default: 30303)
+  -d, --data-dir <path>          Data directory (default: ./jaelis-data)
+  --rpc-host <host>              RPC host (default: 0.0.0.0)
+  --no-rpc                       Disable RPC server
+  --sync-mode <mode>             Sync mode: full, light, archive (default: full)
+  --reward-recipient <address>   Wallet address for node rewards (ANY chain!)
 ```
 
+## RPC Methods
+
+Your node exposes standard JSON-RPC plus JAELIS-specific methods:
+
+### Universal VM Methods
+| Method | Description |
+|--------|-------------|
+| `jaelis_getSupportedLanguages` | Returns: `['solidity', 'rust', 'move', 'func', 'cairo', 'vyper']` |
+| `jaelis_deployContract` | Deploy contract in any supported language |
+| `jaelis_executeContract` | Execute contract method |
+| `jaelis_crossContractCall` | Call between contracts of different languages |
+
+### Cross-Chain Settlement Methods
+| Method | Description |
+|--------|-------------|
+| `jaelis_crossChain_getChains` | List all 30+ registered chains |
+| `jaelis_crossChain_getChainInfo` | Get chain metadata (name, RPC, block time) |
+| `jaelis_crossChain_readState` | Read settled external chain state |
+| `jaelis_crossChain_settleState` | Submit proof and settle state |
+| `jaelis_crossChain_getStateDiff` | Compare state across chains |
+| `jaelis_crossChain_getLightClientStatus` | Check light client sync status |
+
+### Wallet Standard Methods (ERC-5792, EIP-7702)
+| Method | Description |
+|--------|-------------|
+| `jaelis_wallet_getCapabilities` | Get wallet capabilities |
+| `jaelis_wallet_sendCalls` | Atomic batch transactions |
+| `jaelis_wallet_getCallsStatus` | Check batch status |
+| `jaelis_wallet_grantPermissions` | Grant session permissions |
+| `jaelis_validateAddressSafety` | Anti-phishing check |
+| `jaelis_checkDustAttacks` | Detect address poisoning |
+
+### Standard Ethereum-Compatible Methods
+| Method | Description |
+|--------|-------------|
+| `eth_blockNumber` | Get latest block number |
+| `eth_getBalance` | Get account balance |
+| `eth_sendTransaction` | Send transaction |
+| `eth_call` | Call contract (read-only) |
+| `eth_getTransactionReceipt` | Get transaction receipt |
+
 ## Programmatic Usage
 
 ```javascript
-const { JaelisNode, BootstrapNode } = require('@jaelis/node');
+const { JaelisNode, BootstrapNode } = require('jaelis-node');
 
-// Create and start a full node
+// Create and start a node
 const node = new JaelisNode({
     network: 'testnet',
     rpcPort: 8545,
     p2pPort: 30303,
-    dataDir: './my-node-data'
+    dataDir: './my-node-data',
+    rewardRecipient: '0xYourAddress'  // Any chain address
 });
 
 await node.start();
 
 // Get node status
 const status = node.getStatus();
-console.log(status);
+console.log('Chain ID:', status.chainId);      // 4545 (testnet) or 4547 (mainnet)
+console.log('Peers:', status.peerCount);
+console.log('Block:', status.blockNumber);
 
 // Listen for events
 node.on('peer:connect', (peerCount) => {
-    console.log(`Peers connected: ${peerCount}`);
+    console.log(`Connected peers: ${peerCount}`);
 });
 
-// Stop the node
-await node.stop();
-```
-
-### Bootstrap Node
-
-```javascript
-const { BootstrapNode } = require('@jaelis/node');
-
-const bootstrap = new BootstrapNode({
-    port: 30305,
-    network: 'testnet'
+node.on('block:new', (block) => {
+    console.log(`New block: ${block.number}`);
 });
 
-await bootstrap.start();
-console.log(`Bootstrap node running, ${bootstrap.getPeerCount()} peers`);
+// Stop the node
+await node.stop();
 ```
 
 ## Network Configuration
 
 | Network | Chain ID | RPC URL | Status |
 |---------|----------|---------|--------|
-| Testnet | 4545 | https://rpc.jaelis.io | Active |
+| Testnet | 4545 | https://rpc.jaelis.io | **Active** |
 | Mainnet | 4547 | https://mainnet.jaelis.io | Coming Soon |
 
+## Node Rewards
+
+JAELIS rewards node operators based on:
+- **Uptime** - Keep your node running
+- **Transactions Processed** - Help validate transactions
+- **Bandwidth Provided** - Serve data to the network
+- **Validator Mode** - Opt-in for bonus rewards
+
+**No staking required.** JAELIS never holds your funds. Use any wallet from any chain.
+
+```bash
+# Check your node's contribution stats
+jaelis-node status
+```
+
 ## System Requirements
 
 | Requirement | Minimum | Recommended |
@@ -151,11 +248,11 @@ console.log(`Bootstrap node running, ${bootstrap.getPeerCount()} peers`);
 
 ```
 jaelis-data/
-├── blockchain/       # Block and state data
-│   ├── blocks/       # Block storage (LevelDB)
-│   └── state/        # State trie (LevelDB)
+├── blockchain/       # Block and state data (LevelDB)
+├── node-registry/    # Node tracking and statistics
+├── wallet-config/    # Wallet configuration
 ├── peers/            # Peer database
-├── keys/             # Node keys (if validator)
+├── keys/             # Node identity keys
 └── logs/             # Node logs
 ```
 
@@ -163,38 +260,44 @@ jaelis-data/
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `JAELIS_CORE_PATH` | Path to JAELIS core | Auto-detected |
-| `JAELIS_DATA_DIR` | Data directory | `./jaelis-data` |
 | `JAELIS_NETWORK` | Network (testnet/mainnet) | `testnet` |
+| `JAELIS_DATA_DIR` | Data directory | `./jaelis-data` |
 | `JAELIS_RPC_PORT` | RPC port | `8545` |
 | `JAELIS_P2P_PORT` | P2P port | `30303` |
+| `JAELIS_REWARD_ADDRESS` | Reward wallet address | - |
 
 ## Docker
 
 ```bash
-# Pull the image
-docker pull jaelis/node
-
 # Run a full node
 docker run -d \
   --name jaelis-node \
   -p 8545:8545 \
   -p 30303:30303 \
   -v jaelis-data:/data \
+  -e JAELIS_REWARD_ADDRESS=0xYourAddress \
   jaelis/node start --network testnet
-
-# Check logs
-docker logs -f jaelis-node
 ```
 
-## Contributing
+## Technical Highlights
+
+### Patent-Pending Technology
+JAELIS implements three patent-pending systems:
+1. **Universal VM Architecture** - Multi-language contract execution
+2. **Cross-Chain Light Client Protocol** - Trustless external state verification
+3. **LODE Computation Model** - Zero-fee transaction processing
 
-Contributions are welcome! Please see our contributing guidelines.
+### Security
+- Real libp2p P2P networking (same protocol as Ethereum 2.0, Filecoin, IPFS)
+- Automatic peer discovery and DHT routing
+- Built-in MEV protection
+- Address poisoning detection
+- No trusted setup for privacy features
 
 ## Links
 
+- SDK: [npmjs.com/package/jaelis.js](https://www.npmjs.com/package/jaelis.js)
 - Website: [jaelis.io](https://jaelis.io)
-- SDK: [npm/jaelis.js](https://www.npmjs.com/package/jaelis.js)
 - Documentation: [docs.jaelis.io](https://docs.jaelis.io)
 - GitHub: [github.com/jaelis-foundation](https://github.com/jaelis-foundation)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaelis-node",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Official JAELIS Blockchain Node - Run a full node, validator, or bootstrap node with Cross-Chain Settlement (30+ chains!), ERC-5792 wallet capabilities, EIP-7702 account abstraction",
   "main": "lib/index.js",
   "bin": {