agentguard-python-sdk 0.2.0__tar.gz → 0.2.2__tar.gz

agentguard_python_sdk-0.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentGuard Team
+
+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.

{agentguard_python_sdk-0.2.0 → agentguard_python_sdk-0.2.2}/PKG-INFO

@@ -1,16 +1,18 @@
 Metadata-Version: 2.4
 Name: agentguard-python-sdk
-Version: 0.2.0
+Version: 0.2.2
 Summary: A production-grade middleware for AI agents to perform on-chain payments and verifiable consent.
 Author: AgentGuard Team
 License-Expression: MIT
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pydantic-settings>=2.0.0
 Requires-Dist: pynacl>=1.5.0
 Requires-Dist: py-algorand-sdk>=2.0.0
+Dynamic: license-file
 
 # AgentGuard SDK
 
@@ -29,16 +31,40 @@ pip install agentguard-python-sdk
 ```python
 import asyncio
 from agentguard import AgentGuardClient
+from agentguard.types import DelegatedAuthorization, AuthorizationConstraints, NonceContext, AuthorizationMetadata
 
 async def main():
     # 1. Initialize the client
-    async with AgentGuardClient(wallet_address="YOUR_WALLET_ADDRESS") as client:
+    # NOTE: The backend requires a cryptographic signature on `/pay`.
+    # Provide `private_key` as a base64-encoded Algorand private key seed for request signing.
+    async with AgentGuardClient(
+        wallet_address="YOUR_WALLET_ADDRESS",
+        private_key="YOUR_PRIVATE_KEY_B64",
+        backend_url="https://agentguard-backend-9s8j.onrender.com"
+    ) as client:
+        
+        # 1.5 Authorize a capability (LogicSig)
+        auth = DelegatedAuthorization(
+            authorization_id="YOUR_AUTHORIZATION_ID",
+            principal_id="YOUR_WALLET_ADDRESS",
+            logic_sig_b64="YOUR_SIGNED_LOGICSIG_BASE64",
+            constraints=AuthorizationConstraints(
+                max_amount_microalgos=1000000,
+                expires_at_unix=1900000000,
+                max_txns_per_window=10,
+                window_seconds=3600
+            ),
+            nonce_context=NonceContext(lease_strategy="deterministic", scope="session"),
+            metadata=AuthorizationMetadata(created_at=1716000000, sdk_version="0.2.2", delegation_type="LogicSig")
+        )
+        await client.authorize(auth)
         
         # 2. Perform a secure payment (includes automatic DPDP consent hashing)
         receipt = await client.pay_and_fetch(
             resource_url="https://api.stock.com/reliance",
             amount_algo="0.05",
-            purpose="Financial Analysis"
+            purpose="Financial Analysis",
+            authorization_id="YOUR_AUTHORIZATION_ID"
         )
         print(f"Payment Successful! TX ID: {receipt.tx_id}")
 

{agentguard_python_sdk-0.2.0 → agentguard_python_sdk-0.2.2}/README.md

@@ -15,16 +15,40 @@ pip install agentguard-python-sdk
 ```python
 import asyncio
 from agentguard import AgentGuardClient
+from agentguard.types import DelegatedAuthorization, AuthorizationConstraints, NonceContext, AuthorizationMetadata
 
 async def main():
     # 1. Initialize the client
-    async with AgentGuardClient(wallet_address="YOUR_WALLET_ADDRESS") as client:
+    # NOTE: The backend requires a cryptographic signature on `/pay`.
+    # Provide `private_key` as a base64-encoded Algorand private key seed for request signing.
+    async with AgentGuardClient(
+        wallet_address="YOUR_WALLET_ADDRESS",
+        private_key="YOUR_PRIVATE_KEY_B64",
+        backend_url="https://agentguard-backend-9s8j.onrender.com"
+    ) as client:
+        
+        # 1.5 Authorize a capability (LogicSig)
+        auth = DelegatedAuthorization(
+            authorization_id="YOUR_AUTHORIZATION_ID",
+            principal_id="YOUR_WALLET_ADDRESS",
+            logic_sig_b64="YOUR_SIGNED_LOGICSIG_BASE64",
+            constraints=AuthorizationConstraints(
+                max_amount_microalgos=1000000,
+                expires_at_unix=1900000000,
+                max_txns_per_window=10,
+                window_seconds=3600
+            ),
+            nonce_context=NonceContext(lease_strategy="deterministic", scope="session"),
+            metadata=AuthorizationMetadata(created_at=1716000000, sdk_version="0.2.2", delegation_type="LogicSig")
+        )
+        await client.authorize(auth)
         
         # 2. Perform a secure payment (includes automatic DPDP consent hashing)
         receipt = await client.pay_and_fetch(
             resource_url="https://api.stock.com/reliance",
             amount_algo="0.05",
-            purpose="Financial Analysis"
+            purpose="Financial Analysis",
+            authorization_id="YOUR_AUTHORIZATION_ID"
         )
         print(f"Payment Successful! TX ID: {receipt.tx_id}")
 

agentguard_python_sdk-0.2.2/agentguard/__init__.py

@@ -0,0 +1,57 @@
+from .client import AgentGuardClient
+from .config import AgentGuardConfig
+from .errors import (
+    AgentGuardError,
+    ValidationError,
+    TransportError,
+    AuthenticationError,
+    InvalidSignatureError,
+    ExpiredSignatureError,
+    PaymentError,
+    ReplayAttackError,
+    DuplicatePaymentError,
+    BudgetExceededError,
+    VerificationError,
+    SecurityError,
+    UnknownExecutionStateError,
+    AuthorizationRequiredError
+)
+from .types import (
+    AgentGuardReceipt,
+    AuditProof,
+    AuthorizationConstraints,
+    NonceContext,
+    AuthorizationMetadata,
+    DelegatedAuthorization,
+    AuthorizationReceipt,
+    RevocationReceipt
+)
+
+__version__ = "0.2.2"
+
+__all__ = [
+    "AgentGuardClient",
+    "AgentGuardConfig",
+    "AgentGuardError",
+    "ValidationError",
+    "TransportError",
+    "AuthenticationError",
+    "InvalidSignatureError",
+    "ExpiredSignatureError",
+    "PaymentError",
+    "ReplayAttackError",
+    "DuplicatePaymentError",
+    "BudgetExceededError",
+    "VerificationError",
+    "SecurityError",
+    "UnknownExecutionStateError",
+    "AuthorizationRequiredError",
+    "AgentGuardReceipt",
+    "AuditProof",
+    "AuthorizationConstraints",
+    "NonceContext",
+    "AuthorizationMetadata",
+    "DelegatedAuthorization",
+    "AuthorizationReceipt",
+    "RevocationReceipt",
+]

agentguard_python_sdk-0.2.2/agentguard/auth.py

@@ -0,0 +1,20 @@
+import json
+import unicodedata
+import hashlib
+import base64
+import time
+from typing import Dict, Any
+import nacl.signing
+import nacl.encoding
+
+from agentguard_crypto.signing import sign_payload
+
+def sign_request(payload: Any, private_key_b64: str) -> str:
+    """
+    Signs a request using the shared cryptographic source of truth.
+    Payload MUST be a strictly typed canonical model.
+    """
+    if isinstance(payload, dict):
+        raise TypeError("Dictionary payloads are strictly prohibited. You must use a Canonical Payload model.")
+            
+    return sign_payload(payload, private_key_b64)