aw-protocol-sdk 0.1.0__tar.gz

aw_protocol_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: aw-protocol-sdk
+Version: 0.1.0
+Summary: Python SDK for AgentWallet Protocol - AI Agent Wallet Infrastructure on Solana
+License-Expression: MIT
+Project-URL: Homepage, https://agentwallet.dev
+Project-URL: Repository, https://github.com/YouthAIAgent/agentwallet
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+
+# aw-protocol-sdk
+
+Python SDK for the AgentWallet Protocol — AI Agent Wallet Infrastructure on Solana.
+
+## Install
+
+```bash
+pip install aw-protocol-sdk
+```
+
+## Quick Start
+
+```python
+from agentwallet import AgentWallet
+
+async with AgentWallet(api_key="aw_live_...") as aw:
+    agent = await aw.agents.create(name="trading-bot")
+    tx = await aw.transactions.transfer_sol(
+        from_wallet=agent["default_wallet_id"],
+        to_address="RecipientPubkey...",
+        amount_sol=0.5,
+    )
+```
+
+## Links
+
+- [GitHub](https://github.com/YouthAIAgent/agentwallet)
+- [API Docs](https://trustworthy-celebration-production-6a3e.up.railway.app/docs)

aw_protocol_sdk-0.1.0/README.md

@@ -0,0 +1,28 @@
+# aw-protocol-sdk
+
+Python SDK for the AgentWallet Protocol — AI Agent Wallet Infrastructure on Solana.
+
+## Install
+
+```bash
+pip install aw-protocol-sdk
+```
+
+## Quick Start
+
+```python
+from agentwallet import AgentWallet
+
+async with AgentWallet(api_key="aw_live_...") as aw:
+    agent = await aw.agents.create(name="trading-bot")
+    tx = await aw.transactions.transfer_sol(
+        from_wallet=agent["default_wallet_id"],
+        to_address="RecipientPubkey...",
+        amount_sol=0.5,
+    )
+```
+
+## Links
+
+- [GitHub](https://github.com/YouthAIAgent/agentwallet)
+- [API Docs](https://trustworthy-celebration-production-6a3e.up.railway.app/docs)

aw_protocol_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "aw-protocol-sdk"
+version = "0.1.0"
+description = "Python SDK for AgentWallet Protocol - AI Agent Wallet Infrastructure on Solana"
+requires-python = ">=3.10"
+dependencies = [
+    "httpx>=0.27",
+]
+readme = "README.md"
+license = "MIT"
+
+[project.urls]
+Homepage = "https://agentwallet.dev"
+Repository = "https://github.com/YouthAIAgent/agentwallet"
+
+[build-system]
+requires = ["setuptools>=70"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

aw_protocol_sdk-0.1.0/setup.cfg

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

aw_protocol_sdk-0.1.0/src/agentwallet/__init__.py

@@ -0,0 +1,21 @@
+"""AgentWallet Python SDK -- AI Agent Wallet Infrastructure on Solana."""
+
+from .client import AgentWallet
+from .exceptions import (
+    AgentWalletAPIError,
+    AuthenticationError,
+    NotFoundError,
+    RateLimitError,
+    ValidationError,
+)
+
+__all__ = [
+    "AgentWallet",
+    "AgentWalletAPIError",
+    "AuthenticationError",
+    "NotFoundError",
+    "RateLimitError",
+    "ValidationError",
+]
+
+__version__ = "0.1.0"

aw_protocol_sdk-0.1.0/src/agentwallet/client.py

@@ -0,0 +1,108 @@
+"""Main AgentWallet SDK client -- Stripe-like interface."""
+
+from __future__ import annotations
+
+import httpx
+
+from .exceptions import (
+    AgentWalletAPIError,
+    AuthenticationError,
+    AuthorizationError,
+    ConflictError,
+    NotFoundError,
+    RateLimitError,
+    ValidationError,
+)
+from .resources.agents import AgentsResource
+from .resources.analytics import AnalyticsResource
+from .resources.escrow import EscrowResource
+from .resources.policies import PoliciesResource
+from .resources.transactions import TransactionsResource
+from .resources.wallets import WalletsResource
+
+DEFAULT_BASE_URL = "http://localhost:8000/v1"
+
+ERROR_MAP = {
+    401: AuthenticationError,
+    403: AuthorizationError,
+    404: NotFoundError,
+    409: ConflictError,
+    422: ValidationError,
+    429: RateLimitError,
+}
+
+
+class AgentWallet:
+    """AgentWallet SDK client.
+
+    Usage:
+        async with AgentWallet(api_key="aw_live_...") as aw:
+            agent = await aw.agents.create(name="trading-bot")
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = 30.0,
+    ):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self._client = httpx.AsyncClient(
+            base_url=self.base_url,
+            headers={"X-API-Key": api_key},
+            timeout=timeout,
+        )
+
+        # Sub-resources
+        self.agents = AgentsResource(self)
+        self.wallets = WalletsResource(self)
+        self.transactions = TransactionsResource(self)
+        self.escrow = EscrowResource(self)
+        self.analytics = AnalyticsResource(self)
+        self.policies = PoliciesResource(self)
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, *args):
+        await self.close()
+
+    async def close(self):
+        await self._client.aclose()
+
+    async def _request(
+        self,
+        method: str,
+        path: str,
+        json: dict | None = None,
+        params: dict | None = None,
+    ) -> dict:
+        """Make an authenticated API request."""
+        resp = await self._client.request(method, path, json=json, params=params)
+
+        if resp.status_code >= 400:
+            body = {}
+            try:
+                body = resp.json()
+            except Exception:
+                pass
+            message = body.get("error", body.get("detail", resp.text))
+            error_cls = ERROR_MAP.get(resp.status_code, AgentWalletAPIError)
+            raise error_cls(resp.status_code, message, body)
+
+        if resp.status_code == 204:
+            return {}
+        return resp.json()
+
+    async def get(self, path: str, params: dict | None = None) -> dict:
+        return await self._request("GET", path, params=params)
+
+    async def post(self, path: str, json: dict | None = None) -> dict:
+        return await self._request("POST", path, json=json)
+
+    async def patch(self, path: str, json: dict | None = None) -> dict:
+        return await self._request("PATCH", path, json=json)
+
+    async def delete(self, path: str) -> dict:
+        return await self._request("DELETE", path)

aw_protocol_sdk-0.1.0/src/agentwallet/exceptions.py

@@ -0,0 +1,39 @@
+"""SDK exception hierarchy."""
+
+
+class AgentWalletAPIError(Exception):
+    """Base error for API responses."""
+
+    def __init__(self, status_code: int, message: str, body: dict | None = None):
+        self.status_code = status_code
+        self.message = message
+        self.body = body or {}
+        super().__init__(f"[{status_code}] {message}")
+
+
+class AuthenticationError(AgentWalletAPIError):
+    """401 Unauthorized."""
+
+
+class AuthorizationError(AgentWalletAPIError):
+    """403 Forbidden."""
+
+
+class NotFoundError(AgentWalletAPIError):
+    """404 Not Found."""
+
+
+class ValidationError(AgentWalletAPIError):
+    """422 Validation Error."""
+
+
+class RateLimitError(AgentWalletAPIError):
+    """429 Too Many Requests."""
+
+    def __init__(self, message: str, retry_after: int = 60):
+        self.retry_after = retry_after
+        super().__init__(429, message)
+
+
+class ConflictError(AgentWalletAPIError):
+    """409 Conflict."""

aw_protocol_sdk-0.1.0/src/agentwallet/resources/agents.py

@@ -0,0 +1,55 @@
+"""Agents sub-resource."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..types import Agent, ListResponse
+
+if TYPE_CHECKING:
+    from ..client import AgentWallet
+
+
+class AgentsResource:
+    def __init__(self, client: AgentWallet):
+        self._client = client
+
+    async def create(
+        self,
+        name: str,
+        description: str | None = None,
+        capabilities: list[str] | None = None,
+        is_public: bool = False,
+        metadata: dict | None = None,
+    ) -> Agent:
+        data = await self._client.post("/agents", json={
+            "name": name,
+            "description": description,
+            "capabilities": capabilities or [],
+            "is_public": is_public,
+            "metadata": metadata or {},
+        })
+        return Agent(**data)
+
+    async def get(self, agent_id: str) -> Agent:
+        data = await self._client.get(f"/agents/{agent_id}")
+        return Agent(**data)
+
+    async def list(
+        self,
+        status: str | None = None,
+        limit: int = 50,
+        offset: int = 0,
+    ) -> ListResponse:
+        params = {"limit": limit, "offset": offset}
+        if status:
+            params["status"] = status
+        data = await self._client.get("/agents", params=params)
+        return ListResponse(
+            data=[Agent(**a) for a in data["data"]],
+            total=data["total"],
+        )
+
+    async def update(self, agent_id: str, **kwargs) -> Agent:
+        data = await self._client.patch(f"/agents/{agent_id}", json=kwargs)
+        return Agent(**data)

aw_protocol_sdk-0.1.0/src/agentwallet/resources/analytics.py

@@ -0,0 +1,30 @@
+"""Analytics sub-resource."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..types import AnalyticsSummary
+
+if TYPE_CHECKING:
+    from ..client import AgentWallet
+
+
+class AnalyticsResource:
+    def __init__(self, client: AgentWallet):
+        self._client = client
+
+    async def summary(self, days: int = 30) -> AnalyticsSummary:
+        data = await self._client.get("/analytics/summary", params={"days": days})
+        return AnalyticsSummary(**data)
+
+    async def daily(
+        self, days: int = 30, agent_id: str | None = None
+    ) -> list[dict]:
+        params = {"days": days}
+        if agent_id:
+            params["agent_id"] = agent_id
+        return await self._client.get("/analytics/daily", params=params)
+
+    async def by_agent(self, days: int = 30) -> list[dict]:
+        return await self._client.get("/analytics/agents", params={"days": days})

aw_protocol_sdk-0.1.0/src/agentwallet/resources/escrow.py

@@ -0,0 +1,74 @@
+"""Escrow sub-resource."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..types import Escrow, ListResponse
+
+if TYPE_CHECKING:
+    from ..client import AgentWallet
+
+
+class EscrowResource:
+    def __init__(self, client: AgentWallet):
+        self._client = client
+
+    async def create(
+        self,
+        funder_wallet: str,
+        recipient_address: str,
+        amount_sol: float,
+        token_mint: str | None = None,
+        arbiter_address: str | None = None,
+        conditions: dict | None = None,
+        expires_in_hours: int = 24,
+    ) -> Escrow:
+        data = await self._client.post("/escrow", json={
+            "funder_wallet_id": funder_wallet,
+            "recipient_address": recipient_address,
+            "amount_sol": amount_sol,
+            "token_mint": token_mint,
+            "arbiter_address": arbiter_address,
+            "conditions": conditions or {},
+            "expires_in_hours": expires_in_hours,
+        })
+        return Escrow(**data)
+
+    async def get(self, escrow_id: str) -> Escrow:
+        data = await self._client.get(f"/escrow/{escrow_id}")
+        return Escrow(**data)
+
+    async def list(
+        self,
+        status: str | None = None,
+        limit: int = 50,
+        offset: int = 0,
+    ) -> ListResponse:
+        params = {"limit": limit, "offset": offset}
+        if status:
+            params["status"] = status
+        data = await self._client.get("/escrow", params=params)
+        return ListResponse(
+            data=[Escrow(**e) for e in data["data"]],
+            total=data["total"],
+        )
+
+    async def release(self, escrow_id: str) -> Escrow:
+        data = await self._client.post(f"/escrow/{escrow_id}/action", json={
+            "action": "release",
+        })
+        return Escrow(**data)
+
+    async def refund(self, escrow_id: str) -> Escrow:
+        data = await self._client.post(f"/escrow/{escrow_id}/action", json={
+            "action": "refund",
+        })
+        return Escrow(**data)
+
+    async def dispute(self, escrow_id: str, reason: str) -> Escrow:
+        data = await self._client.post(f"/escrow/{escrow_id}/action", json={
+            "action": "dispute",
+            "reason": reason,
+        })
+        return Escrow(**data)

aw_protocol_sdk-0.1.0/src/agentwallet/resources/policies.py

@@ -0,0 +1,50 @@
+"""Policies sub-resource."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..types import ListResponse, Policy
+
+if TYPE_CHECKING:
+    from ..client import AgentWallet
+
+
+class PoliciesResource:
+    def __init__(self, client: AgentWallet):
+        self._client = client
+
+    async def create(
+        self,
+        name: str,
+        rules: dict,
+        scope_type: str = "org",
+        scope_id: str | None = None,
+        priority: int = 100,
+    ) -> Policy:
+        data = await self._client.post("/policies", json={
+            "name": name,
+            "rules": rules,
+            "scope_type": scope_type,
+            "scope_id": scope_id,
+            "priority": priority,
+        })
+        return Policy(**data)
+
+    async def get(self, policy_id: str) -> Policy:
+        data = await self._client.get(f"/policies/{policy_id}")
+        return Policy(**data)
+
+    async def list(self, limit: int = 50, offset: int = 0) -> ListResponse:
+        data = await self._client.get("/policies", params={"limit": limit, "offset": offset})
+        return ListResponse(
+            data=[Policy(**p) for p in data["data"]],
+            total=data["total"],
+        )
+
+    async def update(self, policy_id: str, **kwargs) -> Policy:
+        data = await self._client.patch(f"/policies/{policy_id}", json=kwargs)
+        return Policy(**data)
+
+    async def delete(self, policy_id: str) -> None:
+        await self._client.delete(f"/policies/{policy_id}")

aw_protocol_sdk-0.1.0/src/agentwallet/resources/transactions.py

@@ -0,0 +1,65 @@
+"""Transactions sub-resource."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..types import ListResponse, Transaction
+
+if TYPE_CHECKING:
+    from ..client import AgentWallet
+
+
+class TransactionsResource:
+    def __init__(self, client: AgentWallet):
+        self._client = client
+
+    async def transfer_sol(
+        self,
+        from_wallet: str,
+        to_address: str,
+        amount_sol: float,
+        memo: str | None = None,
+        idempotency_key: str | None = None,
+    ) -> Transaction:
+        data = await self._client.post("/transactions/transfer-sol", json={
+            "from_wallet_id": from_wallet,
+            "to_address": to_address,
+            "amount_sol": amount_sol,
+            "memo": memo,
+            "idempotency_key": idempotency_key,
+        })
+        return Transaction(**data)
+
+    async def get(self, tx_id: str) -> Transaction:
+        data = await self._client.get(f"/transactions/{tx_id}")
+        return Transaction(**data)
+
+    async def list(
+        self,
+        agent_id: str | None = None,
+        wallet_id: str | None = None,
+        status: str | None = None,
+        limit: int = 50,
+        offset: int = 0,
+    ) -> ListResponse:
+        params = {"limit": limit, "offset": offset}
+        if agent_id:
+            params["agent_id"] = agent_id
+        if wallet_id:
+            params["wallet_id"] = wallet_id
+        if status:
+            params["status"] = status
+        data = await self._client.get("/transactions", params=params)
+        return ListResponse(
+            data=[Transaction(**t) for t in data["data"]],
+            total=data["total"],
+        )
+
+    async def batch_transfer(
+        self, transfers: list[dict]
+    ) -> list[Transaction]:
+        data = await self._client.post("/transactions/batch-transfer", json={
+            "transfers": transfers,
+        })
+        return [Transaction(**t) for t in data]

aw_protocol_sdk-0.1.0/src/agentwallet/resources/wallets.py

@@ -0,0 +1,54 @@
+"""Wallets sub-resource."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from ..types import ListResponse, Wallet, WalletBalance
+
+if TYPE_CHECKING:
+    from ..client import AgentWallet
+
+
+class WalletsResource:
+    def __init__(self, client: AgentWallet):
+        self._client = client
+
+    async def create(
+        self,
+        agent_id: str | None = None,
+        wallet_type: str = "agent",
+        label: str | None = None,
+    ) -> Wallet:
+        data = await self._client.post("/wallets", json={
+            "agent_id": agent_id,
+            "wallet_type": wallet_type,
+            "label": label,
+        })
+        return Wallet(**data)
+
+    async def get(self, wallet_id: str) -> Wallet:
+        data = await self._client.get(f"/wallets/{wallet_id}")
+        return Wallet(**data)
+
+    async def list(
+        self,
+        agent_id: str | None = None,
+        wallet_type: str | None = None,
+        limit: int = 50,
+        offset: int = 0,
+    ) -> ListResponse:
+        params = {"limit": limit, "offset": offset}
+        if agent_id:
+            params["agent_id"] = agent_id
+        if wallet_type:
+            params["wallet_type"] = wallet_type
+        data = await self._client.get("/wallets", params=params)
+        return ListResponse(
+            data=[Wallet(**w) for w in data["data"]],
+            total=data["total"],
+        )
+
+    async def get_balance(self, wallet_id: str) -> WalletBalance:
+        data = await self._client.get(f"/wallets/{wallet_id}/balance")
+        return WalletBalance(**data)

aw_protocol_sdk-0.1.0/src/agentwallet/types.py

@@ -0,0 +1,114 @@
+"""Response types as dataclasses."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class Agent:
+    id: str
+    org_id: str
+    name: str
+    description: str | None
+    status: str
+    capabilities: list[str]
+    default_wallet_id: str | None
+    reputation_score: float
+    is_public: bool
+    created_at: str
+    updated_at: str
+
+
+@dataclass
+class Wallet:
+    id: str
+    org_id: str
+    agent_id: str | None
+    address: str
+    wallet_type: str
+    label: str | None
+    is_active: bool
+    created_at: str
+
+
+@dataclass
+class WalletBalance:
+    address: str
+    sol_balance: float
+    lamports: int
+    tokens: list[dict] = field(default_factory=list)
+
+
+@dataclass
+class Transaction:
+    id: str
+    org_id: str
+    agent_id: str | None
+    wallet_id: str
+    tx_type: str
+    status: str
+    signature: str | None
+    from_address: str
+    to_address: str
+    amount_lamports: int
+    token_mint: str | None
+    platform_fee_lamports: int
+    memo: str | None
+    error: str | None
+    created_at: str
+    confirmed_at: str | None
+
+
+@dataclass
+class Escrow:
+    id: str
+    org_id: str
+    funder_wallet_id: str
+    recipient_address: str
+    arbiter_address: str | None
+    escrow_address: str | None
+    amount_lamports: int
+    token_mint: str | None
+    status: str
+    conditions: dict
+    fund_signature: str | None
+    release_signature: str | None
+    refund_signature: str | None
+    dispute_reason: str | None
+    expires_at: str | None
+    funded_at: str | None
+    completed_at: str | None
+    created_at: str
+
+
+@dataclass
+class Policy:
+    id: str
+    org_id: str
+    name: str
+    rules: dict
+    scope_type: str
+    scope_id: str | None
+    priority: int
+    enabled: bool
+    created_at: str
+    updated_at: str
+
+
+@dataclass
+class ListResponse:
+    data: list
+    total: int
+
+
+@dataclass
+class AnalyticsSummary:
+    total_spend_lamports: int
+    total_fees_lamports: int
+    tx_count: int
+    failed_tx_count: int
+    active_agents: int
+    unique_destinations: int
+    period_start: str
+    period_end: str

aw_protocol_sdk-0.1.0/src/aw_protocol_sdk.egg-info/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: aw-protocol-sdk
+Version: 0.1.0
+Summary: Python SDK for AgentWallet Protocol - AI Agent Wallet Infrastructure on Solana
+License-Expression: MIT
+Project-URL: Homepage, https://agentwallet.dev
+Project-URL: Repository, https://github.com/YouthAIAgent/agentwallet
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+
+# aw-protocol-sdk
+
+Python SDK for the AgentWallet Protocol — AI Agent Wallet Infrastructure on Solana.
+
+## Install
+
+```bash
+pip install aw-protocol-sdk
+```
+
+## Quick Start
+
+```python
+from agentwallet import AgentWallet
+
+async with AgentWallet(api_key="aw_live_...") as aw:
+    agent = await aw.agents.create(name="trading-bot")
+    tx = await aw.transactions.transfer_sol(
+        from_wallet=agent["default_wallet_id"],
+        to_address="RecipientPubkey...",
+        amount_sol=0.5,
+    )
+```
+
+## Links
+
+- [GitHub](https://github.com/YouthAIAgent/agentwallet)
+- [API Docs](https://trustworthy-celebration-production-6a3e.up.railway.app/docs)

aw_protocol_sdk-0.1.0/src/aw_protocol_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+README.md
+pyproject.toml
+src/agentwallet/__init__.py
+src/agentwallet/client.py
+src/agentwallet/exceptions.py
+src/agentwallet/types.py
+src/agentwallet/resources/__init__.py
+src/agentwallet/resources/agents.py
+src/agentwallet/resources/analytics.py
+src/agentwallet/resources/escrow.py
+src/agentwallet/resources/policies.py
+src/agentwallet/resources/transactions.py
+src/agentwallet/resources/wallets.py
+src/aw_protocol_sdk.egg-info/PKG-INFO
+src/aw_protocol_sdk.egg-info/SOURCES.txt
+src/aw_protocol_sdk.egg-info/dependency_links.txt
+src/aw_protocol_sdk.egg-info/requires.txt
+src/aw_protocol_sdk.egg-info/top_level.txt

aw_protocol_sdk-0.1.0/src/aw_protocol_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aw_protocol_sdk-0.1.0/src/aw_protocol_sdk.egg-info/requires.txt

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

aw_protocol_sdk-0.1.0/src/aw_protocol_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+agentwallet