agirails 2.3.1__tar.gz → 2.3.2__tar.gz

{agirails-2.3.1 → agirails-2.3.2}/.env.example

@@ -8,7 +8,7 @@
 # =============================================================================
 
 # Client wallet (requester) - Your private key for sending transactions
-# Generate a new wallet for testing: https://vanity-eth.tk/
+# Generate a new wallet: use `actp init` or any Ethereum wallet generator
 CLIENT_PRIVATE_KEY=0x_your_client_private_key_here
 
 # Provider wallet - Private key for receiving payments (optional)
@@ -34,17 +34,17 @@ CHAIN_ID=84532
 MOCK_USDC_ADDRESS=0x444b4e1A65949AB2ac75979D5d0166Eb7A248Ccb
 
 # ACTP Kernel contract
-# ACTP_KERNEL_ADDRESS=0xD199070F8e9FB9a127F6Fe730Bc13300B4b3d962
+# ACTP_KERNEL_ADDRESS=0x90a1Bcc218c148F63D036aB2f7B5329C9ee7868d
 
 # Escrow Vault contract
-# ESCROW_VAULT_ADDRESS=0x948b9Ea081C4Cec1E112Af2e539224c531d4d585
+# ESCROW_VAULT_ADDRESS=0xA336967F4481EeE4A8Bb59e35423D273fbf9f5e7
 
 # =============================================================================
 # EAS (Ethereum Attestation Service)
 # =============================================================================
 
 # Delivery proof schema UID on Base Sepolia
-EAS_DELIVERY_SCHEMA_UID=0x1525e033c59c1c34aa5ab5f38fc0524641835476bca08b2e5c5e076b9ba7ed84
+EAS_DELIVERY_SCHEMA_UID=0x1b0ebdf0bd20c28ec9d5362571ce8715a55f46e81c3de2f9b0d8e1b95fb5ffce
 
 # =============================================================================
 # Local Development (Optional)

{agirails-2.3.1 → agirails-2.3.2}/CHANGELOG.md

@@ -90,6 +90,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+> Note: Changelog entries for v2.1.0 through v2.3.1 were not recorded.
+> See git log for detailed changes.
+
 ### Planned for 2.1.0
 - `BlockchainRuntime` - Real blockchain integration
 - CLI tool implementation (`actp` command)

{agirails-2.3.1 → agirails-2.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agirails
-Version: 2.3.1
+Version: 2.3.2
 Summary: AGIRAILS Python SDK - Agent Commerce Transaction Protocol
 Project-URL: Homepage, https://agirails.io
 Project-URL: Documentation, https://docs.agirails.io
@@ -63,12 +63,12 @@ Description-Content-Type: text/markdown
 
 The official Python SDK for the **Agent Commerce Transaction Protocol (ACTP)** — enabling AI agents to transact with each other through blockchain-based escrow on Base L2.
 
-**Full 1:1 parity with TypeScript SDK v2.5.0.**
+**Full 1:1 parity with TypeScript SDK v2.5.0+.**
 
 ## Install
 
 ```bash
-pip install agirails==2.3.0
+pip install agirails==2.3.1
 ```
 
 ## Features
@@ -185,7 +185,7 @@ actp time advance <duration>
 
 ## SDK Parity
 
-Full 1:1 parity with TypeScript SDK v2.5.0:
+Full 1:1 parity with TypeScript SDK v2.5.0+:
 
 | Feature | Python | TypeScript |
 |---------|--------|------------|

{agirails-2.3.1 → agirails-2.3.2}/README.md

@@ -7,12 +7,12 @@
 
 The official Python SDK for the **Agent Commerce Transaction Protocol (ACTP)** — enabling AI agents to transact with each other through blockchain-based escrow on Base L2.
 
-**Full 1:1 parity with TypeScript SDK v2.5.0.**
+**Full 1:1 parity with TypeScript SDK v2.5.0+.**
 
 ## Install
 
 ```bash
-pip install agirails==2.3.0
+pip install agirails==2.3.1
 ```
 
 ## Features
@@ -129,7 +129,7 @@ actp time advance <duration>
 
 ## SDK Parity
 
-Full 1:1 parity with TypeScript SDK v2.5.0:
+Full 1:1 parity with TypeScript SDK v2.5.0+:
 
 | Feature | Python | TypeScript |
 |---------|--------|------------|

{agirails-2.3.1 → agirails-2.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agirails"
-version = "2.3.1"
+version = "2.3.2"
 description = "AGIRAILS Python SDK - Agent Commerce Transaction Protocol"
 readme = "README.md"
 license = "Apache-2.0"
@@ -36,7 +36,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    # Security Note (M-1): Pin upper bounds to prevent breaking changes
+    # Pin upper bounds to prevent breaking changes
     "web3>=7.0.0,<8.0.0",
     "eth-account>=0.13.0,<0.14.0",
     "eth-abi>=5.0.0,<6.0.0",

{agirails-2.3.1 → agirails-2.3.2}/src/agirails/__init__.py

@@ -352,6 +352,32 @@ from agirails.storage import (
     CircuitBreakerConfig,
 )
 
+# Negotiation Module (autonomous buyer-side negotiation)
+from agirails.negotiation import (
+    DEFAULT_WEIGHTS,
+    PolicyEngine,
+    BuyerPolicy,
+    Constraints,
+    MaxUnitPrice,
+    MaxDailySpend,
+    Negotiation,
+    Selection,
+    QuoteOffer,
+    PolicyViolation,
+    PolicyResult,
+    DecisionEngine,
+    ScoringWeights,
+    CandidateStats,
+    ScoredCandidate,
+    ScoreBreakdown,
+    SessionStore,
+    SessionMapping,
+    BuyerOrchestrator,
+    NegotiationResult,
+    RoundResult,
+    OrchestratorConfig,
+)
+
 __all__ = [
     # Version
     "__version__",
@@ -620,4 +646,27 @@ __all__ = [
     "DownloadResult",
     # Types - Circuit Breaker
     "CircuitBreakerConfig",
+    # Negotiation Module
+    "DEFAULT_WEIGHTS",
+    "PolicyEngine",
+    "BuyerPolicy",
+    "Constraints",
+    "MaxUnitPrice",
+    "MaxDailySpend",
+    "Negotiation",
+    "Selection",
+    "QuoteOffer",
+    "PolicyViolation",
+    "PolicyResult",
+    "DecisionEngine",
+    "ScoringWeights",
+    "CandidateStats",
+    "ScoredCandidate",
+    "ScoreBreakdown",
+    "SessionStore",
+    "SessionMapping",
+    "BuyerOrchestrator",
+    "NegotiationResult",
+    "RoundResult",
+    "OrchestratorConfig",
 ]

{agirails-2.3.1 → agirails-2.3.2}/src/agirails/abis/actp_kernel.json

@@ -397,6 +397,16 @@
         "name": "serviceHash",
         "type": "bytes32",
         "internalType": "bytes32"
+      },
+      {
+        "name": "agentId",
+        "type": "uint256",
+        "internalType": "uint256"
+      },
+      {
+        "name": "requesterAgentId",
+        "type": "uint256",
+        "internalType": "uint256"
       }
     ],
     "outputs": [
@@ -553,6 +563,26 @@
             "name": "platformFeeBpsLocked",
             "type": "uint16",
             "internalType": "uint16"
+          },
+          {
+            "name": "agentId",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "requesterAgentId",
+            "type": "uint256",
+            "internalType": "uint256"
+          },
+          {
+            "name": "disputeInitiator",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "disputeBond",
+            "type": "uint256",
+            "internalType": "uint256"
           }
         ]
       }
@@ -1067,10 +1097,10 @@
         "internalType": "address"
       },
       {
-        "name": "disputeId",
-        "type": "bytes32",
+        "name": "bondAmount",
+        "type": "uint256",
         "indexed": false,
-        "internalType": "bytes32"
+        "internalType": "uint256"
       },
       {
         "name": "timestamp",
@@ -1098,10 +1128,22 @@
         "internalType": "bytes32"
       },
       {
-        "name": "resolution",
-        "type": "uint8",
+        "name": "initiator",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "providerAtFault",
+        "type": "bool",
         "indexed": false,
-        "internalType": "uint8"
+        "internalType": "bool"
+      },
+      {
+        "name": "bondAmount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
       },
       {
         "name": "timestamp",
@@ -1594,6 +1636,12 @@
         "type": "uint256",
         "indexed": false,
         "internalType": "uint256"
+      },
+      {
+        "name": "agentId",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
       }
     ],
     "anonymous": false
@@ -1603,6 +1651,55 @@
     "name": "ReentrancyGuardReentrantCall",
     "inputs": []
   },
+  {
+    "type": "function",
+    "name": "acceptQuote",
+    "inputs": [
+      {
+        "name": "transactionId",
+        "type": "bytes32",
+        "internalType": "bytes32"
+      },
+      {
+        "name": "newAmount",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "event",
+    "name": "QuoteAccepted",
+    "inputs": [
+      {
+        "name": "transactionId",
+        "type": "bytes32",
+        "indexed": true,
+        "internalType": "bytes32"
+      },
+      {
+        "name": "oldAmount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "newAmount",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      },
+      {
+        "name": "timestamp",
+        "type": "uint256",
+        "indexed": false,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  },
   {
     "type": "error",
     "name": "SafeERC20FailedOperation",

{agirails-2.3.1 → agirails-2.3.2}/src/agirails/adapters/standard.py

@@ -229,6 +229,27 @@ class StandardAdapter(BaseAdapter):
 
         return tx_id
 
+    async def accept_quote(
+        self,
+        tx_id: str,
+        new_amount: Union[str, int, float],
+    ) -> None:
+        """
+        Accept a provider's quote, updating the transaction amount.
+
+        Does NOT change state (stays QUOTED). After accept_quote, call link_escrow.
+
+        Args:
+            tx_id: Transaction ID
+            new_amount: New amount in user-friendly format ("100", 100.50, "100 USDC")
+
+        Raises:
+            TransactionNotFoundError: If transaction doesn't exist.
+            InvalidStateTransitionError: If not in QUOTED state.
+        """
+        amount_wei = self.parse_amount(new_amount)
+        await self._runtime.accept_quote(tx_id=tx_id, new_amount=amount_wei)
+
     async def link_escrow(self, tx_id: str, amount: Optional[Union[str, int, float]] = None) -> str:
         """
         Link escrow to transaction (locks funds).

agirails-2.3.2/src/agirails/api/__init__.py

@@ -0,0 +1,5 @@
+"""AGIRAILS API clients."""
+
+from agirails.api.discover import discover_agents, DiscoverParams, DiscoverResult, DiscoverAgent
+
+__all__ = ["discover_agents", "DiscoverParams", "DiscoverResult", "DiscoverAgent"]

agirails-2.3.2/src/agirails/api/agirails_app.py

@@ -0,0 +1,236 @@
+"""agirails.app API Client — Profile sync, slug check, claim.
+
+Four functions matching TS src/api/agirailsApp.ts:
+- check_slug: Pre-chain slug availability
+- upsert_agent: Post-publish profile sync (dual auth)
+- get_claim_challenge: Redis challenge generation
+- claim_agent: Ownership verification
+"""
+
+from __future__ import annotations
+
+import json as _json
+import os
+from dataclasses import dataclass
+from typing import Any, Dict, Optional
+
+try:
+    import httpx
+
+    _HAS_HTTPX = True
+except ImportError:
+    _HAS_HTTPX = False
+
+try:
+    import aiohttp
+
+    _HAS_AIOHTTP = True
+except ImportError:
+    _HAS_AIOHTTP = False
+
+
+# ============================================================================
+# Constants
+# ============================================================================
+
+AGIRAILS_APP_BASE_URL = os.environ.get("AGIRAILS_APP_URL", "https://agirails.app")
+
+
+# ============================================================================
+# Types
+# ============================================================================
+
+
+class AgirailsAppError(Exception):
+    """Error from agirails.app API."""
+
+    def __init__(self, message: str, status_code: int = 0):
+        super().__init__(message)
+        self.status_code = status_code
+
+
+@dataclass
+class UpsertAgentParams:
+    """Parameters for upsert_agent (1:1 with TS UpsertAgentParams)."""
+
+    slug: str
+    agent_id: str  # agentId in TS
+    wallet: str
+    config_cid: str  # configCid in TS
+    config_hash: str  # configHash in TS
+    signature: str  # EIP-191 wallet signature
+    message: str  # the signed message
+    timestamp: int  # Unix seconds — part of signed message, server rejects >5min
+    network: str = ""  # Network name (e.g. "base-sepolia") — bound in signed message
+
+    def to_camel_case_dict(self) -> Dict[str, Any]:
+        """Serialize to camelCase keys matching TS API contract."""
+        return {
+            "slug": self.slug,
+            "agentId": self.agent_id,
+            "wallet": self.wallet,
+            "configCid": self.config_cid,
+            "configHash": self.config_hash,
+            "signature": self.signature,
+            "message": self.message,
+            "timestamp": self.timestamp,
+            **({"network": self.network} if self.network else {}),
+        }
+
+
+@dataclass
+class ClaimAgentParams:
+    """Parameters for claim_agent."""
+
+    agent_id: str
+    wallet: str
+    challenge: str
+    signature: str
+
+
+# ============================================================================
+# HTTP Helpers (same fallback pattern as discover.py)
+# ============================================================================
+
+
+async def _get(url: str, timeout: float = 15.0) -> Dict[str, Any]:
+    """HTTP GET with httpx → aiohttp → urllib fallback."""
+    if _HAS_HTTPX:
+        async with httpx.AsyncClient() as client:
+            resp = await client.get(url, headers={"Accept": "application/json"}, timeout=timeout)
+            if resp.status_code >= 400:
+                raise AgirailsAppError(f"GET {url} failed: {resp.status_code}", resp.status_code)
+            return resp.json()
+
+    if _HAS_AIOHTTP:
+        async with aiohttp.ClientSession() as session:
+            async with session.get(url, headers={"Accept": "application/json"}, timeout=aiohttp.ClientTimeout(total=timeout)) as resp:
+                if resp.status >= 400:
+                    raise AgirailsAppError(f"GET {url} failed: {resp.status}", resp.status)
+                return await resp.json()
+
+    from urllib.request import Request, urlopen
+
+    req = Request(url, headers={"Accept": "application/json"})
+    with urlopen(req, timeout=int(timeout)) as resp:
+        if resp.status >= 400:
+            raise AgirailsAppError(f"GET {url} failed: {resp.status}", resp.status)
+        return _json.loads(resp.read().decode("utf-8"))
+
+
+async def _post(url: str, body: Dict[str, Any], timeout: float = 15.0) -> Dict[str, Any]:
+    """HTTP POST with httpx → aiohttp → urllib fallback."""
+    if _HAS_HTTPX:
+        async with httpx.AsyncClient() as client:
+            resp = await client.post(
+                url,
+                json=body,
+                headers={"Content-Type": "application/json", "Accept": "application/json"},
+                timeout=timeout,
+            )
+            if resp.status_code >= 400:
+                raise AgirailsAppError(f"POST {url} failed: {resp.status_code}", resp.status_code)
+            return resp.json()
+
+    if _HAS_AIOHTTP:
+        async with aiohttp.ClientSession() as session:
+            async with session.post(
+                url,
+                json=body,
+                headers={"Content-Type": "application/json", "Accept": "application/json"},
+                timeout=aiohttp.ClientTimeout(total=timeout),
+            ) as resp:
+                if resp.status >= 400:
+                    raise AgirailsAppError(f"POST {url} failed: {resp.status}", resp.status)
+                return await resp.json()
+
+    from urllib.request import Request, urlopen
+
+    data = _json.dumps(body).encode("utf-8")
+    req = Request(
+        url,
+        data=data,
+        headers={"Content-Type": "application/json", "Accept": "application/json"},
+        method="POST",
+    )
+    with urlopen(req, timeout=int(timeout)) as resp:
+        if resp.status >= 400:
+            raise AgirailsAppError(f"POST {url} failed: {resp.status}", resp.status)
+        return _json.loads(resp.read().decode("utf-8"))
+
+
+# ============================================================================
+# API Functions
+# ============================================================================
+
+
+async def check_slug(slug: str) -> Dict[str, Any]:
+    """Check slug availability on agirails.app.
+
+    Args:
+        slug: Agent slug to check (3-64 chars).
+
+    Returns:
+        Dict with 'available' (bool), 'slug' (str), optionally 'suggestions' (list).
+    """
+    from urllib.parse import quote
+
+    url = f"{AGIRAILS_APP_BASE_URL}/api/v1/agents/check-slug?slug={quote(slug)}"
+    return await _get(url)
+
+
+async def upsert_agent(params: UpsertAgentParams) -> Dict[str, Any]:
+    """Create or update agent profile on agirails.app.
+
+    Dual auth: session (Supabase JWT) + wallet-sig (SDK publish via EIP-712).
+
+    Args:
+        params: Agent data with EIP-712 signature.
+
+    Returns:
+        API response dict.
+    """
+    url = f"{AGIRAILS_APP_BASE_URL}/api/v1/agents"
+    return await _post(url, params.to_camel_case_dict())
+
+
+async def get_claim_challenge(wallet: str) -> Dict[str, Any]:
+    """Get a Redis-backed challenge for agent claiming.
+
+    Args:
+        wallet: Wallet address.
+
+    Returns:
+        Dict with 'challenge' (str).
+    """
+    url = f"{AGIRAILS_APP_BASE_URL}/api/v1/agents/claim/challenge"
+    return await _post(url, {"wallet": wallet})
+
+
+async def claim_agent(params: ClaimAgentParams) -> Dict[str, Any]:
+    """Claim agent ownership via on-chain ownerOf verification.
+
+    Args:
+        params: Claim parameters with challenge signature.
+
+    Returns:
+        API response dict.
+    """
+    url = f"{AGIRAILS_APP_BASE_URL}/api/v1/agents/claim"
+    return await _post(url, {
+        "agentId": params.agent_id,
+        "wallet": params.wallet,
+        "challenge": params.challenge,
+        "signature": params.signature,
+    })
+
+
+__all__ = [
+    "AgirailsAppError",
+    "UpsertAgentParams",
+    "ClaimAgentParams",
+    "check_slug",
+    "upsert_agent",
+    "get_claim_challenge",
+    "claim_agent",
+]