mech-client 0.14.0__py3-none-any.whl → 0.15.0__py3-none-any.whl

mech_client/__init__.py

@@ -1,3 +1,3 @@
 """Mech client."""
 
-__version__ = "0.14.0"
+__version__ = "0.14.1"

mech_client/cli.py

@@ -20,10 +20,24 @@
 """Mech client CLI module."""
 import json
 import os
+import sys
+from pathlib import Path
 from typing import Any, Dict, List, Optional, Tuple
 
 import click
 from click import ClickException
+from dotenv import load_dotenv, set_key
+from operate.cli import OperateApp
+from operate.cli import logger as operate_logger
+from operate.constants import NO_STAKING_PROGRAM_ID
+from operate.operate_types import ServiceTemplate
+from operate.quickstart.run_service import (
+    QuickstartConfig,
+    ask_password_if_needed,
+    load_local_config,
+    run_service,
+)
+from operate.services.manage import KeysManager
 from tabulate import tabulate  # type: ignore
 
 from mech_client import __version__
@@ -58,10 +72,177 @@ from scripts.deposit_token import main as deposit_token_main
 from scripts.nvm_subscribe import main as nvm_subscribe_main
 
 
+CURR_DIR = Path(__file__).resolve().parent
+BASE_DIR = CURR_DIR.parent
+OPERATE_FOLDER_NAME = ".operate_mech_client"
+SETUP_MODE_COMMAND = "setup-agent-mode"
+DEFAULT_NETWORK = "gnosis"
+
+CHAIN_TO_TEMPLATE = {
+    "gnosis": BASE_DIR / "config" / "mech_client_gnosis.json",
+    "base": BASE_DIR / "config" / "mech_client_base.json",
+    "polygon": BASE_DIR / "config" / "mech_client_polygon.json",
+}
+
+ENV_PATH = BASE_DIR / ".env"
+
+
+def get_operate_path() -> Path:
+    """Fetches the operate path for the mech client service"""
+    home = Path.home()
+    operate_path = home.joinpath(OPERATE_FOLDER_NAME)
+    return operate_path
+
+
+def is_agent_mode(ctx: click.Context) -> bool:
+    """Fetches whether agent mode is on or not"""
+    client_mode = ctx.obj.get("client_mode", False)
+    agent_mode = not client_mode
+    return agent_mode
+
+
+def get_password(operate: OperateApp) -> str:
+    """Load password from env/.env if present, otherwise prompt once and persist."""
+    load_dotenv(dotenv_path=ENV_PATH, override=False)
+    env_password = os.getenv("OPERATE_PASSWORD")
+    if env_password:
+        os.environ["OPERATE_PASSWORD"] = env_password
+        os.environ["ATTENDED"] = "false"
+        return os.environ["OPERATE_PASSWORD"]
+
+    ask_password_if_needed(operate)
+    if not operate.password:
+        raise ClickException("Password could not be set for Operate.")
+
+    set_key(str(ENV_PATH), "OPERATE_PASSWORD", os.environ["OPERATE_PASSWORD"])
+    os.environ["ATTENDED"] = "false"
+    return os.environ["OPERATE_PASSWORD"]
+
+
+def mech_client_configure_local_config(
+    template: ServiceTemplate, operate: "OperateApp"
+) -> QuickstartConfig:
+    """Configure local quickstart configuration."""
+    config = load_local_config(operate=operate, service_name=template["name"])
+
+    if config.rpc is None:
+        config.rpc = {}
+
+    for chain in template["configurations"]:
+        config.rpc[chain] = os.getenv("MECHX_RPC_URL")
+
+    config.principal_chain = template["home_chain"]
+
+    # set chain configs in the service template
+    for chain in template["configurations"]:
+        template["configurations"][chain] |= {
+            "staking_program_id": NO_STAKING_PROGRAM_ID,
+            "rpc": config.rpc[chain],
+            "cost_of_bond": 1,
+        }
+
+    if config.user_provided_args is None:
+        config.user_provided_args = {}
+
+    config.store()
+    return config
+
+
+def fetch_agent_mode_data(
+    chain_config: Optional[str],
+) -> Tuple[str, str, Optional[str]]:
+    """Fetches the agent mode data of safe address and the keystore path plus password"""
+    chain_config = chain_config or DEFAULT_NETWORK
+
+    # This is acceptable way to as the main functionality
+    # of keys manager is to allow access to the required data.
+    operate_path = get_operate_path()
+    operate = OperateApp(operate_path)
+    # Ensure the password is loaded so keys can be decrypted.
+    get_password(operate)
+    keys_manager = KeysManager(
+        path=operate._keys,  # pylint: disable=protected-access
+        logger=operate_logger,
+        password=operate.password,
+    )
+    service_manager = operate.service_manager()
+    service_config_id = None
+    for service in service_manager.json:
+        if service["home_chain"] == chain_config:
+            service_config_id = service["service_config_id"]
+            break
+
+    if not service_config_id:
+        raise ClickException(
+            f"""Cannot find deployed service id for chain {chain_config}. Setup agent mode for a chain using mechx setup-agent-mode cli command."""
+        )
+
+    service = operate.service_manager().load(service_config_id)
+
+    key_path = keys_manager.get_private_key_file(service.agent_addresses[0])
+    safe = service.chain_configs[chain_config].chain_data.multisig
+
+    return safe, str(key_path), os.getenv("OPERATE_PASSWORD")
+
+
 @click.group(name="mechx")  # type: ignore
 @click.version_option(__version__, prog_name="mechx")
-def cli() -> None:
+@click.option(
+    "--client-mode",
+    is_flag=True,
+    help="Enables client mode",
+)
+@click.pass_context
+def cli(ctx: click.Context, client_mode: bool) -> None:
     """Command-line tool for interacting with mechs."""
+    ctx.ensure_object(dict)
+    ctx.obj["client_mode"] = client_mode
+
+    cli_command = ctx.invoked_subcommand if ctx.invoked_subcommand else None
+    is_setup_called = cli_command == SETUP_MODE_COMMAND
+
+    if not is_setup_called and not client_mode:
+        click.echo("Agent mode enabled")
+        operate_path = get_operate_path()
+        if not operate_path.exists():
+            raise ClickException(
+                f"""Operate path does not exists at: {operate_path}. Setup agent mode for a chain using mechx setup-agent-mode cli command."""
+            )
+
+
+@click.command()
+@click.option(
+    "--chain-config",
+    type=str,
+    help="Id of the mech's chain configuration (stored configs/mechs.json)",
+)
+def setup_agent_mode(
+    chain_config: str,
+) -> None:
+    """Sets up the agent mode for users"""
+    template = CHAIN_TO_TEMPLATE.get(chain_config)
+    if template is None:
+        supported_chains = list(CHAIN_TO_TEMPLATE.keys())
+        raise ClickException(
+            f"""{chain_config} chain not supported for agent mode. Supported chains are: {supported_chains}"""
+        )
+
+    operate_path = get_operate_path()
+    operate = OperateApp(operate_path)
+    operate.setup()
+    get_password(operate)
+
+    sys.modules[
+        "operate.quickstart.run_service"
+    ].configure_local_config = mech_client_configure_local_config  # type: ignore
+
+    print(f"Setting up agent mode using config at {template}...")
+    run_service(
+        operate=operate,
+        config_path=template,
+        build_only=True,
+        skip_dependency_check=False,
+    )
 
 
 @click.command()
@@ -133,14 +314,16 @@ def cli() -> None:
     type=str,
     help="Id of the mech's chain configuration (stored configs/mechs.json)",
 )
+@click.pass_context
 def interact(  # pylint: disable=too-many-arguments,too-many-locals
+    ctx: click.Context,
     prompts: tuple,
     agent_id: int,
     priority_mech: str,
     use_prepaid: bool,
     use_offchain: bool,
-    key: Optional[str],
     tools: Optional[tuple],
+    safe: Optional[str] = None,
     extra_attribute: Optional[List[str]] = None,
     confirm: Optional[str] = None,
     retries: Optional[int] = None,
@@ -150,6 +333,11 @@ def interact(  # pylint: disable=too-many-arguments,too-many-locals
 ) -> None:
     """Interact with a mech specifying a prompt and tool."""
     try:
+        agent_mode = is_agent_mode(ctx)
+        click.echo(f"Running interact with agent_mode={agent_mode}")
+        key_path: Optional[str] = None
+        key_password: Optional[str] = None
+
         extra_attributes_dict: Dict[str, Any] = {}
         if extra_attribute:
             for pair in extra_attribute:
@@ -171,13 +359,23 @@ def interact(  # pylint: disable=too-many-arguments,too-many-locals
                     f"The number of prompts ({len(prompts)}) must match the number of tools ({len(tools)})"
                 )
 
+            if agent_mode:
+                safe, key_path, key_password = fetch_agent_mode_data(chain_config)
+                if not safe or not key_path:
+                    raise ClickException(
+                        "Cannot fetch safe or key data for the agent mode."
+                    )
+
             marketplace_interact_(
                 prompts=prompts,
                 priority_mech=priority_mech,
+                agent_mode=agent_mode,
+                safe_address=safe,
                 use_prepaid=use_prepaid,
                 use_offchain=use_offchain,
                 mech_offchain_url=mech_offchain_url,
-                private_key_path=key,
+                private_key_path=key_path,
+                private_key_password=key_password,
                 tools=tools,
                 extra_attributes=extra_attributes_dict,
                 retries=retries,
@@ -205,7 +403,8 @@ def interact(  # pylint: disable=too-many-arguments,too-many-locals
             interact_(
                 prompt=prompts[0],
                 agent_id=agent_id,
-                private_key_path=key,
+                private_key_path=key_path,
+                private_key_password=key_password,
                 tool=tools[0] if tools else None,
                 extra_attributes=extra_attributes_dict,
                 confirmation_type=(
@@ -459,14 +658,29 @@ def tool_io_schema_for_marketplace_mech(tool_id: str, chain_config: str) -> None
     type=click.Path(exists=True, file_okay=True, dir_okay=False),
     help="Path to private key to use for deposit",
 )
+@click.pass_context
 def deposit_native(
+    ctx: click.Context,
     amount_to_deposit: str,
-    key: Optional[str],
+    safe: Optional[str] = None,
     chain_config: Optional[str] = None,
 ) -> None:
     """Deposits Native balance for prepaid requests."""
+    agent_mode = is_agent_mode(ctx)
+    click.echo(f"Running deposit native with agent_mode={agent_mode}")
+
+    if agent_mode:
+        safe, key_path, key_password = fetch_agent_mode_data(chain_config)
+        if not safe or not key_path:
+            raise ClickException("Cannot fetch safe or key data for the agent mode.")
+
     deposit_native_main(
-        amount=amount_to_deposit, private_key_path=key, chain_config=chain_config
+        agent_mode=agent_mode,
+        safe_address=safe,
+        amount=amount_to_deposit,
+        private_key_path=key_path,
+        private_key_password=key_password,
+        chain_config=chain_config,
     )
 
 
@@ -482,14 +696,29 @@ def deposit_native(
     type=click.Path(exists=True, file_okay=True, dir_okay=False),
     help="Path to private key to use for deposit",
 )
+@click.pass_context
 def deposit_token(
+    ctx: click.Context,
     amount_to_deposit: str,
-    key: Optional[str],
+    safe: Optional[str] = None,
     chain_config: Optional[str] = None,
 ) -> None:
     """Deposits Token balance for prepaid requests."""
+    agent_mode = is_agent_mode(ctx)
+    click.echo(f"Running deposit token with agent_mode={agent_mode}")
+
+    if agent_mode:
+        safe, key_path, key_password = fetch_agent_mode_data(chain_config)
+        if not safe or not key_path:
+            raise ClickException("Cannot fetch safe or key data for the agent mode.")
+
     deposit_token_main(
-        amount=amount_to_deposit, private_key_path=key, chain_config=chain_config
+        agent_mode=agent_mode,
+        safe_address=safe,
+        amount=amount_to_deposit,
+        private_key_path=key_path,
+        private_key_password=key_password,
+        chain_config=chain_config,
     )
 
 
@@ -504,12 +733,28 @@ def deposit_token(
     type=click.Path(exists=True, file_okay=True, dir_okay=False),
     help="Path to private key to use for deposit",
 )
+@click.pass_context
 def nvm_subscribe(
-    key: str,
+    ctx: click.Context,
     chain_config: str,
+    safe: Optional[str] = None,
 ) -> None:
     """Allows to purchase nvm subscription for nvm mech requests."""
-    nvm_subscribe_main(private_key_path=key, chain_config=chain_config)
+    agent_mode = is_agent_mode(ctx)
+    click.echo(f"Running purchase nvm subscription with agent_mode={agent_mode}")
+
+    if agent_mode:
+        safe, key_path, key_password = fetch_agent_mode_data(chain_config)
+        if not safe or not key_path:
+            raise ClickException("Cannot fetch safe or key data for the agent mode.")
+
+    nvm_subscribe_main(
+        agent_mode=agent_mode,
+        safe_address=safe,
+        private_key_path=key_path,
+        private_key_password=key_password,
+        chain_config=chain_config,
+    )
 
 
 @click.command(name="fetch-mm-mechs-info")
@@ -560,6 +805,7 @@ def query_mm_mechs_info_cli(
         return None
 
 
+cli.add_command(setup_agent_mode)
 cli.add_command(interact)
 cli.add_command(prompt_to_ipfs)
 cli.add_command(push_to_ipfs)
@@ -577,4 +823,4 @@ cli.add_command(query_mm_mechs_info_cli)
 
 
 if __name__ == "__main__":
-    cli()
+    cli()  # pylint: disable=no-value-for-parameter

mech_client/configs/mechs.json

@@ -1,116 +1,116 @@
 {
-    "gnosis": {
-        "agent_registry_contract": "0xE49CB081e8d96920C38aA7AB90cb0294ab4Bc8EA",
-        "service_registry_contract": "0x9338b5153AE39BB89f50468E608eD9d764B755fD",
-        "mech_marketplace_contract": "0x735FAAb1c4Ec41128c367AFb5c3baC73509f70bB",
-        "complementary_metadata_hash_address": "0x0598081D48FB80B0A7E52FAD2905AE9beCd6fC69",
-        "rpc_url": "https://rpc.eu-central-2.gateway.fm/v4/gnosis/non-archival/mainnet",
-        "wss_endpoint": "wss://rpc.gnosischain.com/wss",
-        "ledger_config": {
-            "address": "https://rpc.eu-central-2.gateway.fm/v4/gnosis/non-archival/mainnet",
-            "chain_id": 100,
-            "poa_chain": false,
-            "default_gas_price_strategy": "eip1559",
-            "is_gas_estimation_enabled": false
-        },
-        "gas_limit": 500000,
-        "price": 10000000000000000,
-        "transaction_url": "https://gnosisscan.io/tx/{transaction_digest}",
-        "subgraph_url": "https://api.studio.thegraph.com/query/89372/olas-gnosis-mech-marketplace/v0.0.2"
+  "gnosis": {
+    "agent_registry_contract": "0xE49CB081e8d96920C38aA7AB90cb0294ab4Bc8EA",
+    "service_registry_contract": "0x9338b5153AE39BB89f50468E608eD9d764B755fD",
+    "mech_marketplace_contract": "0x735FAAb1c4Ec41128c367AFb5c3baC73509f70bB",
+    "complementary_metadata_hash_address": "0x0598081D48FB80B0A7E52FAD2905AE9beCd6fC69",
+    "rpc_url": "https://rpc.eu-central-2.gateway.fm/v4/gnosis/non-archival/mainnet",
+    "wss_endpoint": "wss://rpc.gnosischain.com/wss",
+    "ledger_config": {
+      "address": "https://rpc.eu-central-2.gateway.fm/v4/gnosis/non-archival/mainnet",
+      "chain_id": 100,
+      "poa_chain": false,
+      "default_gas_price_strategy": "eip1559",
+      "is_gas_estimation_enabled": false
     },
-    "arbitrum": {
-        "agent_registry_contract": "0xa4799B083E0068732456EF45ff9fe5c683658327",
-        "service_registry_contract": "0xE3607b00E75f6405248323A9417ff6b39B244b50",
-        "mech_marketplace_contract": "0x0000000000000000000000000000000000000000",
-        "complementary_metadata_hash_address": "0x0000000000000000000000000000000000000000",
-        "rpc_url": "https://arbitrum.llamarpc.com",
-        "wss_endpoint": "wss://arbitrum.gateway.tenderly.co",
-        "ledger_config": {
-            "address": "https://arbitrum.llamarpc.com",
-            "chain_id": 42161,
-            "poa_chain": false,
-            "default_gas_price_strategy": "eip1559",
-            "is_gas_estimation_enabled": false
-        },
-        "gas_limit": 100000,
-        "price": 3000000000000,
-        "transaction_url": "https://arbiscan.io/tx/{transaction_digest}",
-        "subgraph_url": ""
+    "gas_limit": 500000,
+    "price": 10000000000000000,
+    "transaction_url": "https://gnosisscan.io/tx/{transaction_digest}",
+    "subgraph_url": "https://api.studio.thegraph.com/query/89372/olas-gnosis-mech-marketplace/v0.0.2"
+  },
+  "arbitrum": {
+    "agent_registry_contract": "0xa4799B083E0068732456EF45ff9fe5c683658327",
+    "service_registry_contract": "0xE3607b00E75f6405248323A9417ff6b39B244b50",
+    "mech_marketplace_contract": "0x0000000000000000000000000000000000000000",
+    "complementary_metadata_hash_address": "0x0000000000000000000000000000000000000000",
+    "rpc_url": "https://arbitrum.llamarpc.com",
+    "wss_endpoint": "wss://arbitrum.gateway.tenderly.co",
+    "ledger_config": {
+      "address": "https://arbitrum.llamarpc.com",
+      "chain_id": 42161,
+      "poa_chain": false,
+      "default_gas_price_strategy": "eip1559",
+      "is_gas_estimation_enabled": false
     },
-    "polygon": {
-        "agent_registry_contract": "0x984cf72FDe8B5aA910e9e508aC5e007ae5BDcC9C",
-        "service_registry_contract": "0xE3607b00E75f6405248323A9417ff6b39B244b50",
-        "mech_marketplace_contract": "0x0000000000000000000000000000000000000000",
-        "complementary_metadata_hash_address": "0x0000000000000000000000000000000000000000",
-        "rpc_url": "https://polygon-bor-rpc.publicnode.com",
-        "wss_endpoint": "wss://polygon.gateway.tenderly.co",
-        "ledger_config": {
-            "address": "https://polygon-bor-rpc.publicnode.com",
-            "chain_id": 137,
-            "poa_chain": true,
-            "default_gas_price_strategy": "eip1559",
-            "is_gas_estimation_enabled": false
-        },
-        "gas_limit": 100000,
-        "price": 10000000000000000,
-        "transaction_url": "https://polygonscan.com/tx/{transaction_digest}",
-        "subgraph_url": ""
+    "gas_limit": 100000,
+    "price": 3000000000000,
+    "transaction_url": "https://arbiscan.io/tx/{transaction_digest}",
+    "subgraph_url": ""
+  },
+  "polygon": {
+    "agent_registry_contract": "0x984cf72FDe8B5aA910e9e508aC5e007ae5BDcC9C",
+    "service_registry_contract": "0xE3607b00E75f6405248323A9417ff6b39B244b50",
+    "mech_marketplace_contract": "0x343F2B005cF6D70bA610CD9F1F1927049414B582",
+    "complementary_metadata_hash_address": "0xDC175E77d11246c79B23D7088750eb59160DD6b7",
+    "rpc_url": "https://polygon-bor-rpc.publicnode.com",
+    "wss_endpoint": "wss://polygon.gateway.tenderly.co",
+    "ledger_config": {
+      "address": "https://polygon-bor-rpc.publicnode.com",
+      "chain_id": 137,
+      "poa_chain": true,
+      "default_gas_price_strategy": "eip1559",
+      "is_gas_estimation_enabled": false
     },
-    "base": {
-        "agent_registry_contract": "0x88DE734655184a09B70700aE4F72364d1ad23728",
-        "service_registry_contract": "0x3C1fF68f5aa342D296d4DEe4Bb1cACCA912D95fE",
-        "mech_marketplace_contract": "0xf24eE42edA0fc9b33B7D41B06Ee8ccD2Ef7C5020",
-        "complementary_metadata_hash_address": "0x28C1edC7CEd549F7f80B732fDC19f0370160707d",
-        "rpc_url": "https://base.llamarpc.com",
-        "wss_endpoint": "wss://base.gateway.tenderly.co",
-        "ledger_config": {
-            "address": "https://base.llamarpc.com",
-            "chain_id": 8453,
-            "poa_chain": false,
-            "default_gas_price_strategy": "eip1559",
-            "is_gas_estimation_enabled": false
-        },
-        "gas_limit": 500000,
-        "price": 3000000000000,
-        "transaction_url": "https://basescan.org/tx/{transaction_digest}",
-        "subgraph_url": "https://api.studio.thegraph.com/query/89372/olas-base-mech-marketplace/v0.0.2"
+    "gas_limit": 3000000,
+    "price": 10000,
+    "transaction_url": "https://polygonscan.com/tx/{transaction_digest}",
+    "subgraph_url": ""
+  },
+  "base": {
+    "agent_registry_contract": "0x88DE734655184a09B70700aE4F72364d1ad23728",
+    "service_registry_contract": "0x3C1fF68f5aa342D296d4DEe4Bb1cACCA912D95fE",
+    "mech_marketplace_contract": "0xf24eE42edA0fc9b33B7D41B06Ee8ccD2Ef7C5020",
+    "complementary_metadata_hash_address": "0x28C1edC7CEd549F7f80B732fDC19f0370160707d",
+    "rpc_url": "https://base.llamarpc.com",
+    "wss_endpoint": "wss://base.gateway.tenderly.co",
+    "ledger_config": {
+      "address": "https://base.llamarpc.com",
+      "chain_id": 8453,
+      "poa_chain": false,
+      "default_gas_price_strategy": "eip1559",
+      "is_gas_estimation_enabled": false
     },
-    "celo": {
-        "agent_registry_contract": "0xE49CB081e8d96920C38aA7AB90cb0294ab4Bc8EA",
-        "service_registry_contract": "0xE3607b00E75f6405248323A9417ff6b39B244b50",
-        "mech_marketplace_contract": "0x0000000000000000000000000000000000000000",
-        "complementary_metadata_hash_address": "0x0000000000000000000000000000000000000000",
-        "rpc_url": "https://forno.celo.org",
-        "wss_endpoint": "wss://forno.celo.org/ws",
-        "ledger_config": {
-            "address": "https://forno.celo.org",
-            "chain_id": 42220,
-            "poa_chain": true,
-            "default_gas_price_strategy": "eip1559",
-            "is_gas_estimation_enabled": false
-        },
-        "gas_limit": 250000,
-        "price": 10000000000000000,
-        "transaction_url": "https://celoscan.io/tx/{transaction_digest}",
-        "subgraph_url": ""
+    "gas_limit": 500000,
+    "price": 3000000000000,
+    "transaction_url": "https://basescan.org/tx/{transaction_digest}",
+    "subgraph_url": "https://api.studio.thegraph.com/query/89372/olas-base-mech-marketplace/v0.0.2"
+  },
+  "celo": {
+    "agent_registry_contract": "0xE49CB081e8d96920C38aA7AB90cb0294ab4Bc8EA",
+    "service_registry_contract": "0xE3607b00E75f6405248323A9417ff6b39B244b50",
+    "mech_marketplace_contract": "0x0000000000000000000000000000000000000000",
+    "complementary_metadata_hash_address": "0x0000000000000000000000000000000000000000",
+    "rpc_url": "https://forno.celo.org",
+    "wss_endpoint": "wss://forno.celo.org/ws",
+    "ledger_config": {
+      "address": "https://forno.celo.org",
+      "chain_id": 42220,
+      "poa_chain": true,
+      "default_gas_price_strategy": "eip1559",
+      "is_gas_estimation_enabled": false
     },
-    "optimism": {
-        "agent_registry_contract": "0x75D529FAe220bC8db714F0202193726b46881B76",
-        "service_registry_contract": "0x3d77596beb0f130a4415df3D2D8232B3d3D31e44",
-        "mech_marketplace_contract": "0x0000000000000000000000000000000000000000",
-        "complementary_metadata_hash_address": "0x0000000000000000000000000000000000000000",
-        "rpc_url": "https://mainnet.optimism.io",
-        "wss_endpoint": "wss://optimism.gateway.tenderly.co",
-        "ledger_config": {
-            "address": "https://mainnet.optimism.io",
-            "chain_id": 10,
-            "poa_chain": false,
-            "default_gas_price_strategy": "eip1559",
-            "is_gas_estimation_enabled": false
-        },
-        "gas_limit": 100000,
-        "price": 3000000000000,
-        "transaction_url": "https://optimistic.etherscan.io/tx/{transaction_digest}",
-        "subgraph_url": ""
-    }
-}
+    "gas_limit": 250000,
+    "price": 10000000000000000,
+    "transaction_url": "https://celoscan.io/tx/{transaction_digest}",
+    "subgraph_url": ""
+  },
+  "optimism": {
+    "agent_registry_contract": "0x75D529FAe220bC8db714F0202193726b46881B76",
+    "service_registry_contract": "0x3d77596beb0f130a4415df3D2D8232B3d3D31e44",
+    "mech_marketplace_contract": "0x46C0D07F55d4F9B5Eed2Fc9680B5953e5fd7b461",
+    "complementary_metadata_hash_address": "0x11949cBC85d8793B360029E26b18ae759708e28b",
+    "rpc_url": "https://mainnet.optimism.io",
+    "wss_endpoint": "wss://optimism.gateway.tenderly.co",
+    "ledger_config": {
+      "address": "https://mainnet.optimism.io",
+      "chain_id": 10,
+      "poa_chain": false,
+      "default_gas_price_strategy": "eip1559",
+      "is_gas_estimation_enabled": false
+    },
+    "gas_limit": 100000,
+    "price": 3000000000000,
+    "transaction_url": "https://optimistic.etherscan.io/tx/{transaction_digest}",
+    "subgraph_url": ""
+  }
+}

mech_client/interact.py

@@ -514,6 +514,7 @@ def interact(  # pylint: disable=too-many-arguments,too-many-locals
     tool: Optional[str] = None,
     extra_attributes: Optional[Dict[str, Any]] = None,
     private_key_path: Optional[str] = None,
+    private_key_password: Optional[str] = None,
     confirmation_type: ConfirmationType = ConfirmationType.WAIT_FOR_BOTH,
     retries: Optional[int] = None,
     timeout: Optional[float] = None,
@@ -533,6 +534,8 @@ def interact(  # pylint: disable=too-many-arguments,too-many-locals
     :type extra_attributes: Optional[Dict[str, Any]]
     :param private_key_path: The path to the private key file (optional).
     :type private_key_path: Optional[str]
+    :param private_key_password: Password to decrypt the keystore (if encrypted).
+    :type private_key_password: Optional[str]
     :param confirmation_type: The confirmation type for the interaction (default: ConfirmationType.WAIT_FOR_BOTH).
     :type confirmation_type: ConfirmationType
     :return: The data received from on-chain/off-chain.
@@ -562,7 +565,9 @@ def interact(  # pylint: disable=too-many-arguments,too-many-locals
         )
 
     wss = websocket.create_connection(mech_config.wss_endpoint)
-    crypto = EthereumCrypto(private_key_path=private_key_path)
+    crypto = EthereumCrypto(
+        private_key_path=private_key_path, password=private_key_password
+    )
     ledger_api = EthereumApi(**asdict(ledger_config))
 
     tool = verify_or_retrieve_tool(