gennet.js 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,261 @@
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown> | unknown[];
+}
+interface JsonRpcSuccessResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result: unknown;
+}
+interface JsonRpcErrorResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;
+interface JsonRpcNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params: {
+        subscription: string;
+        result: unknown;
+    };
+}
+declare class RpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(message: string, code: number, data?: unknown);
+}
+type GatewayState = 'INITIALIZING' | 'READY' | 'RUNNING' | 'STOPPED';
+interface ModuleInfo {
+    name: string;
+    version: string;
+    state: string;
+    status?: string;
+}
+interface NodeInfo {
+    state: GatewayState;
+    peerId: string | null;
+    address: string;
+    peers: number;
+    knownPeers: number;
+    uptime: number;
+    multiaddrs: string[];
+    tcpAddrs: string[];
+    circuitAddrs: string[];
+    relay: boolean;
+    listenPort: number;
+    datadir: string;
+    modules: ModuleInfo[];
+}
+interface PeerInfo {
+    peerId: string;
+    address: string;
+    multiaddr: string;
+    connected: boolean;
+}
+interface AgentResult {
+    ok: boolean;
+    response?: string;
+    toolCalls?: Array<{
+        name: string;
+    }>;
+    tokensUsed?: {
+        input: number;
+        output: number;
+    };
+    error?: string;
+}
+interface IdentityInfo {
+    index: number;
+    address: string;
+    filename: string;
+}
+type SubscriptionTopic = 'logs' | 'messages' | 'mempool';
+interface Subscription {
+    id: string;
+    unsubscribe: () => Promise<boolean>;
+}
+interface Provider {
+    /** JSON-RPC Request senden und auf Response warten. */
+    request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
+    /** Listener für Push-Notifications (Subscriptions). */
+    on(event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    /** Listener entfernen. */
+    off(event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    /** Verbindung schließen. */
+    disconnect(): void;
+    /** Verbindung herstellen (bei WebSocket). */
+    connect?(): Promise<void>;
+    /** Ob eine aktive Verbindung besteht. */
+    readonly connected: boolean;
+}
+
+/** admin Namespace — Node-Administration. */
+declare class Admin {
+    private readonly provider;
+    constructor(provider: Provider);
+    /** Node-Info: Status, PeerId, Adresse, Peers, Uptime, Module. */
+    nodeInfo(): Promise<NodeInfo>;
+    /** Gateway herunterfahren. */
+    shutdown(): Promise<{
+        ok: boolean;
+    }>;
+    /** Alle Module und ihren Status auflisten. */
+    modules(): Promise<{
+        modules: ModuleInfo[];
+    }>;
+    /** Ein Modul starten. */
+    startModule(name: string): Promise<{
+        name: string;
+        state: string;
+    }>;
+    /** Ein Modul stoppen. */
+    stopModule(name: string): Promise<{
+        name: string;
+        state: string;
+    }>;
+}
+
+/** net Namespace — P2P-Netzwerk. */
+declare class Net {
+    private readonly provider;
+    constructor(provider: Provider);
+    /** Alle bekannten Peers auflisten. */
+    peers(): Promise<{
+        peers: PeerInfo[];
+    }>;
+    /** Mit einem Peer über Multiaddr verbinden. */
+    connect(multiaddr: string): Promise<{
+        peerId: string;
+        connected: boolean;
+    }>;
+    /** Verschlüsselte Nachricht an einen Peer senden. */
+    send(address: string, text: string): Promise<{
+        sent: boolean;
+        to: string;
+    }>;
+    /** Agent-Prompt auf einem Remote-Peer ausführen (ECIES-verschlüsselt). */
+    peerAgent(address: string, prompt: string): Promise<AgentResult>;
+}
+
+/** personal Namespace — Identity/Keystore-Management. */
+declare class Personal {
+    private readonly provider;
+    constructor(provider: Provider);
+    /** Neue Identität erstellen und im Keystore speichern. */
+    newIdentity(password: string): Promise<{
+        address: string;
+        path: string;
+    }>;
+    /** Alle Identitäten im Keystore auflisten. */
+    listIdentities(): Promise<{
+        identities: IdentityInfo[];
+    }>;
+}
+
+/** agent Namespace — Lokaler AI-Agent. */
+declare class Agent {
+    private readonly provider;
+    constructor(provider: Provider);
+    /** Agent-Loop mit einem Prompt ausführen. */
+    run(input: string): Promise<AgentResult>;
+}
+
+/** mempool Namespace — Transaction Mempool. */
+declare class Mempool {
+    private readonly provider;
+    constructor(provider: Provider);
+    /** Nachricht ans Netzwerk broadcasten (GossipSub). */
+    broadcast(message: string): Promise<{
+        sent: boolean;
+        taskId: string;
+    }>;
+}
+
+/**
+ * GenNet Client — Hauptklasse für die Interaktion mit einem GenNet-Node.
+ *
+ * @example
+ * ```typescript
+ * const gennet = new GenNet('ws://localhost:18789');
+ * await gennet.connect();
+ *
+ * const info = await gennet.admin.nodeInfo();
+ * const peers = await gennet.net.peers();
+ * await gennet.net.send('0x...', 'Hello');
+ *
+ * const sub = await gennet.subscribe('messages', (data) => console.log(data));
+ * await sub.unsubscribe();
+ *
+ * gennet.disconnect();
+ * ```
+ */
+declare class GenNet {
+    readonly admin: Admin;
+    readonly net: Net;
+    readonly personal: Personal;
+    readonly agent: Agent;
+    readonly mempool: Mempool;
+    private readonly provider;
+    constructor(providerOrUrl: string | Provider);
+    /** Verbindung herstellen (nur bei WebSocket nötig). */
+    connect(): Promise<void>;
+    /** Verbindung schließen. */
+    disconnect(): void;
+    /** Ob eine aktive Verbindung besteht. */
+    get connected(): boolean;
+    /**
+     * Subscription starten (nur WebSocket).
+     * Topics: 'logs', 'messages', 'mempool'.
+     */
+    subscribe(topic: SubscriptionTopic, callback: (data: unknown) => void): Promise<Subscription>;
+    /** Raw JSON-RPC Request (für erweiterte Nutzung). */
+    request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
+    private static createProvider;
+}
+
+/**
+ * WebSocket Provider — nutzt native WebSocket API (Browser + Node 22+).
+ * Unterstützt Subscriptions via Push-Notifications.
+ */
+declare class WebSocketProvider implements Provider {
+    private readonly url;
+    private readonly timeout;
+    private ws;
+    private requestId;
+    private pending;
+    private listeners;
+    private connectPromise;
+    constructor(url: string, timeout?: number);
+    get connected(): boolean;
+    connect(): Promise<void>;
+    request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
+    on(_event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    off(_event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    disconnect(): void;
+    private handleMessage;
+}
+
+/**
+ * HTTP Provider — fetch-basiert, browser-kompatibel.
+ * Unterstützt keine Subscriptions (kein Push-Kanal).
+ */
+declare class HttpProvider implements Provider {
+    private readonly url;
+    constructor(url: string);
+    get connected(): boolean;
+    request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
+    on(_event: 'notification', _listener: (notification: JsonRpcNotification) => void): void;
+    off(_event: 'notification', _listener: (notification: JsonRpcNotification) => void): void;
+    disconnect(): void;
+}
+
+export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
+export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, Subscription, SubscriptionTopic };

package/dist/index.d.ts

@@ -0,0 +1,261 @@
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown> | unknown[];
+}
+interface JsonRpcSuccessResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result: unknown;
+}
+interface JsonRpcErrorResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;
+interface JsonRpcNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params: {
+        subscription: string;
+        result: unknown;
+    };
+}
+declare class RpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(message: string, code: number, data?: unknown);
+}
+type GatewayState = 'INITIALIZING' | 'READY' | 'RUNNING' | 'STOPPED';
+interface ModuleInfo {
+    name: string;
+    version: string;
+    state: string;
+    status?: string;
+}
+interface NodeInfo {
+    state: GatewayState;
+    peerId: string | null;
+    address: string;
+    peers: number;
+    knownPeers: number;
+    uptime: number;
+    multiaddrs: string[];
+    tcpAddrs: string[];
+    circuitAddrs: string[];
+    relay: boolean;
+    listenPort: number;
+    datadir: string;
+    modules: ModuleInfo[];
+}
+interface PeerInfo {
+    peerId: string;
+    address: string;
+    multiaddr: string;
+    connected: boolean;
+}
+interface AgentResult {
+    ok: boolean;
+    response?: string;
+    toolCalls?: Array<{
+        name: string;
+    }>;
+    tokensUsed?: {
+        input: number;
+        output: number;
+    };
+    error?: string;
+}
+interface IdentityInfo {
+    index: number;
+    address: string;
+    filename: string;
+}
+type SubscriptionTopic = 'logs' | 'messages' | 'mempool';
+interface Subscription {
+    id: string;
+    unsubscribe: () => Promise<boolean>;
+}
+interface Provider {
+    /** JSON-RPC Request senden und auf Response warten. */
+    request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
+    /** Listener für Push-Notifications (Subscriptions). */
+    on(event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    /** Listener entfernen. */
+    off(event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    /** Verbindung schließen. */
+    disconnect(): void;
+    /** Verbindung herstellen (bei WebSocket). */
+    connect?(): Promise<void>;
+    /** Ob eine aktive Verbindung besteht. */
+    readonly connected: boolean;
+}
+
+/** admin Namespace — Node-Administration. */
+declare class Admin {
+    private readonly provider;
+    constructor(provider: Provider);
+    /** Node-Info: Status, PeerId, Adresse, Peers, Uptime, Module. */
+    nodeInfo(): Promise<NodeInfo>;
+    /** Gateway herunterfahren. */
+    shutdown(): Promise<{
+        ok: boolean;
+    }>;
+    /** Alle Module und ihren Status auflisten. */
+    modules(): Promise<{
+        modules: ModuleInfo[];
+    }>;
+    /** Ein Modul starten. */
+    startModule(name: string): Promise<{
+        name: string;
+        state: string;
+    }>;
+    /** Ein Modul stoppen. */
+    stopModule(name: string): Promise<{
+        name: string;
+        state: string;
+    }>;
+}
+
+/** net Namespace — P2P-Netzwerk. */
+declare class Net {
+    private readonly provider;
+    constructor(provider: Provider);
+    /** Alle bekannten Peers auflisten. */
+    peers(): Promise<{
+        peers: PeerInfo[];
+    }>;
+    /** Mit einem Peer über Multiaddr verbinden. */
+    connect(multiaddr: string): Promise<{
+        peerId: string;
+        connected: boolean;
+    }>;
+    /** Verschlüsselte Nachricht an einen Peer senden. */
+    send(address: string, text: string): Promise<{
+        sent: boolean;
+        to: string;
+    }>;
+    /** Agent-Prompt auf einem Remote-Peer ausführen (ECIES-verschlüsselt). */
+    peerAgent(address: string, prompt: string): Promise<AgentResult>;
+}
+
+/** personal Namespace — Identity/Keystore-Management. */
+declare class Personal {
+    private readonly provider;
+    constructor(provider: Provider);
+    /** Neue Identität erstellen und im Keystore speichern. */
+    newIdentity(password: string): Promise<{
+        address: string;
+        path: string;
+    }>;
+    /** Alle Identitäten im Keystore auflisten. */
+    listIdentities(): Promise<{
+        identities: IdentityInfo[];
+    }>;
+}
+
+/** agent Namespace — Lokaler AI-Agent. */
+declare class Agent {
+    private readonly provider;
+    constructor(provider: Provider);
+    /** Agent-Loop mit einem Prompt ausführen. */
+    run(input: string): Promise<AgentResult>;
+}
+
+/** mempool Namespace — Transaction Mempool. */
+declare class Mempool {
+    private readonly provider;
+    constructor(provider: Provider);
+    /** Nachricht ans Netzwerk broadcasten (GossipSub). */
+    broadcast(message: string): Promise<{
+        sent: boolean;
+        taskId: string;
+    }>;
+}
+
+/**
+ * GenNet Client — Hauptklasse für die Interaktion mit einem GenNet-Node.
+ *
+ * @example
+ * ```typescript
+ * const gennet = new GenNet('ws://localhost:18789');
+ * await gennet.connect();
+ *
+ * const info = await gennet.admin.nodeInfo();
+ * const peers = await gennet.net.peers();
+ * await gennet.net.send('0x...', 'Hello');
+ *
+ * const sub = await gennet.subscribe('messages', (data) => console.log(data));
+ * await sub.unsubscribe();
+ *
+ * gennet.disconnect();
+ * ```
+ */
+declare class GenNet {
+    readonly admin: Admin;
+    readonly net: Net;
+    readonly personal: Personal;
+    readonly agent: Agent;
+    readonly mempool: Mempool;
+    private readonly provider;
+    constructor(providerOrUrl: string | Provider);
+    /** Verbindung herstellen (nur bei WebSocket nötig). */
+    connect(): Promise<void>;
+    /** Verbindung schließen. */
+    disconnect(): void;
+    /** Ob eine aktive Verbindung besteht. */
+    get connected(): boolean;
+    /**
+     * Subscription starten (nur WebSocket).
+     * Topics: 'logs', 'messages', 'mempool'.
+     */
+    subscribe(topic: SubscriptionTopic, callback: (data: unknown) => void): Promise<Subscription>;
+    /** Raw JSON-RPC Request (für erweiterte Nutzung). */
+    request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
+    private static createProvider;
+}
+
+/**
+ * WebSocket Provider — nutzt native WebSocket API (Browser + Node 22+).
+ * Unterstützt Subscriptions via Push-Notifications.
+ */
+declare class WebSocketProvider implements Provider {
+    private readonly url;
+    private readonly timeout;
+    private ws;
+    private requestId;
+    private pending;
+    private listeners;
+    private connectPromise;
+    constructor(url: string, timeout?: number);
+    get connected(): boolean;
+    connect(): Promise<void>;
+    request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
+    on(_event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    off(_event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    disconnect(): void;
+    private handleMessage;
+}
+
+/**
+ * HTTP Provider — fetch-basiert, browser-kompatibel.
+ * Unterstützt keine Subscriptions (kein Push-Kanal).
+ */
+declare class HttpProvider implements Provider {
+    private readonly url;
+    constructor(url: string);
+    get connected(): boolean;
+    request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
+    on(_event: 'notification', _listener: (notification: JsonRpcNotification) => void): void;
+    off(_event: 'notification', _listener: (notification: JsonRpcNotification) => void): void;
+    disconnect(): void;
+}
+
+export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
+export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, Subscription, SubscriptionTopic };