@gns-foundation/hive-worker 0.1.0

package/dist/llama.d.ts

@@ -0,0 +1,12 @@
+import { type ChildProcess } from 'child_process';
+export declare const DEFAULT_RPC_PORT = 50052;
+export interface LlamaRpcHandle {
+    process: ChildProcess;
+    port: number;
+    pid: number;
+}
+export declare function findRpcBinary(): string | null;
+export declare function isRpcServerAvailable(): boolean;
+export declare function startRpcServer(port?: number, onLog?: (line: string) => void): LlamaRpcHandle | null;
+export declare function stopRpcServer(handle: LlamaRpcHandle): void;
+export declare function isPortFree(port: number): Promise<boolean>;

package/dist/llama.js

@@ -0,0 +1,65 @@
+// ============================================================
+// HIVE WORKER — LLAMA.CPP RPC SERVER
+// Start / stop the llama.cpp rpc-server process
+// Detects binary location, manages lifecycle
+// ============================================================
+import { spawn } from 'child_process';
+import { execSync } from 'child_process';
+import os from 'os';
+export const DEFAULT_RPC_PORT = 50052;
+const RPC_BINARY_CANDIDATES = [
+    'rpc-server',
+    'llama-rpc-server',
+    '/usr/local/bin/rpc-server',
+    `${os.homedir()}/llama.cpp/rpc-server`,
+    `${os.homedir()}/llama.cpp/build/bin/rpc-server`,
+    `${os.homedir()}/llama.cpp/build/rpc-server`,
+];
+export function findRpcBinary() {
+    for (const candidate of RPC_BINARY_CANDIDATES) {
+        try {
+            execSync(`which "${candidate}" 2>/dev/null || test -f "${candidate}"`, { timeout: 2000 });
+            return candidate;
+        }
+        catch { }
+    }
+    try {
+        execSync('rpc-server --help 2>&1 | head -1', { timeout: 2000 });
+        return 'rpc-server';
+    }
+    catch { }
+    return null;
+}
+export function isRpcServerAvailable() {
+    return findRpcBinary() !== null;
+}
+export function startRpcServer(port = DEFAULT_RPC_PORT, onLog) {
+    const binary = findRpcBinary();
+    if (!binary)
+        return null;
+    const isAppleSilicon = os.platform() === 'darwin' && os.arch() === 'arm64';
+    const args = ['--host', '0.0.0.0', '--port', String(port)];
+    if (isAppleSilicon)
+        args.push('-d', 'CPU');
+    const proc = spawn(binary, args, {
+        detached: false,
+        stdio: ['ignore', 'ignore', 'ignore'],
+    });
+    return { process: proc, port, pid: proc.pid ?? 0 };
+}
+export function stopRpcServer(handle) {
+    try {
+        handle.process.kill('SIGTERM');
+    }
+    catch { }
+}
+export async function isPortFree(port) {
+    const net = await import('net');
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => resolve(false));
+        server.once('listening', () => { server.close(); resolve(true); });
+        server.listen(port, '127.0.0.1');
+    });
+}
+//# sourceMappingURL=llama.js.map

package/dist/llama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llama.js","sourceRoot":"","sources":["../src/llama.ts"],"names":[],"mappings":"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"}

package/dist/registry.d.ts

@@ -0,0 +1,25 @@
+import type { HiveIdentity } from './identity.js';
+import type { HardwareProfile, GeoProfile } from './hardware.js';
+export type WorkerStatus = 'idle' | 'computing' | 'offline';
+export interface SwarmNode {
+    pk: string;
+    h3_cell: string;
+    handle: string | null;
+    hardware: HardwareProfile;
+    geo: GeoProfile;
+    status: WorkerStatus;
+    last_heartbeat: string;
+    tokens_earned: number;
+    rpc_port: number | null;
+    worker_version: string;
+}
+export interface RegistryStats {
+    totalNodes: number;
+    activeNodes: number;
+    totalTflops: number;
+}
+export declare function registerNode(identity: HiveIdentity, hw: HardwareProfile, geo: GeoProfile, handle: string | null, rpcPort: number | null): Promise<void>;
+export declare function heartbeat(pk: string, status: WorkerStatus): Promise<void>;
+export declare function deregisterNode(pk: string): Promise<void>;
+export declare function fetchSwarmStats(): Promise<RegistryStats>;
+export declare function fetchTokenBalance(pk: string): Promise<number>;

package/dist/registry.js

@@ -0,0 +1,97 @@
+// ============================================================
+// HIVE WORKER — REGISTRY
+// Supabase swarm_nodes: register, heartbeat, deregister
+// Matches the schema built on March 25, 2026
+// ============================================================
+const SUPABASE_URL = 'https://kaqwkxfaclyqjlfhxrmt.supabase.co';
+const SUPABASE_ANON = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImthcXdreGZhY2x5cWpsZmh4cm10Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI4MzU4NTAsImV4cCI6MjA4ODQxMTg1MH0.ClyWNGRxQjpKYzIROPZBqTXDsWvJioGe9pQymDOYBTc';
+const HEADERS = {
+    'apikey': SUPABASE_ANON,
+    'Authorization': `Bearer ${SUPABASE_ANON}`,
+    'Content-Type': 'application/json',
+    'Prefer': 'resolution=merge-duplicates,return=minimal',
+};
+async function supabase(method, table, body, query) {
+    const url = `${SUPABASE_URL}/rest/v1/${table}${query ? '?' + query : ''}`;
+    return fetch(url, {
+        method,
+        headers: HEADERS,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+}
+// ─── Registration ─────────────────────────────────────────────
+export async function registerNode(identity, hw, geo, handle, rpcPort) {
+    const node = {
+        pk: identity.pk,
+        h3_cell: geo.h3Cell,
+        handle,
+        hardware: hw,
+        geo,
+        status: 'idle',
+        last_heartbeat: new Date().toISOString(),
+        tokens_earned: await getExistingTokens(identity.pk),
+        rpc_port: rpcPort,
+        worker_version: '0.1.0',
+    };
+    // Upsert — on conflict update everything except tokens_earned
+    const resp = await supabase('POST', 'swarm_nodes', node, 'on_conflict=pk');
+    if (!resp.ok) {
+        const err = await resp.text();
+        throw new Error(`Registry registration failed: ${resp.status} ${err}`);
+    }
+}
+async function getExistingTokens(pk) {
+    try {
+        const resp = await supabase('GET', 'swarm_nodes', undefined, `pk=eq.${pk}&select=tokens_earned`);
+        if (!resp.ok)
+            return 0;
+        const rows = await resp.json();
+        return rows[0]?.tokens_earned ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+// ─── Heartbeat ─────────────────────────────────────────────
+export async function heartbeat(pk, status) {
+    const resp = await supabase('PATCH', 'swarm_nodes', { status, last_heartbeat: new Date().toISOString() }, `pk=eq.${pk}`);
+    if (!resp.ok && resp.status !== 204) {
+        throw new Error(`Heartbeat failed: ${resp.status}`);
+    }
+}
+// ─── Deregister (graceful shutdown) ─────────────────────────
+export async function deregisterNode(pk) {
+    await supabase('PATCH', 'swarm_nodes', { status: 'offline', last_heartbeat: new Date().toISOString() }, `pk=eq.${pk}`);
+}
+// ─── Stats (for dashboard) ──────────────────────────────────
+export async function fetchSwarmStats() {
+    try {
+        const resp = await supabase('GET', 'swarm_nodes', undefined, 'select=pk,status,hardware');
+        if (!resp.ok)
+            return { totalNodes: 0, activeNodes: 0, totalTflops: 0 };
+        const rows = await resp.json();
+        const totalNodes = rows.length;
+        const activeNodes = rows.filter(r => r.status !== 'offline').length;
+        const totalTflops = rows
+            .filter(r => r.status !== 'offline')
+            .reduce((sum, r) => sum + (r.hardware?.estimatedTflops ?? 0), 0);
+        return { totalNodes, activeNodes, totalTflops: Math.round(totalTflops * 10) / 10 };
+    }
+    catch {
+        return { totalNodes: 0, activeNodes: 0, totalTflops: 0 };
+    }
+}
+// ─── Token balance ──────────────────────────────────────────
+export async function fetchTokenBalance(pk) {
+    try {
+        const resp = await supabase('GET', 'swarm_nodes', undefined, `pk=eq.${pk}&select=tokens_earned`);
+        if (!resp.ok)
+            return 0;
+        const rows = await resp.json();
+        return rows[0]?.tokens_earned ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,yBAAyB;AACzB,wDAAwD;AACxD,6CAA6C;AAC7C,+DAA+D;AAK/D,MAAM,YAAY,GAAG,0CAA0C,CAAC;AAChE,MAAM,aAAa,GAAG,kNAAkN,CAAC;AAEzO,MAAM,OAAO,GAAG;IACd,QAAQ,EAAE,aAAa;IACvB,eAAe,EAAE,UAAU,aAAa,EAAE;IAC1C,cAAc,EAAE,kBAAkB;IAClC,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAuBF,KAAK,UAAU,QAAQ,CACrB,MAAc,EACd,KAAa,EACb,IAAc,EACd,KAAc;IAEd,MAAM,GAAG,GAAG,GAAG,YAAY,YAAY,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC1E,OAAO,KAAK,CAAC,GAAG,EAAE;QAChB,MAAM;QACN,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,iEAAiE;AAEjE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAsB,EACtB,EAAmB,EACnB,GAAe,EACf,MAAqB,EACrB,OAAsB;IAEtB,MAAM,IAAI,GAAc;QACtB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,OAAO,EAAE,GAAG,CAAC,MAAM;QACnB,MAAM;QACN,QAAQ,EAAE,EAAE;QACZ,GAAG;QACH,MAAM,EAAE,MAAM;QACd,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxC,aAAa,EAAE,MAAM,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,QAAQ,EAAE,OAAO;QACjB,cAAc,EAAE,OAAO;KACxB,CAAC;IAEF,8DAA8D;IAC9D,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,MAAM,EACN,aAAa,EACb,IAAI,EACJ,gBAAgB,CACjB,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,EAAU;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;QACjG,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAsC,CAAC;QACnE,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,8DAA8D;AAE9D,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAU,EACV,MAAoB;IAEpB,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,OAAO,EACP,aAAa,EACb,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EACpD,SAAS,EAAE,EAAE,CACd,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,+DAA+D;AAE/D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAU;IAC7C,MAAM,QAAQ,CACZ,OAAO,EACP,aAAa,EACb,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAC/D,SAAS,EAAE,EAAE,CACd,CAAC;AACJ,CAAC;AAED,+DAA+D;AAE/D,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,2BAA2B,CAAC,CAAC;QAC1F,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAA0D,CAAC;QACvF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QACpE,MAAM,WAAW,GAAG,IAAI;aACrB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC;aACnC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,eAAe,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,+DAA+D;AAE/D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAAU;IAChD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;QACjG,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAsC,CAAC;QACnE,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/settlement.d.ts

@@ -0,0 +1,15 @@
+export declare const SPLIT: {
+    readonly WORKER: 0.6;
+    readonly PLATFORM: 0.25;
+    readonly HYDRATION: 0.1;
+    readonly SOVEREIGN: 0.05;
+};
+export interface SettlementRecord {
+    jobId: string;
+    workerPk: string;
+    grossReward: number;
+    workerSlice: number;
+    settledAt: string;
+    stellarTxHash: string | null;
+}
+export declare function creditWorker(workerPk: string, jobId: string, grossReward: number): Promise<SettlementRecord>;

package/dist/settlement.js

@@ -0,0 +1,112 @@
+// ============================================================
+// HIVE WORKER — SETTLEMENT
+// After a job completes, credit GNS to the worker's
+// tokens_earned balance in Supabase.
+//
+// Real Stellar settlement (the 60/25/10/5 split) runs
+// server-side in the orchestrator. The worker just reads
+// its credited balance here.
+//
+// This module:
+//   1. Increments tokens_earned in swarm_nodes (optimistic)
+//   2. Marks job.settled = true
+//   3. Polls for the actual Stellar TX hash from the orchestrator
+// ============================================================
+const SUPABASE_URL = 'https://kaqwkxfaclyqjlfhxrmt.supabase.co';
+const SUPABASE_ANON = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImthcXdreGZhY2x5cWpsZmh4cm10Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI4MzU4NTAsImV4cCI6MjA4ODQxMTg1MH0.ClyWNGRxQjpKYzIROPZBqTXDsWvJioGe9pQymDOYBTc';
+const HEADERS = {
+    'apikey': SUPABASE_ANON,
+    'Authorization': `Bearer ${SUPABASE_ANON}`,
+    'Content-Type': 'application/json',
+    'Prefer': 'return=minimal',
+};
+// GNS split ratios (matches whitepaper §8.1 and March 25 settlement)
+export const SPLIT = {
+    WORKER: 0.60, // community node operators
+    PLATFORM: 0.25, // GEIANT / ULISSY orchestration
+    HYDRATION: 0.10, // hydration & resilience fund
+    SOVEREIGN: 0.05, // BFT quorum coordinators
+};
+// ─── Credit worker (local optimistic update) ──────────────────
+// Increments tokens_earned in swarm_nodes by the 60% worker slice.
+// The orchestrator does the actual Stellar TX — we just reflect it here.
+export async function creditWorker(workerPk, jobId, grossReward) {
+    const workerSlice = Math.round(grossReward * SPLIT.WORKER * 1_000_000) / 1_000_000;
+    // Step 1: increment tokens_earned via Postgres RPC
+    await incrementTokens(workerPk, workerSlice);
+    // Step 2: mark job settled (tx hash comes from orchestrator async)
+    await markJobSettled(jobId, workerSlice);
+    // Step 3: poll for Stellar TX hash (up to 30s, non-blocking)
+    const stellarTxHash = await pollForTxHash(jobId);
+    return {
+        jobId,
+        workerPk,
+        grossReward,
+        workerSlice,
+        settledAt: new Date().toISOString(),
+        stellarTxHash,
+    };
+}
+// ─── Supabase RPC: atomic increment ──────────────────────────
+async function incrementTokens(workerPk, amount) {
+    // Use a raw SQL RPC to do atomic increment (no race condition)
+    const resp = await fetch(`${SUPABASE_URL}/rest/v1/rpc/increment_worker_tokens`, {
+        method: 'POST',
+        headers: HEADERS,
+        body: JSON.stringify({ p_worker_pk: workerPk, p_amount: amount }),
+    });
+    if (!resp.ok) {
+        // Fallback: PATCH with current + amount (non-atomic, acceptable for v0.1)
+        await fallbackIncrementTokens(workerPk, amount);
+    }
+}
+async function fallbackIncrementTokens(workerPk, amount) {
+    // Read current balance
+    const getResp = await fetch(`${SUPABASE_URL}/rest/v1/swarm_nodes?pk=eq.${workerPk}&select=tokens_earned`, { headers: HEADERS });
+    if (!getResp.ok)
+        return;
+    const rows = await getResp.json();
+    const current = rows[0]?.tokens_earned ?? 0;
+    // Write new total
+    await fetch(`${SUPABASE_URL}/rest/v1/swarm_nodes?pk=eq.${workerPk}`, {
+        method: 'PATCH',
+        headers: HEADERS,
+        body: JSON.stringify({ tokens_earned: current + amount }),
+    });
+}
+async function markJobSettled(jobId, workerSlice) {
+    await fetch(`${SUPABASE_URL}/rest/v1/hive_jobs?id=eq.${jobId}`, {
+        method: 'PATCH',
+        headers: HEADERS,
+        body: JSON.stringify({ settled: true }),
+    });
+}
+async function pollForTxHash(jobId, maxWaitMs = 30_000) {
+    const deadline = Date.now() + maxWaitMs;
+    while (Date.now() < deadline) {
+        await sleep(3000);
+        const resp = await fetch(`${SUPABASE_URL}/rest/v1/hive_jobs?id=eq.${jobId}&select=stellar_tx_hash`, { headers: HEADERS });
+        if (!resp.ok)
+            break;
+        const rows = await resp.json();
+        const hash = rows[0]?.stellar_tx_hash;
+        if (hash)
+            return hash;
+    }
+    return null;
+}
+function sleep(ms) {
+    return new Promise(res => setTimeout(res, ms));
+}
+// ─── SQL to add to supabase_migration.sql ────────────────────
+// (included here as a comment so it's easy to find)
+//
+// CREATE OR REPLACE FUNCTION increment_worker_tokens(
+//   p_worker_pk TEXT,
+//   p_amount    NUMERIC
+// ) RETURNS VOID AS $$
+//   UPDATE swarm_nodes
+//   SET tokens_earned = tokens_earned + p_amount
+//   WHERE pk = p_worker_pk;
+// $$ LANGUAGE SQL;
+//# sourceMappingURL=settlement.js.map

package/dist/settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.js","sourceRoot":"","sources":["../src/settlement.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2BAA2B;AAC3B,oDAAoD;AACpD,qCAAqC;AACrC,EAAE;AACF,sDAAsD;AACtD,yDAAyD;AACzD,6BAA6B;AAC7B,EAAE;AACF,eAAe;AACf,4DAA4D;AAC5D,gCAAgC;AAChC,kEAAkE;AAClE,+DAA+D;AAE/D,MAAM,YAAY,GAAG,0CAA0C,CAAC;AAChE,MAAM,aAAa,GAAG,kNAAkN,CAAC;AAEzO,MAAM,OAAO,GAAG;IACd,QAAQ,EAAE,aAAa;IACvB,eAAe,EAAE,UAAU,aAAa,EAAE;IAC1C,cAAc,EAAE,kBAAkB;IAClC,QAAQ,EAAE,gBAAgB;CAC3B,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,MAAM,EAAM,IAAI,EAAG,2BAA2B;IAC9C,QAAQ,EAAI,IAAI,EAAG,gCAAgC;IACnD,SAAS,EAAG,IAAI,EAAG,8BAA8B;IACjD,SAAS,EAAG,IAAI,EAAG,0BAA0B;CACrC,CAAC;AAWX,iEAAiE;AACjE,mEAAmE;AACnE,yEAAyE;AAEzE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,KAAa,EACb,WAAmB;IAEnB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAEnF,mDAAmD;IACnD,MAAM,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAE7C,mEAAmE;IACnE,MAAM,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAEzC,6DAA6D;IAC7D,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAEjD,OAAO;QACL,KAAK;QACL,QAAQ;QACR,WAAW;QACX,WAAW;QACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,aAAa;KACd,CAAC;AACJ,CAAC;AAED,gEAAgE;AAEhE,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,MAAc;IAC7D,+DAA+D;IAC/D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,YAAY,sCAAsC,EAAE;QAC9E,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;KAClE,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,0EAA0E;QAC1E,MAAM,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,QAAgB,EAAE,MAAc;IACrE,uBAAuB;IACvB,MAAM,OAAO,GAAG,MAAM,KAAK,CACzB,GAAG,YAAY,8BAA8B,QAAQ,uBAAuB,EAC5E,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO;IACxB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAsC,CAAC;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,IAAI,CAAC,CAAC;IAE5C,kBAAkB;IAClB,MAAM,KAAK,CAAC,GAAG,YAAY,8BAA8B,QAAQ,EAAE,EAAE;QACnE,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;KAC1D,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,KAAa,EAAE,WAAmB;IAC9D,MAAM,KAAK,CAAC,GAAG,YAAY,4BAA4B,KAAK,EAAE,EAAE;QAC9D,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KACxC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,KAAa,EAAE,SAAS,GAAG,MAAM;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,GAAG,YAAY,4BAA4B,KAAK,yBAAyB,EACzE,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM;QACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAA+C,CAAC;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC;QACtC,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,gEAAgE;AAChE,oDAAoD;AACpD,EAAE;AACF,sDAAsD;AACtD,sBAAsB;AACtB,wBAAwB;AACxB,uBAAuB;AACvB,uBAAuB;AACvB,iDAAiD;AACjD,4BAA4B;AAC5B,mBAAmB"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@gns-foundation/hive-worker",
+  "version": "0.1.0",
+  "description": "Turn your device into a GEIANT Hive compute node. Earn GNS tokens.",
+  "bin": {
+    "hive-worker": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/cli.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["geiant", "hive", "gns", "ai", "inference", "decentralized"],
+  "author": "GNS Foundation <cayerbe@ulissy.app>",
+  "license": "BSL-1.1",
+  "dependencies": {
+    "tweetnacl": "^1.0.3",
+    "tweetnacl-util": "^0.15.1",
+    "node-fetch": "^3.3.2",
+    "h3-js": "^4.1.0",
+    "ora": "^8.0.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.5",
+    "@types/node": "^20.12.0",
+    "ts-node": "^10.9.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "module"
+}