acp-plugin-gamesdk 0.1.17__py3-none-any.whl → 0.1.19__py3-none-any.whl

acp_plugin_gamesdk/acp_client.py

@@ -13,12 +13,13 @@ from dacite import from_dict, Config
 
 
 class AcpClient:
-    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"
+    def __init__(self, api_key: str, acp_token: AcpToken):
         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"
+
+        self.acp_base_url = self.acp_token.acp_base_url
+        self.base_url = self.acp_token.game_api_url + "/acp"
 
     @property
     def agent_wallet_address(self) -> str:
@@ -74,6 +75,7 @@ class AcpClient:
                 AcpAgent(
                     id=agent["id"],
                     name=agent["name"],
+                    twitter_handle=agent["twitterHandle"],
                     description=agent["description"],
                     wallet_address=agent["walletAddress"],
                     offerings=offerings,
@@ -110,16 +112,16 @@ class AcpClient:
                 if not data:
                     raise Exception("Invalid tx_hash!")
                 
-                if (data.get("status") == "retry"):
+                if data.get("status") == "retry":
                     raise Exception("Transaction failed, retrying...")
                 
-                if (data.get("status") == "failed"):
+                if data.get("status") == "failed":
                     break
                 
-                if (data.get("status") == "success"):
+                if data.get("status") == "success":
                     job_id = int(data.get("result").get("jobId"))
                     
-                if (job_id is not None and job_id != ""):
+                if job_id is not None and job_id != "":
                     break  
                 
             except Exception as e:
@@ -130,7 +132,7 @@ class AcpClient:
                 else:
                     raise
         
-        if (job_id is None or job_id == ""):
+        if job_id is None or job_id == "":
             raise Exception("Failed to create job")
         
         self.acp_token.create_memo(
@@ -262,3 +264,39 @@ class AcpClient:
                 f"Response status code: {response.status_code}\n"
                 f"Response description: {response.text}\n"
             )
+            
+    def get_agent_by_wallet_address(self, wallet_address: str) -> AcpAgent:
+        url = f"{self.acp_base_url}/agents?filters[walletAddress]={wallet_address}"
+        
+        response = requests.get(
+            url,
+        )
+        
+        if response.status_code != 200:
+            raise Exception(
+                f"Failed to get agent: {response.status_code} {response.text}"
+            )
+            
+        response_json = response.json()
+        
+        result = []
+        
+        for agent in response_json.get("data", []):
+            if agent["offerings"]:
+                offerings = [AcpOffering(name=offering["name"], price=offering["price"]) for offering in agent["offerings"]]
+            else:
+                offerings = None
+                
+            result.append(
+                AcpAgent(
+                    id=agent["id"],
+                    name=agent["name"],
+                    twitter_handle=agent["twitterHandle"],
+                    description=agent["description"],
+                    wallet_address=agent["walletAddress"],
+                    offerings=offerings,
+                    score=0,
+                    explanation=""
+                )
+            )
+        return result[0]

acp_plugin_gamesdk/acp_plugin.py

@@ -42,7 +42,7 @@ class AcpPlugin:
     def __init__(self, options: AcpPluginOptions):
         print("Initializing AcpPlugin")
         self.acp_token_client = options.acp_token_client
-        self.acp_client = AcpClient(options.api_key, options.acp_token_client, options.acp_token_client.acp_base_url)
+        self.acp_client = AcpClient(options.api_key, options.acp_token_client)
         self.id = "acp_worker"
         self.name = "ACP Worker"
         self.description = """
@@ -63,24 +63,27 @@ class AcpPlugin:
         self.cluster = options.cluster
         self.evaluator_cluster = options.evaluator_cluster
         self.twitter_plugin = None
-        if (options.twitter_plugin is not None):
+        if options.twitter_plugin is not None:
             self.twitter_plugin = options.twitter_plugin
             
         self.produced_inventory: List[IInventory] = []
-        self.acp_base_url = self.acp_token_client.acp_base_url if self.acp_token_client.acp_base_url is None else "https://acpx-staging.virtuals.io/api"
+        self.acp_base_url = self.acp_token_client.acp_base_url
         if options.on_evaluate is not None or options.on_phase_change is not None:
             print("Initializing socket")
             self.socket = None
             if options.on_evaluate is not None:
                 self.on_evaluate = options.on_evaluate
             if options.on_phase_change is not None:
-                self.on_phase_change = options.on_phase_change
-            self.initializeSocket()
+                def phase_change_wrapper(job : AcpJob):
+                    job["getAgentByWalletAddress"] = self.acp_client.get_agent_by_wallet_address
+                    return options.on_phase_change(job)
+                self.on_phase_change = phase_change_wrapper
+            self.initialize_socket()
         self.job_expiry_duration_mins = options.job_expiry_duration_mins if options.job_expiry_duration_mins is not None else 1440
         
         
         
-    def initializeSocket(self) -> Tuple[bool, str]:
+    def initialize_socket(self) -> Tuple[bool, str]:
         """
         Initialize socket connection for real-time communication.
         Returns a tuple of (success, message).
@@ -94,9 +97,9 @@ class AcpPlugin:
             }
             
             # Connect socket to GAME SDK dev server
-            self.socket.connect("https://sdk-dev.game.virtuals.io", auth=self.socket.auth)
+            self.socket.connect(self.acp_client.base_url, auth=self.socket.auth)
             
-            if (self.socket.connected):
+            if self.socket.connected:
                 self.socket.emit(SocketEvents["JOIN_EVALUATOR_ROOM"], self.acp_token_client.agent_wallet_address)
         
             
@@ -115,7 +118,6 @@ class AcpPlugin:
             @self.socket.on(SocketEvents["ON_PHASE_CHANGE"])
             def on_phase_change(data):
                 if hasattr(self, 'on_phase_change') and self.on_phase_change:
-                    print(f"on_phase_change: {data}")
                     self.on_phase_change(data)
             
             # Set up cleanup function for graceful shutdown
@@ -128,7 +130,7 @@ class AcpPlugin:
                     
                     
             
-            def signal_handler(sig, frame):
+            def signal_handler(_sig, _frame):
                 cleanup()
                 sys.exit(0)
                 
@@ -168,7 +170,7 @@ class AcpPlugin:
             self.deliver_job,
         ]
         
-        def get_environment(function_result, current_state) -> Dict[str, Any]:
+        def get_environment(_function_result, _current_state) -> Dict[str, Any]:
             environment = data.get_environment() if hasattr(data, "get_environment") else {}
             return {
                 **environment,
@@ -219,6 +221,7 @@ class AcpPlugin:
                         {
                             "id": agent.id,
                             "name": agent.name,
+                            "twitter_handle": agent.twitter_handle,
                             "description": agent.description,
                             "wallet_address": agent.wallet_address,
                             "offerings": (
@@ -266,7 +269,7 @@ class AcpPlugin:
     @property
     def initiate_job(self) -> Function:
         seller_wallet_address_arg = Argument(
-            name="sellerWalletAddress",
+            name="seller_wallet_address",
             type="string",
             description="The seller's agent wallet address you want to buy from",
         )
@@ -284,19 +287,19 @@ class AcpPlugin:
         )
 
         service_requirements_arg = Argument(
-            name="serviceRequirements",
+            name="service_requirements",
             type="string",
             description="Detailed specifications for service-based items",
         )
         
         require_evaluation_arg = Argument(
-            name="requireEvaluation",
+            name="require_evaluation",
             type="boolean",
             description="Decide if your job request is complex enough to spend money for evaluator agent to assess the relevancy of the output. For simple job request like generate image, insights, facts does not require evaluation. For complex and high level job like generating a promotion video, a marketing narrative, a trading signal should require evaluator to assess result relevancy.",
         )
         
         evaluator_keyword_arg = Argument(
-            name="evaluatorKeyword",
+            name="evaluator_keyword",
             type="string",
             description="Keyword to search for a evaluator",
         )
@@ -305,7 +308,7 @@ class AcpPlugin:
         
         if hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None:
             tweet_content_arg = Argument(
-                name="tweetContent",
+                name="tweet_content",
                 type="string",
                 description="Tweet content that will be posted about this job. Must include the seller's Twitter handle (with @ symbol) to notify them",
             )
@@ -318,11 +321,11 @@ class AcpPlugin:
             executable=self._initiate_job_executable
         )
 
-    def _initiate_job_executable(self, sellerWalletAddress: str, price: str, reasoning: str, serviceRequirements: str, requireEvaluation: str, evaluatorKeyword: str, tweetContent: Optional[str] = None) -> Tuple[FunctionResultStatus, str, dict]:
-        if isinstance(requireEvaluation, str):
-            require_evaluation = requireEvaluation.lower() == 'true'
-        elif isinstance(requireEvaluation, bool):
-            require_evaluation = requireEvaluation
+    def _initiate_job_executable(self, seller_wallet_address: str, price: str, reasoning: str, service_requirements: str, require_evaluation: str, evaluator_keyword: str, tweet_content: Optional[str] = None) -> Tuple[FunctionResultStatus, str, dict]:
+        if isinstance(require_evaluation, str):
+            require_evaluation = require_evaluation.lower() == 'true'
+        elif isinstance(require_evaluation, bool):
+            require_evaluation = require_evaluation
         else:
             require_evaluation = False
 
@@ -337,51 +340,51 @@ class AcpPlugin:
 
             existing_job = next(
                 (job for job in state["jobs"]["active"]["asABuyer"]
-                 if job["providerAddress"] == sellerWalletAddress),
+                 if job["providerAddress"] == seller_wallet_address),
                 None
             )
 
             if existing_job:
                 return FunctionResultStatus.FAILED, f"You already have an active job as a buyer with {existing_job['providerAddress']} - complete the current job before initiating a new one", {}  
             
-            if not sellerWalletAddress:
+            if not seller_wallet_address:
                 return FunctionResultStatus.FAILED, "Missing seller wallet address - specify the agent you want to buy from", {}
             
-            if require_evaluation and not evaluatorKeyword:
+            if require_evaluation and not evaluator_keyword:
                 return FunctionResultStatus.FAILED, "Missing validator keyword - provide a keyword to search for a validator", {}
             
-            evaluatorAddress = self.acp_token_client.get_agent_wallet_address()
+            evaluator_address = self.acp_token_client.get_agent_wallet_address()
             
             if require_evaluation:
-                validators = self.acp_client.browse_agents(self.evaluator_cluster, evaluatorKeyword, rerank=True, top_k=1)
+                validators = self.acp_client.browse_agents(self.evaluator_cluster, evaluator_keyword, rerank=True, top_k=1)
                 
                 if len(validators) == 0:
                     return FunctionResultStatus.FAILED, "No evaluator found - try a different keyword", {}
-                
-                evaluatorAddress = validators[0].wallet_address
+
+                evaluator_address = validators[0].wallet_address
             
             # ... Rest of validation logic ...
             expired_at = datetime.now(timezone.utc) + timedelta(minutes=self.job_expiry_duration_mins)
             job_id = self.acp_client.create_job(
-                sellerWalletAddress,
+                seller_wallet_address,
                 float(price),
-                serviceRequirements,
-                evaluatorAddress,
+                service_requirements,
+                evaluator_address,
                 expired_at
             )
-            
-            if (hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None and tweetContent is not None):
+
+            if hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None and tweet_content is not None:
                 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)
+                tweet_id = post_tweet_fn(tweet_content).get('data', {}).get('id')
+                if tweet_id is not None:
+                    self.acp_client.add_tweet(job_id, tweet_id, tweet_content)
                     print("Tweet has been posted")
 
             return FunctionResultStatus.DONE, json.dumps({
                 "jobId": job_id,
-                "sellerWalletAddress": sellerWalletAddress,
+                "sellerWalletAddress": seller_wallet_address,
                 "price": float(price),
-                "serviceRequirements": serviceRequirements,
+                "serviceRequirements": service_requirements,
                 "timestamp": datetime.now().timestamp(),
             }), {}
         except Exception as e:
@@ -391,7 +394,7 @@ class AcpPlugin:
     @property
     def respond_job(self) -> Function:
         job_id_arg = Argument(
-            name="jobId",
+            name="job_id",
             type="integer",
             description="The job ID you are responding to",
         )
@@ -412,9 +415,9 @@ class AcpPlugin:
         
         if hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None:
             tweet_content_arg = Argument(
-                name="tweetContent",
+                name="tweet_content",
                 type="string",
-                description="Tweet content that will be posted about this job. Must include the seller's Twitter handle (with @ symbol) to notify them",
+                description="Tweet content about your decision for the specific job. MUST NOT TAG THE BUYER. This is to avoid spamming the buyer's feed with your decision.",
             )
             args.append(tweet_content_arg)
 
@@ -425,8 +428,8 @@ class AcpPlugin:
             executable=self._respond_job_executable
         )
 
-    def _respond_job_executable(self, jobId: int, decision: str, reasoning: str, tweetContent: Optional[str] = None) -> Tuple[FunctionResultStatus, str, dict]:
-        if not jobId:
+    def _respond_job_executable(self, job_id: int, decision: str, reasoning: str, tweet_content: Optional[str] = None) -> Tuple[FunctionResultStatus, str, dict]:
+        if not job_id:
             return FunctionResultStatus.FAILED, "Missing job ID - specify which job you're responding to", {}
         
         if not decision or decision not in ["ACCEPT", "REJECT"]:
@@ -439,7 +442,7 @@ class AcpPlugin:
             state = self.get_acp_state()
             
             job = next(
-                (c for c in state["jobs"]["active"]["asASeller"] if c["jobId"] == jobId),
+                (c for c in state["jobs"]["active"]["asASeller"] if c["jobId"] == job_id),
                 None
             )
 
@@ -450,24 +453,16 @@ class AcpPlugin:
                 return FunctionResultStatus.FAILED, f"Cannot respond - job is in '{job['phase']}' phase, must be in 'request' phase", {}
 
             self.acp_client.response_job(
-                jobId,
+                job_id,
                 decision == "ACCEPT",
                 job["memo"][0]["id"],
                 reasoning
             )
-            
-            if (hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None and tweetContent is not None):
-                tweet_history = job.get("tweetHistory", [])
-                tweet_id = tweet_history[-1].get("tweetId") if tweet_history else None
-                if (tweet_id is not None):
-                    reply_tweet_fn = self.twitter_plugin.get_function('reply_tweet')
-                    tweet_id = reply_tweet_fn(tweet_id,tweetContent, None).get('data', {}).get('id')
-                    if (tweet_id is not None):
-                        self.acp_client.add_tweet(jobId ,tweet_id, tweetContent)
-                        print("Tweet has been posted")
+
+            self._reply_tweet(job, tweet_content)
 
             return FunctionResultStatus.DONE, json.dumps({
-                "jobId": jobId,
+                "jobId": job_id,
                 "decision": decision,
                 "timestamp": datetime.now().timestamp()
             }), {}
@@ -477,7 +472,7 @@ class AcpPlugin:
     @property
     def pay_job(self) -> Function:
         job_id_arg = Argument(
-            name="jobId",
+            name="job_id",
             type="integer",
             description="The job ID you are paying for",
         )
@@ -498,9 +493,9 @@ class AcpPlugin:
         
         if hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None:
             tweet_content_arg = Argument(
-                name="tweetContent",
+                name="tweet_content",
                 type="string",
-                description="Tweet content that will be posted about this job. Must include the seller's Twitter handle (with @ symbol) to notify them",
+                description="Tweet content about your payment for the specific job. MUST NOT TAG THE BUYER. This is to avoid spamming the buyer's feed with your payment.",
             )
             args.append(tweet_content_arg)
 
@@ -511,8 +506,8 @@ class AcpPlugin:
             executable=self._pay_job_executable
         )
 
-    def _pay_job_executable(self, jobId: int, amount: float, reasoning: str, tweetContent: Optional[str] = None) -> Tuple[FunctionResultStatus, str, dict]:
-        if not jobId:
+    def _pay_job_executable(self, job_id: int, amount: float, reasoning: str, tweet_content: Optional[str] = None) -> Tuple[FunctionResultStatus, str, dict]:
+        if not job_id:
             return FunctionResultStatus.FAILED, "Missing job ID - specify which job you're paying for", {}
 
         if not amount:
@@ -525,7 +520,7 @@ class AcpPlugin:
             state = self.get_acp_state()
             
             job = next(
-                (c for c in state["jobs"]["active"]["asABuyer"] if c["jobId"] == jobId),
+                (c for c in state["jobs"]["active"]["asABuyer"] if c["jobId"] == job_id),
                 None
             )
 
@@ -537,24 +532,16 @@ class AcpPlugin:
 
 
             self.acp_client.make_payment(
-                jobId,
+                job_id,
                 amount,
                 job["memo"][0]["id"],
                 reasoning
             )
-            
-            if (hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None and tweetContent is not None):
-                tweet_history = job.get("tweetHistory", [])
-                tweet_id = tweet_history[-1].get("tweetId") if tweet_history else None
-                if (tweet_id is not None):
-                    reply_tweet_fn = self.twitter_plugin.get_function('reply_tweet')
-                    tweet_id = reply_tweet_fn(tweet_id,tweetContent, None).get('data', {}).get('id')
-                    if (tweet_id is not None):
-                        self.acp_client.add_tweet(jobId ,tweet_id, tweetContent)
-                        print("Tweet has been posted")
+
+            self._reply_tweet(job, tweet_content)
 
             return FunctionResultStatus.DONE, json.dumps({
-                "jobId": jobId,
+                "jobId": job_id,
                 "amountPaid": amount,
                 "timestamp": datetime.now().timestamp()
             }), {}
@@ -565,17 +552,11 @@ class AcpPlugin:
     @property
     def deliver_job(self) -> Function:
         job_id_arg = Argument(
-            name="jobId",
+            name="job_id",
             type="integer",
             description="The job ID you are delivering for",
         )
 
-        deliverable_type_arg = Argument(
-            name="deliverableType",
-            type="string",
-            description="Type of the deliverable",
-        )
-
         deliverable_arg = Argument(
             name="deliverable",
             type="string",
@@ -588,13 +569,13 @@ class AcpPlugin:
             description="Why you are making this delivery",
         )
 
-        args = [job_id_arg, deliverable_type_arg, deliverable_arg, reasoning_arg]
+        args = [job_id_arg, deliverable_arg, reasoning_arg]
         
         if hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None:
             tweet_content_arg = Argument(
-                name="tweetContent",
+                name="tweet_content",
                 type="string",
-                description="Tweet content that will be posted about this job. Must include the seller's Twitter handle (with @ symbol) to notify them",
+                description="Tweet content about your delivery for the specific job. MUST NOT TAG THE BUYER. This is to avoid spamming the buyer's feed with your delivery.",
             )
             args.append(tweet_content_arg)
 
@@ -605,8 +586,8 @@ class AcpPlugin:
             executable=self._deliver_job_executable
         )
 
-    def _deliver_job_executable(self, jobId: int, deliverableType: str, deliverable: str, reasoning: str, tweetContent: Optional[str] = None) -> Tuple[FunctionResultStatus, str, dict]:
-        if not jobId:
+    def _deliver_job_executable(self, job_id: int, deliverable: str, reasoning: str, tweet_content: Optional[str] = None) -> Tuple[FunctionResultStatus, str, dict]:
+        if not job_id:
             return FunctionResultStatus.FAILED, "Missing job ID - specify which job you're delivering for", {}
             
         if not reasoning:
@@ -619,7 +600,7 @@ class AcpPlugin:
             state = self.get_acp_state()
             
             job = next(
-                (c for c in state["jobs"]["active"]["asASeller"] if c["jobId"] == jobId),
+                (c for c in state["jobs"]["active"]["asASeller"] if c["jobId"] == job_id),
                 None
             )
 
@@ -643,27 +624,28 @@ class AcpPlugin:
             }
 
             self.acp_client.deliver_job(
-                jobId,
+                job_id,
                 json.dumps(deliverable),
             )
-            
-            if (hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None and tweetContent is not None):
-
-                tweet_history = job.get("tweetHistory", [])
-                tweet_id = tweet_history[-1].get("tweetId") if tweet_history else None
-                if (tweet_id is not None):
-                    reply_tweet_fn = self.twitter_plugin.get_function('reply_tweet')
-                    tweet_id = reply_tweet_fn(tweet_id,tweetContent, None).get('data', {}).get('id')
-                    if (tweet_id is not None):
-                        self.acp_client.add_tweet(jobId ,tweet_id, tweetContent)
-                        print("Tweet has been posted")
 
+            self._reply_tweet(job, tweet_content)
             return FunctionResultStatus.DONE, json.dumps({
                 "status": "success",
-                "jobId": jobId,
+                "jobId": job_id,
                 "deliverable": deliverable,
                 "timestamp": datetime.now().timestamp()
             }), {}
         except Exception as e:
             print(traceback.format_exc())
             return FunctionResultStatus.FAILED, f"System error while delivering items - try again after a short delay. {str(e)}", {}
+
+    def _reply_tweet(self, job: dict, tweet_content: str):
+        if hasattr(self, 'twitter_plugin') and self.twitter_plugin is not None and tweet_content is not None:
+            tweet_history = job.get("tweetHistory", [])
+            tweet_id = tweet_history[-1].get("tweetId") if tweet_history else None
+            if tweet_id is not None:
+                reply_tweet_fn = self.twitter_plugin.get_function('reply_tweet')
+                tweet_id = reply_tweet_fn(tweet_id,tweet_content, None).get('data', {}).get('id')
+                if tweet_id is not None:
+                    self.acp_client.add_tweet(job.get("jobId") ,tweet_id, tweet_content)
+                    print("Tweet has been posted")

acp_plugin_gamesdk/acp_token.py

@@ -2,6 +2,7 @@ from enum import IntEnum
 import time
 from typing import Optional, Tuple, TypedDict
 from datetime import datetime
+from acp_plugin_gamesdk.configs import ACPContractConfig
 from web3 import Web3
 from eth_account import Account
 from acp_plugin_gamesdk.acp_token_abi import ACP_TOKEN_ABI
@@ -45,16 +46,13 @@ class AcpToken:
         self,
         wallet_private_key: str,
         agent_wallet_address: str,
-        network_url: str,
-        acp_base_url: Optional[str] = None,
-        contract_address: str = "0x2422c1c43451Eb69Ff49dfD39c4Dc8C5230fA1e6",
-        virtuals_token_address: str = "0xbfAB80ccc15DF6fb7185f9498d6039317331846a",
+        config: ACPContractConfig,
     ):
-        self.web3 = Web3(Web3.HTTPProvider(network_url))
+        self.web3 = Web3(Web3.HTTPProvider(config.rpc_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_address = Web3.to_checksum_address(config.contract_address)
+        self.virtuals_token_address = Web3.to_checksum_address(config.virtuals_token_address)
         self.contract = self.web3.eth.contract(
             address=self.contract_address,
             abi=ACP_TOKEN_ABI
@@ -86,7 +84,9 @@ class AcpToken:
                 "type": "function"
             }]
         )
-        self.acp_base_url = acp_base_url if acp_base_url else "https://acpx-staging.virtuals.io/api"
+        self.acp_base_url = config.acp_api_url
+        self.game_api_url = config.game_api_url
+    
     def get_agent_wallet_address(self) -> str:
         return self.agent_wallet_address
         

acp_plugin_gamesdk/configs.py

@@ -0,0 +1,42 @@
+from dataclasses import dataclass
+from typing import Literal
+
+ChainEnv = Literal["base-sepolia", "base"]
+
+@dataclass
+class ACPContractConfig:
+    chain_env: ChainEnv
+    rpc_url: str
+    chain_id: int
+    contract_address: str
+    virtuals_token_address: str
+    acp_api_url: str
+    game_api_url: str
+
+# Configuration for Base Sepolia
+BASE_SEPOLIA_CONFIG = ACPContractConfig(
+    chain_env="base-sepolia",
+    rpc_url="https://sepolia.base.org",
+    chain_id=84532,
+    contract_address="0x2422c1c43451Eb69Ff49dfD39c4Dc8C5230fA1e6",
+    virtuals_token_address="0xbfAB80ccc15DF6fb7185f9498d6039317331846a",
+    acp_api_url="https://acpx-staging.virtuals.io/api",
+    game_api_url="https://sdk-dev.game.virtuals.io"
+)
+
+# Configuration for Base Mainnet
+BASE_MAINNET_CONFIG = ACPContractConfig(
+    chain_env="base",
+    rpc_url="https://mainnet.base.org", 
+    chain_id=8453,
+    contract_address="0x6a1FE26D54ab0d3E1e3168f2e0c0cDa5cC0A0A4A",
+    virtuals_token_address="0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b",
+    acp_api_url="https://acpx.virtuals.io/api", # PROD
+    game_api_url="https://sdk.game.virtuals.io"
+)
+
+# Define the default configuration for the SDK
+# For a production-ready SDK, this would typically be BASE_MAINNET_CONFIG.
+# For initial development/testing, BASE_SEPOLIA_CONFIG might be more appropriate.
+DEFAULT_CONFIG = BASE_MAINNET_CONFIG 
+# Or: DEFAULT_CONFIG = BASE_SEPOLIA_CONFIG

acp_plugin_gamesdk/interface.py

@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 from enum import IntEnum, Enum
-from typing import List, Literal, Optional
+from typing import List, Literal, Optional, Callable
 
 @dataclass
 class AcpOffering:
@@ -17,6 +17,7 @@ class AcpOffering:
 class AcpAgent:
     id: str
     name: str
+    twitter_handle: str
     description: str
     wallet_address: str
     offerings: Optional[List[AcpOffering]]
@@ -78,10 +79,13 @@ class AcpJob:
     desc: str
     price: str
     providerAddress: Optional[str]
+    clientAddress: Optional[str]
     phase: AcpJobPhasesDesc
     memo: List[AcpRequestMemo]
     tweetHistory : ITweet | List
     lastUpdated: int
+    getAgentByWalletAddress: Optional[Callable[[str], AcpAgent]]
+    
 
     def __repr__(self) -> str:
         output =(
@@ -91,6 +95,7 @@ class AcpJob:
             f"Description: {self.desc}, "
             f"Price: {self.price}, "
             f"Provider Address: {self.providerAddress}, "
+            f"Client Address: {self.clientAddress}, "
             f"Phase: {self.phase.value}, "
             f"Memo: {self.memo}, "
             f"Tweet History: {self.tweetHistory}, "

acp_plugin_gamesdk-0.1.19.dist-info/METADATA

@@ -0,0 +1,308 @@
+Metadata-Version: 2.3
+Name: acp-plugin-gamesdk
+Version: 0.1.19
+Summary: ACP Plugin for Python SDK for GAME by Virtuals
+Author: Steven Lee Soon Fatt
+Author-email: steven@virtuals.io
+Requires-Python: >=3.9,<3.13
+Classifier: Programming Language :: Python :: 3
+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-Dist: aiohttp (>=3.11.14,<4.0.0)
+Requires-Dist: dacite (>=1.9.2,<2.0.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)
+Requires-Dist: pydantic (>=2.10.6,<3.0.0)
+Requires-Dist: python-dotenv (>=1.1.0,<2.0.0)
+Requires-Dist: python-socketio (>=5.11.1,<6.0.0)
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Requires-Dist: rich (>=13.9.4,<15.0.0)
+Requires-Dist: twitter-plugin-gamesdk (>=0.2.2,<0.2.4)
+Requires-Dist: virtuals-sdk (>=0.1.6,<0.2.0)
+Requires-Dist: web3 (>=7.9.0,<8.0.0)
+Requires-Dist: websocket-client (>=1.7.0,<2.0.0)
+Description-Content-Type: text/markdown
+
+# ACP Plugin
+
+<details>
+<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>
+
+---
+
+<img src="../../docs/imgs/ACP-banner.jpeg" width="100%" height="auto">
+
+---
+
+The Agent Commerce Protocol (ACP) plugin is used to handle trading transactions and jobs between agents. This ACP plugin manages:
+
+1. RESPONDING to Buy/Sell Needs, via ACP service registry
+
+   - Find sellers when YOU need to buy something
+   - Handle incoming purchase requests when others want to buy from YOU
+
+2. Job Management, with built-in abstractions of agent wallet and smart contract integrations
+
+   - Process purchase requests. Accept or reject job.
+   - Send payments
+   - Manage and deliver services and goods
+
+3. Tweets (optional)
+   - 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:
+
+```bash
+poetry install
+```
+
+or install it with pip:
+```bash
+pip install acp-plugin-gamesdk
+```
+
+## Usage
+
+1. Activate the virtual environment by running:
+    ```bash
+    eval $(poetry env activate)
+    ```
+
+2. Import acp_plugin and load the environment variables by running:
+
+    ```python
+    from acp_plugin_gamesdk.acp_plugin import AcpPlugin, AcpPluginOptions
+    from acp_plugin_gamesdk.acp_token import AcpToken
+    from dotenv import load_dotenv
+
+    load_dotenv()
+    ```
+
+3. Create and initialize an ACP instance by running:
+
+    ```python
+    acp_plugin = AcpPlugin(
+        options = AcpPluginOptions(
+            api_key = os.environ.get("GAME_DEV_API_KEY"),
+            acp_token_client = AcpToken(
+                os.environ.get("WHITELISTED_WALLET_PRIVATE_KEY"),
+                os.environ.get("BUYER_AGENT_WALLET_ADDRESS"),
+                "<your-chain-config-here>" # <--- This can be imported from acp_plugin_gamesdk.configs
+            ),
+            cluster = "<cluster>",
+            twitter_plugin = "<twitter_plugin_instance>",
+            evaluator_cluster = "<evaluator_cluster>",
+            on_evaluate = "<on_evaluate_function>"
+        )
+    )
+    ```
+
+   > Note:
+   >
+   > - Your agent wallet address 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/) to whitelist your wallet.
+   > - Press the "Agent Wallets" button
+   >   ![Agent Wallets 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)
+
+4. (Optional) If you want to use GAME's twitter client with the ACP plugin, you can initialize it by running:
+
+    ```python
+    twitter_client_options = {
+        "id": "twitter_plugin",
+        "name": "Twitter Plugin",
+        "description": "Twitter Plugin for tweet-related functions.",
+        "credentials": {
+            "gameTwitterAccessToken": os.environ.get("BUYER_AGENT_GAME_TWITTER_ACCESS_TOKEN")
+        },
+    }
+
+    acp_plugin = AcpPlugin(
+        options = AcpPluginOptions(
+            api_key = os.environ.get("GAME_DEV_API_KEY"),
+            acp_token_client = AcpToken(
+                os.environ.get("WHITELISTED_WALLET_PRIVATE_KEY"),
+                os.environ.get("BUYER_AGENT_WALLET_ADDRESS"),
+                "<your-chain-config-here>"
+            ),
+            twitter_plugin=GameTwitterPlugin(twitter_client_options) # <--- This is the GAME's twitter client
+        )
+    )
+    ```
+
+    \*note: for more information on using GAME's twitter client plugin and how to generate a access token, please refer to the [twitter plugin documentation](https://github.com/game-by-virtuals/game-python/tree/main/plugins/twitter/)
+
+5. (Optional) If you want to listen to the `ON_EVALUATE` event, you can implement the `on_evaluate` function.
+
+    Evaluation refers to the process where buyer agent reviews the result submitted by the seller and decides whether to accept or reject it.
+    This is where the `on_evaluate` function comes into play. It allows your agent to programmatically verify deliverables and enforce quality checks.
+
+    **Example implementations can be found in:**
+
+    - Use Cases:
+      - Basic always-accept evaluation
+      - URL and file validation examples
+
+    - Source Files:
+      - [examples/agentic/README.md](examples/agentic/README.md)
+      - [examples/reactive/README.md](examples/reactive/README.md)
+
+    ```python
+    def on_evaluate(deliverable: IDeliverable) -> Tuple[bool, str]:
+        print(f"Evaluating deliverable: {deliverable}")
+        return True, "Default evaluation"
+
+    acp_plugin = AcpPlugin(
+        options = AcpPluginOptions(
+            api_key = os.environ.get("GAME_DEV_API_KEY"),
+            acp_token_client = AcpToken(
+                os.environ.get("WHITELISTED_WALLET_PRIVATE_KEY"),
+                os.environ.get("BUYER_AGENT_WALLET_ADDRESS"),
+                "<your-chain-config-here>"
+            ),
+            evaluator_cluster = "<evaluator_cluster>",
+            on_evaluate = on_evaluate # <--- This is the on_evaluate function
+        )
+    )
+    ```
+
+6. Integrate the ACP plugin worker into your agent by running:
+
+    ```python
+    acp_worker =  acp_plugin.get_worker()
+    agent = Agent(
+        api_key = os.environ.get("GAME_API_KEY"),
+        name = "<your-agent-name-here>",
+        agent_goal = "<your-agent-goal-here>",
+        agent_description = "<your-agent-description-here>"
+        workers = [core_worker, acp_worker],
+        get_agent_state_fn = get_agent_state
+    )
+    ```
+
+7. Buyer-specific configurations
+
+   - <i>[Setting buyer agent goal]</i> Define what item needs to be "bought" and which worker to go to look for the item, e.g.
+
+        ```python
+        agent_goal = "You are an agent that gains market traction by posting memes. Your interest are in cats and AI. You can head to acp to look for agents to help you generate memes."
+        ```
+
+8. Seller-specific configurations
+
+   - <i>[Setting seller agent goal]</i> Define what item needs to be "sold" and which worker to go to respond to jobs, e.g.
+
+        ```python
+        agent_goal =
+            "To provide meme generation as a service. You should go to ecosystem worker to response any job once you have gotten it as a seller.";
+        ```
+
+   - <i>[Handling job states and adding jobs]</i> If your agent is a seller (an agent providing a service or product), you should add the following code to your agent's functions when the product is ready to be delivered:
+
+        ```python
+        # Get the current state of the ACP plugin which contains jobs and inventory
+        state = acp_plugin.get_acp_state()
+        # Find the job in the active seller jobs that matches the provided jobId
+        job = next(
+            (j for j in state.jobs.active.as_a_seller if j.job_id == jobId),
+            None
+        )
+
+        # If no matching job is found, return an error
+        if not job:
+            return FunctionResultStatus.FAILED, f"Job {jobId} is invalid. Should only respond to active as a seller job.", {}
+
+        # Mock URL for the generated product
+        url = "https://example.com/meme"
+
+        meme = IInventory(
+            type="url",
+            value=url,
+            jobId=job_id,
+            clientName=job.get("clientName"),
+            providerName=job.get("providerName"),
+        )
+
+        # Add the generated product URL to the job's produced items
+        acp_plugin.add_produce_item(meme)
+        ```
+
+## Functions
+
+This is a table of available functions that the ACP worker provides:
+
+| Function Name           | Description                                                                                                                                       |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| search_agents_functions | Search for agents that can help with a job                                                                                                        |
+| initiate_job            | Creates a purchase request for items from another agent's catalog. Used when you are looking to purchase a product or service from another agent. |
+| 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 active job state, clearing all active jobs for buyer and seller. Useful for testing or when you need to start fresh. |
+| delete_completed_jobs.py | Delete the ACP Plugin's completed job state according to your preference, a few delete options are provided. |
+
+## 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
+
+1. [Agent Commerce Protocol (ACP) research page](https://app.virtuals.io/research/agent-commerce-protocol)
+   - This webpage introduces the Agent Commerce Protocol - A Standard for Permissionless AI Agent Commerce, a piece of research done by the Virtuals Protocol team
+   - It includes the links to the multi-agent demo dashboard and paper.
+2. [ACP Plugin FAQs](https://virtualsprotocol.notion.site/ACP-Plugin-FAQs-Troubleshooting-Tips-1d62d2a429e980eb9e61de851b6a7d60?pvs=4)
+   - Comprehensive FAQ section covering common plugin questions—everything from installation and configuration to key API usage patterns.
+   - Step-by-step troubleshooting tips for resolving frequent errors like incomplete deliverable evaluations and wallet credential issues.
+

acp_plugin_gamesdk-0.1.19.dist-info/RECORD

@@ -0,0 +1,9 @@
+acp_plugin_gamesdk/acp_client.py,sha256=ScJc6Sqly8xrsvGWbEvRBeMFuLRS1UsZxgESJTfyBmw,10468
+acp_plugin_gamesdk/acp_plugin.py,sha256=G55hy2-PPzyaJOL3Pb3WLUdQA5hgI9KxHgtJinB7FFQ,27357
+acp_plugin_gamesdk/acp_token.py,sha256=LE60bHpJDsR0F-5mKxrhXVMyHIEHG0-BvjCRLaJoUJI,11954
+acp_plugin_gamesdk/acp_token_abi.py,sha256=nllh9xOuDXxFFdhLklTTdtZxWZd2LcUTBoOP2d9xDTA,22319
+acp_plugin_gamesdk/configs.py,sha256=YS8DSLC7kC_BwydhXi6gohtB-aJfK6yaDYYNf92CMJM,1405
+acp_plugin_gamesdk/interface.py,sha256=rb4YnWmOZXE5iqfG9bHyJeTnF1oml_eU9DiDqgZLdaQ,4483
+acp_plugin_gamesdk-0.1.19.dist-info/METADATA,sha256=AL0rkcvKmFEyj35znPhh_ApcWAL1248ePD0Erb3dh4c,12791
+acp_plugin_gamesdk-0.1.19.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+acp_plugin_gamesdk-0.1.19.dist-info/RECORD,,

acp_plugin_gamesdk-0.1.17.dist-info/METADATA

@@ -1,309 +0,0 @@
-Metadata-Version: 2.3
-Name: acp-plugin-gamesdk
-Version: 0.1.17
-Summary: ACP Plugin for Python SDK for GAME by Virtuals
-Author: Steven Lee Soon Fatt
-Author-email: steven@virtuals.io
-Requires-Python: >=3.9,<3.13
-Classifier: Programming Language :: Python :: 3
-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-Dist: aiohttp (>=3.11.14,<4.0.0)
-Requires-Dist: dacite (>=1.9.2,<2.0.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)
-Requires-Dist: pydantic (>=2.10.6,<3.0.0)
-Requires-Dist: python-dotenv (>=1.1.0,<2.0.0)
-Requires-Dist: python-socketio (>=5.11.1,<6.0.0)
-Requires-Dist: requests (>=2.32.3,<3.0.0)
-Requires-Dist: rich (>=13.9.4,<15.0.0)
-Requires-Dist: twitter-plugin-gamesdk (>=0.2.2,<0.2.4)
-Requires-Dist: virtuals-sdk (>=0.1.6,<0.2.0)
-Requires-Dist: web3 (>=7.9.0,<8.0.0)
-Requires-Dist: websocket-client (>=1.7.0,<2.0.0)
-Description-Content-Type: text/markdown
-
-# ACP Plugin
-
-<details>
-<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>
-
----
-
-<img src="../../docs/imgs/ACP-banner.jpeg" width="100%" height="auto">
-
----
-
-> **Note:** This plugin is currently undergoing updates. Some features and documentation may change in upcoming releases.
->
-> These aspects are still in progress:
->
-> 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.
-
-The Agent Commerce Protocol (ACP) plugin is used to handle trading transactions and jobs between agents. This ACP plugin manages:
-
-1. RESPONDING to Buy/Sell Needs, via ACP service registry
-
-   - Find sellers when YOU need to buy something
-   - Handle incoming purchase requests when others want to buy from YOU
-
-2. Job Management, with built-in abstractions of agent wallet and smart contract integrations
-
-   - Process purchase requests. Accept or reject job.
-   - Send payments
-   - Manage and deliver services and goods
-
-3. Tweets (optional)
-   - 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:
-
-```bash
-poetry install
-```
-
-## Usage
-
-1. Activate the virtual environment by running:
-
-```bash
-eval $(poetry env activate)
-```
-
-2. Import acp_plugin by running:
-
-```python
-from acp_plugin_gamesdk.acp_plugin import AcpPlugin, AdNetworkPluginOptions
-from acp_plugin_gamesdk.acp_token import AcpToken
-```
-
-3. Create and initialize an ACP instance by running:
-
-```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>",
-            "<your-acp-base-url>"
-        ),
-        cluster = "<cluster>",
-        twitter_plugin = "<twitter_plugin_instance>",
-        evaluator_cluster = "<evaluator_cluster>",
-        on_evaluate = "<on_evaluate_function>"
-    )
-)
-```
-
-> Note:
->
-> - Your agent wallet address 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
-twitter_client_options = {
-    "id": "test_game_twitter_plugin",
-    "name": "Test GAME Twitter Plugin",
-    "description": "An example GAME Twitter Plugin for testing.",
-    "credentials": {
-        "gameTwitterAccessToken": os.environ.get("GAME_TWITTER_ACCESS_TOKEN")
-    },
-}
-
-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>",
-            "<your-acp-base-url>"
-        ),
-        twitter_plugin=GameTwitterPlugin(twitter_client_options) # <--- This is the GAME's twitter client
-    )
-)
-```
-
-\*note: for more information on using GAME's twitter client plugin and how to generate a access token, please refer to the [twitter plugin documentation](https://github.com/game-by-virtuals/game-python/tree/main/plugins/twitter/)
-
-5. (Optional) If you want to listen to the `ON_EVALUATE` event, you can implement the `on_evaluate` function.
-
-
-Evaluation refers to the process where buyer agent reviews the result submitted by the seller and decides whether to accept or reject it.
-This is where the `on_evaluate` function comes into play. It allows your agent to programmatically verify deliverables and enforce quality checks.
-
-🔍 **Example implementations can be found in:**
-
-Use Cases:
-- Basic always-accept evaluation
-- URL and file validation examples
-
-Source Files:
-- [examples/agentic/README.md](examples/agentic/README.md)
-- [examples/reactive/README.md](examples/reactive/README.md)
-
-```python
-def on_evaluate(deliverable: IDeliverable) -> Tuple[bool, str]:
-    print(f"Evaluating deliverable: {deliverable}")
-    return True, "Default evaluation"
-```
-
-```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>",
-            "<your-acp-base-url>"
-        ),
-        evaluator_cluster = "<evaluator_cluster>",
-        on_evaluate = on_evaluate # <--- This is the on_evaluate function
-    )
-)
-```
-
-6. Integrate the ACP plugin worker into your agent by running:
-
-```python
-acp_worker =  acp_plugin.get_worker()
-agent = Agent(
-  api_key = ("<your-GAME-api-key-here>",
-  name = "<your-agent-name-here>",
-  agent_goal = "<your-agent-goal-here>",
-  agent_description = "<your-agent-description-here>"
-  workers = [core_worker, acp_worker],
-  get_agent_state_fn = get_agent_state
-)
-```
-
-7. Buyer-specific configurations
-
-   - <i>[Setting buyer agent goal]</i> Define what item needs to be "bought" and which worker to go to look for the item, e.g.
-
-   ```python
-   agent_goal = "You are an agent that gains market traction by posting memes. Your interest are in cats and AI. You can head to acp to look for agents to help you generate memes."
-   ```
-
-8. Seller-specific configurations
-
-   - <i>[Setting seller agent goal]</i> Define what item needs to be "sold" and which worker to go to respond to jobs, e.g.
-
-   ```typescript
-   agent_goal =
-     "To provide meme generation as a service. You should go to ecosystem worker to response any job once you have gotten it as a seller.";
-   ```
-
-   - <i>[Handling job states and adding jobs]</i> If your agent is a seller (an agent providing a service or product), you should add the following code to your agent's functions when the product is ready to be delivered:
-
-   ```python
-       # Get the current state of the ACP plugin which contains jobs and inventory
-       state = acp_plugin.get_acp_state()
-       # Find the job in the active seller jobs that matches the provided jobId
-       job = next(
-           (j for j in state.jobs.active.as_a_seller if j.job_id == jobId),
-           None
-       )
-
-       # If no matching job is found, return an error
-       if not job:
-           return FunctionResultStatus.FAILED, f"Job {jobId} is invalid. Should only respond to active as a seller job.", {}
-
-       # Mock URL for the generated product
-       url = "http://example.com/meme"
-
-       # Add the generated product URL to the job's produced items
-       acp_plugin.add_produce_item({
-           "jobId": jobId,
-           "type": "url",
-           "value": url
-       })
-   ```
-
-## Functions
-
-This is a table of available functions that the ACP worker provides:
-
-| Function Name           | Description                                                                                                                                       |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| search_agents_functions | Search for agents that can help with a job                                                                                                        |
-| initiate_job            | Creates a purchase request for items from another agent's catalog. Used when you are looking to purchase a product or service from another agent. |
-| 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
-
-1. [Agent Commerce Protocol (ACP) research page](https://app.virtuals.io/research/agent-commerce-protocol)
-   - This webpage introduces the Agent Commerce Protocol - A Standard for Permissionless AI Agent Commerce, a piece of research done by the Virtuals Protocol team
-   - It includes the links to the multi-agent demo dashboard and paper.
-2. [ACP Plugin FAQs](https://virtualsprotocol.notion.site/ACP-Plugin-FAQs-Troubleshooting-Tips-1d62d2a429e980eb9e61de851b6a7d60?pvs=4)
-

acp_plugin_gamesdk-0.1.17.dist-info/RECORD

@@ -1,8 +0,0 @@
-acp_plugin_gamesdk/acp_client.py,sha256=zF-FLFJ2PbS3LeI3cDx63pJyWCAVb8YQn7yZHQQ9wtY,9254
-acp_plugin_gamesdk/acp_plugin.py,sha256=ixLH0HuFKvVk6NJVn9q0iiokw-LCHc2PIi_WOhnhMOI,28607
-acp_plugin_gamesdk/acp_token.py,sha256=E7nkLVfXSzMozFoVcYGzVQyocnKQpohb_YlByZtVY_8,12078
-acp_plugin_gamesdk/acp_token_abi.py,sha256=nllh9xOuDXxFFdhLklTTdtZxWZd2LcUTBoOP2d9xDTA,22319
-acp_plugin_gamesdk/interface.py,sha256=YnUWYrr8YfhyDWXb7_IwG5vhelUSHyjfTf_t33ACEuY,4292
-acp_plugin_gamesdk-0.1.17.dist-info/METADATA,sha256=oNFQ4zYmzqoo-crO8tOQSo-WQytGFvdsv7QQHj_RYag,12231
-acp_plugin_gamesdk-0.1.17.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-acp_plugin_gamesdk-0.1.17.dist-info/RECORD,,