acp-plugin-gamesdk 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

acp_plugin_gamesdk/acp_client.py

@@ -2,74 +2,116 @@ from datetime import datetime, timedelta
 from typing import List, Optional
 from web3 import Web3
 import requests
+from acp_plugin_gamesdk.interface import AcpAgent, AcpJobPhases, AcpState
+from acp_plugin_gamesdk.acp_token import AcpToken, MemoType
+import time
 
-import sys
-import os
-sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), "../../../")))
-from .interface import AcpAgent, AcpJobPhases, AcpState
-from .acp_token import AcpToken, MemoType
 
 class AcpClient:
-    def __init__(self, api_key: str, acp_token: AcpToken):
+    def __init__(self, api_key: str, acp_token: AcpToken, acp_base_url: Optional[str] = None):
         self.base_url = "https://sdk-dev.game.virtuals.io/acp"
         self.api_key = api_key
         self.acp_token = acp_token
         self.web3 = Web3()
+        self.acp_base_url = acp_base_url if acp_base_url else "https://acpx-staging.virtuals.io/api"
 
     @property
-    def wallet_address(self) -> str:
-        return self.acp_token.get_wallet_address()
+    def agent_wallet_address(self) -> str:
+        return self.acp_token.get_agent_wallet_address()
 
     def get_state(self) -> AcpState:
         response =  requests.get(
-            f"{self.base_url}/states/{self.wallet_address}",
+            f"{self.base_url}/states/{self.agent_wallet_address}",
             headers={"x-api-key": self.api_key}
         )
         return response.json()
 
-    def browse_agents(self, cluster: Optional[str] = None) -> List[AcpAgent]:
-        url = "https://acpx.virtuals.gg/api/agents"
+    def browse_agents(self, cluster: Optional[str] = None, query: Optional[str] = None) -> List[AcpAgent]:
+        url = f"{self.acp_base_url}/agents"
         
-        params = {}
+        # Build URL with query parameters
+        if query:
+            url += f"?search={requests.utils.quote(query)}"
+            
         if cluster:
-            params["filters[cluster]"] = cluster
-        
-        response = requests.get(url, params=params)
+            # Add & if there's already a parameter, otherwise add ?
+            separator = "&" if query else "?"
+            url += f"{separator}filters[cluster]={requests.utils.quote(cluster)}"
+
+        response = requests.get(url)
         
         if response.status_code != 200:
             raise Exception(f"Failed to browse agents: {response.text}")
 
         response_json = response.json()
         
-        return [
-            {
+        result = []
+        
+        for agent in response_json.get("data", []):
+            result.append(
+                {
                 "id": agent["id"],
                 "name": agent["name"],
                 "description": agent["description"],
                 "walletAddress": agent["walletAddress"]
-            }
-            for agent in response_json.get("data", [])
-        ]
+                }
+            )
+            
+        return result
 
     def create_job(self, provider_address: str, price: float, job_description: str) -> int:
         expire_at = datetime.now() + timedelta(days=1)
         
         tx_result =  self.acp_token.create_job(
             provider_address=provider_address,
+            evaluator_address=provider_address,
             expire_at=expire_at
         )
-        job_id = tx_result["jobId"]
-        memo_response =  self.acp_token.create_memo(
-            job_id=job_id,
-            content=job_description,
-            memo_type=MemoType.MESSAGE,
-            is_secured=False,
-            next_phase=AcpJobPhases.NEGOTIATION
-        )
+        job_id = None
+        retry_count = 3
+        retry_delay = 3
+        
+        time.sleep(retry_delay) 
+        for attempt in range(retry_count):
+            try:
+                response = self.acp_token.validate_transaction(tx_result["txHash"])
+                data = response.get("data", {})
+                if not data:
+                    raise Exception("Invalid tx_hash!")
+                
+                if (data.get("status") == "retry"):
+                    raise Exception("Transaction failed, retrying...")
+                
+                if (data.get("status") == "failed"):
+                    break
+                
+                if (data.get("status") == "success"):
+                    job_id = data.get("result").get("jobId")
+                    
+                if (job_id is not None and job_id != ""):
+                    break  
+                
+            except Exception as e:
+                print(f"Error creating job: {e}")
+                if attempt < retry_count - 1:
+                    time.sleep(retry_delay) 
+                else:
+                    raise
+        
+        if (job_id is None or job_id == ""):
+            raise Exception("Failed to create job")
+        
+        self.acp_token.create_memo(
+                    job_id=int(job_id),
+                    content=job_description,
+                    memo_type=MemoType.MESSAGE,
+                    is_secured=False,
+                    next_phase=AcpJobPhases.NEGOTIATION
+                )
 
         payload = {
-            "jobId": job_id,
-            "clientAddress": self.acp_token.get_wallet_address(),
+            "jobId": int(job_id),
+            "clientAddress": self.agent_wallet_address,
             "providerAddress": provider_address,
             "description": job_description,
             "price": price,
@@ -90,10 +132,12 @@ class AcpClient:
 
     def response_job(self, job_id: int, accept: bool, memo_id: int, reasoning: str):
         if accept:
-            tx_hash = self.acp_token.sign_memo(memo_id, accept, reasoning)
+            self.acp_token.sign_memo(memo_id, accept, reasoning)
+            
+            time.sleep(5)
             
             return self.acp_token.create_memo(
-                job_id=job_id,
+                job_id=int(job_id),
                 content=f"Job {job_id} accepted. {reasoning}",
                 memo_type=MemoType.MESSAGE,
                 is_secured=False,
@@ -101,7 +145,7 @@ class AcpClient:
             )
         else:
             return self.acp_token.create_memo(
-                job_id=job_id,
+                job_id=int(job_id),
                 content=f"Job {job_id} rejected. {reasoning}",
                 memo_type=MemoType.MESSAGE,
                 is_secured=False,
@@ -112,13 +156,15 @@ class AcpClient:
         # Convert amount to Wei (smallest ETH unit)
         amount_wei = self.web3.to_wei(amount, 'ether')
         
-        tx_hash = self.acp_token.set_budget(job_id, amount_wei)
-        approval_tx_hash = self.acp_token.approve_allowance(amount_wei)
+        self.acp_token.set_budget(job_id, amount_wei)
+        time.sleep(5)
+        self.acp_token.approve_allowance(amount_wei)
+        time.sleep(5)
         return self.acp_token.sign_memo(memo_id, True, reason)
 
     def deliver_job(self, job_id: int, deliverable: str, memo_id: int, reason: str):
         return self.acp_token.create_memo(
-            job_id=job_id,
+            job_id=int(job_id),
             content=deliverable,
             memo_type=MemoType.MESSAGE,
             is_secured=False,
@@ -143,7 +189,7 @@ class AcpClient:
         }
         
         response = requests.post(
-            f"{self.base_url}/{job_id}/tweets/{self.wallet_address}",
+            f"{self.base_url}/{job_id}/tweets/{self.agent_wallet_address}",
             json=payload,
             headers={
                 "Accept": "application/json",

acp_plugin_gamesdk/acp_plugin.py

@@ -5,26 +5,25 @@ from datetime import datetime
 
 from game_sdk.game.agent import WorkerConfig
 from game_sdk.game.custom_types import Function, FunctionResultStatus
-from twitter_plugin_gamesdk.twitter_plugin import TwitterPlugin
-
 from twitter_plugin_gamesdk.twitter_plugin import TwitterPlugin
 from twitter_plugin_gamesdk.game_twitter_plugin import GameTwitterPlugin
-from .acp_client import AcpClient
-from .acp_token import AcpToken
-from .interface import AcpJobPhasesDesc, IInventory
+from acp_plugin_gamesdk.acp_client import AcpClient
+from acp_plugin_gamesdk.acp_token import AcpToken
+from acp_plugin_gamesdk.interface import AcpJobPhasesDesc, IInventory
 
 @dataclass
-class AdNetworkPluginOptions:
+class AcpPluginOptions:
     api_key: str
     acp_token_client: AcpToken
     twitter_plugin: TwitterPlugin | GameTwitterPlugin = None
     cluster: Optional[str] = None
+    acp_base_url: Optional[str] = None
+
 
 class AcpPlugin:
-    def __init__(self, options: AdNetworkPluginOptions):
+    def __init__(self, options: AcpPluginOptions):
         print("Initializing AcpPlugin")
-        self.acp_client = AcpClient(options.api_key, options.acp_token_client)
-        
+        self.acp_client = AcpClient(options.api_key, options.acp_token_client, options.acp_base_url)
         self.id = "acp_worker"
         self.name = "ACP Worker"
         self.description = """
@@ -45,12 +44,14 @@ class AcpPlugin:
         self.cluster = options.cluster
         self.twitter_plugin = options.twitter_plugin
         self.produced_inventory: List[IInventory] = []
+        self.acp_base_url = options.acp_base_url
+
 
     def add_produce_item(self, item: IInventory) -> None:
         self.produced_inventory.append(item)
         
     def reset_state(self) -> None:
-        self.acp_client.reset_state(self.acp_client.wallet_address)
+        self.acp_client.reset_state(self.acp_client.agent_wallet_address)
         
     def get_acp_state(self) -> Dict:
         server_state = self.acp_client.get_state()
@@ -100,11 +101,11 @@ class AcpPlugin:
             * phase: request (seller should response to accept/reject to the job) → pending_payment (as a buyer to make the payment for the service) → in_progress (seller to deliver the service) → evaluation → completed/rejected
         """
         
-    def _search_agents_executable(self,reasoning: str) -> Tuple[FunctionResultStatus, str, dict]:
+    def _search_agents_executable(self,reasoning: str, keyword: str) -> Tuple[FunctionResultStatus, str, dict]:
         if not reasoning:
             return FunctionResultStatus.FAILED, "Reasoning for the search must be provided. This helps track your decision-making process for future reference.", {}
             
-        agents = self.acp_client.browse_agents(self.cluster)
+        agents = self.acp_client.browse_agents(self.cluster, keyword)
         
         if not agents:
             return FunctionResultStatus.FAILED, "No other trading agents found in the system. Please try again later when more agents are available.", {}
@@ -126,7 +127,12 @@ class AcpPlugin:
                     "name": "reasoning",
                     "type": "string",
                     "description": "Explain why you need to find trading partners at this time",
-                }
+                },
+                {
+                    "name": "keyword",
+                    "type": "string",
+                    "description": "Search for agents by name or description. Use this to find specific trading partners or products.",
+                },
             ],
             executable=self._search_agents_executable
         )
@@ -177,7 +183,6 @@ class AcpPlugin:
                 return FunctionResultStatus.FAILED, "You already have an active job as a buyer", {}
 
             # ... Rest of validation logic ...
-            
             job_id = self.acp_client.create_job(
                 sellerWalletAddress,
                 float(price),
@@ -188,7 +193,7 @@ class AcpPlugin:
                 post_tweet_fn = self.twitter_plugin.get_function('post_tweet')
                 tweet_id = post_tweet_fn(tweetContent, None).get('data', {}).get('id')
                 if (tweet_id is not None):
-                    self.acp_client.add_tweet(job_id,tweet_id, tweetContent)
+                    self.acp_client.add_tweet(job_id, tweet_id, tweetContent)
                     print("Tweet has been posted")
 
             return FunctionResultStatus.DONE, json.dumps({

acp_plugin_gamesdk/acp_token.py

@@ -1,14 +1,13 @@
-import asyncio
 from enum import IntEnum
 import time
-from typing import Optional, Tuple, TypedDict, List
+from typing import Optional, Tuple, TypedDict
 from datetime import datetime
 from web3 import Web3
 from eth_account import Account
-import sys
-import os
-sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), "../../../")))
-from .acp_token_abi import ACP_TOKEN_ABI
+from acp_plugin_gamesdk.acp_token_abi import ACP_TOKEN_ABI
+import requests
+from eth_account.messages import encode_defunct
+import json
 
 class MemoType(IntEnum):
     MESSAGE = 0
@@ -44,94 +43,118 @@ class AcpToken:
     def __init__(
         self,
         wallet_private_key: str,
+        agent_wallet_address: str,
         network_url: str,
-        contract_address: str = "0x5e4ee2620482f7c4fee12bf27b095e48d441f5cf",
-        virtuals_token_address: str = "0xbfAB80ccc15DF6fb7185f9498d6039317331846a"
+        acp_base_url: Optional[str] = None,
+        contract_address: str = "0x2422c1c43451Eb69Ff49dfD39c4Dc8C5230fA1e6",
+        virtuals_token_address: str = "0xbfAB80ccc15DF6fb7185f9498d6039317331846a",
     ):
         self.web3 = Web3(Web3.HTTPProvider(network_url))
         self.account = Account.from_key(wallet_private_key)
+        self.agent_wallet_address = agent_wallet_address
         self.contract_address = Web3.to_checksum_address(contract_address)
         self.virtuals_token_address = Web3.to_checksum_address(virtuals_token_address)
         self.contract = self.web3.eth.contract(
             address=self.contract_address,
             abi=ACP_TOKEN_ABI
         )
+        self.virtuals_token_contract = self.web3.eth.contract(
+            address=self.virtuals_token_address,
+            abi=[{
+                "inputs": [
+                    {
+                        "internalType": "address",
+                        "name": "spender",
+                        "type": "address"
+                    },
+                    {
+                        "internalType": "uint256",
+                        "name": "amount", 
+                        "type": "uint256"
+                    }
+                ],
+                "name": "approve",
+                "outputs": [
+                    {
+                        "internalType": "bool",
+                        "name": "",
+                        "type": "bool"
+                    }
+                ],
+                "stateMutability": "nonpayable",
+                "type": "function"
+            }]
+        )
+        self.acp_base_url = acp_base_url if acp_base_url else "https://acpx-staging.virtuals.io/api"
+    def get_agent_wallet_address(self) -> str:
+        return self.agent_wallet_address
         
     def get_contract_address(self) -> str:
         return self.contract_address
 
-    def get_wallet_address(self) -> str:
-        return self.account.address
+    def validate_transaction(self, hash_value: str) -> object:
+        try:
+            response = requests.post(f"{self.acp_base_url}/acp-agent-wallets/trx-result", json={"userOpHash": hash_value})
+            return response.json()
+        except Exception as error:
+            print(f"Error getting job_id: {error}")
+            raise Exception("Failed to get job_id")
 
     def create_job(
         self,
         provider_address: str,
+        evaluator_address: str,
         expire_at: datetime
     ) -> dict:
         try:
             provider_address = Web3.to_checksum_address(provider_address)
             expire_timestamp = int(expire_at.timestamp())
-            
-            transaction = self.contract.functions.createJob(
-                provider_address,
-                expire_timestamp
-            ).build_transaction({
-                'from': self.account.address,
-                'nonce': self.web3.eth.get_transaction_count(self.account.address),
-            })
-            
-            signed_txn = self.web3.eth.account.sign_transaction(
-                transaction, 
-                self.account.key
+        
+            # Sign the transaction
+            trx_data, signature = self._sign_transaction(
+                "createJob", 
+                [provider_address, evaluator_address, expire_timestamp]
             )
-            
-            tx_hash = self.web3.eth.send_raw_transaction(signed_txn.raw_transaction)
-            receipt = self.web3.eth.wait_for_transaction_receipt(tx_hash)
-            
-            # Get job ID from event logs
-            job_created_event = self.contract.events.JobCreated().process_receipt(receipt)
-            job_id = job_created_event[0]['args']['jobId']
-            
-            return {
-                'txHash': tx_hash.hex(),
-                'jobId': job_id
+                
+            # Prepare payload
+            payload = {
+                "agentWallet": self.get_agent_wallet_address(),
+                "trxData": trx_data,
+                "signature": signature
             }
+            
+            # Submit to custom API
+            api_url = f"{self.acp_base_url}/acp-agent-wallets/transactions"
+            response = requests.post(api_url, json=payload)
+                
+            # Return transaction hash or response ID
+            return { "txHash": response.json().get("data", {}).get("userOpHash", "")}
+        
         except Exception as error:
             print(f"Error creating job: {error}")
             raise Exception("Failed to create job")
 
     def approve_allowance(self, price_in_wei: int) -> str:
         try:
-            erc20_contract = self.web3.eth.contract(
-                address=self.virtuals_token_address,
-                abi=[{
-                    "inputs": [
-                        {"name": "spender", "type": "address"},
-                        {"name": "amount", "type": "uint256"}
-                    ],
-                    "name": "approve",
-                    "outputs": [{"name": "", "type": "bool"}],
-                    "stateMutability": "nonpayable",
-                    "type": "function"
-                }]
+            trx_data, signature = self._sign_transaction(
+                "approve", 
+                [self.contract_address, price_in_wei],
+                self.virtuals_token_address
             )
             
-            transaction = erc20_contract.functions.approve(
-                self.contract_address,
-                price_in_wei
-            ).build_transaction({
-                'from': self.account.address,
-                'nonce': self.web3.eth.get_transaction_count(self.account.address),
-            })
+            payload = {
+                "agentWallet": self.get_agent_wallet_address(),
+                "trxData": trx_data,
+                "signature": signature
+            }
             
-            signed_txn = self.web3.eth.account.sign_transaction(
-                transaction,
-                self.account.key
-            )
-            tx_hash = self.web3.eth.send_raw_transaction(signed_txn.raw_transaction)
-            self.web3.eth.wait_for_transaction_receipt(tx_hash)
+            api_url = f"{self.acp_base_url}/acp-agent-wallets/transactions"
+            response = requests.post(api_url, json=payload)
+            
+            if (response.status_code != 200):
+                raise Exception("Failed to approve allowance")
             
-            return tx_hash.hex()
+            return response.json()
         except Exception as error:
             print(f"Error approving allowance: {error}")
             raise Exception("Failed to approve allowance")
@@ -147,32 +170,24 @@ class AcpToken:
         retries = 3
         while retries > 0:
             try:
-                transaction = self.contract.functions.createMemo(
-                    jobId = job_id,
-                    content = content,
-                    memoType = memo_type,
-                    isSecured = is_secured,
-                    nextPhase = next_phase
-                ).build_transaction({
-                    'from': self.account.address,
-                    'nonce': self.web3.eth.get_transaction_count(self.account.address),
-                })
-                
-                signed_txn = self.web3.eth.account.sign_transaction(
-                    transaction,
-                    self.account.key
+                trx_data, signature = self._sign_transaction(
+                    "createMemo", 
+                    [job_id, content, memo_type, is_secured, next_phase]
                 )
-                tx_hash = self.web3.eth.send_raw_transaction(signed_txn.raw_transaction)
-                receipt = self.web3.eth.wait_for_transaction_receipt(tx_hash)
-                
-                # Get memo ID from event logs
-                new_memo_event = self.contract.events.NewMemo().process_receipt(receipt)
-                memo_id = new_memo_event[0]['args']['memoId']
                 
-                return {
-                    'txHash': tx_hash.hex(),
-                    'memoId': memo_id
+                payload = {
+                    "agentWallet": self.get_agent_wallet_address(),
+                    "trxData": trx_data,
+                    "signature": signature
                 }
+
+                api_url = f"{self.acp_base_url}/acp-agent-wallets/transactions"
+                response = requests.post(api_url, json=payload)
+                
+                if (response.status_code != 200):
+                    raise Exception("Failed to create memo")
+                
+                return { "txHash": response.json().get("txHash", response.json().get("id", "")), "memoId": response.json().get("memoId", "")}
             except Exception as error:
                 print(f"Error creating memo: {error}")
                 retries -= 1
@@ -180,6 +195,27 @@ class AcpToken:
                 
         raise Exception("Failed to create memo")
 
+    def _sign_transaction(self, method_name: str, args: list, contract_address: Optional[str] = None) -> Tuple[dict, str]:
+        if contract_address:
+            encoded_data = self.virtuals_token_contract.encode_abi(method_name, args=args)
+        else:
+            encoded_data = self.contract.encode_abi(method_name, args=args)
+        
+        trx_data = {
+            "target": contract_address if contract_address else self.get_contract_address(),
+            "value": "0",
+            "data": encoded_data
+        }
+        
+        message_json = json.dumps(trx_data, separators=(",", ":"), sort_keys=False)
+        message_bytes = message_json.encode()
+        
+        # Sign the transaction
+        message = encode_defunct(message_bytes)
+        signature = "0x" + self.account.sign_message(message).signature.hex()
+        
+        return trx_data, signature
+
     def sign_memo(
         self,
         memo_id: int,
@@ -189,24 +225,25 @@ class AcpToken:
         retries = 3
         while retries > 0:
             try:
-                transaction = self.contract.functions.signMemo(
-                    memo_id,
-                    is_approved,
-                    reason or ""
-                ).build_transaction({
-                    'from': self.account.address,
-                    'nonce': self.web3.eth.get_transaction_count(self.account.address),
-                })
-                
-                signed_txn = self.web3.eth.account.sign_transaction(
-                    transaction,
-                    self.account.key
+                trx_data, signature = self._sign_transaction(
+                    "signMemo", 
+                    [memo_id, is_approved, reason]
                 )
                 
-                tx_hash = self.web3.eth.send_raw_transaction(signed_txn.raw_transaction)
-                self.web3.eth.wait_for_transaction_receipt(tx_hash)
+                payload = {
+                    "agentWallet": self.get_agent_wallet_address(),
+                    "trxData": trx_data,
+                    "signature": signature
+                }
+                
+                api_url = f"{self.acp_base_url}/acp-agent-wallets/transactions"
+                response = requests.post(api_url, json=payload)
+                
+                if (response.status_code != 200):
+                    raise Exception("Failed to sign memo")
+                
+                return response.json()
                 
-                return tx_hash.hex()
             except Exception as error:
                 print(f"Error signing memo: {error}")
                 retries -= 1
@@ -216,22 +253,24 @@ class AcpToken:
 
     def set_budget(self, job_id: int, budget: int) -> str:
         try:
-            transaction = self.contract.functions.setBudget(
-                job_id,
-                budget
-            ).build_transaction({
-                'from': self.account.address,
-                'nonce': self.web3.eth.get_transaction_count(self.account.address),
-            })
-            
-            signed_txn = self.web3.eth.account.sign_transaction(
-                transaction,
-                self.account.key
+            trx_data, signature = self._sign_transaction(
+                "setBudget", 
+                [job_id, budget]
             )
-            tx_hash = self.web3.eth.send_raw_transaction(signed_txn.raw_transaction)
-            self.web3.eth.wait_for_transaction_receipt(tx_hash)
             
-            return tx_hash.hex()
+            payload = {
+                "agentWallet": self.get_agent_wallet_address(),
+                "trxData": trx_data,
+                "signature": signature
+            }
+            
+            api_url = f"{self.acp_base_url}/acp-agent-wallets/transactions"
+            response = requests.post(api_url, json=payload)
+            
+            if (response.status_code != 200):
+                raise Exception("Failed to set budget")
+            
+            return response.json()
         except Exception as error:
             print(f"Error setting budget: {error}")
             raise Exception("Failed to set budget")

acp_plugin_gamesdk/acp_token_abi.py

@@ -28,6 +28,25 @@ ACP_TOKEN_ABI = [
         "name": "SafeERC20FailedOperation",
         "type": "error",
     },
+    {
+        "anonymous": False,
+        "inputs": [
+            {
+                "indexed": True,
+                "internalType": "uint256",
+                "name": "jobId",
+                "type": "uint256",
+            },
+            {
+                "indexed": False,
+                "internalType": "uint256",
+                "name": "newBudget",
+                "type": "uint256",
+            },
+        ],
+        "name": "BudgetSet",
+        "type": "event",
+    },
     {
         "anonymous": False,
         "inputs": [
@@ -95,7 +114,7 @@ ACP_TOKEN_ABI = [
         "anonymous": False,
         "inputs": [
             {
-                "indexed": True,
+                "indexed": False,
                 "internalType": "uint256",
                 "name": "jobId",
                 "type": "uint256",
@@ -112,6 +131,12 @@ ACP_TOKEN_ABI = [
                 "name": "provider",
                 "type": "address",
             },
+            {
+                "indexed": True,
+                "internalType": "address",
+                "name": "evaluator",
+                "type": "address",
+            },
         ],
         "name": "JobCreated",
         "type": "event",
@@ -334,13 +359,6 @@ ACP_TOKEN_ABI = [
         "stateMutability": "view",
         "type": "function",
     },
-    {
-        "inputs": [{"internalType": "address", "name": "evaluator", "type": "address"}],
-        "name": "addEvaluator",
-        "outputs": [],
-        "stateMutability": "nonpayable",
-        "type": "function",
-    },
     {
         "inputs": [
             {"internalType": "address", "name": "account", "type": "address"},
@@ -361,6 +379,7 @@ ACP_TOKEN_ABI = [
     {
         "inputs": [
             {"internalType": "address", "name": "provider", "type": "address"},
+            {"internalType": "address", "name": "evaluator", "type": "address"},
             {"internalType": "uint256", "name": "expiredAt", "type": "uint256"},
         ],
         "name": "createJob",
@@ -385,13 +404,6 @@ ACP_TOKEN_ABI = [
         "stateMutability": "nonpayable",
         "type": "function",
     },
-    {
-        "inputs": [],
-        "name": "evaluatorCounter",
-        "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
-        "stateMutability": "view",
-        "type": "function",
-    },
     {
         "inputs": [],
         "name": "evaluatorFeeBP",
@@ -400,14 +412,11 @@ ACP_TOKEN_ABI = [
         "type": "function",
     },
     {
-        "inputs": [{"internalType": "address", "name": "", "type": "address"}],
-        "name": "evaluators",
-        "outputs": [{"internalType": "bool", "name": "", "type": "bool"}],
-        "stateMutability": "view",
-        "type": "function",
-    },
-    {
-        "inputs": [{"internalType": "uint256", "name": "jobId", "type": "uint256"}],
+        "inputs": [
+            {"internalType": "uint256", "name": "jobId", "type": "uint256"},
+            {"internalType": "uint256", "name": "offset", "type": "uint256"},
+            {"internalType": "uint256", "name": "limit", "type": "uint256"},
+        ],
         "name": "getAllMemos",
         "outputs": [
             {
@@ -421,13 +430,13 @@ ACP_TOKEN_ABI = [
                     {"internalType": "bool", "name": "isSecured", "type": "bool"},
                     {"internalType": "uint8", "name": "nextPhase", "type": "uint8"},
                     {"internalType": "uint256", "name": "jobId", "type": "uint256"},
-                    {"internalType": "uint8", "name": "numApprovals", "type": "uint8"},
                     {"internalType": "address", "name": "sender", "type": "address"},
                 ],
                 "internalType": "struct InteractionLedger.Memo[]",
                 "name": "",
                 "type": "tuple[]",
             },
+            {"internalType": "uint256", "name": "total", "type": "uint256"},
         ],
         "stateMutability": "view",
         "type": "function",
@@ -436,6 +445,8 @@ ACP_TOKEN_ABI = [
         "inputs": [
             {"internalType": "uint256", "name": "jobId", "type": "uint256"},
             {"internalType": "uint8", "name": "phase", "type": "uint8"},
+            {"internalType": "uint256", "name": "offset", "type": "uint256"},
+            {"internalType": "uint256", "name": "limit", "type": "uint256"},
         ],
         "name": "getMemosForPhase",
         "outputs": [
@@ -450,13 +461,13 @@ ACP_TOKEN_ABI = [
                     {"internalType": "bool", "name": "isSecured", "type": "bool"},
                     {"internalType": "uint8", "name": "nextPhase", "type": "uint8"},
                     {"internalType": "uint256", "name": "jobId", "type": "uint256"},
-                    {"internalType": "uint8", "name": "numApprovals", "type": "uint8"},
                     {"internalType": "address", "name": "sender", "type": "address"},
                 ],
                 "internalType": "struct InteractionLedger.Memo[]",
                 "name": "",
                 "type": "tuple[]",
             },
+            {"internalType": "uint256", "name": "total", "type": "uint256"},
         ],
         "stateMutability": "view",
         "type": "function",
@@ -497,24 +508,16 @@ ACP_TOKEN_ABI = [
     },
     {
         "inputs": [
-            {"internalType": "address", "name": "_providerRegistry", "type": "address"},
             {"internalType": "address", "name": "paymentTokenAddress", "type": "address"},
             {"internalType": "uint256", "name": "evaluatorFeeBP_", "type": "uint256"},
-            {"internalType": "uint8", "name": "numEvaluatorsPerJob_", "type": "uint8"},
-            {"internalType": "uint8", "name": "minApprovals_", "type": "uint8"},
+            {"internalType": "uint256", "name": "platformFeeBP_", "type": "uint256"},
+            {"internalType": "address", "name": "platformTreasury_", "type": "address"},
         ],
         "name": "initialize",
         "outputs": [],
         "stateMutability": "nonpayable",
         "type": "function",
     },
-    {
-        "inputs": [{"internalType": "address", "name": "evaluator", "type": "address"}],
-        "name": "isEvaluator",
-        "outputs": [{"internalType": "bool", "name": "", "type": "bool"}],
-        "stateMutability": "view",
-        "type": "function",
-    },
     {
         "inputs": [
             {"internalType": "uint256", "name": "jobId", "type": "uint256"},
@@ -532,16 +535,6 @@ ACP_TOKEN_ABI = [
         "stateMutability": "view",
         "type": "function",
     },
-    {
-        "inputs": [
-            {"internalType": "uint256", "name": "jobId", "type": "uint256"},
-            {"internalType": "uint256", "name": "", "type": "uint256"},
-        ],
-        "name": "jobEvaluators",
-        "outputs": [{"internalType": "address", "name": "evaluators", "type": "address"}],
-        "stateMutability": "view",
-        "type": "function",
-    },
     {
         "inputs": [
             {"internalType": "uint256", "name": "jobId", "type": "uint256"},
@@ -565,7 +558,7 @@ ACP_TOKEN_ABI = [
             {"internalType": "uint8", "name": "phase", "type": "uint8"},
             {"internalType": "uint256", "name": "memoCount", "type": "uint256"},
             {"internalType": "uint256", "name": "expiredAt", "type": "uint256"},
-            {"internalType": "uint8", "name": "evaluatorCount", "type": "uint8"},
+            {"internalType": "address", "name": "evaluator", "type": "address"},
         ],
         "stateMutability": "view",
         "type": "function",
@@ -577,13 +570,6 @@ ACP_TOKEN_ABI = [
         "stateMutability": "view",
         "type": "function",
     },
-    {
-        "inputs": [],
-        "name": "minApprovals",
-        "outputs": [{"internalType": "uint8", "name": "", "type": "uint8"}],
-        "stateMutability": "view",
-        "type": "function",
-    },
     {
         "inputs": [],
         "name": "numEvaluatorsPerJob",
@@ -600,22 +586,16 @@ ACP_TOKEN_ABI = [
     },
     {
         "inputs": [],
-        "name": "providerRegistry",
-        "outputs": [
-            {
-                "internalType": "contract IServiceProviderRegistry",
-                "name": "",
-                "type": "address",
-            },
-        ],
+        "name": "platformFeeBP",
+        "outputs": [{"internalType": "uint256", "name": "", "type": "uint256"}],
         "stateMutability": "view",
         "type": "function",
     },
     {
-        "inputs": [{"internalType": "address", "name": "evaluator", "type": "address"}],
-        "name": "removeEvaluator",
-        "outputs": [],
-        "stateMutability": "nonpayable",
+        "inputs": [],
+        "name": "platformTreasury",
+        "outputs": [{"internalType": "address", "name": "", "type": "address"}],
+        "stateMutability": "view",
         "type": "function",
     },
     {
@@ -679,10 +659,18 @@ ACP_TOKEN_ABI = [
     {
         "inputs": [
             {"internalType": "uint256", "name": "evaluatorFeeBP_", "type": "uint256"},
-            {"internalType": "uint8", "name": "numEvaluatorsPerJob_", "type": "uint8"},
-            {"internalType": "uint8", "name": "minApprovals_", "type": "uint8"},
         ],
-        "name": "updateEvaluatorConfigs",
+        "name": "updateEvaluatorFee",
+        "outputs": [],
+        "stateMutability": "nonpayable",
+        "type": "function",
+    },
+    {
+        "inputs": [
+            {"internalType": "uint256", "name": "platformFeeBP_", "type": "uint256"},
+            {"internalType": "address", "name": "platformTreasury_", "type": "address"},
+        ],
+        "name": "updatePlatformFee",
         "outputs": [],
         "stateMutability": "nonpayable",
         "type": "function",

{acp_plugin_gamesdk-0.1.0.dist-info → acp_plugin_gamesdk-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: acp-plugin-gamesdk
-Version: 0.1.0
+Version: 0.1.2
 Summary: ACP Plugin for Python SDK for GAME by Virtuals
 Author: Steven Lee Soon Fatt
 Author-email: steven@virtuals.io
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: aiohttp (>=3.11.14,<4.0.0)
-Requires-Dist: eth-account (>=0.13.5,<0.14.0)
+Requires-Dist: eth-account (>=0.13.6,<0.14.0)
 Requires-Dist: eth-typing (>=5.2.0,<6.0.0)
 Requires-Dist: eth-utils (>=5.2.0,<6.0.0)
 Requires-Dist: game-sdk (>=0.1.5)
@@ -29,9 +29,12 @@ Description-Content-Type: text/markdown
 <summary>Table of Contents</summary>
 
 - [ACP Plugin](#acp-plugin)
+  - [Prerequisite](#prerequisite)
   - [Installation](#installation)
   - [Usage](#usage)
   - [Functions](#functions)
+  - [Tools](#tools)
+  - [Agent Registry](#agent-registry)
   - [Useful Resources](#useful-resources)
 
 </details>
@@ -49,8 +52,6 @@ Description-Content-Type: text/markdown
 > 1. **Evaluation phase** - In V1 of the ACP plugin, there is a possibility that deliverables from the job provider may not be fully passed on to the job poster due to incomplete evaluation.
 > 
 > 2. **Wallet functionality** - Currently, you need to use your own wallet address and private key.
->
-> 3. **Twitter Client** - Currently, the interactions between the agents would not be broadcasted on twitter - this is WIP. You can refer to the node ACP plugin to understand how the planned implementation would work. 
 > 
 
 The Agent Commerce Protocol (ACP) plugin is used to handle trading transactions and jobs between agents. This ACP plugin manages:
@@ -68,6 +69,10 @@ The Agent Commerce Protocol (ACP) plugin is used to handle trading transactions
    - Post tweets and tag other agents for job requests
    - Respond to tweets from other agents
 
+## Prerequisite
+⚠️⚠️⚠️ Important: Before testing your agent’s services with a counterpart agent, you must register your agent with the [Service Registry](https://acp-staging.virtuals.io/).
+This step is a critical precursor. Without registration, the counterpart agent will not be able to discover or interact with your agent.
+
 ## Installation
 
 From this directory (`acp`), run the installation:
@@ -90,24 +95,36 @@ poetry install
 
 3. Create and initialize an ACP instance by running:
 
- ```python
- acp_plugin = AcpPlugin(
-     options=AdNetworkPluginOptions(
-         api_key = "<your-GAME-dev-api-key-here>",
-         acp_token_client = AcpToken(
-             "<your-agent-wallet-private-key>",
-             "<your-chain-here>"
-         )
-     )
- )
- ```
+```python
+acp_plugin = AcpPlugin(
+    options = AcpPluginOptions(
+        api_key = "<your-GAME-dev-api-key-here>",
+        acp_token_client = AcpToken(
+            "<your-whitelisted-wallet-private-key>",
+            "<your-agent-wallet-address>",
+            "<your-chain-here>"
+        )
+    )
+)
+```
+
  > Note: 
  > - Your ACP token for your buyer and seller should be different.
  > - Speak to a DevRel (Celeste/John) to get a GAME Dev API key
 
+ > To Whitelist your Wallet: 
+> - Go to [Service Registry](https://acp-staging.virtuals.io/) page to whitelist your wallet.
+> - Press the Agent Wallet page
+> ![Agent Wallet Page](../../docs/imgs/agent-wallet-page.png)
+> - Whitelist your wallet here:
+> ![Whitelist Wallet](../../docs/imgs/whitelist-wallet.png)
+> ![Whitelist Wallet](../../docs/imgs/whitelist-wallet-info.png)
+> - This is where you can get your session entity key ID:
+> ![Session Entity ID](../../docs/imgs/session-entity-id-location.png)
+
 4. (optional) If you want to use GAME's twitter client with the ACP plugin, you can initialize it by running:
 ```python
-options = {
+twitter_client_options = {
     "id": "test_game_twitter_plugin",
     "name": "Test GAME Twitter Plugin",
     "description": "An example GAME Twitter Plugin for testing.",
@@ -117,14 +134,15 @@ options = {
 }
 
 acp_plugin = AcpPlugin(
-  options=AdNetworkPluginOptions(
-      api_key = "<your-GAME-dev-api-key-here>",
-      acp_token_client = AcpToken(
-          "<your-agent-wallet-private-key>",
-          "<your-chain-here>"
-      ),
-      twitter_plugin=GameTwitterPlugin(options) # <--- This is the GAME's twitter client
-  )
+    options = AcpPluginOptions(
+        api_key = "<your-GAME-dev-api-key-here>",
+        acp_token_client = AcpToken(
+            "<your-whitelisted-wallet-private-key>",
+            "<your-agent-wallet-address>",
+            "<your-chain-here>"
+        ),
+        twitter_plugin=GameTwitterPlugin(twitter_client_options) # <--- This is the GAME's twitter client
+    )
 )
 ```
 
@@ -192,6 +210,34 @@ This is a table of available functions that the ACP worker provides:
 | respond_job | Respond to a job. Used when you are looking to sell a product or service to another agent. |
 | pay_job | Pay for a job. Used when you are looking to pay for a job. |
 | deliver_job | Deliver a job. Used when you are looking to deliver a job. |
+| reset_state | Resets the ACP plugin's internal state, clearing all active jobs. Useful for testing or when you need to start fresh. |
+
+## Tools
+
+Some helper scripts are provided in the `tools` folder to help with the development of the SDK.
+| Script | Description |
+| ------------- | ------------- |
+| reset_states.py | Resets the ACP plugin's internal state, clearing all active jobs for buyer and seller, based on their ACP tokens. Useful for testing or when you need to start fresh. |
+
+## Agent Registry
+
+To register your agent, please head over to the [agent registry](https://acp-staging.virtuals.io/).
+
+1. Click on "Join ACP" button
+
+    <img src="../../docs/imgs/Join-acp.png" width="400" alt="ACP Agent Registry">
+
+2. Click on "Connect Wallet" button
+
+    <img src="../../docs/imgs/connect-wallet.png" width="400" alt="Connect Wallet">
+
+3. Register your agent there + include a service offering and a price (up to 5 max for now)
+
+    <img src="../../docs/imgs/register-agent.png" width="400" alt="Register Agent">
+
+4. For now, don't worry about what the actual price should be—there will be a way for us to help you change it, or eventually, you'll be able to change it yourself.
+
+5. Use a positive number (e.g., USD 1) when setting the arbitrary service offering rate.
 
 ## Useful Resources
 

acp_plugin_gamesdk-0.1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+acp_plugin_gamesdk/acp_client.py,sha256=PWauYP0-54Wvl_zge_GsUeqDkCfTrdzB4MzlrkVyQzc,7520
+acp_plugin_gamesdk/acp_plugin.py,sha256=W6jfRmptsL9WSID8uWh-9HsMrxuFAKO6XwSQGl46WeQ,20064
+acp_plugin_gamesdk/acp_token.py,sha256=M8P8QkYeu97F5KMGDPEKQPaibBUefmynrXXcwvK89P0,11498
+acp_plugin_gamesdk/acp_token_abi.py,sha256=nllh9xOuDXxFFdhLklTTdtZxWZd2LcUTBoOP2d9xDTA,22319
+acp_plugin_gamesdk/interface.py,sha256=xNorCmjb9HZTOjVK5LJ8rvisgP4yUC8QoLEPCRstBtM,1255
+acp_plugin_gamesdk-0.1.2.dist-info/METADATA,sha256=lCHZy3BIZ07Nz-lwOMC6JRlHIzhYg8kMt5X2aGBSo6M,9680
+acp_plugin_gamesdk-0.1.2.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+acp_plugin_gamesdk-0.1.2.dist-info/RECORD,,

acp_plugin_gamesdk-0.1.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-acp_plugin_gamesdk/acp_client.py,sha256=NcU3KNp4kukIygTAwqJOw85QkUPRf59N-VMKVvRM3GA,5756
-acp_plugin_gamesdk/acp_plugin.py,sha256=bsTdWIPL-IH_2vCvX3Eh4w1mqWGNSs-n6hj-MJMP_MI,19716
-acp_plugin_gamesdk/acp_token.py,sha256=D_t2DHbJNwYhA4gDbW2cnShfSlH5Wz42FWjm7jPHi2U,10126
-acp_plugin_gamesdk/acp_token_abi.py,sha256=m-_Pm1IGO2-DOuCqcxxaDnClVlnQ9xH7YI1lMiysomU,22870
-acp_plugin_gamesdk/interface.py,sha256=xNorCmjb9HZTOjVK5LJ8rvisgP4yUC8QoLEPCRstBtM,1255
-acp_plugin_gamesdk-0.1.0.dist-info/METADATA,sha256=QSL9d-xHJTYRHXRTKFizWG6TH2S2UimOl8dWWN2XJg0,7555
-acp_plugin_gamesdk-0.1.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-acp_plugin_gamesdk-0.1.0.dist-info/RECORD,,