@singularity-layer/grid 0.1.0 → 0.3.0

package/README.md

@@ -32,7 +32,7 @@ import OpenAI from "openai";
 
 const client = new OpenAI({
   baseURL:
-    "https://sgl-network-orchestrator.ivaavimusicproductions.workers.dev/v1",
+    "https://grid.x402compute.cc/v1",
   apiKey: "sgl-anonymous",
 });
 

package/dist/index.d.mts

@@ -97,9 +97,115 @@ interface ChatCompletionResponse {
         completion_tokens: number;
         total_tokens: number;
     };
+    /** Confidential-compute attestation of the serving node (E2E path). */
+    attestation?: Attestation;
+}
+/** Confidential-compute attestation of the node that served the request. */
+interface Attestation {
+    nodeId: string;
+    teeType: string | null;
+    verified: boolean;
+}
+/** Response from POST /v1/reserve — the node + the X25519 key to seal the prompt to. */
+interface ReserveResponse {
+    reservation_token: string;
+    node_id: string;
+    node_x25519_pubkey: string;
+    node_ed25519_pubkey: string | null;
+    tee_type?: string | null;
+    attestation_verified?: boolean;
+    expires_in_ms: number;
+}
+interface DeployProcessorOptions {
+    name: string;
+    code: string;
+    runtime?: "deno" | "wasm";
+    memory_mb?: number;
+    timeout_seconds?: number;
+    tee_type_required?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ProcessorInfo {
+    id: string;
+    name: string;
+    owner_wallet: string;
+    owner_chain: string;
+    runtime: string;
+    memory_mb: number;
+    timeout_seconds: number;
+    tee_type_required?: string;
+    invocation_count: number;
+    last_invoked_at?: string;
+    status: string;
+    code_hash?: string;
+    deployment_stake_sgl: number;
+    invoke_url: string;
+    created_at: string;
+    updated_at?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ProcessorDeployResult {
+    id: string;
+    name: string;
+    runtime: string;
+    memory_mb: number;
+    timeout_seconds: number;
+    status: string;
+    code_hash: string;
+    invoke_url: string;
+    tier: string;
+    sgl_staked: number;
+    created_at: string;
+}
+interface ProcessorInvokeResult {
+    job_id: string;
+    processor: string;
+    status: string;
+    output?: unknown;
+    duration_ms?: number;
+    payment?: {
+        amount_usd: string;
+        token: string;
+        discount_pct: number;
+    };
+    tee?: {
+        node_id: string;
+        tee_type: string;
+        attestation_verified: boolean;
+    };
+    message?: string;
+}
+interface ProcessorListResponse {
+    processors: ProcessorInfo[];
+    total: number;
+    page: number;
+    limit: number;
+}
+interface ProcessorLogEntry {
+    id: string;
+    processor_id: string;
+    job_id: string;
+    node_id: string;
+    duration_ms?: number;
+    status: string;
+    error_message?: string;
+    created_at: string;
+}
+interface ProcessorLogsResponse {
+    logs: ProcessorLogEntry[];
+    total: number;
+    page: number;
+    limit: number;
+}
+interface WalletAuth {
+    address: string;
+    chain?: string;
+    signature: string;
+    timestamp: string;
+    nonce: string;
 }
 
-declare const DEFAULT_BASE_URL = "https://sgl-network-orchestrator.ivaavimusicproductions.workers.dev";
+declare const DEFAULT_BASE_URL = "https://grid.x402compute.cc";
 declare class GridClient {
     private readonly baseUrl;
     private readonly headers;
@@ -115,7 +221,43 @@ declare class GridClient {
     }): Promise<JobResponse>;
     getJob(jobId: string): Promise<JobResult>;
     getAttestation(jobId: string): Promise<AttestationProof>;
+    /** Reserve a node + learn its X25519 key so we can seal the prompt to it. */
+    private reserve;
+    /**
+     * End-to-end encrypted chat completion. The prompt is sealed in this client to
+     * the serving node's key and only decrypts inside its TEE — the orchestrator
+     * only relays ciphertext. Requires an `apiKey` (credits); without one the grid
+     * replies 402 (the SDK does not sign x402 payments — use the wallet/browser flow).
+     */
     chatCompletions(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    /**
+     * Streaming end-to-end encrypted chat completion. Yields decoded text as it
+     * arrives; each chunk is decrypted and its ordering + termination verified (a
+     * truncated stream throws). Requires `apiKey` (credits). If the server isn't
+     * streaming (toggle off), the whole reply is yielded as a single chunk.
+     */
+    chatCompletionStream(request: ChatCompletionRequest): AsyncGenerator<string, void, unknown>;
+    private requestWithWalletAuth;
+    private requestWithPayment;
+    deployProcessor(wallet: WalletAuth, options: DeployProcessorOptions): Promise<ProcessorDeployResult>;
+    invokeProcessor(processorName: string, input: Record<string, unknown>, options?: {
+        paymentHeader?: string;
+        paymentToken?: "USDC" | "SGL";
+    }): Promise<ProcessorInvokeResult>;
+    listProcessors(options?: {
+        owner?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<ProcessorListResponse>;
+    getProcessor(processorId: string): Promise<ProcessorInfo>;
+    deleteProcessor(processorId: string, wallet: WalletAuth): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
+    getProcessorLogs(processorId: string, wallet: WalletAuth, options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ProcessorLogsResponse>;
 }
 
 declare class SGLError extends Error {
@@ -136,4 +278,4 @@ declare class SGLConnectionError extends SGLError {
     constructor(message: string);
 }
 
-export { type AttestationProof, type CapacityResponse, type ChatChoice, type ChatCompletionRequest, type ChatCompletionResponse, type ChatMessage, DEFAULT_BASE_URL, GridClient, type GridClientOptions, type JobResponse, type JobResult, type JobSubmission, type ModelInfo, type ModelPricing, type PricingInfo, SGLAPIError, SGLAuthError, SGLConnectionError, SGLError, SGLNotFoundError, type TeeCapacity };
+export { type Attestation, type AttestationProof, type CapacityResponse, type ChatChoice, type ChatCompletionRequest, type ChatCompletionResponse, type ChatMessage, DEFAULT_BASE_URL, type DeployProcessorOptions, GridClient, type GridClientOptions, type JobResponse, type JobResult, type JobSubmission, type ModelInfo, type ModelPricing, type PricingInfo, type ProcessorDeployResult, type ProcessorInfo, type ProcessorInvokeResult, type ProcessorListResponse, type ProcessorLogEntry, type ProcessorLogsResponse, type ReserveResponse, SGLAPIError, SGLAuthError, SGLConnectionError, SGLError, SGLNotFoundError, type TeeCapacity, type WalletAuth };

package/dist/index.d.ts

@@ -97,9 +97,115 @@ interface ChatCompletionResponse {
         completion_tokens: number;
         total_tokens: number;
     };
+    /** Confidential-compute attestation of the serving node (E2E path). */
+    attestation?: Attestation;
+}
+/** Confidential-compute attestation of the node that served the request. */
+interface Attestation {
+    nodeId: string;
+    teeType: string | null;
+    verified: boolean;
+}
+/** Response from POST /v1/reserve — the node + the X25519 key to seal the prompt to. */
+interface ReserveResponse {
+    reservation_token: string;
+    node_id: string;
+    node_x25519_pubkey: string;
+    node_ed25519_pubkey: string | null;
+    tee_type?: string | null;
+    attestation_verified?: boolean;
+    expires_in_ms: number;
+}
+interface DeployProcessorOptions {
+    name: string;
+    code: string;
+    runtime?: "deno" | "wasm";
+    memory_mb?: number;
+    timeout_seconds?: number;
+    tee_type_required?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ProcessorInfo {
+    id: string;
+    name: string;
+    owner_wallet: string;
+    owner_chain: string;
+    runtime: string;
+    memory_mb: number;
+    timeout_seconds: number;
+    tee_type_required?: string;
+    invocation_count: number;
+    last_invoked_at?: string;
+    status: string;
+    code_hash?: string;
+    deployment_stake_sgl: number;
+    invoke_url: string;
+    created_at: string;
+    updated_at?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ProcessorDeployResult {
+    id: string;
+    name: string;
+    runtime: string;
+    memory_mb: number;
+    timeout_seconds: number;
+    status: string;
+    code_hash: string;
+    invoke_url: string;
+    tier: string;
+    sgl_staked: number;
+    created_at: string;
+}
+interface ProcessorInvokeResult {
+    job_id: string;
+    processor: string;
+    status: string;
+    output?: unknown;
+    duration_ms?: number;
+    payment?: {
+        amount_usd: string;
+        token: string;
+        discount_pct: number;
+    };
+    tee?: {
+        node_id: string;
+        tee_type: string;
+        attestation_verified: boolean;
+    };
+    message?: string;
+}
+interface ProcessorListResponse {
+    processors: ProcessorInfo[];
+    total: number;
+    page: number;
+    limit: number;
+}
+interface ProcessorLogEntry {
+    id: string;
+    processor_id: string;
+    job_id: string;
+    node_id: string;
+    duration_ms?: number;
+    status: string;
+    error_message?: string;
+    created_at: string;
+}
+interface ProcessorLogsResponse {
+    logs: ProcessorLogEntry[];
+    total: number;
+    page: number;
+    limit: number;
+}
+interface WalletAuth {
+    address: string;
+    chain?: string;
+    signature: string;
+    timestamp: string;
+    nonce: string;
 }
 
-declare const DEFAULT_BASE_URL = "https://sgl-network-orchestrator.ivaavimusicproductions.workers.dev";
+declare const DEFAULT_BASE_URL = "https://grid.x402compute.cc";
 declare class GridClient {
     private readonly baseUrl;
     private readonly headers;
@@ -115,7 +221,43 @@ declare class GridClient {
     }): Promise<JobResponse>;
     getJob(jobId: string): Promise<JobResult>;
     getAttestation(jobId: string): Promise<AttestationProof>;
+    /** Reserve a node + learn its X25519 key so we can seal the prompt to it. */
+    private reserve;
+    /**
+     * End-to-end encrypted chat completion. The prompt is sealed in this client to
+     * the serving node's key and only decrypts inside its TEE — the orchestrator
+     * only relays ciphertext. Requires an `apiKey` (credits); without one the grid
+     * replies 402 (the SDK does not sign x402 payments — use the wallet/browser flow).
+     */
     chatCompletions(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    /**
+     * Streaming end-to-end encrypted chat completion. Yields decoded text as it
+     * arrives; each chunk is decrypted and its ordering + termination verified (a
+     * truncated stream throws). Requires `apiKey` (credits). If the server isn't
+     * streaming (toggle off), the whole reply is yielded as a single chunk.
+     */
+    chatCompletionStream(request: ChatCompletionRequest): AsyncGenerator<string, void, unknown>;
+    private requestWithWalletAuth;
+    private requestWithPayment;
+    deployProcessor(wallet: WalletAuth, options: DeployProcessorOptions): Promise<ProcessorDeployResult>;
+    invokeProcessor(processorName: string, input: Record<string, unknown>, options?: {
+        paymentHeader?: string;
+        paymentToken?: "USDC" | "SGL";
+    }): Promise<ProcessorInvokeResult>;
+    listProcessors(options?: {
+        owner?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<ProcessorListResponse>;
+    getProcessor(processorId: string): Promise<ProcessorInfo>;
+    deleteProcessor(processorId: string, wallet: WalletAuth): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
+    getProcessorLogs(processorId: string, wallet: WalletAuth, options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ProcessorLogsResponse>;
 }
 
 declare class SGLError extends Error {
@@ -136,4 +278,4 @@ declare class SGLConnectionError extends SGLError {
     constructor(message: string);
 }
 
-export { type AttestationProof, type CapacityResponse, type ChatChoice, type ChatCompletionRequest, type ChatCompletionResponse, type ChatMessage, DEFAULT_BASE_URL, GridClient, type GridClientOptions, type JobResponse, type JobResult, type JobSubmission, type ModelInfo, type ModelPricing, type PricingInfo, SGLAPIError, SGLAuthError, SGLConnectionError, SGLError, SGLNotFoundError, type TeeCapacity };
+export { type Attestation, type AttestationProof, type CapacityResponse, type ChatChoice, type ChatCompletionRequest, type ChatCompletionResponse, type ChatMessage, DEFAULT_BASE_URL, type DeployProcessorOptions, GridClient, type GridClientOptions, type JobResponse, type JobResult, type JobSubmission, type ModelInfo, type ModelPricing, type PricingInfo, type ProcessorDeployResult, type ProcessorInfo, type ProcessorInvokeResult, type ProcessorListResponse, type ProcessorLogEntry, type ProcessorLogsResponse, type ReserveResponse, SGLAPIError, SGLAuthError, SGLConnectionError, SGLError, SGLNotFoundError, type TeeCapacity, type WalletAuth };