blockintql-sdk 0.1.0__tar.gz

blockintql_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: blockintql-sdk
+Version: 0.1.0
+Summary: Python SDK for BlockINTQL Ethereum and stablecoin intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27.0
+
+# BlockINTQL Python SDK
+
+Minimal Python client for:
+
+- capability discovery
+- investigation planning
+- workspace lifecycle
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Example
+
+```python
+from blockintql_sdk import BlockINTQL
+
+client = BlockINTQL()
+
+capabilities = client.capabilities()
+plan = client.plan(
+    goal="Investigate this wallet's stablecoin counterparties and bridge activity",
+    address="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
+    budget_credits=12,
+)
+
+workspace = client.create_workspace(
+    name="stablecoin-investigation",
+    modules=["verdict", "stablecoins", "bridge-activity", "chart"],
+)
+```

blockintql_sdk-0.1.0/README.md

@@ -0,0 +1,33 @@
+# BlockINTQL Python SDK
+
+Minimal Python client for:
+
+- capability discovery
+- investigation planning
+- workspace lifecycle
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Example
+
+```python
+from blockintql_sdk import BlockINTQL
+
+client = BlockINTQL()
+
+capabilities = client.capabilities()
+plan = client.plan(
+    goal="Investigate this wallet's stablecoin counterparties and bridge activity",
+    address="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
+    budget_credits=12,
+)
+
+workspace = client.create_workspace(
+    name="stablecoin-investigation",
+    modules=["verdict", "stablecoins", "bridge-activity", "chart"],
+)
+```

blockintql_sdk-0.1.0/blockintql_sdk/__init__.py

@@ -0,0 +1,3 @@
+from .client import BlockINTQL
+
+__all__ = ["BlockINTQL"]

blockintql_sdk-0.1.0/blockintql_sdk/client.py

@@ -0,0 +1,79 @@
+import os
+from typing import Any, Dict, List, Optional
+
+import httpx
+
+
+class BlockINTQL:
+    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None, timeout: float = 30.0):
+        self.api_key = api_key or os.environ.get("BLOCKINTQL_API_KEY")
+        self.base_url = (base_url or os.environ.get("BLOCKINTQL_API_URL") or "https://blockintql.com").rstrip("/")
+        self.timeout = timeout
+
+    def _headers(self, require_auth: bool = True) -> Dict[str, str]:
+        headers = {"Content-Type": "application/json"}
+        if require_auth:
+            if not self.api_key:
+                raise ValueError("API key required for this call")
+            headers["Authorization"] = f"Bearer {self.api_key}"
+        return headers
+
+    def _get(self, path: str, *, params: Optional[Dict[str, Any]] = None, require_auth: bool = True) -> Dict[str, Any]:
+        response = httpx.get(f"{self.base_url}{path}", headers=self._headers(require_auth=require_auth), params=params, timeout=self.timeout)
+        response.raise_for_status()
+        return response.json()
+
+    def _post(self, path: str, *, body: Dict[str, Any], require_auth: bool = True) -> Dict[str, Any]:
+        response = httpx.post(f"{self.base_url}{path}", headers=self._headers(require_auth=require_auth), json=body, timeout=max(self.timeout, 60.0))
+        response.raise_for_status()
+        return response.json()
+
+    def capabilities(self, surface: Optional[str] = None, category: Optional[str] = None) -> Dict[str, Any]:
+        params: Dict[str, Any] = {}
+        if surface:
+            params["surface"] = surface
+        if category:
+            params["category"] = category
+        return self._get("/v1/capabilities", params=params, require_auth=False)
+
+    def plan(
+        self,
+        *,
+        goal: str,
+        address: Optional[str] = None,
+        chain: str = "ethereum",
+        budget_credits: Optional[int] = None,
+        budget_usd: Optional[float] = None,
+        prefer_surface: str = "auto",
+    ) -> Dict[str, Any]:
+        body: Dict[str, Any] = {"goal": goal, "chain": chain, "prefer_surface": prefer_surface}
+        if address:
+            body["address"] = address
+        if budget_credits is not None:
+            body["budget_credits"] = budget_credits
+        if budget_usd is not None:
+            body["budget_usd"] = budget_usd
+        return self._post("/v1/plan", body=body, require_auth=False)
+
+    def create_workspace(
+        self,
+        *,
+        name: str,
+        chain: str = "ethereum",
+        modules: Optional[List[str]] = None,
+    ) -> Dict[str, Any]:
+        return self._post(
+            "/v1/workspaces/create",
+            body={
+                "name": name,
+                "chain": chain,
+                "modules": modules or ["verdict", "stablecoins", "bridge-activity", "chart"],
+            },
+            require_auth=True,
+        )
+
+    def get_workspace(self, workspace_id: str) -> Dict[str, Any]:
+        return self._get(f"/v1/workspaces/{workspace_id}", require_auth=True)
+
+    def destroy_workspace(self, workspace_id: str) -> Dict[str, Any]:
+        return self._post(f"/v1/workspaces/{workspace_id}/destroy", body={}, require_auth=True)

blockintql_sdk-0.1.0/blockintql_sdk.egg-info/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: blockintql-sdk
+Version: 0.1.0
+Summary: Python SDK for BlockINTQL Ethereum and stablecoin intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27.0
+
+# BlockINTQL Python SDK
+
+Minimal Python client for:
+
+- capability discovery
+- investigation planning
+- workspace lifecycle
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Example
+
+```python
+from blockintql_sdk import BlockINTQL
+
+client = BlockINTQL()
+
+capabilities = client.capabilities()
+plan = client.plan(
+    goal="Investigate this wallet's stablecoin counterparties and bridge activity",
+    address="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
+    budget_credits=12,
+)
+
+workspace = client.create_workspace(
+    name="stablecoin-investigation",
+    modules=["verdict", "stablecoins", "bridge-activity", "chart"],
+)
+```

blockintql_sdk-0.1.0/blockintql_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+blockintql_sdk/__init__.py
+blockintql_sdk/client.py
+blockintql_sdk.egg-info/PKG-INFO
+blockintql_sdk.egg-info/SOURCES.txt
+blockintql_sdk.egg-info/dependency_links.txt
+blockintql_sdk.egg-info/requires.txt
+blockintql_sdk.egg-info/top_level.txt
+examples/plan_and_workspace.py

blockintql_sdk-0.1.0/blockintql_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

blockintql_sdk-0.1.0/blockintql_sdk.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.27.0

blockintql_sdk-0.1.0/blockintql_sdk.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+blockintql_sdk
+dist
+examples

blockintql_sdk-0.1.0/examples/plan_and_workspace.py

@@ -0,0 +1,29 @@
+from blockintql_sdk import BlockINTQL
+
+
+def main():
+    client = BlockINTQL()
+
+    capabilities = client.capabilities()
+    print("surfaces:", capabilities.get("surfaces"))
+    print("categories:", capabilities.get("categories"))
+
+    plan = client.plan(
+        goal="Investigate this wallet's stablecoin counterparties and bridge activity",
+        address="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
+        budget_credits=12,
+    )
+    print("plan summary:", plan.get("summary"))
+    print("recommended surface:", plan.get("recommended_surface"))
+    print("steps:", [step.get("capability_id") for step in plan.get("steps", [])])
+
+    # Requires BLOCKINTQL_API_KEY
+    # workspace = client.create_workspace(
+    #     name="stablecoin-investigation",
+    #     modules=["verdict", "stablecoins", "bridge-activity", "chart"],
+    # )
+    # print(workspace)
+
+
+if __name__ == "__main__":
+    main()

blockintql_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "blockintql-sdk"
+version = "0.1.0"
+description = "Python SDK for BlockINTQL Ethereum and stablecoin intelligence"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = ["httpx>=0.27.0"]
+
+[tool.setuptools.packages.find]
+where = ["."]

blockintql_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+