genlayer-test 0.1.3__py3-none-any.whl → 0.3.0__py3-none-any.whl

{genlayer_test-0.1.3.dist-info → genlayer_test-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: genlayer-test
-Version: 0.1.3
+Version: 0.3.0
 Summary: GenLayer Testing Suite
 Author: GenLayer
 License-Expression: MIT
@@ -14,7 +14,11 @@ Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pytest
-Requires-Dist: genlayer-py==0.3.0
+Requires-Dist: setuptools>=77.0
+Requires-Dist: genlayer-py==0.5.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: pyyaml
+Requires-Dist: python-dotenv
 Dynamic: license-file
 
 # GenLayer Testing Suite
@@ -41,13 +45,13 @@ pip install genlayer-test
 ### Basic Usage
 
 ```python
-from gltest import get_contract_factory, default_account, create_account
+from gltest import get_contract_factory, get_default_account, create_account
 from gltest.assertions import tx_execution_succeeded
 
 factory = get_contract_factory("MyContract")
 # Deploy a contract with default account
 contract = factory.deploy() # This will be deployed with default_account
-assert contract.account == default_account
+assert contract.account == get_default_account()
 
 # Deploy a contract with other account
 other_account = create_account()
@@ -99,6 +103,58 @@ $ cd genlayer-testing-suite
 $ pip install -e .
 ```
 
+### Configuration
+
+The GenLayer Testing Suite can be configured using an optional but recommended `gltest.config.yaml` file in your project root. While not required, this file helps manage network configurations, contract paths, and environment settings in a centralized way, making it easier to maintain different environments and share configurations across team members.
+
+```yaml
+# gltest.config.yaml
+networks:
+  default: localnet  # Default network to use
+
+  localnet:  # Local development network configuration
+    url: "http://127.0.0.1:4000/api"
+
+  testnet_asimov:  # Test network configuration
+    id: 4221
+    url: "http://34.32.169.58:9151"
+    accounts:
+      - "${ACCOUNT_PRIVATE_KEY_1}"
+      - "${ACCOUNT_PRIVATE_KEY_2}"
+      - "${ACCOUNT_PRIVATE_KEY_3}"
+
+paths:
+  contracts: "contracts"  # Path to your contracts directory
+
+environment: .env  # Path to your environment file containing private keys and other secrets
+```
+
+Key configuration sections:
+
+1. **Networks**: Define different network environments
+   - `default`: Specifies which network to use by default
+   - Network configurations can include:
+     - `url`: The RPC endpoint for the network
+     - `id`: Chain ID
+     - `accounts`: List of account private keys (using environment variables)
+   - Special case for `localnet`:
+     - If a network is named `localnet`, missing fields will be filled with default values
+     - For all other network names, `id`, `url`, and `accounts` are required fields
+
+2. **Paths**: Define important directory paths
+   - `contracts`: Location of your contract files
+
+3. **Environment**: Path to your `.env` file containing sensitive information like private keys
+
+If you don't provide a config file, the suite will use default values. You can override these settings using command-line arguments. For example:
+```bash
+# Override the default network
+gltest --network testnet_asimov
+
+# Override the contracts directory
+gltest --contracts-dir custom/contracts/path
+```
+
 ### Running Tests
 
 1. Run all tests:
@@ -126,17 +182,27 @@ $ gltest -v
 $ gltest --contracts-dir <path_to_contracts>
 ```
 
-6. Run tests with a custom RPC url
+6. Run tests on a specific network:
+```bash
+# Run tests on localnet (default)
+$ gltest --network localnet
+
+# Run tests on testnet
+$ gltest --network testnet_asimov
+```
+The `--network` flag allows you to specify which network configuration to use from your `gltest.config.yaml`. If not specified, it will use the `default` network defined in your config file.
+
+7. Run tests with a custom RPC url
 ```bash
 $ gltest --rpc-url <custom_rpc_url>
 ```
 
-6. Run tests with a default wait interval for waiting transaction receipts
+8. Run tests with a default wait interval for waiting transaction receipts
 ```bash
 $ gltest --default-wait-interval <default_wait_interval>
 ```
 
-6. Run tests with a default wait retries for waiting transaction receipts
+9. Run tests with a default wait retries for waiting transaction receipts
 ```bash
 $ gltest --default-wait-retries <default_wait_retries>
 ```
@@ -233,13 +299,14 @@ def test_deployment():
 Reading from the contract is straightforward:
 
 ```python
-from gltest import get_contract_factory, default_account
+from gltest import get_contract_factory
 
 def test_read_methods():
+
     # Get the contract factory and deploy the contract
     factory = get_contract_factory("Storage")
-    contract = factory.deploy(account=default_account)
-    
+    contract = factory.deploy()
+
     # Call a read-only method
     result = contract.get_value(args=[])
     

genlayer_test-0.3.0.dist-info/RECORD

@@ -0,0 +1,65 @@
+genlayer_test-0.3.0.dist-info/licenses/LICENSE,sha256=che_H4vE0QUx3HvWrAa1_jDEVInift0U6VO15-QqEls,1064
+gltest/__init__.py,sha256=Uozr4VS-_oKUxEdXbWoEVLB8JQKBWGs6vGEHDj1-6LY,348
+gltest/assertions.py,sha256=0dEk0VxcHK4I7GZPHxJmz-2jaA60V499gOSR74rZbfM,1748
+gltest/exceptions.py,sha256=deJPmrTe5gF33qkkKF2IVJY7lc_knI7Ql3N7jZ8aLZs,510
+gltest/types.py,sha256=BODmwTr2gAUEiO9FjiuTiWwuKvXgo4xZWstQWNUfnlw,156
+gltest/artifacts/__init__.py,sha256=qTt3TE19gVNWnQLUlt5aDe4nNvJ2YJ1jzDkMmYIsCG0,194
+gltest/artifacts/contract.py,sha256=KChpmfjZod_0dVB8y-dvWz6IVm7QlIJsgG2ArtvVDaU,6457
+gltest/glchain/__init__.py,sha256=QLd55hVB9xVTAtCKbjmGPAwh0M8_tUNJ5xI0H93YyTY,428
+gltest/glchain/account.py,sha256=HUmWguJMolggQaZNRPw-LGlRlQCjLLdUanKRowMv6pI,812
+gltest/glchain/client.py,sha256=urRvnLt8GpdCV3yOBSvJNZQzu_TsZr8HqKn14Q2SpIQ,1547
+gltest/glchain/contract.py,sha256=RFLbEZseWatX0Xvt3-Eo_zOowxLMhukoXjK8V8Ca0Ok,11370
+gltest/helpers/__init__.py,sha256=I7HiTu_H7_hP65zY6Wl02r-5eAMr2eZvqBVmusuQLX4,180
+gltest/helpers/fixture_snapshot.py,sha256=VydrtviG60ukSFIvzO5QwK-SHmkRmbsQFEVdyItvGWI,2142
+gltest/helpers/take_snapshot.py,sha256=eXqEKXM2hcox3pLGIcNddobU8zXPQvD-Iwf87eHqW2s,1276
+gltest_cli/logging.py,sha256=2Bkh6OR5C19HefARLQN5xBfam3apXzf7_Wei2PBfKlM,1241
+gltest_cli/main.py,sha256=Ti2-0Ev1x5_cM0D1UKqdgaDt80CDHEQGtdRne2qLm4M,53
+gltest_cli/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gltest_cli/config/constants.py,sha256=lX8C3aS7zXWazA8LWgE0BkPvy7NopyEMyJNI2yYWX9M,300
+gltest_cli/config/general.py,sha256=ezpoGsT8grO9zQH6RugV14b1GzeFt-htYToHQBJhNvY,186
+gltest_cli/config/plugin.py,sha256=zEWsi18hEoK9yloKKPd8y77wXCpgWf7hAWI1JL8S5Ho,3325
+gltest_cli/config/types.py,sha256=R5ylpHKzoOK43_tXC047mJqAybCZhj615_FWBhsmNAU,5237
+gltest_cli/config/user.py,sha256=LjjoqXWRLPeNgOvLKy2tJDNl1M0uLb-5rwEsnGyJunE,8065
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/conftest.py,sha256=RKdoE5_zcMimeojAoA_GSFI9du4pMzMi1vZ1njtfoAs,28
+tests/examples/contracts/football_prediction_market.py,sha256=kdouFijjeCdIJyaVJlgXcqbBAXecA9_YdhklSsIW-QM,3219
+tests/examples/contracts/intelligent_oracle.py,sha256=WrNZWWoi1sz22Azt2EXgdWHDg5Ihca2pWUHrM9pVfQE,12319
+tests/examples/contracts/intelligent_oracle_factory.py,sha256=ax496IZuDCA728rRcbjwTaM4Q4E-Y1jGkHsEcyf1cig,1490
+tests/examples/contracts/llm_erc20.py,sha256=nfIs-7A79L46NgHQzWbPyEOUlzAlFLsf4K05acwKr_M,2523
+tests/examples/contracts/log_indexer.py,sha256=VwMC8_Gy1Z1qjuy5GeEMyepjZ3Z5y7VAOrHMl5MrjxI,1852
+tests/examples/contracts/multi_read_erc20.py,sha256=HsMJKGT9a9eZAO43Em7hCRfh1yyHDgcUbQ0gmOE1MXs,850
+tests/examples/contracts/multi_tenant_storage.py,sha256=aGLPC76FegXdnIjMjeGsu3s3AbKK9dtV6t1d_KoI8rI,1897
+tests/examples/contracts/read_erc20.py,sha256=kstiB93JHHajJe1GldzeawxnVYutjT8KE2d1bYTgggU,390
+tests/examples/contracts/storage.py,sha256=GZHBXhjc94eEkdSO1UWgcop0fEo0hD57KZM0ds3pUFM,490
+tests/examples/contracts/user_storage.py,sha256=j-RXxTIqb1dePYqP_pkeoCxxDq07VURryvzF_Q-sZmI,638
+tests/examples/contracts/wizard_of_coin.py,sha256=BJ0Nv6N-JJP_Pk7YUSXPPRxX5_mDRBDlfL6nabeaoyA,1606
+tests/examples/contracts/multi_file_contract/__init__.py,sha256=8O3BvoUrLSmc4uTf2jm7MyrmcaiGD0w8wPwotdAqZHQ,485
+tests/examples/contracts/multi_file_contract/other.py,sha256=jHDtjUL3eAUgE6yOYKFw_RfAH7kIwk8CvxUjbWHNruk,236
+tests/examples/tests/test_football_prediction_market.py,sha256=wFu024sq3IURLL1zyLyO_G1sRCjPTV7iImi87__dZ4Y,657
+tests/examples/tests/test_intelligent_oracle_factory.py,sha256=Nw7jO9bjD79AETT2QQl0Vun-yxSAAuqGSdkQn2Y3WUw,5377
+tests/examples/tests/test_llm_erc20.py,sha256=3-wsZi23TpQ_9HYPfcbyo9206AkDndqTfBzRWXzlsNE,1400
+tests/examples/tests/test_log_indexer.py,sha256=Km44SiA8dlA4WBqwugXVBCQUlODdf1dB4p4nt24HG9k,2649
+tests/examples/tests/test_multi_file_contract.py,sha256=pWmK6lcZrSAnDH09Z6Q-cXs8V6VGFhHkvgThvJKEB4U,512
+tests/examples/tests/test_multi_file_contract_legacy.py,sha256=Jx_u0rDrQJspQgFo1KUddcFgTcOhcE-YLuLgk3tKrCA,527
+tests/examples/tests/test_multi_read_erc20.py,sha256=A-mRoZPj3_0B6CUnwtPFxtXoOfd1RuB8PIeExniZlCs,3411
+tests/examples/tests/test_multi_tenant_storage.py,sha256=yliqhit7wWO1Y6OXl_cv3ruTCOto8ZfKGtkT3lRvZpQ,2717
+tests/examples/tests/test_read_erc20.py,sha256=9bUmigPab2dDf1GElRXVbf1TVbMur37IPT7HFZDmFUg,1208
+tests/examples/tests/test_storage.py,sha256=jcVNAeBynn70Ov1rF1robZwFZptuNLtHW-u1XfG393k,712
+tests/examples/tests/test_storage_legacy.py,sha256=RNVnD0G9ilb4I2s0CPAAgJEuKUgEkkbItuesOfmv-pg,677
+tests/examples/tests/test_user_storage.py,sha256=qUv57rn1X3wAiIglnj3LH3r2clIBwF38MMkKvU4IGaA,2552
+tests/examples/tests/test_wizard_of_coin.py,sha256=aUDeV5w0XONMMS71Vzw80lHfcSM0z8RKPJSXAuDwRto,392
+tests/gltest/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/gltest/artifact/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/gltest/artifact/test_contract_definition.py,sha256=6R8THNFKKpG7brULzp63vT1_pPd_JFNp3ZS08CJJWrg,3642
+tests/gltest/artifact/contracts/duplicate_ic_contract_1.py,sha256=bSWsUVjBy5cGtI72cjnkstsMzuUJbB3IG5JjTxOF-dc,500
+tests/gltest/artifact/contracts/duplicate_ic_contract_2.py,sha256=bSWsUVjBy5cGtI72cjnkstsMzuUJbB3IG5JjTxOF-dc,500
+tests/gltest/artifact/contracts/not_ic_contract.py,sha256=hQyGnYiiVceYdLI2WrvcFgPqzy1S4-YMb9FPhiHEGSA,510
+tests/gltest/assertions/test_assertions.py,sha256=qzVrOdOM4xYtIy1sFHVAD_-naDHOequ23tEN0MELh0k,10781
+tests/gltest_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/gltest_cli/config/test_plugin.py,sha256=06-GENVugrL6mPQkgRgQqRsCTuQMy3WZcbh_9Du6zHo,3502
+tests/gltest_cli/config/test_user.py,sha256=oJDcM6NbA16tQzQj5s8ZDvQYBm2uuvar5junFcVeitY,12116
+genlayer_test-0.3.0.dist-info/METADATA,sha256=daKEgnpolSsdJRa4yvqPIiciVNKGKePFWT2H-o-fLiQ,17231
+genlayer_test-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+genlayer_test-0.3.0.dist-info/entry_points.txt,sha256=RWPcSArBpz_G4BYioh5L8Q8hyClRbSgzLimjcWMp-BQ,94
+genlayer_test-0.3.0.dist-info/top_level.txt,sha256=-qiGZxTRBytujzgVcKpxjvQ-WNeUDjXa59ceGMwMpko,24
+genlayer_test-0.3.0.dist-info/RECORD,,

{genlayer_test-0.1.3.dist-info → genlayer_test-0.3.0.dist-info}/entry_points.txt

@@ -2,4 +2,4 @@
 gltest = gltest_cli.main:main
 
 [pytest11]
-gltest = gltest.plugin_hooks
+gltest = gltest_cli.config.plugin

gltest/__init__.py

@@ -3,8 +3,8 @@ from gltest.glchain import (
     create_accounts,
     get_contract_factory,
     get_gl_client,
-    default_account,
-    accounts,
+    get_accounts,
+    get_default_account,
 )
 
 __all__ = [
@@ -13,6 +13,6 @@ __all__ = [
     "create_accounts",
     "get_contract_factory",
     "get_gl_client",
-    "default_account",
-    "accounts",
+    "get_accounts",
+    "get_default_account",
 ]

gltest/artifacts/__init__.py

@@ -1,3 +1,6 @@
-from .contract import find_contract_definition
+from .contract import (
+    find_contract_definition_from_name,
+    find_contract_definition_from_path,
+)
 
-__all__ = ["find_contract_definition"]
+__all__ = ["find_contract_definition_from_name", "find_contract_definition_from_path"]

gltest/artifacts/contract.py

@@ -2,7 +2,7 @@ import ast
 from typing import Optional
 from dataclasses import dataclass
 from pathlib import Path
-from gltest.plugin_config import get_contracts_dir
+from gltest_cli.config.general import get_general_config
 import io
 import zipfile
 from typing import Union
@@ -20,8 +20,13 @@ class ContractDefinition:
 
 def search_path_by_class_name(contracts_dir: Path, contract_name: str) -> Path:
     """Search for a file by class name in the contracts directory."""
+    matching_files = []
+    exclude_dirs = {".venv", "venv", "env", "build", "dist", "__pycache__", ".git"}
+
     for file_path in contracts_dir.rglob("*"):
-        if not file_path.suffix in [".gpy", ".py"]:
+        if any(exclude_dir in file_path.parts for exclude_dir in exclude_dirs):
+            continue
+        if file_path.suffix not in [".gpy", ".py"]:
             continue
         try:
             # Read the file content
@@ -40,10 +45,24 @@ def search_path_by_class_name(contracts_dir: Path, contract_name: str) -> Path:
                                 and base.value.id == "gl"
                                 and base.attr == "Contract"
                             ):
-                                return file_path
+                                matching_files.append(file_path)
+                                break
+                    break
         except Exception as e:
-            raise ValueError(f"Error reading file {file_path}: {e}")
-    raise FileNotFoundError(f"Contract {contract_name} not found at: {contracts_dir}")
+            raise ValueError(f"Error reading file {file_path}: {e}") from e
+
+    if len(matching_files) == 0:
+        raise FileNotFoundError(
+            f"Contract {contract_name} not found at: {contracts_dir}"
+        )
+    if len(matching_files) > 1:
+        file_paths_str = ", ".join(str(f) for f in matching_files)
+        raise ValueError(
+            f"Multiple contracts named '{contract_name}' found in contracts directory. "
+            f"Found in files: {file_paths_str}. Please ensure contract names are unique."
+        ) from None
+
+    return matching_files[0]
 
 
 def compute_contract_code(
@@ -71,14 +90,35 @@ def compute_contract_code(
     return buffer.getvalue()
 
 
-def find_contract_definition(contract_name: str) -> Optional[ContractDefinition]:
-    """
-    Search in the contracts directory for a contract definition.
-    """
-    contracts_dir = get_contracts_dir()
-    if not contracts_dir.exists():
-        raise FileNotFoundError(f"Contracts directory not found at: {contracts_dir}")
-    main_file_path = search_path_by_class_name(contracts_dir, contract_name)
+def _extract_contract_name_from_file(file_path: Path) -> str:
+    """Extract contract name from a file by parsing the AST."""
+    try:
+        with open(file_path, "r") as f:
+            content = f.read()
+        tree = ast.parse(content)
+
+        # Search for class definitions that inherit from gl.Contract
+        for node in ast.walk(tree):
+            if isinstance(node, ast.ClassDef):
+                for base in node.bases:
+                    if (
+                        isinstance(base, ast.Attribute)
+                        and isinstance(base.value, ast.Name)
+                        and base.value.id == "gl"
+                        and base.attr == "Contract"
+                    ):
+                        return node.name
+    except Exception as e:
+        raise ValueError(f"Error parsing contract file {file_path}: {e}") from e
+
+    raise ValueError(f"No valid contract class found in {file_path}")
+
+
+def _create_contract_definition(
+    main_file_path: Path, contract_name: str
+) -> ContractDefinition:
+    """Create a ContractDefinition from a main file path and contract name."""
+    # Determine if it's a multifile contract
     main_file_dir = main_file_path.parent
     runner_file_path = None
     if main_file_path.name in ["__init__.py", "__init__.gpy"]:
@@ -87,9 +127,49 @@ def find_contract_definition(contract_name: str) -> Optional[ContractDefinition]
         if not runner_file_path.exists():
             # No runner file, so it's a single file contract
             runner_file_path = None
+
+    # Compute contract code
+    contract_code = compute_contract_code(main_file_path, runner_file_path)
+
     return ContractDefinition(
         contract_name=contract_name,
-        contract_code=compute_contract_code(main_file_path, runner_file_path),
+        contract_code=contract_code,
         main_file_path=main_file_path,
         runner_file_path=runner_file_path,
     )
+
+
+def find_contract_definition_from_name(
+    contract_name: str,
+) -> Optional[ContractDefinition]:
+    """
+    Search in the contracts directory for a contract definition.
+    """
+    general_config = get_general_config()
+    contracts_dir = general_config.get_contracts_dir()
+    if not contracts_dir.exists():
+        raise FileNotFoundError(f"Contracts directory not found at: {contracts_dir}")
+
+    main_file_path = search_path_by_class_name(contracts_dir, contract_name)
+    return _create_contract_definition(main_file_path, contract_name)
+
+
+def find_contract_definition_from_path(
+    contract_file_path: Union[str, Path],
+) -> ContractDefinition:
+    """
+    Create a ContractDefinition from a given file path relative to the contracts directory.
+    """
+    general_config = get_general_config()
+    contracts_dir = general_config.get_contracts_dir()
+    if not contracts_dir.exists():
+        raise FileNotFoundError(f"Contracts directory not found at: {contracts_dir}")
+
+    # Resolve the file path relative to contracts directory
+    main_file_path = contracts_dir / contract_file_path
+    if not main_file_path.exists():
+        raise FileNotFoundError(f"Contract file not found at: {main_file_path}")
+
+    contract_name = _extract_contract_name_from_file(main_file_path)
+
+    return _create_contract_definition(main_file_path, contract_name)

gltest/glchain/__init__.py

@@ -1,6 +1,6 @@
 from .contract import Contract, ContractFactory, get_contract_factory
 from .client import get_gl_client, get_gl_provider
-from .account import create_accounts, create_account, accounts, default_account
+from .account import create_account, get_accounts, get_default_account, create_accounts
 
 
 __all__ = [
@@ -8,9 +8,9 @@ __all__ = [
     "ContractFactory",
     "get_contract_factory",
     "create_account",
-    "default_account",
-    "accounts",
     "create_accounts",
+    "get_accounts",
+    "get_default_account",
     "get_gl_client",
     "get_gl_provider",
 ]

gltest/glchain/account.py

@@ -1,18 +1,22 @@
+from gltest_cli.config.general import get_general_config
 from genlayer_py import create_account
+from eth_account.signers.local import LocalAccount
+from typing import List
 
 
 def create_accounts(n_accounts: int):
-    """
-    Create a list of accounts
-    """
-    accounts = []
-    for _ in range(n_accounts):
-        accounts.append(create_account())
-    return accounts
+    return [create_account() for _ in range(n_accounts)]
 
 
-# Accounts for testing
-accounts = create_accounts(n_accounts=10)
+def get_accounts() -> List[LocalAccount]:
+    general_config = get_general_config()
+    selected_network = general_config.get_network_name()
+    accounts = general_config.get_accounts_keys(selected_network)
+    return [create_account(account) for account in accounts]
 
-# Default account to use for transaction handling, if not specified
-default_account = accounts[0]
+
+def get_default_account() -> LocalAccount:
+    general_config = get_general_config()
+    selected_network = general_config.get_network_name()
+    default_account_key = general_config.get_default_account_key(selected_network)
+    return create_account(default_account_key)

gltest/glchain/client.py

@@ -1,8 +1,8 @@
 from genlayer_py.chains import localnet
 from genlayer_py import create_client
-from .account import default_account
+from .account import get_default_account
 from functools import lru_cache
-from gltest.plugin_config import get_rpc_url
+from gltest_cli.config.general import get_general_config
 
 
 @lru_cache(maxsize=1)
@@ -10,8 +10,44 @@ def get_gl_client():
     """
     Get the GenLayer client instance.
     """
+    general_config = get_general_config()
+    chain = general_config.get_chain()
+    default_account = get_default_account()
+    endpoint = general_config.get_rpc_url()
     return create_client(
-        chain=localnet, account=default_account, endpoint=get_rpc_url()
+        chain=chain,
+        account=default_account,
+        endpoint=endpoint,
+    )
+
+
+@lru_cache(maxsize=1)
+def get_gl_hosted_studio_client():
+    """
+    Get the GenLayer hosted studio client instance.
+
+    Note: This is a temporary solution to get contract schema.
+    TODO: Remove this once we have a proper way to get contract schema from testnet.
+    """
+    return create_client(
+        chain=localnet,
+        account=get_default_account(),
+        endpoint="https://studio.genlayer.com/api",
+    )
+
+
+@lru_cache(maxsize=1)
+def get_local_client():
+    """
+    Get the GenLayer local client instance.
+
+    Note: This is a temporary solution to get contract schema.
+    TODO: Remove this once we have a proper way to get contract schema from testnet.
+    """
+    return create_client(
+        chain=localnet,
+        account=get_default_account(),
+        endpoint="http://127.0.0.1:4000/api",
     )