oneshot-python 0.2.0__tar.gz → 0.3.0__tar.gz

{oneshot_python-0.2.0 → oneshot_python-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oneshot-python
-Version: 0.2.0
+Version: 0.3.0
 Summary: Core Python SDK for the OneShot API — HTTP client with x402 payment handling
 License-Expression: MIT
 Requires-Python: >=3.10

oneshot_python-0.3.0/README.md

@@ -0,0 +1,110 @@
+# oneshot-python
+
+Core Python SDK for the [OneShot](https://oneshotagent.com) API. Handles the x402 payment protocol (quote, sign, pay, poll) so your Python code can call any OneShot tool.
+
+This is the foundation package. If you're using LangChain, install [`langchain-oneshot`](https://pypi.org/project/langchain-oneshot/) instead (it includes this package).
+
+## Installation
+
+```bash
+pip install oneshot-python
+```
+
+## Quick Start
+
+```python
+from oneshot import OneShotClient
+
+client = OneShotClient(
+    private_key="0x...",
+    test_mode=True,  # Base Sepolia testnet (default)
+)
+
+# Paid tool — handles 402 -> sign -> pay -> poll automatically
+result = client.call_tool("/v1/tools/email/send", {
+    "to": "user@example.com",
+    "subject": "Hello from Python",
+    "body": "Sent via oneshot-python",
+})
+
+# Free endpoint
+balance = client.call_free_get("/v1/wallet/balance")
+```
+
+### Async
+
+```python
+import asyncio
+from oneshot import OneShotClient
+
+client = OneShotClient(private_key="0x...", test_mode=True)
+
+async def main():
+    result = await client.acall_tool("/v1/tools/research", {
+        "topic": "AI agent frameworks",
+        "depth": "quick",
+    })
+    print(result)
+
+asyncio.run(main())
+```
+
+## How Payments Work
+
+Paid endpoints use the [x402 protocol](https://x402.org):
+
+1. Client POSTs to a tool endpoint
+2. API returns `402 Payment Required` with a USDC quote
+3. Client signs a `TransferWithAuthorization` (EIP-3009) locally
+4. Client re-POSTs with the signed payment in the `x-payment` header
+5. API processes the request and returns the result
+
+Your private key never leaves your machine. All signing happens locally via `eth-account`.
+
+## Configuration
+
+```python
+# Test mode (default) — Base Sepolia, no real money
+client = OneShotClient(private_key="0x...", test_mode=True)
+
+# Production — Base Mainnet, real USDC
+client = OneShotClient(private_key="0x...", test_mode=False)
+
+# Debug logging
+client = OneShotClient(private_key="0x...", debug=True)
+
+# Custom API URL
+client = OneShotClient(private_key="0x...", base_url="https://custom-api.example.com")
+```
+
+## API
+
+### Paid tools
+
+- `call_tool(endpoint, payload, *, max_cost=None, timeout_sec=120)` — Blocking
+- `acall_tool(endpoint, payload, *, max_cost=None, timeout_sec=120)` — Async
+
+### Free endpoints
+
+- `call_free_get(endpoint, params=None)` / `acall_free_get(...)` — GET
+- `call_free_post(endpoint, payload=None)` / `acall_free_post(...)` — POST
+- `call_free_patch(endpoint, payload=None)` / `acall_free_patch(...)` — PATCH
+
+## Requirements
+
+- Python 3.10+
+- `httpx >= 0.27.0`
+- `eth-account >= 0.13.0`
+
+## Links
+
+- [Documentation](https://docs.oneshotagent.com/sdk/installation#install-via-pip-python)
+- [LangChain integration](https://pypi.org/project/langchain-oneshot/) — 26 tools as LangChain BaseTool
+- [GAME plugin](https://pypi.org/project/game-plugin-oneshot/) — Virtuals Protocol integration
+- [TypeScript SDK](https://www.npmjs.com/package/@oneshot-agent/sdk)
+- [MCP Server](https://www.npmjs.com/package/@oneshot-agent/mcp-server)
+- [GitHub](https://github.com/oneshot-agent/sdk)
+
+## License
+
+MIT

{oneshot_python-0.2.0 → oneshot_python-0.3.0}/oneshot/client.py

@@ -25,19 +25,12 @@ from oneshot._errors import (
 )
 from oneshot.x402 import sign_payment_authorization
 
-SDK_VERSION = "0.2.0"
+SDK_VERSION = "0.3.0"
 
 # ---------------------------------------------------------------------------
-# Environment configuration (mirrors TS SDK)
+# Environment configuration
 # ---------------------------------------------------------------------------
 
-TEST_ENV = {
-    "base_url": "https://api-stg.oneshotagent.com",
-    "rpc_url": "https://sepolia.base.org",
-    "chain_id": 84532,
-    "usdc_address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
-}
-
 PROD_ENV = {
     "base_url": "https://win.oneshotagent.com",
     "rpc_url": "https://mainnet.base.org",
@@ -45,6 +38,9 @@ PROD_ENV = {
     "usdc_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
 }
 
+# Deprecated: staging is internal-only. TEST_ENV now aliases to PROD_ENV.
+TEST_ENV = PROD_ENV
+
 _POLL_INTERVAL = 2.0  # seconds
 _MAX_POLL_RETRIES = 3
 
@@ -60,7 +56,7 @@ class OneShotClient:
         self,
         private_key: str,
         *,
-        test_mode: bool = True,
+        test_mode: bool = False,
         base_url: Optional[str] = None,
         debug: bool = False,
     ) -> None:

{oneshot_python-0.2.0 → oneshot_python-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "oneshot-python"
-version = "0.2.0"
+version = "0.3.0"
 description = "Core Python SDK for the OneShot API — HTTP client with x402 payment handling"
 readme = {text = "Core Python SDK for the OneShot API", content-type = "text/plain"}
 license = "MIT"