agentguard-python-sdk 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

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/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.dist-info → agentguard_python_sdk-0.2.1.dist-info}/METADATA

@@ -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.dist-info → agentguard_python_sdk-0.2.1.dist-info}/RECORD

@@ -1,12 +1,12 @@
 agentguard/__init__.py,sha256=gCRF3pf7qpWf6_VVwgl2X1A4apOSCx7zqd8g2r3fe44,130
 agentguard/auth.py,sha256=PBb7l-x5MGTv_iwilK6LTi5Yhr76qcZL30p1-J80lDg,1720
-agentguard/client.py,sha256=iQW4rseOh2LaRf4SIN4TsBEFepcy4gC7DyLNe4LAmbw,18443
+agentguard/client.py,sha256=fXQKzOinq0731ltx9y5VG9W_5CRGAIvhJqWoVq9w97Q,19063
 agentguard/config.py,sha256=96xRt8FCVoRS1jVzNt4i4hzzP1NorT2NrAWPE_5XbCU,1032
-agentguard/consent.py,sha256=iTVCf4FaFlsJQF0R63HtbgYTtDUPzRCVPULz-cmX2nA,2706
+agentguard/consent.py,sha256=E5Bt7oZyCwSRSNM5RPCdTkkJmhKRKCgLNjro-ZTSCCY,2118
 agentguard/errors.py,sha256=rEFQI4mrbccXRyjVYm_pZwHWr4aolcg8e5KMCIzrOdE,4181
 agentguard/observability.py,sha256=2xSySYDtPhtiNUKXH0zQ0N4WG7j3ssQqPtOBDK6V2EQ,1706
 agentguard/types.py,sha256=HpxtMCzV6x-TIsv99gurLwd53DqtC-ul_IMKPuzps2Y,599
-agentguard_python_sdk-0.2.0.dist-info/METADATA,sha256=T6mwNf3cIpwXBtJVWOgRBeT1IImBMn5CI14uJHA71_I,2544
-agentguard_python_sdk-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-agentguard_python_sdk-0.2.0.dist-info/top_level.txt,sha256=rEW5sAnjxXRs63ja2psmsMRMJJfi_3EAxf7crl1nHyw,11
-agentguard_python_sdk-0.2.0.dist-info/RECORD,,
+agentguard_python_sdk-0.2.1.dist-info/METADATA,sha256=ynHkdnM_o5Jt3rPP3r8larm0H9yVupIix4-6gmZx244,2773
+agentguard_python_sdk-0.2.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+agentguard_python_sdk-0.2.1.dist-info/top_level.txt,sha256=rEW5sAnjxXRs63ja2psmsMRMJJfi_3EAxf7crl1nHyw,11
+agentguard_python_sdk-0.2.1.dist-info/RECORD,,