sthrip 0.1.0__tar.gz

sthrip-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sthrip Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sthrip-0.1.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: sthrip
+Version: 0.1.0
+Summary: Anonymous payments for AI agents
+License: MIT
+Project-URL: Homepage, https://sthrip.dev
+Project-URL: Documentation, https://sthrip-api-production.up.railway.app/docs
+Project-URL: Repository, https://github.com/sthrip/sthrip
+Keywords: payments,ai,agents,monero,anonymous
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# sthrip
+
+> Anonymous payments for AI agents.
+
+[![PyPI version](https://img.shields.io/pypi/v/sthrip)](https://pypi.org/project/sthrip/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Quickstart
+
+```python
+from sthrip import Sthrip
+
+s = Sthrip()               # auto-registers on first use
+s.pay("agent-name", 0.5)   # send 0.5 XMR
+```
+
+## Install
+
+```
+pip install sthrip
+```
+
+## How it works
+
+Agents register and get a unique XMR deposit address. Deposit Monero to the address, then pay other agents through the hub with a single method call. Payments are routed internally -- instant, private, and charged at 0.1% per transaction. The entire system is built on Monero for maximum privacy. No accounts, no KYC, no tracking.
+
+## API Reference
+
+| Method | Description |
+|--------|-------------|
+| `Sthrip()` | Initialize client (auto-registers if no credentials found) |
+| `s.deposit_address()` | Get your XMR deposit address |
+| `s.pay(agent, amount)` | Send payment to another agent |
+| `s.balance()` | Check your current balance |
+| `s.find_agents()` | Discover available agents |
+| `s.me()` | View your agent profile |
+| `s.withdraw(amount, addr)` | Withdraw XMR to an external address |
+| `s.payment_history()` | View transaction history |
+
+## Configuration
+
+| Variable | Purpose |
+|----------|---------|
+| `STHRIP_API_KEY` | API key for authentication |
+| `STHRIP_API_URL` | Custom API URL (optional) |
+
+Credentials are auto-saved to `~/.sthrip/credentials.json` on first registration.
+
+## Fees
+
+- **0.1%** per hub-routed payment
+- No registration fee
+- No deposit fee
+
+## Links
+
+- [Landing page](https://sthrip.dev)
+- [API Docs](https://sthrip-api-production.up.railway.app/docs)
+- [PyPI](https://pypi.org/project/sthrip/)
+
+## License
+
+[MIT](LICENSE)

sthrip-0.1.0/README.md

@@ -0,0 +1,64 @@
+# sthrip
+
+> Anonymous payments for AI agents.
+
+[![PyPI version](https://img.shields.io/pypi/v/sthrip)](https://pypi.org/project/sthrip/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Quickstart
+
+```python
+from sthrip import Sthrip
+
+s = Sthrip()               # auto-registers on first use
+s.pay("agent-name", 0.5)   # send 0.5 XMR
+```
+
+## Install
+
+```
+pip install sthrip
+```
+
+## How it works
+
+Agents register and get a unique XMR deposit address. Deposit Monero to the address, then pay other agents through the hub with a single method call. Payments are routed internally -- instant, private, and charged at 0.1% per transaction. The entire system is built on Monero for maximum privacy. No accounts, no KYC, no tracking.
+
+## API Reference
+
+| Method | Description |
+|--------|-------------|
+| `Sthrip()` | Initialize client (auto-registers if no credentials found) |
+| `s.deposit_address()` | Get your XMR deposit address |
+| `s.pay(agent, amount)` | Send payment to another agent |
+| `s.balance()` | Check your current balance |
+| `s.find_agents()` | Discover available agents |
+| `s.me()` | View your agent profile |
+| `s.withdraw(amount, addr)` | Withdraw XMR to an external address |
+| `s.payment_history()` | View transaction history |
+
+## Configuration
+
+| Variable | Purpose |
+|----------|---------|
+| `STHRIP_API_KEY` | API key for authentication |
+| `STHRIP_API_URL` | Custom API URL (optional) |
+
+Credentials are auto-saved to `~/.sthrip/credentials.json` on first registration.
+
+## Fees
+
+- **0.1%** per hub-routed payment
+- No registration fee
+- No deposit fee
+
+## Links
+
+- [Landing page](https://sthrip.dev)
+- [API Docs](https://sthrip-api-production.up.railway.app/docs)
+- [PyPI](https://pypi.org/project/sthrip/)
+
+## License
+
+[MIT](LICENSE)

sthrip-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[project]
+name = "sthrip"
+version = "0.1.0"
+description = "Anonymous payments for AI agents"
+requires-python = ">=3.8"
+dependencies = ["requests>=2.25"]
+license = {text = "MIT"}
+readme = "README.md"
+keywords = ["payments", "ai", "agents", "monero", "anonymous"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+
+[project.urls]
+Homepage = "https://sthrip.dev"
+Documentation = "https://sthrip-api-production.up.railway.app/docs"
+Repository = "https://github.com/sthrip/sthrip"
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"

sthrip-0.1.0/setup.cfg

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

sthrip-0.1.0/sthrip/__init__.py

@@ -0,0 +1,35 @@
+"""Sthrip SDK -- anonymous payments for AI agents.
+
+Quick start::
+
+    from sthrip import Sthrip
+
+    s = Sthrip()                       # auto-registers if no key found
+    print(s.deposit_address())         # get XMR deposit address
+    print(s.balance())                 # check balance
+    s.pay("other-agent", 0.05)         # send payment
+"""
+
+from .client import Sthrip
+from .exceptions import (
+    AgentNotFound,
+    AuthError,
+    InsufficientBalance,
+    NetworkError,
+    PaymentError,
+    RateLimitError,
+    StrhipError,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "Sthrip",
+    "StrhipError",
+    "AuthError",
+    "PaymentError",
+    "InsufficientBalance",
+    "AgentNotFound",
+    "RateLimitError",
+    "NetworkError",
+]

sthrip-0.1.0/sthrip/auth.py

@@ -0,0 +1,85 @@
+"""Credential storage for the Sthrip SDK.
+
+Credentials are persisted at ``~/.sthrip/credentials.json`` with file
+permissions restricted to the owning user (0600).  The module never
+mutates the dict that is returned by ``load_credentials`` -- callers
+receive a fresh copy each time.
+"""
+
+import json
+import os
+import stat
+from pathlib import Path
+
+# typing import kept compatible with Python 3.8
+from typing import Dict, Optional
+
+CREDENTIALS_PATH = Path.home() / ".sthrip" / "credentials.json"
+
+# Fields we expect inside the credentials file.
+_REQUIRED_KEYS = ("api_key", "agent_id", "agent_name", "api_url")
+
+
+def load_credentials(path=None):
+    # type: (Optional[Path]) -> Optional[Dict[str, str]]
+    """Load credentials from disk.
+
+    Returns a *new* dict with keys ``api_key``, ``agent_id``,
+    ``agent_name``, and ``api_url``, or ``None`` if the file does not
+    exist or is malformed.
+    """
+    target = path or CREDENTIALS_PATH
+    if not target.is_file():
+        return None
+
+    try:
+        raw = target.read_text(encoding="utf-8")
+        data = json.loads(raw)
+    except (OSError, json.JSONDecodeError, ValueError):
+        return None
+
+    if not isinstance(data, dict):
+        return None
+
+    # Return only the keys we care about -- never leak unknown fields.
+    result = {}
+    for key in _REQUIRED_KEYS:
+        value = data.get(key)
+        if value is None:
+            return None
+        result[key] = str(value)
+
+    return result
+
+
+def save_credentials(api_key, agent_id, agent_name, api_url, path=None):
+    # type: (str, str, str, str, Optional[Path]) -> None
+    """Persist credentials to disk with restricted permissions.
+
+    Creates ``~/.sthrip/`` if it does not exist.  The file is written
+    atomically (write-then-rename would be ideal but pathlib keeps this
+    simple) and its mode is set to ``0600`` immediately.
+    """
+    target = path or CREDENTIALS_PATH
+
+    target.parent.mkdir(parents=True, exist_ok=True)
+
+    payload = {
+        "api_key": api_key,
+        "agent_id": agent_id,
+        "agent_name": agent_name,
+        "api_url": api_url,
+    }
+
+    target.write_text(
+        json.dumps(payload, indent=2) + "\n",
+        encoding="utf-8",
+    )
+
+    # Restrict to owner read/write only.
+    try:
+        os.chmod(str(target), stat.S_IRUSR | stat.S_IWUSR)
+    except OSError:
+        # On platforms where chmod is not supported (e.g. some Windows
+        # builds) we silently continue -- the file was still written.
+        pass

sthrip-0.1.0/sthrip/client.py

@@ -0,0 +1,350 @@
+"""Sthrip SDK client -- thin, synchronous wrapper over the Sthrip REST API.
+
+Usage::
+
+    from sthrip import Sthrip
+
+    s = Sthrip()                       # auto-registers if no key found
+    print(s.balance())
+    s.pay("other-agent", 0.05, memo="thanks")
+"""
+
+import os
+import platform
+import secrets
+import socket
+
+import requests
+
+from .auth import load_credentials, save_credentials
+from .exceptions import (
+    AgentNotFound,
+    AuthError,
+    InsufficientBalance,
+    NetworkError,
+    PaymentError,
+    RateLimitError,
+    StrhipError,
+)
+
+_VERSION = "0.1.0"
+_USER_AGENT = "sthrip-sdk/{}".format(_VERSION)
+_DEFAULT_API_URL = "https://sthrip-api-production.up.railway.app"
+_REQUEST_TIMEOUT = 30  # seconds
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+def _generate_agent_name():
+    # type: () -> str
+    """Build a human-readable agent name from the hostname + random suffix."""
+    try:
+        host = socket.gethostname().split(".")[0]
+    except Exception:
+        host = "agent"
+    # Keep only alphanumeric/underscore/hyphen characters.
+    safe = "".join(ch for ch in host if ch.isalnum() or ch in ("_", "-"))
+    if not safe:
+        safe = "agent"
+    suffix = secrets.token_hex(4)
+    return "{}-{}".format(safe, suffix)
+
+
+def _resolve_api_url(explicit):
+    # type: (str) -> str
+    """Return the API base URL without a trailing slash."""
+    url = explicit or os.environ.get("STHRIP_API_URL", "") or _DEFAULT_API_URL
+    return url.rstrip("/")
+
+
+def _map_error(status_code, detail):
+    # type: (int, str) -> StrhipError
+    """Map an HTTP status + detail string to the most specific exception."""
+    lower = detail.lower()
+
+    if status_code == 429:
+        return RateLimitError(detail, status_code)
+
+    if status_code in (401, 403):
+        return AuthError(detail, status_code)
+
+    if status_code == 404 and "agent" in lower:
+        return AgentNotFound(detail, status_code)
+
+    if "insufficient" in lower or "not enough" in lower:
+        return InsufficientBalance(detail, status_code)
+
+    if status_code >= 400:
+        return PaymentError(detail, status_code)
+
+    return StrhipError(detail, status_code)
+
+
+# ---------------------------------------------------------------------------
+# Client
+# ---------------------------------------------------------------------------
+
+class Sthrip(object):
+    """Synchronous client for the Sthrip anonymous-payments API.
+
+    Parameters
+    ----------
+    api_key : str, optional
+        Bearer token.  Resolution order: *api_key* argument, then
+        ``STHRIP_API_KEY`` env var, then ``~/.sthrip/credentials.json``,
+        and finally auto-registration.
+    api_url : str, optional
+        Base URL of the Sthrip API.  Defaults to the env var
+        ``STHRIP_API_URL`` or the production endpoint.
+    """
+
+    def __init__(self, api_key=None, api_url=None):
+        # type: (str, str) -> None
+        self._api_url = _resolve_api_url(api_url)
+        self._api_key = self._resolve_api_key(api_key)
+        self._session = self._build_session()
+
+    # -- key resolution -----------------------------------------------------
+
+    def _resolve_api_key(self, explicit):
+        # type: (str) -> str
+        """Walk the credential chain and return a usable API key."""
+        # 1. Explicit parameter
+        if explicit:
+            return explicit
+
+        # 2. Environment variable
+        env_key = os.environ.get("STHRIP_API_KEY", "")
+        if env_key:
+            return env_key
+
+        # 3. Credential file
+        creds = load_credentials()
+        if creds is not None:
+            return creds["api_key"]
+
+        # 4. Auto-register
+        return self._auto_register()
+
+    def _auto_register(self):
+        # type: () -> str
+        """Register a new agent and persist the credentials."""
+        agent_name = _generate_agent_name()
+        payload = {"agent_name": agent_name, "privacy_level": "medium"}
+
+        data = self._raw_post(
+            "/v2/agents/register",
+            json_body=payload,
+            authenticated=False,
+        )
+
+        save_credentials(
+            api_key=data["api_key"],
+            agent_id=data["agent_id"],
+            agent_name=data["agent_name"],
+            api_url=self._api_url,
+        )
+
+        return data["api_key"]
+
+    # -- HTTP layer ---------------------------------------------------------
+
+    def _build_session(self):
+        # type: () -> requests.Session
+        session = requests.Session()
+        session.headers.update({
+            "User-Agent": _USER_AGENT,
+            "Accept": "application/json",
+        })
+        return session
+
+    def _headers(self, authenticated):
+        # type: (bool) -> dict
+        """Return a *new* headers dict -- never mutates the session."""
+        headers = {"Content-Type": "application/json"}
+        if authenticated:
+            headers["Authorization"] = "Bearer {}".format(self._api_key)
+        return headers
+
+    def _handle_response(self, response):
+        # type: (requests.Response) -> dict
+        """Raise a typed exception on non-2xx or return the parsed JSON."""
+        if response.ok:
+            return response.json()
+
+        # Try to pull the structured detail from the API error envelope.
+        try:
+            body = response.json()
+            detail = body.get("detail", response.text)
+        except (ValueError, AttributeError):
+            detail = response.text
+
+        raise _map_error(response.status_code, str(detail))
+
+    def _raw_request(self, method, path, json_body=None, params=None, authenticated=True):
+        # type: (str, str, dict, dict, bool) -> dict
+        url = "{}{}".format(self._api_url, path)
+        headers = self._headers(authenticated)
+
+        try:
+            response = self._session.request(
+                method,
+                url,
+                json=json_body,
+                params=params,
+                headers=headers,
+                timeout=_REQUEST_TIMEOUT,
+            )
+        except requests.ConnectionError as exc:
+            raise NetworkError("Connection failed: {}".format(exc))
+        except requests.Timeout as exc:
+            raise NetworkError("Request timed out: {}".format(exc))
+        except requests.RequestException as exc:
+            raise NetworkError("Request error: {}".format(exc))
+
+        return self._handle_response(response)
+
+    def _raw_get(self, path, params=None, authenticated=True):
+        # type: (str, dict, bool) -> dict
+        return self._raw_request("GET", path, params=params, authenticated=authenticated)
+
+    def _raw_post(self, path, json_body=None, authenticated=True):
+        # type: (str, dict, bool) -> dict
+        return self._raw_request("POST", path, json_body=json_body, authenticated=authenticated)
+
+    # -- Public API ---------------------------------------------------------
+
+    def deposit_address(self):
+        # type: () -> str
+        """Return the XMR deposit address for this agent.
+
+        Calls ``POST /v2/balance/deposit`` and returns the address string.
+        """
+        data = self._raw_post("/v2/balance/deposit", json_body={})
+        return data["deposit_address"]
+
+    def pay(self, agent_name, amount, memo=None):
+        # type: (str, float, str) -> dict
+        """Send a hub-routed payment to *agent_name*.
+
+        Parameters
+        ----------
+        agent_name : str
+            Recipient agent's registered name.
+        amount : float
+            Amount in XMR.  Converted to string for the API.
+        memo : str, optional
+            Human-readable note attached to the payment.
+
+        Returns
+        -------
+        dict
+            Full payment receipt from the API.
+        """
+        payload = {
+            "to_agent_name": agent_name,
+            "amount": str(amount),
+            "urgency": "normal",
+        }
+        if memo is not None:
+            payload["memo"] = memo
+
+        return self._raw_post("/v2/payments/hub-routing", json_body=payload)
+
+    def balance(self):
+        # type: () -> dict
+        """Return balance information for the authenticated agent.
+
+        Keys include ``available``, ``pending``, ``total_deposited``,
+        ``total_withdrawn``, ``deposit_address``, and ``token``.
+        """
+        return self._raw_get("/v2/balance")
+
+    def find_agents(self, capability=None, **kwargs):
+        # type: (str, ...) -> list
+        """Discover registered agents.
+
+        Parameters
+        ----------
+        capability : str, optional
+            Currently reserved for future filtering.
+        **kwargs
+            Additional query params forwarded to ``GET /v2/agents``, e.g.
+            ``limit``, ``offset``, ``min_trust_score``, ``tier``,
+            ``verified_only``.
+
+        Returns
+        -------
+        list
+            List of agent profile dicts.
+        """
+        params = {}
+        for key, value in kwargs.items():
+            if value is not None:
+                params[key] = value
+
+        data = self._raw_get("/v2/agents", params=params, authenticated=False)
+
+        # The endpoint may return the list directly or inside an envelope.
+        if isinstance(data, list):
+            return data
+        if isinstance(data, dict) and "agents" in data:
+            return data["agents"]
+        return data
+
+    def me(self):
+        # type: () -> dict
+        """Return the profile of the currently authenticated agent."""
+        return self._raw_get("/v2/agents/me")
+
+    def withdraw(self, amount, address):
+        # type: (float, str) -> dict
+        """Withdraw XMR to an external Monero address.
+
+        Parameters
+        ----------
+        amount : float
+            Amount in XMR.  Converted to string for the API.
+        address : str
+            Destination Monero address.
+
+        Returns
+        -------
+        dict
+            Withdrawal receipt including ``tx_hash``, ``amount``, ``fee``.
+        """
+        payload = {
+            "amount": str(amount),
+            "address": address,
+        }
+        return self._raw_post("/v2/balance/withdraw", json_body=payload)
+
+    def payment_history(self, direction=None, limit=50):
+        # type: (str, int) -> list
+        """Retrieve payment history.
+
+        Parameters
+        ----------
+        direction : str, optional
+            ``"in"`` for received, ``"out"`` for sent, or ``None`` for both.
+        limit : int
+            Maximum number of records (default 50).
+
+        Returns
+        -------
+        list
+            List of payment record dicts.
+        """
+        params = {"limit": limit}
+        if direction is not None:
+            params["direction"] = direction
+
+        data = self._raw_get("/v2/payments/history", params=params)
+
+        if isinstance(data, list):
+            return data
+        if isinstance(data, dict) and "payments" in data:
+            return data["payments"]
+        return data

sthrip-0.1.0/sthrip/exceptions.py

@@ -0,0 +1,63 @@
+"""Typed exceptions for Sthrip SDK.
+
+All exceptions carry ``status_code`` and ``detail`` so callers can
+inspect the failure programmatically without parsing strings.
+"""
+
+
+class StrhipError(Exception):
+    """Base exception for every Sthrip SDK error."""
+
+    def __init__(self, detail, status_code=None):
+        # type: (str, int) -> None
+        super(StrhipError, self).__init__(detail)
+        self.detail = detail
+        self.status_code = status_code
+
+
+class AuthError(StrhipError):
+    """Raised on 401 Unauthorized or 403 Forbidden."""
+
+    def __init__(self, detail="Authentication failed", status_code=401):
+        # type: (str, int) -> None
+        super(AuthError, self).__init__(detail, status_code)
+
+
+class PaymentError(StrhipError):
+    """Generic payment failure."""
+
+    def __init__(self, detail="Payment failed", status_code=None):
+        # type: (str, int) -> None
+        super(PaymentError, self).__init__(detail, status_code)
+
+
+class InsufficientBalance(PaymentError):
+    """Not enough XMR to complete the payment or withdrawal."""
+
+    def __init__(self, detail="Insufficient balance", status_code=None):
+        # type: (str, int) -> None
+        super(InsufficientBalance, self).__init__(detail, status_code)
+
+
+class AgentNotFound(PaymentError):
+    """Recipient agent does not exist."""
+
+    def __init__(self, detail="Agent not found", status_code=404):
+        # type: (str, int) -> None
+        super(AgentNotFound, self).__init__(detail, status_code)
+
+
+class RateLimitError(StrhipError):
+    """Too many requests (HTTP 429)."""
+
+    def __init__(self, detail="Rate limit exceeded", status_code=429):
+        # type: (str, int) -> None
+        super(RateLimitError, self).__init__(detail, status_code)
+
+
+class NetworkError(StrhipError):
+    """Connection or timeout failure talking to the Sthrip API."""
+
+    def __init__(self, detail="Network error", status_code=None):
+        # type: (str, int) -> None
+        super(NetworkError, self).__init__(detail, status_code)

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

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: sthrip
+Version: 0.1.0
+Summary: Anonymous payments for AI agents
+License: MIT
+Project-URL: Homepage, https://sthrip.dev
+Project-URL: Documentation, https://sthrip-api-production.up.railway.app/docs
+Project-URL: Repository, https://github.com/sthrip/sthrip
+Keywords: payments,ai,agents,monero,anonymous
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# sthrip
+
+> Anonymous payments for AI agents.
+
+[![PyPI version](https://img.shields.io/pypi/v/sthrip)](https://pypi.org/project/sthrip/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Quickstart
+
+```python
+from sthrip import Sthrip
+
+s = Sthrip()               # auto-registers on first use
+s.pay("agent-name", 0.5)   # send 0.5 XMR
+```
+
+## Install
+
+```
+pip install sthrip
+```
+
+## How it works
+
+Agents register and get a unique XMR deposit address. Deposit Monero to the address, then pay other agents through the hub with a single method call. Payments are routed internally -- instant, private, and charged at 0.1% per transaction. The entire system is built on Monero for maximum privacy. No accounts, no KYC, no tracking.
+
+## API Reference
+
+| Method | Description |
+|--------|-------------|
+| `Sthrip()` | Initialize client (auto-registers if no credentials found) |
+| `s.deposit_address()` | Get your XMR deposit address |
+| `s.pay(agent, amount)` | Send payment to another agent |
+| `s.balance()` | Check your current balance |
+| `s.find_agents()` | Discover available agents |
+| `s.me()` | View your agent profile |
+| `s.withdraw(amount, addr)` | Withdraw XMR to an external address |
+| `s.payment_history()` | View transaction history |
+
+## Configuration
+
+| Variable | Purpose |
+|----------|---------|
+| `STHRIP_API_KEY` | API key for authentication |
+| `STHRIP_API_URL` | Custom API URL (optional) |
+
+Credentials are auto-saved to `~/.sthrip/credentials.json` on first registration.
+
+## Fees
+
+- **0.1%** per hub-routed payment
+- No registration fee
+- No deposit fee
+
+## Links
+
+- [Landing page](https://sthrip.dev)
+- [API Docs](https://sthrip-api-production.up.railway.app/docs)
+- [PyPI](https://pypi.org/project/sthrip/)
+
+## License
+
+[MIT](LICENSE)

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

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+sthrip/__init__.py
+sthrip/auth.py
+sthrip/client.py
+sthrip/exceptions.py
+sthrip.egg-info/PKG-INFO
+sthrip.egg-info/SOURCES.txt
+sthrip.egg-info/dependency_links.txt
+sthrip.egg-info/requires.txt
+sthrip.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+requests>=2.25

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

@@ -0,0 +1 @@
+sthrip