tenzro-sdk 0.1.0

package/dist/provider.d.ts

@@ -0,0 +1,351 @@
+import { RpcClient } from "./rpc";
+import { ModelLoadInfo, ModelEndpoint } from "./types";
+export interface ParticipateResponse {
+    did: string;
+    address: string;
+    hardware_profile: Record<string, unknown>;
+}
+export interface ProviderStats {
+    is_serving: boolean;
+    models_served: string[];
+    total_inferences: number;
+}
+export interface ChatMessage {
+    role: string;
+    content: string;
+}
+export interface ChatResponse {
+    response: string;
+    model_id: string;
+    tokens_used: number;
+}
+export interface DownloadProgress {
+    model_id: string;
+    status: string;
+    progress: number;
+    bytes_downloaded: number;
+    total_bytes: number;
+}
+export interface HardwareProfile {
+    cpu: string;
+    memory_gb: number;
+    gpu?: string;
+    tee_support: string[];
+}
+/**
+ * A provider discovered on the Tenzro Network via gossipsub announcements.
+ *
+ * Providers broadcast a `ProviderAnnouncement` every 60 seconds on the
+ * `tenzro/providers/1.0.0` gossipsub topic. All peers merge incoming
+ * announcements into their `network_providers` cache so any node can
+ * discover every provider without a central registry.
+ *
+ * Use {@link ProviderClient.listProviders} to discover providers via
+ * the `tenzro_listProviders` JSON-RPC method.
+ */
+export interface NetworkProvider {
+    /** libp2p peer ID of the announcing node */
+    peer_id: string;
+    /** Wallet/account address of the provider */
+    provider_address: string;
+    /** Provider type (e.g. "llm", "tee", "general") */
+    provider_type: string;
+    /** Model IDs currently being served by this node */
+    served_models: string[];
+    /** Capability labels (e.g. "inference", "tee-attestation") */
+    capabilities: string[];
+    /** HTTP RPC endpoint for direct inference routing (e.g. "http://10.128.0.5:8545") */
+    rpc_endpoint: string;
+    /** Lifecycle status (e.g. "active", "draining") */
+    status: string;
+    /** Whether this is the local node */
+    is_local: boolean;
+}
+/**
+ * Client for provider operations including network participation,
+ * model serving, and hardware management.
+ */
+export declare class ProviderClient {
+    private rpc;
+    constructor(rpc: RpcClient);
+    /**
+     * 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);
+     * ```
+     */
+    participate(password: string): Promise<ParticipateResponse>;
+    /**
+     * 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);
+     * ```
+     */
+    downloadModel(modelId: string): Promise<string>;
+    /**
+     * 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)}%`);
+     * ```
+     */
+    getDownloadProgress(modelId: string): Promise<DownloadProgress>;
+    /**
+     * 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");
+     * ```
+     */
+    serveModel(modelId: string): Promise<void>;
+    /**
+     * 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");
+     * ```
+     */
+    stopModel(modelId: string): Promise<void>;
+    /**
+     * Delete a downloaded model
+     *
+     * @param modelId - ID of the model to delete
+     *
+     * @example
+     * ```typescript
+     * await client.provider.deleteModel("gemma4-9b");
+     * console.log("Model deleted");
+     * ```
+     */
+    deleteModel(modelId: string): Promise<void>;
+    /**
+     * 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);
+     * ```
+     */
+    chat(modelId: string, messages: ChatMessage[]): Promise<ChatResponse>;
+    /**
+     * 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");
+     * ```
+     */
+    getHardwareProfile(): Promise<HardwareProfile>;
+    /**
+     * Set node role (validator, provider, light_client)
+     *
+     * @param role - Node role to set
+     *
+     * @example
+     * ```typescript
+     * await client.provider.setRole("provider");
+     * console.log("Role updated");
+     * ```
+     */
+    setRole(role: string): Promise<void>;
+    /**
+     * 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);
+     * ```
+     */
+    register(models: string[], stakeAmount?: number): Promise<string>;
+    /**
+     * 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);
+     * ```
+     */
+    stats(): Promise<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}%)`);
+     *   }
+     * }
+     * ```
+     */
+    listModelEndpoints(): Promise<ModelEndpoint[]>;
+    /**
+     * 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}%)`);
+     * }
+     * ```
+     */
+    getModelLoad(modelId: string): Promise<ModelLoadInfo | undefined>;
+    /**
+     * 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");
+     * ```
+     */
+    listProviders(providerType?: string): Promise<NetworkProvider[]>;
+    /**
+     * 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
+     */
+    joinAsMicroNode(displayName?: string, participantType?: string): Promise<any>;
+    /**
+     * Set the provider availability schedule.
+     * @param schedule - Schedule configuration
+     * @returns Updated schedule
+     */
+    setProviderSchedule(schedule: any): Promise<any>;
+    /**
+     * Get the current provider schedule.
+     * @returns Provider schedule configuration
+     */
+    getProviderSchedule(): Promise<any>;
+    /**
+     * Set provider pricing configuration.
+     * @param pricing - Pricing configuration
+     * @returns Updated pricing
+     */
+    setProviderPricing(pricing: any): Promise<any>;
+    /**
+     * Get the current provider pricing.
+     * @returns Provider pricing configuration
+     */
+    getProviderPricing(): Promise<any>;
+    /**
+     * Get a specific model endpoint.
+     * @param instanceId - The model endpoint instance ID
+     * @returns Model endpoint details
+     */
+    getModelEndpoint(instanceId: string): Promise<any>;
+    /**
+     * 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
+     */
+    registerModelEndpoint(modelId: string, apiEndpoint: string, mcpEndpoint?: string, modelName?: string, providerName?: string): Promise<any>;
+    /**
+     * Unregister a model endpoint.
+     * @param instanceId - The model endpoint instance ID to remove
+     * @returns Unregistration result
+     */
+    unregisterModelEndpoint(instanceId: string): Promise<any>;
+    /**
+     * Add a resource to the node.
+     * @param resourceId - Resource identifier
+     * @param resourceType - Optional resource type
+     * @returns Resource registration result
+     */
+    addResource(resourceId: string, resourceType?: string): Promise<any>;
+    /**
+     * 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
+     */
+    sendTransaction(from: string, to: string, amount: string, asset?: string): Promise<string>;
+    /**
+     * Submit a block to the network.
+     * @param block - Block data to submit
+     * @returns Submission result
+     */
+    submitBlock(block: any): Promise<any>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

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