agent0-sdk 0.2.0__py3-none-any.whl

agent0_sdk/core/web3_client.py

@@ -0,0 +1,192 @@
+"""
+Web3 integration layer for smart contract interactions.
+"""
+
+from __future__ import annotations
+
+import json
+from typing import Any, Dict, List, Optional, Tuple, Union
+
+try:
+    from web3 import Web3
+    from web3.contract import Contract
+    from eth_account import Account
+    from eth_account.signers.base import BaseAccount
+except ImportError:
+    raise ImportError(
+        "Web3 dependencies not installed. Install with: pip install web3 eth-account"
+    )
+
+
+class Web3Client:
+    """Web3 client for interacting with ERC-8004 smart contracts."""
+
+    def __init__(
+        self,
+        rpc_url: str,
+        private_key: Optional[str] = None,
+        account: Optional[BaseAccount] = None,
+    ):
+        """Initialize Web3 client."""
+        self.rpc_url = rpc_url
+        self.w3 = Web3(Web3.HTTPProvider(rpc_url))
+        if not self.w3.is_connected():
+            raise ConnectionError("Failed to connect to Ethereum node")
+        
+        if account:
+            self.account = account
+        elif private_key:
+            self.account = Account.from_key(private_key)
+        else:
+            # Read-only mode - no account
+            self.account = None
+        
+        self.chain_id = self.w3.eth.chain_id
+
+    def get_contract(self, address: str, abi: List[Dict[str, Any]]) -> Contract:
+        """Get contract instance."""
+        return self.w3.eth.contract(address=address, abi=abi)
+
+    def call_contract(
+        self,
+        contract: Contract,
+        method_name: str,
+        *args,
+        **kwargs
+    ) -> Any:
+        """Call a contract method (view/pure)."""
+        method = getattr(contract.functions, method_name)
+        return method(*args, **kwargs).call()
+
+    def transact_contract(
+        self,
+        contract: Contract,
+        method_name: str,
+        *args,
+        gas_limit: Optional[int] = None,
+        gas_price: Optional[int] = None,
+        max_fee_per_gas: Optional[int] = None,
+        max_priority_fee_per_gas: Optional[int] = None,
+        **kwargs
+    ) -> str:
+        """Execute a contract transaction."""
+        if not self.account:
+            raise ValueError("Cannot execute transaction: SDK is in read-only mode. Provide a signer to enable write operations.")
+        
+        method = getattr(contract.functions, method_name)
+        
+        # Build transaction with proper nonce management
+        # Use 'pending' to get the next nonce including pending transactions
+        nonce = self.w3.eth.get_transaction_count(self.account.address, 'pending')
+        tx = method(*args, **kwargs).build_transaction({
+            'from': self.account.address,
+            'nonce': nonce,
+        })
+        
+        # Add gas settings
+        if gas_limit:
+            tx['gas'] = gas_limit
+        if gas_price:
+            tx['gasPrice'] = gas_price
+        if max_fee_per_gas:
+            tx['maxFeePerGas'] = max_fee_per_gas
+        if max_priority_fee_per_gas:
+            tx['maxPriorityFeePerGas'] = max_priority_fee_per_gas
+        
+        # Sign and send
+        signed_tx = self.w3.eth.account.sign_transaction(tx, self.account.key)
+        tx_hash = self.w3.eth.send_raw_transaction(signed_tx.rawTransaction if hasattr(signed_tx, 'rawTransaction') else signed_tx.raw_transaction)
+        
+        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 get_events(
+        self,
+        contract: Contract,
+        event_name: str,
+        from_block: int = 0,
+        to_block: Optional[int] = None,
+        argument_filters: Optional[Dict[str, Any]] = None
+    ) -> List[Dict[str, Any]]:
+        """Get contract events."""
+        if to_block is None:
+            to_block = self.w3.eth.block_number
+        
+        event_filter = contract.events[event_name].create_filter(
+            fromBlock=from_block,
+            toBlock=to_block,
+            argument_filters=argument_filters or {}
+        )
+        
+        return event_filter.get_all_entries()
+
+    def encodeFeedbackAuth(
+        self,
+        agentId: int,
+        clientAddress: str,
+        indexLimit: int,
+        expiry: int,
+        chainId: int,
+        identityRegistry: str,
+        signerAddress: str
+    ) -> bytes:
+        """Encode feedback authorization data."""
+        return self.w3.codec.encode(
+            ['uint256', 'address', 'uint64', 'uint256', 'uint256', 'address', 'address'],
+            [agentId, clientAddress, indexLimit, expiry, chainId, identityRegistry, signerAddress]
+        )
+
+    def signMessage(self, message: bytes) -> bytes:
+        """Sign a message with the account's private key."""
+        # Create a SignableMessage from the raw bytes
+        from eth_account.messages import encode_defunct
+        signableMessage = encode_defunct(message)
+        signedMessage = self.account.sign_message(signableMessage)
+        return signedMessage.signature
+
+    def recoverAddress(self, message: bytes, signature: bytes) -> str:
+        """Recover address from message and signature."""
+        from eth_account.messages import encode_defunct
+        signable_message = encode_defunct(message)
+        return self.w3.eth.account.recover_message(signable_message, signature=signature)
+
+    def keccak256(self, data: bytes) -> bytes:
+        """Compute Keccak-256 hash."""
+        return self.w3.keccak(data)
+
+    def to_checksum_address(self, address: str) -> str:
+        """Convert address to checksum format."""
+        return self.w3.to_checksum_address(address)
+    
+    def normalize_address(self, address: str) -> str:
+        """Normalize address to lowercase for consistent storage and comparison.
+        
+        Ethereum addresses are case-insensitive but EIP-55 checksum addresses
+        use mixed case. For storage and comparison purposes, we normalize to
+        lowercase to avoid case-sensitivity issues.
+        
+        Args:
+            address: Ethereum address (with or without checksum)
+            
+        Returns:
+            Address in lowercase format
+        """
+        # Remove 0x prefix if present, convert to lowercase, re-add prefix
+        if address.startswith("0x") or address.startswith("0X"):
+            return "0x" + address[2:].lower()
+        return address.lower()
+
+    def is_address(self, address: str) -> bool:
+        """Check if string is a valid Ethereum address."""
+        return self.w3.is_address(address)
+
+    def get_balance(self, address: str) -> int:
+        """Get ETH balance of an address."""
+        return self.w3.eth.get_balance(address)
+
+    def get_transaction_count(self, address: str) -> int:
+        """Get transaction count (nonce) of an address."""
+        return self.w3.eth.get_transaction_count(address)

agent0_sdk-0.2.0.dist-info/METADATA

@@ -0,0 +1,308 @@
+Metadata-Version: 2.4
+Name: agent0-sdk
+Version: 0.2.0
+Summary: Python SDK for agent portability, discovery and trust based on ERC-8004
+Author-email: Marco De Rossi <marco.derossi@consensys.net>
+License: MIT License
+        
+        Copyright (c) 2025 Marco De Rossi
+        
+        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.
+        
+        
+Project-URL: Homepage, https://sdk.ag0.xyz
+Project-URL: Repository, https://github.com/agent0lab/agent0-py
+Project-URL: Documentation, https://sdk.ag0.xyz
+Project-URL: Source Code, https://github.com/agent0lab/agent0-py
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: web3>=6.0.0
+Requires-Dist: eth-account>=0.8.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: ipfshttpclient>=0.8.0a2
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: scikit-learn>=1.0.0
+Requires-Dist: sentence-transformers>=2.2.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: asyncio-throttle>=1.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Dynamic: license-file
+
+# Agent0 SDK
+
+Python SDK for agent portability, discovery and trust based on ERC-8004.
+
+Agent0 is the SDK for agentic economies. It enables agents to register, advertise their capabilities and how to communicate with them, and give each other feedback and reputation signals. All this using blockchain infrastructure (ERC-8004) and decentralized storage, enabling permissionless discovery without relying on proprietary catalogues or intermediaries.
+
+## What Does Agent0 SDK Do?
+
+Agent0 SDK v0.2 enables you to:
+
+- **Create and manage agent identities** - Register your AI agent on-chain with a unique identity, configure presentation fields (name, description, image), set wallet addresses, and manage trust models with x402 support
+- **Advertise agent capabilities** - Publish MCP and A2A endpoints, with automated extraction of MCP tools and A2A skills from endpoints
+- **Enable permissionless discovery** - Make your agent discoverable by other agents and platforms using rich search by attributes, capabilities, skills, tools, tasks, and x402 support
+- **Build reputation** - Give and receive feedback, retrieve feedback history, and search agents by reputation with cryptographic authentication
+- **Cross-chain registration** - One-line registration with IPFS nodes, Pinata, Filecoin, or HTTP URIs
+- **Public indexing** - Subgraph indexing both on-chain and IPFS data for fast search and retrieval
+
+## ⚠️ Alpha Release
+
+Agent0 SDK v0.2 is in **alpha** with bugs and is not production ready. We're actively testing and improving it.
+
+**Bug reports & feedback:** GitHub: [Report issues](https://github.com/agent0lab/agent0-py/issues) | Telegram: [@marcoderossi](https://t.me/marcoderossi) | Email: marco.derossi@consensys.net
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8 or higher
+- pip package manager
+- Private key for signing transactions (or run in read-only mode)
+- Access to an Ethereum RPC endpoint (e.g., Alchemy, Infura)
+- (Optional) IPFS provider account (Pinata, Filecoin, or local IPFS node)
+
+### Install from PyPI
+
+```bash
+pip install agent0-sdk
+```
+
+### Install from Source
+
+```bash
+git clone https://github.com/agent0lab/agent0-py.git
+cd agent0-py
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Initialize SDK
+
+```python
+from agent0_sdk import SDK
+import os
+
+# Initialize SDK with IPFS and subgraph
+sdk = SDK(
+    chainId=11155111,  # Ethereum Sepolia testnet
+    rpcUrl=os.getenv("RPC_URL"),
+    signer=os.getenv("PRIVATE_KEY"),
+    ipfs="pinata",  # Options: "pinata", "filecoinPin", "node"
+    pinataJwt=os.getenv("PINATA_JWT")  # For Pinata
+    # Subgraph URL auto-defaults from DEFAULT_SUBGRAPH_URLS
+)
+```
+
+### 2. Create and Register Agent
+
+```python
+# Create agent
+agent = sdk.createAgent(
+    name="My AI Agent",
+    description="An intelligent assistant for various tasks. Skills: data analysis, code generation.",
+    image="https://example.com/agent-image.png"
+)
+
+# Configure endpoints (automatically extracts capabilities)
+agent.setMCP("https://mcp.example.com/")  # Extracts tools, prompts, resources
+agent.setA2A("https://a2a.example.com/agent-card.json")  # Extracts skills
+agent.setENS("myagent.eth")
+
+# Configure wallet and trust
+agent.setAgentWallet("0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", chainId=11155111)
+agent.setTrust(reputation=True, cryptoEconomic=True)
+
+# Add metadata and set status
+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..."
+```
+
+### 3. Load and Edit Agent
+
+```python
+# Load existing agent for editing
+agent = sdk.loadAgent("11155111:123")  # Format: "chainId:agentId"
+
+# Edit agent properties
+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}")
+```
+
+### 4. Search Agents
+
+```python
+# Search by name, capabilities, or attributes
+results = sdk.searchAgents(
+    name="AI",  # Substring search
+    mcpTools=["code_generation"],  # Specific MCP tools
+    a2aSkills=["python"],  # Specific A2A skills
+    active=True,  # Only active agents
+    x402support=True  # Payment support
+)
+
+for agent in results['items']:
+    print(f"{agent.name}: {agent.description}")
+    print(f"  Tools: {agent.mcpTools}")
+    print(f"  Skills: {agent.a2aSkills}")
+
+# Get single agent (read-only, faster)
+agent_summary = sdk.getAgent("11155111:123")
+```
+
+### 5. Give and Retrieve Feedback
+
+```python
+# Prepare feedback (only score is mandatory)
+feedback_file = sdk.prepareFeedback(
+    agentId="11155111:123",
+    score=85,  # 0-100 (mandatory)
+    tags=["data_analyst", "finance"],  # Optional
+    capability="tools",  # Optional: MCP capability
+    name="code_generation",  # Optional: MCP tool name
+    skill="python"  # Optional: A2A skill
+)
+
+# Give feedback
+feedback = sdk.giveFeedback(agentId="11155111:123", feedbackFile=feedback_file)
+
+# Search feedback
+results = sdk.searchFeedback(
+    agentId="11155111:123",
+    capabilities=["tools"],
+    minScore=80,
+    maxScore=100
+)
+
+# Get reputation summary
+summary = sdk.getReputationSummary("11155111:123")
+print(f"Average score: {summary['averageScore']}")
+```
+
+## IPFS Configuration Options
+
+```python
+# Option 1: Filecoin Pin (free for ERC-8004 agents)
+sdk = SDK(
+    chainId=11155111,
+    rpcUrl="...",
+    signer=private_key,
+    ipfs="filecoinPin",
+    filecoinPrivateKey="your-filecoin-private-key"
+)
+
+# Option 2: IPFS Node
+sdk = SDK(
+    chainId=11155111,
+    rpcUrl="...",
+    signer=private_key,
+    ipfs="node",
+    ipfsNodeUrl="https://ipfs.infura.io:5001"
+)
+
+# Option 3: Pinata (free for ERC-8004 agents)
+sdk = SDK(
+    chainId=11155111,
+    rpcUrl="...",
+    signer=private_key,
+    ipfs="pinata",
+    pinataJwt="your-pinata-jwt-token"
+)
+
+# Option 4: HTTP registration (no IPFS)
+sdk = SDK(chainId=11155111, rpcUrl="...", signer=private_key)
+agent.register("https://example.com/agent-registration.json")
+```
+
+## Use Cases
+
+- **Building agent marketplaces** - Create platforms where developers can discover, evaluate, and integrate agents based on their capabilities and reputation
+- **Agent interoperability** - Discover agents by specific capabilities (skills, tools, tasks), evaluate them through reputation signals, and integrate them via standard protocols (MCP/A2A)
+- **Managing agent reputation** - Track agent performance, collect feedback from users and other agents, and build trust signals for your agent ecosystem
+- **Cross-chain agent operations** - Deploy and manage agents across multiple blockchain networks with consistent identity and reputation
+
+## 🚀 Coming Soon
+
+- More chains (currently Ethereum Sepolia only)
+- Support for validations
+- Multi-chain agents search
+- Enhanced x402 payments
+- Semantic/Vectorial search
+- Advanced reputation aggregation
+- Import/Export to centralized catalogues
+
+## Tests
+
+Complete working examples are available in the `tests/` directory:
+
+- `test_registration.py` - Agent registration with HTTP URI
+- `test_registrationIpfs.py` - Agent registration with IPFS
+- `test_feedback.py` - Complete feedback flow with IPFS storage
+- `test_search.py` - Agent search and discovery
+- `test_transfer.py` - Agent ownership transfer
+
+## Documentation
+
+Full documentation is available at [sdk.ag0.xyz](https://sdk.ag0.xyz), including:
+
+- [Installation Guide](https://sdk.ag0.xyz/2-usage/2-1-install/)
+- [Agent Configuration](https://sdk.ag0.xyz/2-usage/2-2-configure-agents/)
+- [Registration](https://sdk.ag0.xyz/2-usage/2-3-registration-ipfs/)
+- [Search](https://sdk.ag0.xyz/2-usage/2-5-search/)
+- [Feedback](https://sdk.ag0.xyz/2-usage/2-6-use-feedback/)
+- [Key Concepts](https://sdk.ag0.xyz/1-welcome/1-2-key-concepts/)
+- [API Reference](https://sdk.ag0.xyz/5-reference/5-1-sdk/)
+
+## License
+
+MIT License - see LICENSE file for details.

agent0_sdk-0.2.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+agent0_sdk/__init__.py,sha256=8afqO4bSRL5QBBIGA3uhvBtbELAlEXBvT3jWMKvYoEs,919
+agent0_sdk/core/agent.py,sha256=RQND8F3Hmmpnt-PqCXBP7T8KfrjTXo0_X2nZoMJh01w,33343
+agent0_sdk/core/contracts.py,sha256=mER1pSae4-fiGBwaVTi7oqJ_QYaDnrtyIF7g6dkdE-0,19889
+agent0_sdk/core/endpoint_crawler.py,sha256=JFLW4-SoQlpyXsUDWeOb6h-u1ilEKNVQF0r6LI-3k68,11026
+agent0_sdk/core/feedback_manager.py,sha256=Z--m_VKP4db0-gaizL_QSe7zKEnID-S1Zqigl2HcrxM,36035
+agent0_sdk/core/indexer.py,sha256=04Iui7BLpp87gy7P585txKLzdRP0fJs7pAVNhvNrTVE,40330
+agent0_sdk/core/ipfs_client.py,sha256=YHZRsgHlxl3bpkaHORunBtVMNEPWKfn_xx92Yi6l1Fk,13907
+agent0_sdk/core/models.py,sha256=tgaixQBcMOJ8V0m_5TY4AQwnQqwGG8Fzf2fzsVmcyIQ,12375
+agent0_sdk/core/sdk.py,sha256=4bq2ooUew39b7Ya9YTtKeCGwQAAnbXpHYUzGSjgDUKU,31570
+agent0_sdk/core/subgraph_client.py,sha256=XXFVFAoHcgEfqxc2w2OksSp8vtbKMtsNIuNbNcNQOzE,27280
+agent0_sdk/core/web3_client.py,sha256=859ntu5dAmNlcJ3YM1w_VV2gI3mpCC9QEr-GN1236zU,6850
+agent0_sdk-0.2.0.dist-info/licenses/LICENSE,sha256=rhZZbZm_Ovz4Oa9LNQ-ms8a1tA36wWh90ZkC0OR7WMw,1072
+tests/__init__.py,sha256=60ffheccPhuMCtwiiKP1X-CJJXKpxJ_Ywa0aXGHR9bY,23
+tests/config.py,sha256=1uePvkLBNubOQsvYkQSno0m007PMD1VACgm33fCYY6s,1429
+tests/conftest.py,sha256=P-HCtVVYwSvscuaJqhrgZcv39XXNnr932ekEamzIqis,589
+tests/test_feedback.py,sha256=7lszWYSmseJE0I4BhKzZdBiIzf2bgpPqZTZvhRrCTjY,14638
+tests/test_models.py,sha256=4HOtzpzm0OHyzf7rDmCvXQuYbMxRyt8AyLAMd-6uqCk,7114
+tests/test_real_public_servers.py,sha256=pCo4aLSCG9qv4D6T7jbyVmP1gt3r1jWxdes6z5XSNhU,3433
+tests/test_registration.py,sha256=pYanDPLAFETIfabBUvO34ZDmyD0Rbcv8vecSfgSrQ70,9542
+tests/test_registrationIpfs.py,sha256=9O3IBiN2CVMKzB19bqb-jN-nhqsN22kQINMpe9THqiI,8400
+tests/test_sdk.py,sha256=CRnCgA7ljyuC7L3MfV1w7dtzZk2FrWqCUX0tu5nnca0,9013
+tests/test_search.py,sha256=YC5Zd0c99JhFoy7POwrUkb36I1Q3S9hJPIQrIZIJCwI,11850
+tests/test_transfer.py,sha256=zRBllpoMs6NhagAmaZWmD4ckbYjSvsSUerBK4oS-HlA,9258
+agent0_sdk-0.2.0.dist-info/METADATA,sha256=dMfSUzU9Y6gtP2gaoBcbnaoT37lm9PQLN0T_n-wA-Lo,11174
+agent0_sdk-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+agent0_sdk-0.2.0.dist-info/top_level.txt,sha256=rgGBfOJlLi1zInQ85jBL2MpDu_ZJNbPjIGz-3Vn5rZs,17
+agent0_sdk-0.2.0.dist-info/RECORD,,

agent0_sdk-0.2.0.dist-info/WHEEL

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

agent0_sdk-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Marco De Rossi
+
+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.
+

agent0_sdk-0.2.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+agent0_sdk
+tests

tests/__init__.py

@@ -0,0 +1 @@
+# Tests for Agent0 SDK

tests/config.py

@@ -0,0 +1,46 @@
+"""
+Shared configuration loader for test examples.
+Loads configuration from environment variables (.env file).
+"""
+
+import os
+from pathlib import Path
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+# Look for .env in parent directory (project root)
+env_path = Path(__file__).parent.parent.parent / ".env"
+load_dotenv(dotenv_path=env_path)
+
+# Chain Configuration
+CHAIN_ID = int(os.getenv("CHAIN_ID", "11155111"))
+RPC_URL = os.getenv(
+    "RPC_URL",
+    "https://eth-sepolia.g.alchemy.com/v2/7nkA4bJ0tKWcl2-5Wn15c5eRdpGZ8DDr"
+)
+AGENT_PRIVATE_KEY = os.getenv("AGENT_PRIVATE_KEY", "")
+
+# IPFS Configuration (Pinata)
+PINATA_JWT = os.getenv("PINATA_JWT", "")
+
+# Subgraph Configuration
+SUBGRAPH_URL = os.getenv(
+    "SUBGRAPH_URL",
+    "https://gateway.thegraph.com/api/00a452ad3cd1900273ea62c1bf283f93/subgraphs/id/6wQRC7geo9XYAhckfmfo8kbMRLeWU8KQd3XsJqFKmZLT"
+)
+
+# Agent ID for testing (can be overridden via env)
+AGENT_ID = os.getenv("AGENT_ID", "11155111:374")
+
+
+def print_config():
+    """Print current configuration (hiding sensitive values)."""
+    print("Configuration:")
+    print(f"  CHAIN_ID: {CHAIN_ID}")
+    print(f"  RPC_URL: {RPC_URL[:50]}...")
+    print(f"  AGENT_PRIVATE_KEY: {'***' if AGENT_PRIVATE_KEY else 'NOT SET'}")
+    print(f"  PINATA_JWT: {'***' if PINATA_JWT else 'NOT SET'}")
+    print(f"  SUBGRAPH_URL: {SUBGRAPH_URL[:50]}...")
+    print(f"  AGENT_ID: {AGENT_ID}")
+    print()
+

tests/conftest.py

@@ -0,0 +1,22 @@
+"""
+Pytest configuration file for Agent0 SDK tests.
+Sets up logging to debug level for agent0_sdk only.
+"""
+
+import logging
+import sys
+
+# Configure logging: root logger at WARNING to suppress noisy dependencies
+logging.basicConfig(
+    level=logging.WARNING,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+    datefmt='%Y-%m-%d %H:%M:%S',
+    handlers=[
+        logging.StreamHandler(sys.stdout)
+    ]
+)
+
+# Set debug level ONLY for agent0_sdk loggers
+logging.getLogger('agent0_sdk').setLevel(logging.DEBUG)
+logging.getLogger('agent0_sdk.core').setLevel(logging.DEBUG)
+