tenzro-sdk 0.1.0

package/dist/provider.js

@@ -0,0 +1,368 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderClient = void 0;
+/**
+ * Client for provider operations including network participation,
+ * model serving, and hardware management.
+ */
+class ProviderClient {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * One-click network participation — provisions identity, wallet, and hardware profile
+     *
+     * @param password - Password to encrypt the wallet
+     * @returns Participation response with DID, address, and hardware profile
+     *
+     * @example
+     * ```typescript
+     * const result = await client.provider.participate("my-secure-password");
+     * console.log("DID:", result.did);
+     * console.log("Address:", result.address);
+     * ```
+     */
+    async participate(password) {
+        return await this.rpc.call("tenzro_participate", [password]);
+    }
+    /**
+     * Download a model from the registry
+     *
+     * @param modelId - ID of the model to download
+     * @returns Task ID for tracking download progress
+     *
+     * @example
+     * ```typescript
+     * const taskId = await client.provider.downloadModel("gemma4-9b");
+     * console.log("Download started:", taskId);
+     * ```
+     */
+    async downloadModel(modelId) {
+        return await this.rpc.call("tenzro_downloadModel", [modelId]);
+    }
+    /**
+     * Get download progress for a model
+     *
+     * @param modelId - ID of the model being downloaded
+     * @returns Download progress information
+     *
+     * @example
+     * ```typescript
+     * const progress = await client.provider.getDownloadProgress("gemma4-9b");
+     * console.log(`Progress: ${(progress.progress * 100).toFixed(1)}%`);
+     * ```
+     */
+    async getDownloadProgress(modelId) {
+        return await this.rpc.call("tenzro_getDownloadProgress", [modelId]);
+    }
+    /**
+     * Start serving a model on the network
+     *
+     * @param modelId - ID of the model to serve
+     *
+     * @example
+     * ```typescript
+     * await client.provider.serveModel("gemma4-9b");
+     * console.log("Now serving model");
+     * ```
+     */
+    async serveModel(modelId) {
+        await this.rpc.call("tenzro_serveModel", [modelId]);
+    }
+    /**
+     * Stop serving a model
+     *
+     * @param modelId - ID of the model to stop serving
+     *
+     * @example
+     * ```typescript
+     * await client.provider.stopModel("gemma4-9b");
+     * console.log("Stopped serving model");
+     * ```
+     */
+    async stopModel(modelId) {
+        await this.rpc.call("tenzro_stopModel", [modelId]);
+    }
+    /**
+     * Delete a downloaded model
+     *
+     * @param modelId - ID of the model to delete
+     *
+     * @example
+     * ```typescript
+     * await client.provider.deleteModel("gemma4-9b");
+     * console.log("Model deleted");
+     * ```
+     */
+    async deleteModel(modelId) {
+        await this.rpc.call("tenzro_deleteModel", [modelId]);
+    }
+    /**
+     * Chat with a loaded model
+     *
+     * @param modelId - ID of the model to use
+     * @param messages - Array of chat messages
+     * @returns Chat completion response
+     *
+     * @example
+     * ```typescript
+     * const messages = [
+     *   { role: "user", content: "What is Tenzro Network?" }
+     * ];
+     * const response = await client.provider.chat("gemma4-9b", messages);
+     * console.log("Response:", response.response);
+     * ```
+     */
+    async chat(modelId, messages) {
+        return await this.rpc.call("tenzro_chat", [modelId, messages]);
+    }
+    /**
+     * Get hardware profile of the node
+     *
+     * @returns Hardware profile with CPU, memory, GPU, and TEE support
+     *
+     * @example
+     * ```typescript
+     * const profile = await client.provider.getHardwareProfile();
+     * console.log("CPU:", profile.cpu);
+     * console.log("Memory:", profile.memory_gb, "GB");
+     * ```
+     */
+    async getHardwareProfile() {
+        return await this.rpc.call("tenzro_getHardwareProfile", []);
+    }
+    /**
+     * Set node role (validator, provider, light_client)
+     *
+     * @param role - Node role to set
+     *
+     * @example
+     * ```typescript
+     * await client.provider.setRole("provider");
+     * console.log("Role updated");
+     * ```
+     */
+    async setRole(role) {
+        await this.rpc.call("tenzro_setRole", [role]);
+    }
+    /**
+     * Register as a provider on the network
+     *
+     * Model/inference providers do not need to stake TNZO — staking is only
+     * required for validators. The `stakeAmount` parameter defaults to 0.
+     *
+     * @param models - List of model IDs to serve
+     * @param stakeAmount - Amount of TNZO to stake (default: 0, not required for model providers)
+     * @returns Transaction hash of the registration
+     *
+     * @example
+     * ```typescript
+     * // Register as a model provider — no staking required
+     * const models = ["gemma3-270m"];
+     * const txHash = await client.provider.register(models);
+     * console.log("Registration tx:", txHash);
+     * ```
+     */
+    async register(models, stakeAmount = 0) {
+        return await this.rpc.call("tenzro_registerProvider", [models, stakeAmount]);
+    }
+    /**
+     * Get provider statistics
+     *
+     * @returns Provider statistics with serving state and inference count
+     *
+     * @example
+     * ```typescript
+     * const stats = await client.provider.stats();
+     * console.log("Serving:", stats.is_serving);
+     * console.log("Total inferences:", stats.total_inferences);
+     * ```
+     */
+    async stats() {
+        return await this.rpc.call("tenzro_providerStats", []);
+    }
+    /**
+     * List all model service endpoints with load information
+     *
+     * @returns Array of model endpoints with load data
+     *
+     * @example
+     * ```typescript
+     * const endpoints = await client.provider.listModelEndpoints();
+     * for (const ep of endpoints) {
+     *   console.log(`${ep.model_name}: ${ep.status} (${ep.location})`);
+     *   if (ep.load) {
+     *     console.log(`  Load: ${ep.load.active_requests}/${ep.load.max_concurrent} (${ep.load.utilization_percent}%)`);
+     *   }
+     * }
+     * ```
+     */
+    async listModelEndpoints() {
+        return await this.rpc.call("tenzro_listModelEndpoints", []);
+    }
+    /**
+     * Get load information for a specific model
+     *
+     * @param modelId - ID of the model to check
+     * @returns Load info if the model is being served, undefined otherwise
+     *
+     * @example
+     * ```typescript
+     * const load = await client.provider.getModelLoad("gemma3-270m");
+     * if (load) {
+     *   console.log(`Load: ${load.active_requests}/${load.max_concurrent} (${load.utilization_percent}%)`);
+     * }
+     * ```
+     */
+    async getModelLoad(modelId) {
+        const endpoints = await this.listModelEndpoints();
+        const ep = endpoints.find(e => e.model_id === modelId || e.model_name === modelId);
+        return ep?.load;
+    }
+    /**
+     * List all providers discovered on the Tenzro Network.
+     *
+     * Queries the `tenzro_listProviders` JSON-RPC method which merges:
+     * - The local node's own provider info (if it is serving models)
+     * - All remote providers discovered via the `tenzro/providers/1.0.0`
+     *   gossipsub topic (announcements refreshed every 60 seconds)
+     *
+     * @param providerType - Optional filter by provider type (e.g. "llm", "tee", "general")
+     * @returns Array of discovered network providers
+     *
+     * @example
+     * ```typescript
+     * // List all providers
+     * const providers = await client.provider.listProviders();
+     * for (const p of providers) {
+     *   console.log(`${p.peer_id}: ${p.provider_type} — models: ${p.served_models.join(", ")}`);
+     * }
+     *
+     * // List only LLM providers
+     * const llmProviders = await client.provider.listProviders("llm");
+     * ```
+     */
+    async listProviders(providerType) {
+        const params = providerType ? [{ provider_type: providerType }] : [];
+        return await this.rpc.call("tenzro_listProviders", params);
+    }
+    /**
+     * Join the network as a micro node.
+     * @param displayName - Optional display name for the node
+     * @param participantType - Optional participant type
+     * @returns Micro node registration response
+     */
+    async joinAsMicroNode(displayName, participantType) {
+        return await this.rpc.call("tenzro_joinAsMicroNode", [
+            {
+                display_name: displayName,
+                participant_type: participantType,
+            },
+        ]);
+    }
+    /**
+     * Set the provider availability schedule.
+     * @param schedule - Schedule configuration
+     * @returns Updated schedule
+     */
+    async setProviderSchedule(schedule) {
+        return await this.rpc.call("tenzro_setProviderSchedule", [schedule]);
+    }
+    /**
+     * Get the current provider schedule.
+     * @returns Provider schedule configuration
+     */
+    async getProviderSchedule() {
+        return await this.rpc.call("tenzro_getProviderSchedule", []);
+    }
+    /**
+     * Set provider pricing configuration.
+     * @param pricing - Pricing configuration
+     * @returns Updated pricing
+     */
+    async setProviderPricing(pricing) {
+        return await this.rpc.call("tenzro_setProviderPricing", [pricing]);
+    }
+    /**
+     * Get the current provider pricing.
+     * @returns Provider pricing configuration
+     */
+    async getProviderPricing() {
+        return await this.rpc.call("tenzro_getProviderPricing", []);
+    }
+    /**
+     * Get a specific model endpoint.
+     * @param instanceId - The model endpoint instance ID
+     * @returns Model endpoint details
+     */
+    async getModelEndpoint(instanceId) {
+        return await this.rpc.call("tenzro_getModelEndpoint", [
+            { instance_id: instanceId },
+        ]);
+    }
+    /**
+     * Register a remote model endpoint.
+     * @param modelId - ID of the model
+     * @param apiEndpoint - API endpoint URL
+     * @param mcpEndpoint - Optional MCP endpoint URL
+     * @param modelName - Optional human-readable model name
+     * @param providerName - Optional provider name
+     * @returns Registration result
+     */
+    async registerModelEndpoint(modelId, apiEndpoint, mcpEndpoint, modelName, providerName) {
+        return await this.rpc.call("tenzro_registerModelEndpoint", [
+            {
+                model_id: modelId,
+                api_endpoint: apiEndpoint,
+                mcp_endpoint: mcpEndpoint,
+                model_name: modelName,
+                provider_name: providerName,
+            },
+        ]);
+    }
+    /**
+     * Unregister a model endpoint.
+     * @param instanceId - The model endpoint instance ID to remove
+     * @returns Unregistration result
+     */
+    async unregisterModelEndpoint(instanceId) {
+        return await this.rpc.call("tenzro_unregisterModelEndpoint", [
+            { instance_id: instanceId },
+        ]);
+    }
+    /**
+     * Add a resource to the node.
+     * @param resourceId - Resource identifier
+     * @param resourceType - Optional resource type
+     * @returns Resource registration result
+     */
+    async addResource(resourceId, resourceType) {
+        return await this.rpc.call("tenzro_addResource", [
+            { resource_id: resourceId, resource_type: resourceType },
+        ]);
+    }
+    /**
+     * Send a signed transaction.
+     * @param from - Sender address
+     * @param to - Recipient address
+     * @param amount - Amount to send
+     * @param asset - Optional asset identifier
+     * @returns Transaction hash
+     */
+    async sendTransaction(from, to, amount, asset) {
+        return await this.rpc.call("tenzro_sendTransaction", [
+            { from, to, amount, asset },
+        ]);
+    }
+    /**
+     * Submit a block to the network.
+     * @param block - Block data to submit
+     * @returns Submission result
+     */
+    async submitBlock(block) {
+        return await this.rpc.call("tenzro_submitBlock", [block]);
+    }
+}
+exports.ProviderClient = ProviderClient;
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/rpc.d.ts

@@ -0,0 +1,35 @@
+export interface RpcRequest {
+    jsonrpc: "2.0";
+    method: string;
+    params: unknown[];
+    id: number;
+}
+export interface RpcResponse<T = unknown> {
+    jsonrpc: "2.0";
+    result?: T;
+    error?: RpcError;
+    id: number;
+}
+export interface RpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export declare class RpcClient {
+    private endpoint;
+    private apiEndpoint;
+    private timeout;
+    private requestId;
+    constructor(endpoint: string, apiEndpoint?: string, timeout?: number);
+    call<T>(method: string, params?: unknown[]): Promise<T>;
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    getEndpoint(): string;
+    getApiEndpoint(): string;
+}
+export declare class RpcCallError extends Error {
+    code: number;
+    data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAa;gBAElB,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc;IAiBrE,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAqC3D,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IA0BhC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IA2BtD,WAAW,IAAI,MAAM;IAIrB,cAAc,IAAI,MAAM;CAGzB;AAED,qBAAa,YAAa,SAAQ,KAAK;IAClB,IAAI,EAAE,MAAM;IAA0B,IAAI,CAAC;gBAA3C,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAS,IAAI,CAAC,SAAS;CAIxE"}

package/dist/rpc.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcCallError = exports.RpcClient = void 0;
+class RpcClient {
+    endpoint;
+    apiEndpoint;
+    timeout;
+    requestId = 0;
+    constructor(endpoint, apiEndpoint, timeout = 30000) {
+        this.endpoint = endpoint;
+        this.timeout = timeout;
+        // Derive API endpoint from RPC endpoint if not provided
+        if (apiEndpoint) {
+            this.apiEndpoint = apiEndpoint;
+        }
+        else if (endpoint.includes("rpc.tenzro.network")) {
+            this.apiEndpoint = endpoint.replace("rpc.tenzro.network", "api.tenzro.network");
+        }
+        else if (endpoint.includes("localhost:8545") || endpoint.includes("127.0.0.1:8545")) {
+            this.apiEndpoint = endpoint.replace("8545", "8080");
+        }
+        else {
+            // Default: assume API endpoint is the same as RPC endpoint
+            this.apiEndpoint = endpoint;
+        }
+    }
+    async call(method, params = []) {
+        // Use modular arithmetic to prevent overflow beyond Number.MAX_SAFE_INTEGER
+        this.requestId = (this.requestId + 1) % Number.MAX_SAFE_INTEGER;
+        const id = this.requestId;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(this.endpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ jsonrpc: "2.0", method, params, id }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`RPC HTTP error: ${response.status} ${response.statusText}`);
+            }
+            const json = (await response.json());
+            if (json.error) {
+                throw new RpcCallError(json.error.code, json.error.message, json.error.data);
+            }
+            return json.result;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new Error(`RPC request timed out after ${this.timeout}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async get(path) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(`${this.apiEndpoint}${path}`, {
+                method: "GET",
+                headers: { Accept: "application/json" },
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new Error(`Request timed out after ${this.timeout}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async post(path, body) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(`${this.apiEndpoint}${path}`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", Accept: "application/json" },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new Error(`Request timed out after ${this.timeout}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    getEndpoint() {
+        return this.endpoint;
+    }
+    getApiEndpoint() {
+        return this.apiEndpoint;
+    }
+}
+exports.RpcClient = RpcClient;
+class RpcCallError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(`RPC Error ${code}: ${message}`);
+        this.code = code;
+        this.data = data;
+        this.name = "RpcCallError";
+    }
+}
+exports.RpcCallError = RpcCallError;
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

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

package/dist/settlement.d.ts

@@ -0,0 +1,52 @@
+import { RpcClient } from "./rpc";
+import { SettlementParams, SettlementReceipt } from "./types";
+/**
+ * Client for payment settlement operations.
+ * Supports immediate settlement, escrow, and micropayment channels.
+ */
+export declare class SettlementClient {
+    private rpc;
+    constructor(rpc: RpcClient);
+    /**
+     * Settle a payment for AI inference or other services.
+     * @param request - Settlement request parameters
+     * @returns Settlement receipt with transaction details
+     */
+    settle(request: SettlementParams): Promise<SettlementReceipt>;
+    /**
+     * Get the status of a settlement by receipt ID.
+     * @param receiptId - The settlement receipt identifier
+     * @returns Settlement receipt or null if not found
+     */
+    getSettlement(receiptId: string): Promise<SettlementReceipt | null>;
+    /**
+     * Create an escrow that releases payment when conditions are met.
+     * @param payee - Address receiving the payment
+     * @param amount - Amount to escrow (in smallest unit)
+     * @param asset - Asset identifier (e.g., "TNZO")
+     * @param conditions - JSON-encoded release conditions
+     * @returns Escrow ID
+     */
+    createEscrow(payee: string, amount: bigint, asset: string, conditions: string): Promise<string>;
+    /**
+     * Release funds from an escrow.
+     * @param escrowId - The escrow identifier
+     * @param proof - Optional proof that conditions are met
+     * @returns Transaction hash
+     */
+    releaseEscrow(escrowId: string, proof?: string): Promise<string>;
+    /**
+     * Open a micropayment channel for streaming payments.
+     * @param payee - Address receiving payments
+     * @param deposit - Initial deposit amount
+     * @returns Channel ID
+     */
+    openPaymentChannel(payee: string, deposit: bigint): Promise<string>;
+    /**
+     * Close a micropayment channel.
+     * @param channelId - The channel identifier to close
+     * @returns Channel closure result
+     */
+    closePaymentChannel(channelId: string): Promise<any>;
+}
+//# sourceMappingURL=settlement.d.ts.map

package/dist/settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.d.ts","sourceRoot":"","sources":["../src/settlement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE9D;;;GAGG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAElC;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAInE;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAMzE;;;;;;;OAOG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IAWlB;;;;;OAKG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMtE;;;;;OAKG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASzE;;;;OAIG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAK3D"}