gennet.js 0.2.1 → 0.3.0

package/README.md

@@ -43,6 +43,17 @@ await gennet.net.send('0xRecipientAddress', 'Hello!');
 gennet.disconnect();
 ```
 
+## Authentication
+
+For Gennet-Nodes with JWT authentication enabled, pass the token via options:
+
+```typescript
+const gennet = new GenNet('ws://localhost:18789', { token: 'eyJhbGciOi...' });
+await gennet.connect();
+```
+
+Works with both WebSocket and HTTP providers.
+
 ## Providers
 
 gennet.js auto-detects the provider from the URL:

package/dist/index.cjs

@@ -14,8 +14,10 @@ class RpcError extends Error {
 let requestId = 0;
 class HttpProvider {
   url;
-  constructor(url) {
+  token;
+  constructor(url, token) {
     this.url = url;
+    this.token = token;
   }
   get connected() {
     return true;
@@ -23,9 +25,13 @@ class HttpProvider {
   async request(method, params) {
     const id = ++requestId;
     const body = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+    const headers = { "Content-Type": "application/json" };
+    if (this.token) {
+      headers["Authorization"] = `Bearer ${this.token}`;
+    }
     const res = await fetch(this.url, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers,
       body
     });
     if (!res.ok) {
@@ -312,9 +318,9 @@ class GenNet {
   agent;
   mempool;
   provider;
-  constructor(providerOrUrl) {
+  constructor(providerOrUrl, options) {
     if (typeof providerOrUrl === "string") {
-      this.provider = GenNet.createProvider(providerOrUrl);
+      this.provider = GenNet.createProvider(providerOrUrl, options);
     } else {
       this.provider = providerOrUrl;
     }
@@ -371,12 +377,13 @@ class GenNet {
     return this.provider.request(method, params);
   }
   // ── Private ────────────────────────────────────────────────
-  static createProvider(url) {
+  static createProvider(url, options) {
     if (url.startsWith("ws://") || url.startsWith("wss://")) {
-      return new WebSocketProvider(url);
+      const wsUrl = options?.token ? `${url}${url.includes("?") ? "&" : "?"}token=${encodeURIComponent(options.token)}` : url;
+      return new WebSocketProvider(wsUrl);
     }
     if (url.startsWith("http://") || url.startsWith("https://")) {
-      return new HttpProvider(url);
+      return new HttpProvider(url, options?.token);
     }
     throw new Error(`Unbekanntes URL-Schema: ${url} (erwartet: ws://, wss://, http://, https://)`);
   }

package/dist/index.d.cts

@@ -39,6 +39,14 @@ interface ModuleInfo {
     state: string;
     status?: string;
 }
+interface TransportInfo {
+    enabled: boolean;
+    host?: string;
+    port?: number;
+    api: string[];
+    origins?: string[];
+    auth?: boolean;
+}
 interface NodeInfo {
     state: GatewayState;
     peerId: string | null;
@@ -53,6 +61,9 @@ interface NodeInfo {
     listenPort: number;
     datadir: string;
     modules: ModuleInfo[];
+    ws: TransportInfo;
+    http: TransportInfo;
+    ipc: boolean;
 }
 interface PeerInfo {
     peerId: string;
@@ -209,6 +220,11 @@ declare class Mempool {
  * gennet.disconnect();
  * ```
  */
+/** Optionen für den GenNet Client. */
+interface GenNetOptions {
+    /** JWT-Token für authentifizierte Verbindungen. */
+    token?: string;
+}
 declare class GenNet {
     readonly admin: Admin;
     readonly net: Net;
@@ -216,7 +232,7 @@ declare class GenNet {
     readonly agent: Agent;
     readonly mempool: Mempool;
     private readonly provider;
-    constructor(providerOrUrl: string | Provider);
+    constructor(providerOrUrl: string | Provider, options?: GenNetOptions);
     /** Verbindung herstellen (nur bei WebSocket nötig). */
     connect(): Promise<void>;
     /** Verbindung schließen. */
@@ -278,7 +294,8 @@ declare class WebSocketProvider implements Provider {
  */
 declare class HttpProvider implements Provider {
     private readonly url;
-    constructor(url: string);
+    private readonly token;
+    constructor(url: string, token?: string);
     get connected(): boolean;
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
     on<E extends ProviderEvent>(_event: E, _listener: ProviderEventListener<E>): void;
@@ -287,4 +304,4 @@ declare class HttpProvider implements Provider {
 }
 
 export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
-export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic };
+export type { AgentResult, GatewayState, GenNetOptions, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic, TransportInfo };

package/dist/index.d.mts

@@ -39,6 +39,14 @@ interface ModuleInfo {
     state: string;
     status?: string;
 }
+interface TransportInfo {
+    enabled: boolean;
+    host?: string;
+    port?: number;
+    api: string[];
+    origins?: string[];
+    auth?: boolean;
+}
 interface NodeInfo {
     state: GatewayState;
     peerId: string | null;
@@ -53,6 +61,9 @@ interface NodeInfo {
     listenPort: number;
     datadir: string;
     modules: ModuleInfo[];
+    ws: TransportInfo;
+    http: TransportInfo;
+    ipc: boolean;
 }
 interface PeerInfo {
     peerId: string;
@@ -209,6 +220,11 @@ declare class Mempool {
  * gennet.disconnect();
  * ```
  */
+/** Optionen für den GenNet Client. */
+interface GenNetOptions {
+    /** JWT-Token für authentifizierte Verbindungen. */
+    token?: string;
+}
 declare class GenNet {
     readonly admin: Admin;
     readonly net: Net;
@@ -216,7 +232,7 @@ declare class GenNet {
     readonly agent: Agent;
     readonly mempool: Mempool;
     private readonly provider;
-    constructor(providerOrUrl: string | Provider);
+    constructor(providerOrUrl: string | Provider, options?: GenNetOptions);
     /** Verbindung herstellen (nur bei WebSocket nötig). */
     connect(): Promise<void>;
     /** Verbindung schließen. */
@@ -278,7 +294,8 @@ declare class WebSocketProvider implements Provider {
  */
 declare class HttpProvider implements Provider {
     private readonly url;
-    constructor(url: string);
+    private readonly token;
+    constructor(url: string, token?: string);
     get connected(): boolean;
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
     on<E extends ProviderEvent>(_event: E, _listener: ProviderEventListener<E>): void;
@@ -287,4 +304,4 @@ declare class HttpProvider implements Provider {
 }
 
 export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
-export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic };
+export type { AgentResult, GatewayState, GenNetOptions, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic, TransportInfo };

package/dist/index.d.ts

@@ -39,6 +39,14 @@ interface ModuleInfo {
     state: string;
     status?: string;
 }
+interface TransportInfo {
+    enabled: boolean;
+    host?: string;
+    port?: number;
+    api: string[];
+    origins?: string[];
+    auth?: boolean;
+}
 interface NodeInfo {
     state: GatewayState;
     peerId: string | null;
@@ -53,6 +61,9 @@ interface NodeInfo {
     listenPort: number;
     datadir: string;
     modules: ModuleInfo[];
+    ws: TransportInfo;
+    http: TransportInfo;
+    ipc: boolean;
 }
 interface PeerInfo {
     peerId: string;
@@ -209,6 +220,11 @@ declare class Mempool {
  * gennet.disconnect();
  * ```
  */
+/** Optionen für den GenNet Client. */
+interface GenNetOptions {
+    /** JWT-Token für authentifizierte Verbindungen. */
+    token?: string;
+}
 declare class GenNet {
     readonly admin: Admin;
     readonly net: Net;
@@ -216,7 +232,7 @@ declare class GenNet {
     readonly agent: Agent;
     readonly mempool: Mempool;
     private readonly provider;
-    constructor(providerOrUrl: string | Provider);
+    constructor(providerOrUrl: string | Provider, options?: GenNetOptions);
     /** Verbindung herstellen (nur bei WebSocket nötig). */
     connect(): Promise<void>;
     /** Verbindung schließen. */
@@ -278,7 +294,8 @@ declare class WebSocketProvider implements Provider {
  */
 declare class HttpProvider implements Provider {
     private readonly url;
-    constructor(url: string);
+    private readonly token;
+    constructor(url: string, token?: string);
     get connected(): boolean;
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
     on<E extends ProviderEvent>(_event: E, _listener: ProviderEventListener<E>): void;
@@ -287,4 +304,4 @@ declare class HttpProvider implements Provider {
 }
 
 export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
-export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic };
+export type { AgentResult, GatewayState, GenNetOptions, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic, TransportInfo };

package/dist/index.mjs

@@ -12,8 +12,10 @@ class RpcError extends Error {
 let requestId = 0;
 class HttpProvider {
   url;
-  constructor(url) {
+  token;
+  constructor(url, token) {
     this.url = url;
+    this.token = token;
   }
   get connected() {
     return true;
@@ -21,9 +23,13 @@ class HttpProvider {
   async request(method, params) {
     const id = ++requestId;
     const body = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+    const headers = { "Content-Type": "application/json" };
+    if (this.token) {
+      headers["Authorization"] = `Bearer ${this.token}`;
+    }
     const res = await fetch(this.url, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers,
       body
     });
     if (!res.ok) {
@@ -310,9 +316,9 @@ class GenNet {
   agent;
   mempool;
   provider;
-  constructor(providerOrUrl) {
+  constructor(providerOrUrl, options) {
     if (typeof providerOrUrl === "string") {
-      this.provider = GenNet.createProvider(providerOrUrl);
+      this.provider = GenNet.createProvider(providerOrUrl, options);
     } else {
       this.provider = providerOrUrl;
     }
@@ -369,12 +375,13 @@ class GenNet {
     return this.provider.request(method, params);
   }
   // ── Private ────────────────────────────────────────────────
-  static createProvider(url) {
+  static createProvider(url, options) {
     if (url.startsWith("ws://") || url.startsWith("wss://")) {
-      return new WebSocketProvider(url);
+      const wsUrl = options?.token ? `${url}${url.includes("?") ? "&" : "?"}token=${encodeURIComponent(options.token)}` : url;
+      return new WebSocketProvider(wsUrl);
     }
     if (url.startsWith("http://") || url.startsWith("https://")) {
-      return new HttpProvider(url);
+      return new HttpProvider(url, options?.token);
     }
     throw new Error(`Unbekanntes URL-Schema: ${url} (erwartet: ws://, wss://, http://, https://)`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gennet.js",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Client Library for GenNet — interact with GenNet nodes via JSON-RPC",
   "type": "module",
   "sideEffects": false,