jaelis-node 1.5.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -167,6 +167,54 @@ Options:
167
167
  --reward-recipient <address> Wallet address for node rewards (ANY chain!)
168
168
  ```
169
169
 
170
+ ## Block Sync & Node Status
171
+
172
+ Your node automatically syncs with the JAELIS network:
173
+
174
+ ```bash
175
+ # Check sync status
176
+ curl -X POST http://localhost:8545 \
177
+ -H "Content-Type: application/json" \
178
+ -d '{"jsonrpc":"2.0","method":"jaelis_syncing","params":[],"id":1}'
179
+
180
+ # Response when syncing:
181
+ {
182
+ "currentBlock": "0x1a4",
183
+ "highestBlock": "0x2f8",
184
+ "syncedBlocks": 420,
185
+ "remainingBlocks": 340,
186
+ "percentComplete": "55.26%"
187
+ }
188
+
189
+ # Response when fully synced:
190
+ false
191
+ ```
192
+
193
+ ### Node Registry & Lifetime Tracking
194
+
195
+ When your node connects, it registers with the JAELIS network. Your contributions are tracked **forever** - even across restarts:
196
+
197
+ ```bash
198
+ # See all connected nodes (run on main RPC)
199
+ curl -X POST https://rpc.jaelis.io \
200
+ -H "Content-Type: application/json" \
201
+ -d '{"jsonrpc":"2.0","method":"jaelis_node_getNodes","params":[],"id":1}'
202
+
203
+ # Get network-wide node stats
204
+ curl -X POST https://rpc.jaelis.io \
205
+ -H "Content-Type: application/json" \
206
+ -d '{"jsonrpc":"2.0","method":"jaelis_node_getStats","params":[],"id":1}'
207
+
208
+ # Response:
209
+ {
210
+ "lifetimeNodes": 142, # All nodes that EVER connected
211
+ "activeNodes": 23, # Currently online
212
+ "validators": 8, # Opted-in validators
213
+ "totalUptime": "45d 12h", # Cumulative network uptime
214
+ "byAddressType": { "evm": 89, "solana": 31, "bitcoin": 22 }
215
+ }
216
+ ```
217
+
170
218
  ## RPC Methods
171
219
 
172
220
  Your node exposes standard JSON-RPC plus JAELIS-specific methods: