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

agent0_sdk/__init__.py

@@ -30,7 +30,7 @@ except ImportError:
     Agent = None
     _sdk_available = False
 
-__version__ = "1.0.2"
+__version__ = "1.2.0"
 __all__ = [
     "SDK",
     "Agent",

agent0_sdk/core/contracts.py

@@ -159,7 +159,7 @@ IDENTITY_REGISTRY_ABI = [
             {"internalType": "uint256", "name": "agentId", "type": "uint256"}
         ],
         "name": "getAgentWallet",
-        "outputs": [{"internalType": "address", "name": "", "type": "address"}],
+        "outputs": [{"internalType": "bytes", "name": "", "type": "bytes"}],
         "stateMutability": "view",
         "type": "function"
     },
@@ -175,6 +175,15 @@ IDENTITY_REGISTRY_ABI = [
         "stateMutability": "nonpayable",
         "type": "function"
     },
+    {
+        "inputs": [
+            {"internalType": "uint256", "name": "agentId", "type": "uint256"}
+        ],
+        "name": "unsetAgentWallet",
+        "outputs": [],
+        "stateMutability": "nonpayable",
+        "type": "function"
+    },
     
     # Events
     {
@@ -222,7 +231,8 @@ REPUTATION_REGISTRY_ABI = [
     {
         "inputs": [
             {"internalType": "uint256", "name": "agentId", "type": "uint256"},
-            {"internalType": "uint8", "name": "score", "type": "uint8"},
+            {"internalType": "int256", "name": "value", "type": "int256"},
+            {"internalType": "uint8", "name": "valueDecimals", "type": "uint8"},
             {"internalType": "string", "name": "tag1", "type": "string"},
             {"internalType": "string", "name": "tag2", "type": "string"},
             {"internalType": "string", "name": "endpoint", "type": "string"},
@@ -275,7 +285,8 @@ REPUTATION_REGISTRY_ABI = [
         ],
         "name": "readFeedback",
         "outputs": [
-            {"internalType": "uint8", "name": "score", "type": "uint8"},
+            {"internalType": "int256", "name": "value", "type": "int256"},
+            {"internalType": "uint8", "name": "valueDecimals", "type": "uint8"},
             {"internalType": "string", "name": "tag1", "type": "string"},
             {"internalType": "string", "name": "tag2", "type": "string"},
             {"internalType": "bool", "name": "isRevoked", "type": "bool"}
@@ -293,7 +304,8 @@ REPUTATION_REGISTRY_ABI = [
         "name": "getSummary",
         "outputs": [
             {"internalType": "uint64", "name": "count", "type": "uint64"},
-            {"internalType": "uint8", "name": "averageScore", "type": "uint8"}
+            {"internalType": "int256", "name": "summaryValue", "type": "int256"},
+            {"internalType": "uint8", "name": "summaryValueDecimals", "type": "uint8"}
         ],
         "stateMutability": "view",
         "type": "function"
@@ -308,9 +320,10 @@ REPUTATION_REGISTRY_ABI = [
         ],
         "name": "readAllFeedback",
         "outputs": [
-            {"internalType": "address[]", "name": "clientAddresses", "type": "address[]"},
+            {"internalType": "address[]", "name": "clients", "type": "address[]"},
             {"internalType": "uint64[]", "name": "feedbackIndexes", "type": "uint64[]"},
-            {"internalType": "uint8[]", "name": "scores", "type": "uint8[]"},
+            {"internalType": "int256[]", "name": "values", "type": "int256[]"},
+            {"internalType": "uint8[]", "name": "valueDecimals", "type": "uint8[]"},
             {"internalType": "string[]", "name": "tag1s", "type": "string[]"},
             {"internalType": "string[]", "name": "tag2s", "type": "string[]"},
             {"internalType": "bool[]", "name": "revokedStatuses", "type": "bool[]"}
@@ -345,7 +358,8 @@ REPUTATION_REGISTRY_ABI = [
             {"indexed": True, "internalType": "uint256", "name": "agentId", "type": "uint256"},
             {"indexed": True, "internalType": "address", "name": "clientAddress", "type": "address"},
             {"indexed": False, "internalType": "uint64", "name": "feedbackIndex", "type": "uint64"},
-            {"indexed": False, "internalType": "uint8", "name": "score", "type": "uint8"},
+            {"indexed": False, "internalType": "int256", "name": "value", "type": "int256"},
+            {"indexed": False, "internalType": "uint8", "name": "valueDecimals", "type": "uint8"},
             {"indexed": True, "internalType": "string", "name": "indexedTag1", "type": "string"},
             {"indexed": False, "internalType": "string", "name": "tag1", "type": "string"},
             {"indexed": False, "internalType": "string", "name": "tag2", "type": "string"},

agent0_sdk/core/feedback_manager.py

@@ -16,6 +16,7 @@ from .models import (
 )
 from .web3_client import Web3Client
 from .ipfs_client import IPFSClient
+from .value_encoding import encode_feedback_value, decode_feedback_value
 
 logger = logging.getLogger(__name__)
 
@@ -44,7 +45,7 @@ class FeedbackManager:
         """Prepare an off-chain feedback file payload (no on-chain fields).
         
         This intentionally does NOT attempt to represent on-chain fields like:
-        score/tag1/tag2/endpoint (on-chain value), or registry-derived fields.
+        value/tag1/tag2/endpoint (on-chain value), or registry-derived fields.
         
         It may validate/normalize and remove None values.
         """
@@ -67,7 +68,7 @@ class FeedbackManager:
     def giveFeedback(
         self,
         agentId: AgentId,
-        score: int,
+        value: Union[int, float, str],
         tag1: Optional[str] = None,
         tag2: Optional[str] = None,
         endpoint: Optional[str] = None,
@@ -117,11 +118,7 @@ class FeedbackManager:
         except Exception as e:
             raise ValueError(f"Failed to get feedback index: {e}")
         
-        if score is None:
-            raise ValueError("score is required")
-        if not isinstance(score, int):
-            # Allow numeric strings / floats if passed accidentally
-            score = int(score)
+        value_raw, value_decimals, _normalized = encode_feedback_value(value)
 
         tag1 = tag1 or ""
         tag2 = tag2 or ""
@@ -173,7 +170,8 @@ class FeedbackManager:
                     "agentId",
                     "clientAddress",
                     "createdAt",
-                    "score",
+                    "value",
+                    "valueDecimals",
                     "tag1",
                     "tag2",
                     "endpoint",
@@ -186,7 +184,9 @@ class FeedbackManager:
                     "agentId": tokenId,
                     "clientAddress": f"eip155:{agent_chain_id}:{clientAddress}",
                     "createdAt": created_at,
-                    "score": int(score),
+                    # On-chain fields (store raw+decimals for precision)
+                    "value": str(value_raw),
+                    "valueDecimals": int(value_decimals),
 
                     # OPTIONAL fields that mirror on-chain
                     **({"tag1": tag1} if tag1 else {}),
@@ -206,13 +206,14 @@ class FeedbackManager:
             except Exception as e:
                 raise ValueError(f"Failed to store feedback on IPFS: {e}")
         
-        # Submit to blockchain with new signature: giveFeedback(agentId, score, tag1, tag2, endpoint, feedbackURI, feedbackHash)
+        # Submit to blockchain with new signature: giveFeedback(agentId, value, valueDecimals, tag1, tag2, endpoint, feedbackURI, feedbackHash)
         try:
             txHash = self.web3_client.transact_contract(
                 self.reputation_registry,
                 "giveFeedback",
                 tokenId,
-                score,
+                value_raw,
+                value_decimals,
                 tag1,
                 tag2,
                 endpoint_onchain,
@@ -234,7 +235,7 @@ class FeedbackManager:
             id=feedbackId,
             agentId=agentId,
             reviewer=clientAddress,  # create_id normalizes the ID; reviewer field can remain as-is
-            score=int(score) if score and score > 0 else None,
+            value=decode_feedback_value(value_raw, value_decimals),
             tags=[tag1, tag2] if tag1 or tag2 else [],
             text=ff.get("text"),
             context=ff.get("context"),
@@ -329,7 +330,7 @@ class FeedbackManager:
                 id=Feedback.create_id(agentId, clientAddress, feedbackIndex),  # create_id now normalizes
                 agentId=agentId,
                 reviewer=self.web3_client.normalize_address(clientAddress),  # Also normalize reviewer field
-                score=feedback_data.get('score'),
+                value=float(feedback_data.get("value")) if feedback_data.get("value") is not None else None,
                 tags=tags,
                 text=feedback_file.get('text'),
                 capability=feedback_file.get('capability'),
@@ -377,7 +378,7 @@ class FeedbackManager:
                 feedbackIndex
             )
             
-            score, tag1, tag2, is_revoked = result
+            value_raw, value_decimals, tag1, tag2, is_revoked = result
             
             # Create feedback object (normalize address for consistency)
             normalized_address = self.web3_client.normalize_address(clientAddress)
@@ -394,7 +395,7 @@ class FeedbackManager:
                 id=feedbackId,
                 agentId=agentId,
                 reviewer=normalized_address,
-                score=int(score) if score and score > 0 else None,
+                value=decode_feedback_value(int(value_raw), int(value_decimals)),
                 tags=tags,
                 text=None,  # Not stored on-chain
                 capability=None,  # Not stored on-chain
@@ -418,8 +419,8 @@ class FeedbackManager:
         skills: Optional[List[str]] = None,
         tasks: Optional[List[str]] = None,
         names: Optional[List[str]] = None,
-        minScore: Optional[int] = None,
-        maxScore: Optional[int] = None,
+        minValue: Optional[float] = None,
+        maxValue: Optional[float] = None,
         include_revoked: bool = False,
         first: int = 100,
         skip: int = 0,
@@ -431,14 +432,14 @@ class FeedbackManager:
             # This enables future semantic search capabilities
             return self.indexer.search_feedback(
                 agentId, clientAddresses, tags, capabilities, skills, tasks, names,
-                minScore, maxScore, include_revoked, first, skip
+                minValue, maxValue, include_revoked, first, skip
             )
         
         # Fallback: direct subgraph access (if indexer not available)
         if self.subgraph_client:
             return self._search_feedback_subgraph(
                 agentId, clientAddresses, tags, capabilities, skills, tasks, names,
-                minScore, maxScore, include_revoked, first, skip
+                minValue, maxValue, include_revoked, first, skip
             )
         
         # Fallback to blockchain
@@ -454,7 +455,7 @@ class FeedbackManager:
             tag1_filter = tags[0] if tags else ""
             tag2_filter = tags[1] if tags and len(tags) > 1 else ""
             
-            # Read from blockchain - new signature returns: (clientAddresses, feedbackIndexes, scores, tag1s, tag2s, revokedStatuses)
+            # Read from blockchain - signature returns: (clients, feedbackIndexes, values, valueDecimals, tag1s, tag2s, revokedStatuses)
             result = self.web3_client.call_contract(
                 self.reputation_registry,
                 "readAllFeedback",
@@ -465,7 +466,7 @@ class FeedbackManager:
                 include_revoked
             )
             
-            clients, feedback_indexes, scores, tag1s, tag2s, revoked_statuses = result
+            clients, feedback_indexes, values, value_decimals, tag1s, tag2s, revoked_statuses = result
             
             # Convert to Feedback objects
             feedbacks = []
@@ -484,7 +485,7 @@ class FeedbackManager:
                     id=feedbackId,
                     agentId=agentId,
                     reviewer=clients[i],
-                    score=int(scores[i]) if scores[i] and scores[i] > 0 else None,
+                    value=decode_feedback_value(int(values[i]), int(value_decimals[i])),
                     tags=tags_list,
                     text=None,
                     capability=None,
@@ -511,8 +512,8 @@ class FeedbackManager:
         skills: Optional[List[str]],
         tasks: Optional[List[str]],
         names: Optional[List[str]],
-        minScore: Optional[int],
-        maxScore: Optional[int],
+        minValue: Optional[float],
+        maxValue: Optional[float],
         include_revoked: bool,
         first: int,
         skip: int,
@@ -527,8 +528,8 @@ class FeedbackManager:
             skills=skills,
             tasks=tasks,
             names=names,
-            minScore=minScore,
-            maxScore=maxScore,
+            minValue=minValue,
+            maxValue=maxValue,
             includeRevoked=include_revoked
         )
         
@@ -584,7 +585,7 @@ class FeedbackManager:
                 id=Feedback.create_id(agent_id_str, client_addr, feedback_idx),
                 agentId=agent_id_str,
                 reviewer=client_addr,
-                score=fb_data.get('score'),
+                value=float(fb_data.get("value")) if fb_data.get("value") is not None else None,
                 tags=tags_list,
                 text=feedback_file.get('text'),
                 capability=feedback_file.get('capability'),
@@ -757,14 +758,15 @@ class FeedbackManager:
                 tag2_str
             )
             
-            count, average_score = result
+            count, summary_value, summary_value_decimals = result
+            average_value = decode_feedback_value(int(summary_value), int(summary_value_decimals))
             
             # If no grouping requested, return simple summary
             if not groupBy:
                 return {
                     "agentId": agentId,
                     "count": count,
-                    "averageScore": float(average_score) / 100.0 if average_score > 0 else 0.0,
+                    "averageValue": average_value,
                     "filters": {
                         "clientAddresses": clientAddresses,
                         "tag1": tag1,
@@ -786,7 +788,7 @@ class FeedbackManager:
             return {
                 "agentId": agentId,
                 "totalCount": count,
-                "totalAverageScore": float(average_score) / 100.0 if average_score > 0 else 0.0,
+                "totalAverageValue": average_value,
                 "groupedData": grouped_data,
                 "filters": {
                     "clientAddresses": clientAddresses,
@@ -828,15 +830,15 @@ class FeedbackManager:
         
         # Calculate summary statistics
         count = len(all_feedback)
-        scores = [fb.score for fb in all_feedback if fb.score is not None]
-        average_score = sum(scores) / len(scores) if scores else 0.0
+        values = [fb.value for fb in all_feedback if fb.value is not None]
+        average_value = sum(values) / len(values) if values else 0.0
         
         # If no grouping requested, return simple summary
         if not groupBy:
             return {
                 "agentId": agentId,
                 "count": count,
-                "averageScore": average_score,
+                "averageValue": average_value,
                 "filters": {
                     "clientAddresses": clientAddresses,
                     "tag1": tag1,
@@ -850,7 +852,7 @@ class FeedbackManager:
         return {
             "agentId": agentId,
             "totalCount": count,
-            "totalAverageScore": average_score,
+            "totalAverageValue": average_value,
             "groupedData": grouped_data,
             "filters": {
                 "clientAddresses": clientAddresses,
@@ -871,23 +873,23 @@ class FeedbackManager:
             if group_key not in grouped:
                 grouped[group_key] = {
                     "count": 0,
-                    "totalScore": 0.0,
-                    "averageScore": 0.0,
-                    "scores": [],
+                    "totalValue": 0.0,
+                    "averageValue": 0.0,
+                    "values": [],
                     "feedback": []
                 }
             
             # Add feedback to group
             grouped[group_key]["count"] += 1
-            if feedback.score is not None:
-                grouped[group_key]["totalScore"] += feedback.score
-                grouped[group_key]["scores"].append(feedback.score)
+            if feedback.value is not None:
+                grouped[group_key]["totalValue"] += float(feedback.value)
+                grouped[group_key]["values"].append(float(feedback.value))
             grouped[group_key]["feedback"].append(feedback)
         
         # Calculate averages for each group
         for group_data in grouped.values():
             if group_data["count"] > 0:
-                group_data["averageScore"] = group_data["totalScore"] / group_data["count"]
+                group_data["averageValue"] = group_data["totalValue"] / group_data["count"]
         
         return grouped
     

agent0_sdk/core/indexer.py

@@ -87,7 +87,7 @@ class AgentIndexer:
     def _create_default_embeddings(self):
         """Create default embeddings model."""
         try:
-            from sentence_transformers import SentenceTransformer
+            from sentence_transformers import SentenceTransformer  # type: ignore[import-not-found]
             return SentenceTransformer('all-MiniLM-L6-v2')
         except ImportError:
             # Return None if sentence-transformers is not available
@@ -260,7 +260,7 @@ class AgentIndexer:
             raise ValueError(f"Failed to get agent data: {e}")
 
         # Load registration file
-        registration_data = await self._load_registration_data(token_uri)
+        registration_data = await self._load_registration_data(agent_uri)
         
         # Create agent summary
         summary = self._create_agent_summary(
@@ -1082,7 +1082,7 @@ class AgentIndexer:
             id=Feedback.create_id(agentId, clientAddress, feedbackIndex),
             agentId=agentId,
             reviewer=self.web3_client.normalize_address(clientAddress),
-            score=feedback_data.get('score'),
+            value=float(feedback_data.get("value")) if feedback_data.get("value") is not None else None,
             tags=tags,
             text=feedback_file.get('text'),
             capability=feedback_file.get('capability'),
@@ -1113,8 +1113,8 @@ class AgentIndexer:
         skills: Optional[List[str]] = None,
         tasks: Optional[List[str]] = None,
         names: Optional[List[str]] = None,
-        minScore: Optional[int] = None,
-        maxScore: Optional[int] = None,
+        minValue: Optional[float] = None,
+        maxValue: Optional[float] = None,
         include_revoked: bool = False,
         first: int = 100,
         skip: int = 0,
@@ -1140,7 +1140,7 @@ class AgentIndexer:
         if subgraph_client:
             return self._search_feedback_subgraph(
                 full_agent_id, clientAddresses, tags, capabilities, skills, tasks, names,
-                minScore, maxScore, include_revoked, first, skip, subgraph_client
+                minValue, maxValue, include_revoked, first, skip, subgraph_client
             )
         
         # Fallback not implemented (would require blockchain queries)
@@ -1156,8 +1156,8 @@ class AgentIndexer:
         skills: Optional[List[str]],
         tasks: Optional[List[str]],
         names: Optional[List[str]],
-        minScore: Optional[int],
-        maxScore: Optional[int],
+        minValue: Optional[float],
+        maxValue: Optional[float],
         include_revoked: bool,
         first: int,
         skip: int,
@@ -1178,8 +1178,8 @@ class AgentIndexer:
             skills=skills,
             tasks=tasks,
             names=names,
-            minScore=minScore,
-            maxScore=maxScore,
+            minValue=minValue,
+            maxValue=maxValue,
             includeRevoked=include_revoked
         )
         
@@ -1665,7 +1665,7 @@ class AgentIndexer:
         - updatedAt (timestamp)
         - totalFeedback (count)
         - name (alphabetical)
-        - averageScore (reputation, if available)
+        - averageValue (reputation, if available)
         """
         if not sort or len(sort) == 0:
             # Default: sort by createdAt descending (newest first)
@@ -1700,9 +1700,9 @@ class AgentIndexer:
                 reg_file = agent.get('registrationFile', {})
                 return reg_file.get('name', '').lower()
 
-            elif field == 'averageScore':
-                # If reputation search was done, averageScore may be available
-                return agent.get('averageScore', 0)
+            elif field == 'averageValue':
+                # If reputation search was done, averageValue may be available
+                return agent.get('averageValue', 0)
 
             else:
                 logger.warning(f"Unknown sort field: {field}, defaulting to createdAt")

agent0_sdk/core/models.py

@@ -185,7 +185,9 @@ class Feedback:
     id: tuple  # (agentId, clientAddress, feedbackIndex) - tuple for efficiency
     agentId: AgentId
     reviewer: Address
-    score: Optional[int]  # 0-100
+    # ReputationRegistry Jan 2026: decimal value computed as (value:int256 / 10^valueDecimals).
+    # SDK exposes ONLY the computed value.
+    value: Optional[float]
     tags: List[str] = field(default_factory=list)
     text: Optional[str] = None
     context: Optional[Dict[str, Any]] = None
@@ -291,8 +293,8 @@ class SearchFeedbackParams:
     tasks: Optional[List[str]] = None
     names: Optional[List[str]] = None  # MCP tool/resource/prompt names
     endpoint: Optional[str] = None  # Filter by endpoint URI
-    minScore: Optional[int] = None  # 0-100
-    maxScore: Optional[int] = None  # 0-100
+    minValue: Optional[float] = None
+    maxValue: Optional[float] = None
     includeRevoked: bool = False
     
     def to_dict(self) -> Dict[str, Any]:

agent0_sdk/core/sdk.py

@@ -502,7 +502,7 @@ class SDK:
         skills: Optional[List[str]] = None,
         tasks: Optional[List[str]] = None,
         names: Optional[List[str]] = None,
-        minAverageScore: Optional[int] = None,  # 0-100
+        minAverageValue: Optional[float] = None,
         includeRevoked: bool = False,
         page_size: int = 50,
         cursor: Optional[str] = None,
@@ -522,7 +522,7 @@ class SDK:
                     return asyncio.run(
                         self._search_agents_by_reputation_across_chains(
                             agents, tags, reviewers, capabilities, skills, tasks, names,
-                            minAverageScore, includeRevoked, page_size, cursor, sort, chains
+                            minAverageValue, includeRevoked, page_size, cursor, sort, chains
                         )
                     )
         
@@ -556,7 +556,7 @@ class SDK:
                 skills=skills,
                 tasks=tasks,
                 names=names,
-                minAverageScore=minAverageScore,
+                minAverageValue=minAverageValue,
                 includeRevoked=includeRevoked,
                 first=page_size,
                 skip=skip,
@@ -591,7 +591,7 @@ class SDK:
                     mcpResources=reg_file.get('mcpResources', []),
                     active=reg_file.get('active', True),
                     x402support=reg_file.get('x402support', False),
-                    extras={'averageScore': agent_data.get('averageScore')}
+                    extras={'averageValue': agent_data.get('averageValue')}
                 )
                 results.append(agent_summary)
             
@@ -610,7 +610,7 @@ class SDK:
         skills: Optional[List[str]],
         tasks: Optional[List[str]],
         names: Optional[List[str]],
-        minAverageScore: Optional[int],
+        minAverageValue: Optional[float],
         includeRevoked: bool,
         page_size: int,
         cursor: Optional[str],
@@ -668,7 +668,7 @@ class SDK:
                         skills=skills,
                         tasks=tasks,
                         names=names,
-                        minAverageScore=minAverageScore,
+                        minAverageValue=minAverageValue,
                         includeRevoked=includeRevoked,
                         first=page_size * 3,  # Fetch extra to allow for filtering/sorting
                         skip=0,  # We'll handle pagination after aggregation
@@ -748,14 +748,14 @@ class SDK:
                 mcpResources=reg_file.get('mcpResources', []),
                 active=reg_file.get('active', True),
                 x402support=reg_file.get('x402support', False),
-                extras={'averageScore': agent_data.get('averageScore')}
+                extras={'averageValue': agent_data.get('averageValue')}
             )
             results.append(agent_summary)
         
-        # Sort by averageScore (descending) if available, otherwise by createdAt
+        # Sort by averageValue (descending) if available, otherwise by createdAt
         results.sort(
             key=lambda x: (
-                x.extras.get('averageScore') if x.extras.get('averageScore') is not None else 0,
+                x.extras.get('averageValue') if x.extras.get('averageValue') is not None else 0,
                 x.chainId,
                 x.agentId
             ),
@@ -785,14 +785,14 @@ class SDK:
         """Prepare an off-chain feedback file payload.
         
         This is intentionally off-chain-only; it does not attempt to represent
-        the on-chain fields (score/tag1/tag2/endpoint-on-chain).
+        the on-chain fields (value/tag1/tag2/endpoint-on-chain).
         """
         return self.feedback_manager.prepareFeedbackFile(input)
     
     def giveFeedback(
         self,
         agentId: "AgentId",
-        score: int,
+        value: Union[int, float, str],
         tag1: Optional[str] = None,
         tag2: Optional[str] = None,
         endpoint: Optional[str] = None,
@@ -805,7 +805,7 @@ class SDK:
         """
         return self.feedback_manager.giveFeedback(
             agentId=agentId,
-            score=score,
+            value=value,
             tag1=tag1,
             tag2=tag2,
             endpoint=endpoint,
@@ -832,8 +832,8 @@ class SDK:
         skills: Optional[List[str]] = None,
         tasks: Optional[List[str]] = None,
         names: Optional[List[str]] = None,
-        minScore: Optional[int] = None,
-        maxScore: Optional[int] = None,
+        minValue: Optional[float] = None,
+        maxValue: Optional[float] = None,
         include_revoked: bool = False,
         first: int = 100,
         skip: int = 0,
@@ -847,8 +847,8 @@ class SDK:
             skills=skills,
             tasks=tasks,
             names=names,
-            minScore=minScore,
-            maxScore=maxScore,
+            minValue=minValue,
+            maxValue=maxValue,
             include_revoked=include_revoked,
             first=first,
             skip=skip,

agent0_sdk/core/subgraph_client.py

@@ -260,7 +260,7 @@ class SubgraphClient:
                     orderDirection: desc
                 ) {{
                     id
-                    score
+                    value
                     feedbackIndex
                     tag1
                     tag2
@@ -326,8 +326,7 @@ class SubgraphClient:
                     agentId
                 }}
                 totalFeedback
-                averageScore
-                scoreDistribution
+                averageFeedbackValue
                 totalValidations
                 completedValidations
                 averageValidationScore
@@ -416,7 +415,7 @@ class SubgraphClient:
                 agent { id agentId chainId }
                 clientAddress
                 feedbackIndex
-                score
+                value
                 tag1
                 tag2
                 endpoint
@@ -516,11 +515,11 @@ class SubgraphClient:
             # Join all tag alternatives (each already contains complete filter set)
             tag_filter_condition = ", ".join([f"{{ {item} }}" for item in tag_where_items])
         
-        if params.minScore is not None:
-            where_conditions.append(f'score_gte: {params.minScore}')
+        if params.minValue is not None:
+            where_conditions.append(f'value_gte: "{params.minValue}"')
         
-        if params.maxScore is not None:
-            where_conditions.append(f'score_lte: {params.maxScore}')
+        if params.maxValue is not None:
+            where_conditions.append(f'value_lte: "{params.maxValue}"')
         
         # Feedback file filters
         feedback_file_filters = []
@@ -566,7 +565,7 @@ class SubgraphClient:
                 agent {{ id agentId chainId }}
                 clientAddress
                 feedbackIndex
-                score
+                value
                 tag1
                 tag2
                 endpoint
@@ -616,7 +615,7 @@ class SubgraphClient:
         skills: Optional[List[str]] = None,
         tasks: Optional[List[str]] = None,
         names: Optional[List[str]] = None,
-        minAverageScore: Optional[int] = None,  # 0-100
+        minAverageValue: Optional[float] = None,
         includeRevoked: bool = False,
         first: int = 100,
         skip: int = 0,
@@ -633,7 +632,7 @@ class SubgraphClient:
             capabilities: List of capabilities to filter feedback by
             skills: List of skills to filter feedback by
             tasks: List of tasks to filter feedback by
-            minAverageScore: Minimum average score (0-100) for included agents
+            minAverageValue: Minimum average value for included agents
             includeRevoked: Whether to include revoked feedback in calculations
             first: Number of results to return
             skip: Number of results to skip
@@ -641,7 +640,7 @@ class SubgraphClient:
             order_direction: Sort direction (asc/desc)
             
         Returns:
-            List of agents with averageScore field calculated from filtered feedback
+            List of agents with averageValue field calculated from filtered feedback
         """
         # Build feedback filter
         feedback_filters = []
@@ -790,7 +789,7 @@ class SubgraphClient:
                     createdAt
                 }}
                 feedback(where: {feedback_where_for_agents}) {{
-                    score
+                    value
                     isRevoked
                     feedbackFile {{
                         capability
@@ -813,37 +812,33 @@ class SubgraphClient:
             
             agents_result = result.get('agents', [])
             
-            # Calculate average scores
+            # Calculate average values
             for agent in agents_result:
                 feedbacks = agent.get('feedback', [])
                 if feedbacks:
-                    scores = [int(fb['score']) for fb in feedbacks if fb.get('score', 0) > 0]
-                    if scores:
-                        avg_score = sum(scores) / len(scores)
-                        agent['averageScore'] = avg_score
-                    else:
-                        agent['averageScore'] = None
+                    values = [float(fb["value"]) for fb in feedbacks if fb.get("value") is not None]
+                    agent["averageValue"] = (sum(values) / len(values)) if values else None
                 else:
-                    agent['averageScore'] = None
+                    agent["averageValue"] = None
             
-            # Filter by minAverageScore
-            if minAverageScore is not None:
+            # Filter by minAverageValue
+            if minAverageValue is not None:
                 agents_result = [
                     agent for agent in agents_result
-                    if agent.get('averageScore') is not None and agent['averageScore'] >= minAverageScore
+                    if agent.get("averageValue") is not None and agent["averageValue"] >= minAverageValue
                 ]
             
             # For reputation search, filter logic:
-            # - If specific agents were requested, return them even if averageScore is None
+            # - If specific agents were requested, return them even if averageValue is None
             #   (the user explicitly asked for these agents, so return them)
             # - If general search (no specific agents), only return agents with reputation data
             if agents is None or len(agents) == 0:
                 # General search - only return agents with reputation
                 agents_result = [
                     agent for agent in agents_result
-                    if agent.get('averageScore') is not None
+                    if agent.get("averageValue") is not None
                 ]
-            # else: specific agents requested - return all requested agents (even if averageScore is None)
+            # else: specific agents requested - return all requested agents (even if averageValue is None)
             
             return agents_result
             

agent0_sdk/core/value_encoding.py

@@ -0,0 +1,91 @@
+"""
+Value encoding utilities for ReputationRegistry (Jan 2026).
+
+On-chain representation: (value:int256, valueDecimals:uint8)
+Human representation:    value / 10^valueDecimals
+"""
+
+from __future__ import annotations
+
+import logging
+from decimal import Decimal, ROUND_HALF_UP, getcontext
+from typing import Tuple, Union
+
+logger = logging.getLogger(__name__)
+
+# Plenty of headroom for scaling and clamping checks
+getcontext().prec = 120
+
+MAX_DECIMALS = 18
+# Solidity constant (raw int256 magnitude)
+MAX_ABS_VALUE_RAW = 10**50
+
+
+def encode_feedback_value(input_value: Union[int, float, str, Decimal]) -> Tuple[int, int, str]:
+    """
+    Encode a user-facing value into the on-chain (value, valueDecimals) pair.
+
+    Rules:
+    - str: parsed using Decimal (no float casting). If >18 decimals, it is rounded half-up to 18 decimals.
+    - float: accepted and rounded half-up to 18 decimals (never rejected).
+    - int/Decimal: treated similarly; Decimal preserves precision.
+
+    Returns: (value_raw:int, value_decimals:int, normalized:str)
+    """
+    if isinstance(input_value, Decimal):
+        dec = input_value
+        normalized = format(dec, "f")
+    elif isinstance(input_value, int):
+        dec = Decimal(input_value)
+        normalized = str(input_value)
+    elif isinstance(input_value, float):
+        # Avoid binary float artifacts by going through Decimal(str(x)), then quantize to 18 places.
+        dec = Decimal(str(input_value)).quantize(Decimal("1e-18"), rounding=ROUND_HALF_UP)
+        normalized = format(dec, "f")
+    elif isinstance(input_value, str):
+        s = input_value.strip()
+        if s == "":
+            raise ValueError("value cannot be an empty string")
+        dec = Decimal(s)
+        # Expand to plain decimal string (no exponent) for determining decimals
+        normalized = format(dec, "f")
+    else:
+        raise TypeError(f"value must be int|float|str|Decimal, got {type(input_value)}")
+
+    # Determine decimals from the normalized representation.
+    # This preserves trailing zeros for string inputs like "1.2300".
+    if "." in normalized:
+        decimals = len(normalized.split(".", 1)[1])
+    else:
+        decimals = 0
+
+    if decimals > MAX_DECIMALS:
+        dec = dec.quantize(Decimal("1e-18"), rounding=ROUND_HALF_UP)
+        normalized = format(dec, "f")  # keeps fixed 18 decimals
+        decimals = MAX_DECIMALS
+
+    scale = Decimal(10) ** decimals
+    raw_decimal = dec * scale
+    raw_int = int(raw_decimal.to_integral_value(rounding=ROUND_HALF_UP))
+
+    if abs(raw_int) > MAX_ABS_VALUE_RAW:
+        raw_int = MAX_ABS_VALUE_RAW if raw_int > 0 else -MAX_ABS_VALUE_RAW
+        clamped = Decimal(raw_int) / (Decimal(10) ** decimals)
+        normalized = format(clamped, "f")
+        logger.warning(
+            "Feedback value %r exceeds on-chain max magnitude; clamped to %s (decimals=%s)",
+            input_value,
+            normalized,
+            decimals,
+        )
+
+    return raw_int, decimals, normalized
+
+
+def decode_feedback_value(value_raw: int, value_decimals: int) -> float:
+    """Decode (value, valueDecimals) into a Python float."""
+    if value_decimals < 0:
+        raise ValueError("valueDecimals cannot be negative")
+    return float(Decimal(value_raw) / (Decimal(10) ** int(value_decimals)))
+
+

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent0-sdk
-Version: 1.0.2
+Version: 1.2.0
 Summary: Python SDK for agent portability, discovery and trust based on ERC-8004
 Author-email: Agent0 Team <team@ag0.xyz>
 License: MIT License
@@ -216,7 +216,7 @@ agent_summary = sdk.getAgent("11155111:123")
 # On-chain-only feedback (no off-chain upload, even if IPFS is configured)
 feedback = sdk.giveFeedback(
     agentId="11155111:123",
-    score=85,  # 0-100 (mandatory)
+    value=85,  # number|string
     tag1="data_analyst",  # Optional: tags are strings
     tag2="finance",
     endpoint="https://example.com/endpoint",  # Optional: saved on-chain
@@ -232,7 +232,7 @@ feedback_file = sdk.prepareFeedbackFile({
 
 feedback = sdk.giveFeedback(
     agentId="11155111:123",
-    score=85,
+    value=85,
     tag1="data_analyst",
     tag2="finance",
     endpoint="https://example.com/endpoint",
@@ -243,13 +243,13 @@ feedback = sdk.giveFeedback(
 results = sdk.searchFeedback(
     agentId="11155111:123",
     capabilities=["tools"],
-    minScore=80,
-    maxScore=100
+    minValue=80,
+    maxValue=100
 )
 
 # Get reputation summary
 summary = sdk.getReputationSummary("11155111:123")
-print(f"Average score: {summary['averageScore']}")
+print(f"Average value: {summary['averageValue']}")
 ```
 
 ## IPFS Configuration Options

agent0_sdk-1.2.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+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,,

agent0_sdk-1.0.2.dist-info/RECORD

@@ -1,19 +0,0 @@
-agent0_sdk/__init__.py,sha256=qmIKaQIVmgJk0tOa-kGdj0qxdTKdb6msPnrIPX0SO-g,919
-agent0_sdk/core/agent.py,sha256=NJo0pjigXznP0zDIrpryrL7pMj5bVvZIhfv4abKtUKk,45157
-agent0_sdk/core/contracts.py,sha256=N7lN29zgV_sfValX8515OUm1Lvu6O185gK863dFPCj0,21717
-agent0_sdk/core/endpoint_crawler.py,sha256=QBkFc3tBSQqHj6PtSTZ5D3_HVB00KJZJdxE3uYpI9po,13611
-agent0_sdk/core/feedback_manager.py,sha256=RFl9EYa-GtLahYatIzMf-IOO_X3oLTCk5B6UH8CM_Ic,40704
-agent0_sdk/core/indexer.py,sha256=09NhrPM5dxaBWOsVgBwjzJFpg9Bg9hAastc2YQ0UmHM,70447
-agent0_sdk/core/ipfs_client.py,sha256=17XXMpJgLWhcNUSkmduAZt409c8oJXlj9C_eTGVk-Io,14185
-agent0_sdk/core/models.py,sha256=1BSAX2LVbw0kL_qHK7DxBrIFx8PF3wQvzkzblcQTMUg,12042
-agent0_sdk/core/oasf_validator.py,sha256=ZOtYYzQd7cJj3eJegi7Ch5ydoapJEjaJSxMvwzKSp5o,2980
-agent0_sdk/core/sdk.py,sha256=JhYBNj78JxGhPHeOVl9atdxDZqInnGKy2D5DylO4ImU,38223
-agent0_sdk/core/subgraph_client.py,sha256=VSK9gCB5uYc2OqAVQ659IgeF0N-tXwxPUbv7NK8Kz0U,29575
-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.0.2.dist-info/licenses/LICENSE,sha256=rhZZbZm_Ovz4Oa9LNQ-ms8a1tA36wWh90ZkC0OR7WMw,1072
-agent0_sdk-1.0.2.dist-info/METADATA,sha256=llO2PMTI8QMCcz-Lae0EjqlB9gZ6v_gwQfbGhVxnM24,14565
-agent0_sdk-1.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-agent0_sdk-1.0.2.dist-info/top_level.txt,sha256=p4520WUKNfhU0lVWJgkrB_jdeUfvHSY3K18k4oYLNfI,11
-agent0_sdk-1.0.2.dist-info/RECORD,,