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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentguard-python-sdk
-Version: 0.2.0
+Version: 0.2.1
 Summary: A production-grade middleware for AI agents to perform on-chain payments and verifiable consent.
 Author: AgentGuard Team
 License-Expression: MIT
@@ -32,7 +32,12 @@ from agentguard import AgentGuardClient
 
 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",
+    ) as client:
         
         # 2. Perform a secure payment (includes automatic DPDP consent hashing)
         receipt = await client.pay_and_fetch(

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

@@ -18,7 +18,12 @@ from agentguard import AgentGuardClient
 
 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",
+    ) as client:
         
         # 2. Perform a secure payment (includes automatic DPDP consent hashing)
         receipt = await client.pay_and_fetch(

{agentguard_python_sdk-0.2.0 → agentguard_python_sdk-0.2.1}/agentguard/client.py

@@ -273,9 +273,19 @@ class AgentGuardClient:
                 canonical_json = res_data.get("canonical_json")
                 
                 if not canonical_json and local_proof:
-                    # [Priority 8 BONUS] Reconstruct canonical JSON from raw local proof
+                    # [Priority 8 BONUS] Reconstruct canonical JSON using SHARED SCHEMA BUILDER
+                    from .consent import build_canonical_payload
                     from .auth import canonicalize_payload
-                    canonical_bytes = canonicalize_payload(local_proof)
+                    
+                    canonical_payload = build_canonical_payload(
+                        principal_id=local_proof.get("principal_id", self.wallet_address),
+                        resource_url=local_proof.get("resource_url", ""),
+                        purpose=local_proof.get("purpose", ""),
+                        microalgos=int(local_proof.get("microalgos", 0)),
+                        nonce=local_proof.get("nonce", ""),
+                        timestamp=int(local_proof.get("timestamp", 0))
+                    )
+                    canonical_bytes = canonicalize_payload(canonical_payload)
                     canonical_json = canonical_bytes.decode("utf-8")
                 
                 if not canonical_json:

{agentguard_python_sdk-0.2.0 → agentguard_python_sdk-0.2.1}/agentguard/consent.py

@@ -8,56 +8,36 @@ from typing import Dict, Any
 # Configure logging
 logger = logging.getLogger("agentguard-sdk")
 
-def generate_consent(
+def build_canonical_payload(
     principal_id: str, 
+    resource_url: str, 
     purpose: str, 
-    item: str, 
-    nonce: str, 
     microalgos: int,
-    data_fiduciary: str = "AlgoBharat Agentic Node",
-    timestamp: int = None
+    nonce: str,
+    timestamp: int,
+    data_fiduciary: str = "AlgoBharat Agentic Node"
 ) -> Dict[str, Any]:
     """
-    Creates a user consent object dictionary containing DPDP compliant fields.
-    Includes microalgos (int) and hash_version for future-proofing.
-    
-    Representation Rule:
-    - Internal: microalgos (int) is the single source of truth.
-    - Strings: All metadata is normalized to NFC.
+    SINGLE SOURCE OF TRUTH for the audit payload schema.
+    Guarantees deterministic parity between SDK, Backend, and recovery logic.
     """
-    if timestamp is None:
-        timestamp = int(time.time())
-    
-    # Normalize strings to NFC at the creation boundary
-    consent_obj = {
-        "principal_id": unicodedata.normalize("NFC", principal_id),
+    return {
         "data_fiduciary": unicodedata.normalize("NFC", data_fiduciary),
-        "purpose": unicodedata.normalize("NFC", purpose),
-        "item": unicodedata.normalize("NFC", item),
-        "microalgos": microalgos,
-        "timestamp": timestamp,
+        "hash_version": 2, # Current Refactor Version
+        "item": unicodedata.normalize("NFC", resource_url),
+        "microalgos": int(microalgos),
         "nonce": nonce,
-        "hash_version": 2 # Current Refactor Version
+        "principal_id": unicodedata.normalize("NFC", principal_id),
+        "purpose": unicodedata.normalize("NFC", purpose),
+        "timestamp": int(timestamp)
     }
-    
-    logger.info(f"Generated DPDP consent (v2) for principal={principal_id} at {timestamp}")
-    return consent_obj
 
 def hash_consent(consent: Dict[str, Any]) -> str:
     """
     Canonical hashing implementation.
     MUST REMAINT SYNCED with Backend and MCP Server.
-    
-    Rules:
-    1. sort_keys=True
-    2. separators=(',', ':')
-    3. ensure_ascii=False
-    4. Encoding: utf-8
     """
-    # Convert consent dict to JSON string with strict canonical form:
-    # - Sorted keys
-    # - No spaces (separators=(",", ":"))
-    # Use separators=(",", ":") and ensure_ascii=False for identical bytes across boundaries
+    # Convert consent dict to JSON string with strict canonical form
     consent_json = json.dumps(consent, sort_keys=True, separators=(",", ":"), ensure_ascii=False)
     consent_hash = hashlib.sha256(consent_json.encode("utf-8")).hexdigest()
     
@@ -68,12 +48,15 @@ def generate_consent_proof(principal_id: str, resource_url: str, purpose: str, n
     """
     High-level helper to generate a consent hash and return the timestamp used.
     """
-    consent = generate_consent(
+    if timestamp is None:
+        timestamp = int(time.time())
+    
+    consent = build_canonical_payload(
         principal_id=principal_id,
+        resource_url=resource_url,
         purpose=purpose,
-        item=resource_url,
-        nonce=nonce,
         microalgos=microalgos,
+        nonce=nonce,
         timestamp=timestamp
     )
     return hash_consent(consent), consent["timestamp"]

{agentguard_python_sdk-0.2.0 → agentguard_python_sdk-0.2.1}/agentguard_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentguard-python-sdk
-Version: 0.2.0
+Version: 0.2.1
 Summary: A production-grade middleware for AI agents to perform on-chain payments and verifiable consent.
 Author: AgentGuard Team
 License-Expression: MIT
@@ -32,7 +32,12 @@ from agentguard import AgentGuardClient
 
 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",
+    ) as client:
         
         # 2. Perform a secure payment (includes automatic DPDP consent hashing)
         receipt = await client.pay_and_fetch(

{agentguard_python_sdk-0.2.0 → agentguard_python_sdk-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentguard-python-sdk"
-version = "0.2.0"
+version = "0.2.1"
 description = "A production-grade middleware for AI agents to perform on-chain payments and verifiable consent."
 readme = "README.md"
 requires-python = ">=3.9"