singularity-grid 0.1.0__tar.gz → 0.2.0__tar.gz

{singularity_grid-0.1.0 → singularity_grid-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: singularity-grid
-Version: 0.1.0
+Version: 0.2.0
 Summary: Python SDK for the SGL Network confidential compute grid
 Project-URL: Homepage, https://singularitylayer.xyz
 Project-URL: Repository, https://github.com/SingularityLayer/sgl-network-sdk

{singularity_grid-0.1.0 → singularity_grid-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "singularity-grid"
-version = "0.1.0"
+version = "0.2.0"
 description = "Python SDK for the SGL Network confidential compute grid"
 readme = "README.md"
 license = "MIT"

{singularity_grid-0.1.0 → singularity_grid-0.2.0}/singularity_grid/__init__.py

@@ -19,11 +19,19 @@ from .models import (
     ModelsResponse,
     PricingInfo,
     PricingResponse,
+    ProcessorDeployResult,
+    ProcessorInfo,
+    ProcessorListResponse,
+    ProcessorLogEntry,
+    ProcessorLogsResponse,
+    ProcessorPayment,
+    ProcessorResult,
+    ProcessorTeeInfo,
     TeeCapacity,
 )
 from .openai_compat import create_openai_client
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 
 __all__ = [
     # Client
@@ -36,7 +44,7 @@ __all__ = [
     "SGLAuthError",
     "SGLConnectionError",
     "SGLNotFoundError",
-    # Models
+    # Models — Grid
     "AttestationProof",
     "CapacityResponse",
     "JobResponse",
@@ -47,4 +55,13 @@ __all__ = [
     "PricingInfo",
     "PricingResponse",
     "TeeCapacity",
+    # Models — Processors
+    "ProcessorDeployResult",
+    "ProcessorInfo",
+    "ProcessorListResponse",
+    "ProcessorLogEntry",
+    "ProcessorLogsResponse",
+    "ProcessorPayment",
+    "ProcessorResult",
+    "ProcessorTeeInfo",
 ]

{singularity_grid-0.1.0 → singularity_grid-0.2.0}/singularity_grid/client.py

@@ -15,6 +15,12 @@ from .models import (
     ModelsResponse,
     PricingInfo,
     PricingResponse,
+    ProcessorDeployResult,
+    ProcessorInfo,
+    ProcessorListResponse,
+    ProcessorLogEntry,
+    ProcessorLogsResponse,
+    ProcessorResult,
 )
 
 DEFAULT_BASE_URL = (
@@ -200,6 +206,151 @@ class GridClient:
         data = self._request("GET", f"/grid/jobs/{job_id}/attestation")
         return AttestationProof.model_validate(data)
 
+    # -- processor endpoints -----------------------------------------------
+
+    def deploy_processor(
+        self,
+        name: str,
+        code: str,
+        *,
+        wallet_address: str,
+        chain: str = "solana",
+        runtime: str = "deno",
+        memory_mb: int = 128,
+        timeout_seconds: int = 30,
+        metadata: Optional[Dict[str, Any]] = None,
+    ) -> ProcessorDeployResult:
+        """Deploy a serverless processor to the TEE grid.
+
+        Requires $SGL staking for higher tier limits.
+
+        Parameters
+        ----------
+        name:
+            Processor name (lowercase alphanumeric + hyphens, 2-64 chars).
+        code:
+            JavaScript/TypeScript source code with a default export function.
+        wallet_address:
+            Owner wallet address (must have $SGL staked for higher tiers).
+        chain:
+            Chain the wallet is on (default ``"solana"``).
+        runtime:
+            Execution runtime (``"deno"`` or ``"wasm"``).
+        memory_mb:
+            Memory allocation in MB (64, 128, 256, 512, 1024).
+        timeout_seconds:
+            Max execution time (1-300s, tier-dependent).
+        metadata:
+            Optional metadata dict attached to the processor.
+        """
+        body: Dict[str, Any] = {
+            "name": name,
+            "code": code,
+            "runtime": runtime,
+            "memory_mb": memory_mb,
+            "timeout_seconds": timeout_seconds,
+        }
+        if metadata:
+            body["metadata"] = metadata
+
+        # Set wallet auth headers
+        self._client.headers["X-Auth-Address"] = wallet_address
+        self._client.headers["X-Auth-Chain"] = chain
+        try:
+            data = self._request("POST", "/grid/processors", json=body)
+        finally:
+            self._client.headers.pop("X-Auth-Address", None)
+            self._client.headers.pop("X-Auth-Chain", None)
+
+        return ProcessorDeployResult.model_validate(data)
+
+    def invoke_processor(
+        self,
+        name: str,
+        input_data: Dict[str, Any],
+        *,
+        payment_header: str,
+        payment_token: str = "USDC",
+    ) -> ProcessorResult:
+        """Invoke a deployed processor with x402 payment.
+
+        Parameters
+        ----------
+        name:
+            Processor name.
+        input_data:
+            Input object passed to the handler function.
+        payment_header:
+            x402 payment header (JSON-encoded).
+        payment_token:
+            Payment token type (``"USDC"`` or ``"SGL"``).
+        """
+        body: Dict[str, Any] = {
+            "input": input_data,
+            "payment_token": payment_token,
+        }
+
+        self._client.headers["X-Payment"] = payment_header
+        try:
+            data = self._request(
+                "POST", f"/grid/processors/{name}/invoke", json=body,
+            )
+        finally:
+            self._client.headers.pop("X-Payment", None)
+
+        return ProcessorResult.model_validate(data)
+
+    def list_processors(
+        self,
+        *,
+        owner: Optional[str] = None,
+        page: int = 0,
+        limit: int = 50,
+    ) -> ProcessorListResponse:
+        """List deployed processors."""
+        params: Dict[str, Any] = {"page": page, "limit": limit}
+        if owner:
+            params["owner"] = owner
+        data = self._request("GET", "/grid/processors", params=params)
+        return ProcessorListResponse.model_validate(data)
+
+    def get_processor(self, processor_id: str) -> ProcessorInfo:
+        """Get details for a specific processor."""
+        data = self._request("GET", f"/grid/processors/{processor_id}")
+        return ProcessorInfo.model_validate(data)
+
+    def delete_processor(
+        self,
+        processor_id: str,
+        *,
+        wallet_address: str,
+    ) -> Dict[str, Any]:
+        """Delete a processor (must be the owner)."""
+        self._client.headers["X-Auth-Address"] = wallet_address
+        try:
+            data = self._request(
+                "DELETE", f"/grid/processors/{processor_id}",
+            )
+        finally:
+            self._client.headers.pop("X-Auth-Address", None)
+        return data
+
+    def get_processor_logs(
+        self,
+        processor_id: str,
+        *,
+        page: int = 0,
+        limit: int = 50,
+    ) -> ProcessorLogsResponse:
+        """Get invocation logs for a processor."""
+        params: Dict[str, Any] = {"page": page, "limit": limit}
+        data = self._request(
+            "GET",
+            f"/grid/processors/{processor_id}/logs",
+            params=params,
+        )
+        return ProcessorLogsResponse.model_validate(data)
+
     # -- lifecycle ----------------------------------------------------------
 
     def close(self) -> None:

{singularity_grid-0.1.0 → singularity_grid-0.2.0}/singularity_grid/models.py

@@ -108,3 +108,93 @@ class JobResult(BaseModel):
     created_at: Optional[str] = None
     completed_at: Optional[str] = None
     error: Optional[str] = None
+
+
+# ---------------------------------------------------------------------------
+# Processors
+# ---------------------------------------------------------------------------
+
+class ProcessorInfo(BaseModel):
+    """Processor descriptor returned by list/get endpoints."""
+    id: str
+    name: str
+    owner_wallet: str = ""
+    owner_chain: str = "solana"
+    runtime: str = "deno"
+    memory_mb: int = 128
+    timeout_seconds: int = 30
+    invocation_count: int = 0
+    last_invoked_at: Optional[str] = None
+    status: str = "active"
+    deployment_stake_sgl: float = 0.0
+    invoke_url: Optional[str] = None
+    created_at: Optional[str] = None
+    metadata: Dict[str, Any] = Field(default_factory=dict)
+
+
+class ProcessorDeployResult(BaseModel):
+    """Response from deploying a processor."""
+    id: str
+    name: str
+    runtime: str = "deno"
+    memory_mb: int = 128
+    timeout_seconds: int = 30
+    status: str = "active"
+    code_hash: str = ""
+    invoke_url: str = ""
+    tier: str = "free"
+    sgl_staked: float = 0.0
+    created_at: Optional[str] = None
+
+
+class ProcessorPayment(BaseModel):
+    """Payment details from a processor invocation."""
+    amount_usd: str = "0"
+    token: str = "USDC"
+    discount_pct: float = 0.0
+
+
+class ProcessorTeeInfo(BaseModel):
+    """TEE details from a processor invocation."""
+    node_id: str = ""
+    tee_type: str = ""
+    attestation_verified: bool = False
+
+
+class ProcessorResult(BaseModel):
+    """Response from invoking a processor."""
+    job_id: str
+    processor: str = ""
+    status: str = "pending"
+    output: Optional[Any] = None
+    duration_ms: Optional[int] = None
+    payment: Optional[ProcessorPayment] = None
+    tee: Optional[ProcessorTeeInfo] = None
+
+
+class ProcessorListResponse(BaseModel):
+    """Paginated processor listing."""
+    processors: List[ProcessorInfo] = Field(default_factory=list)
+    total: int = 0
+    page: int = 0
+    limit: int = 50
+
+
+class ProcessorLogEntry(BaseModel):
+    """Single invocation log entry."""
+    id: str = ""
+    processor_id: str = ""
+    job_id: str = ""
+    node_id: Optional[str] = None
+    duration_ms: Optional[int] = None
+    status: str = ""
+    error_message: Optional[str] = None
+    created_at: Optional[str] = None
+
+
+class ProcessorLogsResponse(BaseModel):
+    """Paginated processor logs."""
+    logs: List[ProcessorLogEntry] = Field(default_factory=list)
+    total: int = 0
+    page: int = 0
+    limit: int = 50