jarvisclaw 0.1.0__tar.gz

jarvisclaw-0.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: jarvisclaw
+Version: 0.1.0
+Summary: JarvisClaw AI & Prediction Market SDK — x402 machine payments
+License: MIT
+Project-URL: Homepage, https://jarvisclaw.ai
+Project-URL: Documentation, https://api.jarvisclaw.ai/docs
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28
+Requires-Dist: eth-account>=0.10
+Requires-Dist: eth-abi>=4.0
+
+# JarvisClaw SDK
+
+Python SDK for JarvisClaw AI & Prediction Market APIs with x402 machine payments.
+
+## Install
+
+```bash
+pip install jarvisclaw
+```
+
+## Quick Start
+
+### AI Agent (x402 direct payment — no API key needed)
+
+```python
+from jarvisclaw import JarvisClawClient
+
+# Your agent's wallet (needs USDC on Base chain)
+client = JarvisClawClient(private_key="0x<your-wallet-private-key>")
+
+# AI model call — SDK handles 402 → sign → retry automatically
+response = client.post("/v1/chat/completions", json={
+    "model": "openai/gpt-5.4-nano",
+    "messages": [{"role": "user", "content": "Hello!"}]
+})
+print(response["choices"][0]["message"]["content"])
+
+# Prediction market data
+markets = client.get("/v1/prediction/polymarket/markets", params={"limit": 10})
+print(markets)
+
+# Sports betting odds
+sports = client.get("/v1/prediction/sports/markets", params={"category": "soccer"})
+```
+
+### API Key (traditional — for human users)
+
+If you have an API key, you don't need this SDK. Just use the standard OpenAI SDK:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    base_url="https://api.jarvisclaw.ai/v1",
+    api_key="sk-your-api-key"
+)
+response = client.chat.completions.create(
+    model="auto",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+## Requirements
+
+- Python >= 3.9
+- Wallet with USDC on Base chain (Chain ID 8453)
+- No ETH needed (facilitator pays gas)
+
+## Pricing
+
+- AI models: per-token (see https://api.jarvisclaw.ai/pricing)
+- Prediction GET: $0.001/request
+- Prediction POST: $0.005/request
+- Zero markup on upstream costs

jarvisclaw-0.1.0/README.md

@@ -0,0 +1,64 @@
+# JarvisClaw SDK
+
+Python SDK for JarvisClaw AI & Prediction Market APIs with x402 machine payments.
+
+## Install
+
+```bash
+pip install jarvisclaw
+```
+
+## Quick Start
+
+### AI Agent (x402 direct payment — no API key needed)
+
+```python
+from jarvisclaw import JarvisClawClient
+
+# Your agent's wallet (needs USDC on Base chain)
+client = JarvisClawClient(private_key="0x<your-wallet-private-key>")
+
+# AI model call — SDK handles 402 → sign → retry automatically
+response = client.post("/v1/chat/completions", json={
+    "model": "openai/gpt-5.4-nano",
+    "messages": [{"role": "user", "content": "Hello!"}]
+})
+print(response["choices"][0]["message"]["content"])
+
+# Prediction market data
+markets = client.get("/v1/prediction/polymarket/markets", params={"limit": 10})
+print(markets)
+
+# Sports betting odds
+sports = client.get("/v1/prediction/sports/markets", params={"category": "soccer"})
+```
+
+### API Key (traditional — for human users)
+
+If you have an API key, you don't need this SDK. Just use the standard OpenAI SDK:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    base_url="https://api.jarvisclaw.ai/v1",
+    api_key="sk-your-api-key"
+)
+response = client.chat.completions.create(
+    model="auto",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+## Requirements
+
+- Python >= 3.9
+- Wallet with USDC on Base chain (Chain ID 8453)
+- No ETH needed (facilitator pays gas)
+
+## Pricing
+
+- AI models: per-token (see https://api.jarvisclaw.ai/pricing)
+- Prediction GET: $0.001/request
+- Prediction POST: $0.005/request
+- Zero markup on upstream costs

jarvisclaw-0.1.0/jarvisclaw/__init__.py

@@ -0,0 +1,4 @@
+from jarvisclaw.client import JarvisClawClient
+
+__all__ = ["JarvisClawClient"]
+__version__ = "0.1.0"

jarvisclaw-0.1.0/jarvisclaw/client.py

@@ -0,0 +1,153 @@
+"""
+JarvisClaw SDK — x402 Machine Payment Client
+
+Handles the full x402 payment flow:
+1. Send request → receive 402 + payment requirements
+2. Sign payment with wallet private key (EIP-712)
+3. Retry request with PAYMENT-SIGNATURE header
+"""
+import base64
+import json
+import time
+from typing import Any, Optional
+
+import requests
+from eth_account import Account
+from eth_account.messages import encode_typed_data
+
+DEFAULT_BASE_URL = "https://api.jarvisclaw.ai"
+DEFAULT_NETWORK = "eip155:8453"
+
+
+class JarvisClawClient:
+    """x402-enabled HTTP client for JarvisClaw APIs.
+
+    Usage:
+        client = JarvisClawClient(private_key="0x...")
+
+        # AI model call
+        resp = client.post("/v1/chat/completions", json={
+            "model": "openai/gpt-5.4-nano",
+            "messages": [{"role": "user", "content": "Hello"}]
+        })
+
+        # Prediction market data
+        markets = client.get("/v1/prediction/polymarket/markets")
+    """
+
+    def __init__(
+        self,
+        private_key: str,
+        base_url: str = DEFAULT_BASE_URL,
+        network: str = DEFAULT_NETWORK,
+        timeout: int = 60,
+        max_retries: int = 1,
+    ):
+        self.account = Account.from_key(private_key)
+        self.base_url = base_url.rstrip("/")
+        self.network = network
+        self.timeout = timeout
+        self.max_retries = max_retries
+        self.session = requests.Session()
+
+    @property
+    def address(self) -> str:
+        return self.account.address
+
+    def get(self, path: str, **kwargs) -> Any:
+        return self._request("GET", path, **kwargs)
+
+    def post(self, path: str, **kwargs) -> Any:
+        return self._request("POST", path, **kwargs)
+
+    def _request(self, method: str, path: str, **kwargs) -> Any:
+        url = self.base_url + path
+        kwargs.setdefault("timeout", self.timeout)
+
+        resp = self.session.request(method, url, **kwargs)
+
+        if resp.status_code != 402:
+            resp.raise_for_status()
+            return resp.json()
+
+        # Handle x402 payment
+        payment_req = self._parse_payment_required(resp)
+        signature = self._sign_payment(payment_req, url)
+
+        headers = kwargs.pop("headers", {}) or {}
+        headers["PAYMENT-SIGNATURE"] = signature
+
+        retry_resp = self.session.request(method, url, headers=headers, **kwargs)
+        retry_resp.raise_for_status()
+        return retry_resp.json()
+
+    def _parse_payment_required(self, resp: requests.Response) -> dict:
+        header = resp.headers.get("payment-required", "")
+        if header:
+            return json.loads(header)
+        return resp.json()
+
+    def _sign_payment(self, payment_req: dict, resource_url: str) -> str:
+        pay_to = payment_req.get("payTo", "")
+        amount = payment_req.get("maxAmountRequired", "0")
+        network = payment_req.get("network", self.network)
+        max_timeout = payment_req.get("maxTimeoutSeconds", 300)
+        description = payment_req.get("description", "")
+
+        # Build x402 payment payload
+        payload = {
+            "x402Version": 1,
+            "scheme": "exact",
+            "network": network,
+            "payload": {
+                "signature": "",
+                "authorization": {
+                    "from": self.account.address,
+                    "to": pay_to,
+                    "value": amount,
+                    "validAfter": str(int(time.time()) - 60),
+                    "validBefore": str(int(time.time()) + max_timeout),
+                    "nonce": self._generate_nonce(),
+                },
+            },
+            "resource": resource_url,
+            "description": description,
+        }
+
+        # Sign the authorization with EIP-712
+        auth = payload["payload"]["authorization"]
+        domain = {
+            "name": "USD Coin",
+            "version": "2",
+            "chainId": int(network.split(":")[1]) if ":" in network else 8453,
+            "verifyingContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        }
+        types = {
+            "TransferWithAuthorization": [
+                {"name": "from", "type": "address"},
+                {"name": "to", "type": "address"},
+                {"name": "value", "type": "uint256"},
+                {"name": "validAfter", "type": "uint256"},
+                {"name": "validBefore", "type": "uint256"},
+                {"name": "nonce", "type": "bytes32"},
+            ]
+        }
+        message = {
+            "from": auth["from"],
+            "to": auth["to"],
+            "value": int(auth["value"]),
+            "validAfter": int(auth["validAfter"]),
+            "validBefore": int(auth["validBefore"]),
+            "nonce": bytes.fromhex(auth["nonce"][2:]) if auth["nonce"].startswith("0x") else bytes.fromhex(auth["nonce"]),
+        }
+
+        signable = encode_typed_data(domain, types, message)
+        signed = self.account.sign_message(signable)
+        payload["payload"]["signature"] = signed.signature.hex()
+
+        payload_json = json.dumps(payload, separators=(",", ":"))
+        return base64.b64encode(payload_json.encode()).decode()
+
+    def _generate_nonce(self) -> str:
+        import os
+        return "0x" + os.urandom(32).hex()

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

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: jarvisclaw
+Version: 0.1.0
+Summary: JarvisClaw AI & Prediction Market SDK — x402 machine payments
+License: MIT
+Project-URL: Homepage, https://jarvisclaw.ai
+Project-URL: Documentation, https://api.jarvisclaw.ai/docs
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28
+Requires-Dist: eth-account>=0.10
+Requires-Dist: eth-abi>=4.0
+
+# JarvisClaw SDK
+
+Python SDK for JarvisClaw AI & Prediction Market APIs with x402 machine payments.
+
+## Install
+
+```bash
+pip install jarvisclaw
+```
+
+## Quick Start
+
+### AI Agent (x402 direct payment — no API key needed)
+
+```python
+from jarvisclaw import JarvisClawClient
+
+# Your agent's wallet (needs USDC on Base chain)
+client = JarvisClawClient(private_key="0x<your-wallet-private-key>")
+
+# AI model call — SDK handles 402 → sign → retry automatically
+response = client.post("/v1/chat/completions", json={
+    "model": "openai/gpt-5.4-nano",
+    "messages": [{"role": "user", "content": "Hello!"}]
+})
+print(response["choices"][0]["message"]["content"])
+
+# Prediction market data
+markets = client.get("/v1/prediction/polymarket/markets", params={"limit": 10})
+print(markets)
+
+# Sports betting odds
+sports = client.get("/v1/prediction/sports/markets", params={"category": "soccer"})
+```
+
+### API Key (traditional — for human users)
+
+If you have an API key, you don't need this SDK. Just use the standard OpenAI SDK:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    base_url="https://api.jarvisclaw.ai/v1",
+    api_key="sk-your-api-key"
+)
+response = client.chat.completions.create(
+    model="auto",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+## Requirements
+
+- Python >= 3.9
+- Wallet with USDC on Base chain (Chain ID 8453)
+- No ETH needed (facilitator pays gas)
+
+## Pricing
+
+- AI models: per-token (see https://api.jarvisclaw.ai/pricing)
+- Prediction GET: $0.001/request
+- Prediction POST: $0.005/request
+- Zero markup on upstream costs

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,3 @@
+requests>=2.28
+eth-account>=0.10
+eth-abi>=4.0

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

@@ -0,0 +1 @@
+jarvisclaw

jarvisclaw-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "jarvisclaw"
+version = "0.1.0"
+description = "JarvisClaw AI & Prediction Market SDK — x402 machine payments"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+dependencies = [
+    "requests>=2.28",
+    "eth-account>=0.10",
+    "eth-abi>=4.0",
+]
+
+[project.urls]
+Homepage = "https://jarvisclaw.ai"
+Documentation = "https://api.jarvisclaw.ai/docs"

jarvisclaw-0.1.0/setup.cfg

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