agent0-sdk 1.2.0__py3-none-any.whl → 1.4.1__py3-none-any.whl

agent0_sdk/core/subgraph_client.py

@@ -53,6 +53,12 @@ class SubgraphClient:
             if ("has no field" in msg and "responseURI" in msg) and ("responseURI" in query):
                 logger.debug("Subgraph schema missing responseURI; retrying query with responseUri")
                 return _do_query(query.replace("responseURI", "responseUri"))
+            # Some deployments still expose `x402support` instead of `x402Support`.
+            if (("has no field" in msg and "x402Support" in msg) or ("Cannot query field" in msg and "x402Support" in msg)) and (
+                "x402Support" in query
+            ):
+                logger.debug("Subgraph schema missing x402Support; retrying query with x402support")
+                return _do_query(query.replace("x402Support", "x402support"))
             # Some deployments don't expose agentWallet fields on AgentRegistrationFile.
             if (
                 "Type `AgentRegistrationFile` has no field `agentWallet`" in msg
@@ -115,7 +121,7 @@ class SubgraphClient:
                 description
                 image
                 active
-                x402support
+                x402Support
                 supportedTrusts
                 mcpEndpoint
                 mcpVersion
@@ -183,7 +189,7 @@ class SubgraphClient:
                 description
                 image
                 active
-                x402support
+                x402Support
                 supportedTrusts
                 mcpEndpoint
                 mcpVersion
@@ -772,7 +778,7 @@ class SubgraphClient:
                     description
                     image
                     active
-                    x402support
+                    x402Support
                     supportedTrusts
                     mcpEndpoint
                     mcpVersion

agent0_sdk/core/transaction_handle.py

@@ -0,0 +1,71 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Callable, Dict, Generic, TypeVar, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .web3_client import Web3Client
+
+T = TypeVar("T")
+
+
+@dataclass
+class TransactionMined(Generic[T]):
+    receipt: Dict[str, Any]
+    result: T
+
+
+class TransactionHandle(Generic[T]):
+    """
+    Transaction lifecycle handle (submitted-by-default).
+
+    - `tx_hash` is available immediately after submission.
+    - `wait_mined` / `wait_confirmed` can be called to await a receipt (and optional confirmations)
+      and produce a domain result.
+    """
+
+    def __init__(
+        self,
+        *,
+        web3_client: Web3Client,
+        tx_hash: str,
+        compute_result: Callable[[Dict[str, Any]], T],
+    ):
+        self.web3_client = web3_client
+        self.tx_hash = tx_hash
+        self._compute_result = compute_result
+        self._memo: Dict[str, TransactionMined[T]] = {}
+
+    def wait_mined(
+        self,
+        *,
+        timeout: int = 60,
+        confirmations: int = 1,
+        throw_on_revert: bool = True,
+    ) -> TransactionMined[T]:
+        key = f"{timeout}:{confirmations}:{int(bool(throw_on_revert))}"
+        existing = self._memo.get(key)
+        if existing is not None:
+            return existing
+
+        receipt = self.web3_client.wait_for_transaction(
+            self.tx_hash,
+            timeout=timeout,
+            confirmations=confirmations,
+            throw_on_revert=throw_on_revert,
+        )
+        result = self._compute_result(receipt)
+        mined = TransactionMined(receipt=receipt, result=result)
+        self._memo[key] = mined
+        return mined
+
+    def wait_confirmed(
+        self,
+        *,
+        timeout: int = 60,
+        confirmations: int = 1,
+        throw_on_revert: bool = True,
+    ) -> TransactionMined[T]:
+        return self.wait_mined(timeout=timeout, confirmations=confirmations, throw_on_revert=throw_on_revert)
+
+

agent0_sdk/core/value_encoding.py

@@ -1,7 +1,7 @@
 """
 Value encoding utilities for ReputationRegistry (Jan 2026).
 
-On-chain representation: (value:int256, valueDecimals:uint8)
+On-chain representation: (value:int128, valueDecimals:uint8)
 Human representation:    value / 10^valueDecimals
 """
 
@@ -17,8 +17,8 @@ logger = logging.getLogger(__name__)
 getcontext().prec = 120
 
 MAX_DECIMALS = 18
-# Solidity constant (raw int256 magnitude)
-MAX_ABS_VALUE_RAW = 10**50
+# Solidity constant (raw int128 magnitude). Contract enforces abs(value) <= 1e38.
+MAX_ABS_VALUE_RAW = 10**38
 
 
 def encode_feedback_value(input_value: Union[int, float, str, Decimal]) -> Tuple[int, int, str]:

agent0_sdk/core/web3_client.py

@@ -5,6 +5,7 @@ Web3 integration layer for smart contract interactions.
 from __future__ import annotations
 
 import json
+import time
 from typing import Any, Dict, List, Optional, Tuple, Union, Callable
 
 try:
@@ -99,9 +100,48 @@ class Web3Client:
         
         return tx_hash.hex()
 
-    def wait_for_transaction(self, tx_hash: str, timeout: int = 60) -> Dict[str, Any]:
-        """Wait for transaction to be mined."""
-        return self.w3.eth.wait_for_transaction_receipt(tx_hash, timeout=timeout)
+    def wait_for_transaction(
+        self,
+        tx_hash: str,
+        timeout: int = 60,
+        confirmations: int = 1,
+        throw_on_revert: bool = True,
+    ) -> Dict[str, Any]:
+        """Wait for transaction to be mined, optionally waiting for additional confirmations."""
+        if confirmations < 1:
+            raise ValueError("confirmations must be >= 1")
+
+        start = time.time()
+        receipt = self.w3.eth.wait_for_transaction_receipt(tx_hash, timeout=timeout)
+
+        if throw_on_revert:
+            status = receipt.get("status")
+            # Most chains return 1 for success, 0 for revert (may be int or HexBytes-like).
+            try:
+                status_int = int(status)
+            except Exception:
+                try:
+                    status_int = int(status.hex(), 16)  # type: ignore[attr-defined]
+                except Exception:
+                    status_int = 1  # if unknown, don't falsely throw
+            if status_int == 0:
+                raise ValueError(f"Transaction reverted: {tx_hash}")
+
+        if confirmations > 1:
+            block_number = receipt.get("blockNumber")
+            if block_number is not None:
+                target_block = int(block_number) + (confirmations - 1)
+                while True:
+                    current = int(self.w3.eth.block_number)
+                    if current >= target_block:
+                        break
+                    if time.time() - start > timeout:
+                        raise TimeoutError(
+                            f"Timed out waiting for confirmations (tx={tx_hash}, confirmations={confirmations})"
+                        )
+                    time.sleep(1.0)
+
+        return receipt
 
     def get_events(
         self,
@@ -209,7 +249,7 @@ class Web3Client:
         verifying_contract: str,
         chain_id: int,
     ) -> Dict[str, Any]:
-        """Build EIP-712 typed data for ERC-8004 IdentityRegistry setAgentWallet.
+        """Build EIP-712 typed data for the agent wallet verification message.
 
         Contract expects:
         - domain: name="ERC8004IdentityRegistry", version="1"

{agent0_sdk-1.2.0.dist-info → agent0_sdk-1.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent0-sdk
-Version: 1.2.0
+Version: 1.4.1
 Summary: Python SDK for agent portability, discovery and trust based on ERC-8004
 Author-email: Agent0 Team <team@ag0.xyz>
 License: MIT License
@@ -158,20 +158,23 @@ agent.setTrust(reputation=True, cryptoEconomic=True)
 agent.setMetadata({"version": "1.0.0", "category": "ai-assistant"})
 agent.setActive(True)
 
-# Register on-chain with IPFS
-agent.registerIPFS()
-print(f"Agent registered: {agent.agentId}")  # e.g., "11155111:123"
-print(f"Agent URI: {agent.agentURI}")  # e.g., "ipfs://Qm..."
+# Register on-chain with IPFS (submitted-by-default)
+reg_tx = agent.registerIPFS()
+reg = reg_tx.wait_confirmed(timeout=180).result
+print(f"Agent registered: {reg.agentId}")  # e.g., "11155111:123"
+print(f"Agent URI: {reg.agentURI}")  # e.g., "ipfs://Qm..."
 
 # (Optional) Change the agent wallet after registration
 # - On mint/registration, `agentWallet` defaults to the current owner address.
 # - Call this only if you want a DIFFERENT wallet (or after a transfer, since the wallet resets to zero).
 # - Transaction is sent by the SDK signer (agent owner), but the signature must be produced by the NEW wallet.
-agent.setAgentWallet(
+wallet_tx = agent.setWallet(
     "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
     chainId=11155111,
     new_wallet_signer=os.getenv("NEW_WALLET_PRIVATE_KEY"),
 )
+if wallet_tx:
+    wallet_tx.wait_confirmed(timeout=180)
 ```
 
 ### 3. Load and Edit Agent
@@ -185,8 +188,9 @@ agent.updateInfo(description="Updated description with new capabilities")
 agent.setMCP("https://new-mcp.example.com/")
 
 # Re-register to update on-chain
-agent.registerIPFS()
-print(f"Updated: {agent.agentURI}")
+update_tx = agent.registerIPFS()
+update = update_tx.wait_confirmed(timeout=180).result
+print(f"Updated: {update.agentURI}")
 ```
 
 ### 4. Search Agents
@@ -214,13 +218,14 @@ agent_summary = sdk.getAgent("11155111:123")
 
 ```python
 # On-chain-only feedback (no off-chain upload, even if IPFS is configured)
-feedback = sdk.giveFeedback(
+tx = sdk.giveFeedback(
     agentId="11155111:123",
     value=85,  # number|string
     tag1="data_analyst",  # Optional: tags are strings
     tag2="finance",
     endpoint="https://example.com/endpoint",  # Optional: saved on-chain
 )
+feedback = tx.wait_confirmed(timeout=180).result
 
 # Rich feedback (optional off-chain file + on-chain fields)
 feedback_file = sdk.prepareFeedbackFile({
@@ -230,7 +235,7 @@ feedback_file = sdk.prepareFeedbackFile({
     "text": "Great agent!",      # Optional
 })
 
-feedback = sdk.giveFeedback(
+tx = sdk.giveFeedback(
     agentId="11155111:123",
     value=85,
     tag1="data_analyst",
@@ -238,6 +243,7 @@ feedback = sdk.giveFeedback(
     endpoint="https://example.com/endpoint",
     feedbackFile=feedback_file,  # If provided, requires IPFS configured
 )
+feedback = tx.wait_confirmed(timeout=180).result
 
 # Search feedback
 results = sdk.searchFeedback(
@@ -247,6 +253,16 @@ results = sdk.searchFeedback(
     maxValue=100
 )
 
+# NEW: Search feedback given by a reviewer wallet (across all agents; subgraph required)
+given = sdk.searchFeedback(
+    reviewers=["0x742d35cc6634c0532925a3b844bc9e7595f0beb7"]
+)
+
+# NEW: Search feedback across multiple agents at once
+multi = sdk.searchFeedback(
+    agents=["11155111:123", "11155111:456", "11155111:789"]
+)
+
 # Get reputation summary
 summary = sdk.getReputationSummary("11155111:123")
 print(f"Average value: {summary['averageValue']}")

agent0_sdk-1.4.1.dist-info/RECORD

@@ -0,0 +1,21 @@
+agent0_sdk/__init__.py,sha256=dz1Rxuq5FoLGuA6F-6O8sopQ8WVVmWjYHLJGwVvrKsY,1102
+agent0_sdk/core/agent.py,sha256=P3AX7zm4G5qkWdTJcjOvR69cCyOovHefbRoKejj6QKY,48062
+agent0_sdk/core/contracts.py,sha256=5AAY0_GCOkw8FL49_dDpGF6TwFk1OCwzFe8Je0jb7Oc,22787
+agent0_sdk/core/endpoint_crawler.py,sha256=QBkFc3tBSQqHj6PtSTZ5D3_HVB00KJZJdxE3uYpI9po,13611
+agent0_sdk/core/feedback_manager.py,sha256=gHCyBYK17Yc5HcxDcbhl_blXYqulYO-7oiEvoPQomms,42585
+agent0_sdk/core/indexer.py,sha256=gz4DDQQcRbe1RQtFSgq4OZLLFwXHFIe4v2-CcpD077A,72661
+agent0_sdk/core/ipfs_client.py,sha256=17XXMpJgLWhcNUSkmduAZt409c8oJXlj9C_eTGVk-Io,14185
+agent0_sdk/core/models.py,sha256=kiCtRm_ORdBph-Ces0HStsY92jnevY5yCpITb0PZErw,12218
+agent0_sdk/core/oasf_validator.py,sha256=ZOtYYzQd7cJj3eJegi7Ch5ydoapJEjaJSxMvwzKSp5o,2980
+agent0_sdk/core/sdk.py,sha256=w1Q6oCrQoXnCd9fgFlz1rOM0P1JbLYWAB8gs1Upz4IU,39510
+agent0_sdk/core/subgraph_client.py,sha256=seEisw__r9nqQl1CgXa5DiUb6EvZ2GG7qS4wQPLILWo,29854
+agent0_sdk/core/transaction_handle.py,sha256=tKo6ny02m3eIeDGo0Wjikf-yUtl_8KYJy5YxFkPvyHo,1958
+agent0_sdk/core/value_encoding.py,sha256=NQUUvjTRAr5Tqj8t4HUGlfhak8VDmB8E5WMlfAqJwVk,3311
+agent0_sdk/core/web3_client.py,sha256=9w5ZgHILteCHSOisae3QluwuIsX3OD-VkoAc01koQWA,13786
+agent0_sdk/taxonomies/all_domains.json,sha256=buM8_6mpY8_AMbBIPzM-gtu14Tl30QDmhuQxxrlJU4c,74625
+agent0_sdk/taxonomies/all_skills.json,sha256=WVsutw3fqoj1jfDPru3CyWTr1kc1a5-EhBOWPfXnEi8,47483
+agent0_sdk-1.4.1.dist-info/licenses/LICENSE,sha256=rhZZbZm_Ovz4Oa9LNQ-ms8a1tA36wWh90ZkC0OR7WMw,1072
+agent0_sdk-1.4.1.dist-info/METADATA,sha256=hUaaBL4JaACaiDuJQIc4UPLklW1aygaH0bo-dY_zbDQ,15179
+agent0_sdk-1.4.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+agent0_sdk-1.4.1.dist-info/top_level.txt,sha256=p4520WUKNfhU0lVWJgkrB_jdeUfvHSY3K18k4oYLNfI,11
+agent0_sdk-1.4.1.dist-info/RECORD,,

{agent0_sdk-1.2.0.dist-info → agent0_sdk-1.4.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

agent0_sdk-1.2.0.dist-info/RECORD

@@ -1,20 +0,0 @@
-agent0_sdk/__init__.py,sha256=whhlT0msNtRmUKzXq97m38li8tjT9LOsJh6qYArYIqY,919
-agent0_sdk/core/agent.py,sha256=NJo0pjigXznP0zDIrpryrL7pMj5bVvZIhfv4abKtUKk,45157
-agent0_sdk/core/contracts.py,sha256=AVho-sfIv1dBY3iF34OVXg-kORoTWpFYlcreR9PUuAo,22398
-agent0_sdk/core/endpoint_crawler.py,sha256=QBkFc3tBSQqHj6PtSTZ5D3_HVB00KJZJdxE3uYpI9po,13611
-agent0_sdk/core/feedback_manager.py,sha256=NmPHGvTdenANGgM4LQHW0kQUoeCN9UtNr7qGfQIQQsw,41115
-agent0_sdk/core/indexer.py,sha256=VJ5_vvmiwkgcj8xbGoyxS0KM_4Nmfofr1IxitZ3A4EQ,70548
-agent0_sdk/core/ipfs_client.py,sha256=17XXMpJgLWhcNUSkmduAZt409c8oJXlj9C_eTGVk-Io,14185
-agent0_sdk/core/models.py,sha256=lZ2VDDEYIdTJccySObaGJ39b1ocQyr5oOAQfhvp6xME,12160
-agent0_sdk/core/oasf_validator.py,sha256=ZOtYYzQd7cJj3eJegi7Ch5ydoapJEjaJSxMvwzKSp5o,2980
-agent0_sdk/core/sdk.py,sha256=8b4bMA57TczbFn2fGeDmW3W8zT6X73c1rV8tDUnNzBs,38241
-agent0_sdk/core/subgraph_client.py,sha256=vnxDtKC40TGVX_L6X_F-0k8S5reQtGj9zUqNocVC66U,29407
-agent0_sdk/core/value_encoding.py,sha256=ahcglBCIsWGQPjFsxFPieOFJ18kCgIU4oGe9UJajiyg,3272
-agent0_sdk/core/web3_client.py,sha256=h7s-Al3E1xfbb3QNcPvmQBotKJRg23Jm9xot4emr-hU,12283
-agent0_sdk/taxonomies/all_domains.json,sha256=buM8_6mpY8_AMbBIPzM-gtu14Tl30QDmhuQxxrlJU4c,74625
-agent0_sdk/taxonomies/all_skills.json,sha256=WVsutw3fqoj1jfDPru3CyWTr1kc1a5-EhBOWPfXnEi8,47483
-agent0_sdk-1.2.0.dist-info/licenses/LICENSE,sha256=rhZZbZm_Ovz4Oa9LNQ-ms8a1tA36wWh90ZkC0OR7WMw,1072
-agent0_sdk-1.2.0.dist-info/METADATA,sha256=S1yRxTmHYHqQpF1XEFnbRU7kfruzFFsT6ViEo3BERxE,14561
-agent0_sdk-1.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-agent0_sdk-1.2.0.dist-info/top_level.txt,sha256=p4520WUKNfhU0lVWJgkrB_jdeUfvHSY3K18k4oYLNfI,11
-agent0_sdk-1.2.0.dist-info/RECORD,,