genlayer-test 0.5.1__tar.gz → 0.6.0__tar.gz

{genlayer_test-0.5.1 → genlayer_test-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: genlayer-test
-Version: 0.5.1
+Version: 0.6.0
 Summary: GenLayer Testing Suite
 Author: GenLayer
 License-Expression: MIT
@@ -365,17 +365,24 @@ Key features demonstrated in this contract:
 
 ### Contract Deployment
 
+The GenLayer Testing Suite provides two methods for deploying contracts:
+
+1. **`deploy()`** - Returns the deployed contract instance (recommended for most use cases)
+2. **`deploy_contract_tx()`** - Returns only the transaction receipt
+
 Here's how to deploy the Storage contract:
 
 ```python
 from gltest import get_contract_factory, get_default_account
+from gltest.assertions import tx_execution_succeeded
+from gltest.utils import extract_contract_address
 
 def test_deployment():
     # Get the contract factory for your contract
     # it will search in the contracts directory
     factory = get_contract_factory("Storage")
     
-    # Deploy the contract with constructor arguments
+    # Method 1: Deploy the contract with constructor arguments (recommended)
     contract = factory.deploy(
         args=["initial_value"],  # Constructor arguments
         account=get_default_account(),  # Account to deploy from
@@ -384,6 +391,18 @@ def test_deployment():
     
     # Contract is now deployed and ready to use
     assert contract.address is not None
+    
+    # Method 2: Deploy and get only the receipt
+    receipt = factory.deploy_contract_tx(
+        args=["initial_value"],
+        account=get_default_account(),
+    )
+    
+    # Verify deployment succeeded
+    assert tx_execution_succeeded(receipt)
+
+    # Get the contract address
+    contract_address = extract_contract_address(receipt)
 ```
 
 ### Read Methods

{genlayer_test-0.5.1 → genlayer_test-0.6.0}/README.md

@@ -342,17 +342,24 @@ Key features demonstrated in this contract:
 
 ### Contract Deployment
 
+The GenLayer Testing Suite provides two methods for deploying contracts:
+
+1. **`deploy()`** - Returns the deployed contract instance (recommended for most use cases)
+2. **`deploy_contract_tx()`** - Returns only the transaction receipt
+
 Here's how to deploy the Storage contract:
 
 ```python
 from gltest import get_contract_factory, get_default_account
+from gltest.assertions import tx_execution_succeeded
+from gltest.utils import extract_contract_address
 
 def test_deployment():
     # Get the contract factory for your contract
     # it will search in the contracts directory
     factory = get_contract_factory("Storage")
     
-    # Deploy the contract with constructor arguments
+    # Method 1: Deploy the contract with constructor arguments (recommended)
     contract = factory.deploy(
         args=["initial_value"],  # Constructor arguments
         account=get_default_account(),  # Account to deploy from
@@ -361,6 +368,18 @@ def test_deployment():
     
     # Contract is now deployed and ready to use
     assert contract.address is not None
+    
+    # Method 2: Deploy and get only the receipt
+    receipt = factory.deploy_contract_tx(
+        args=["initial_value"],
+        account=get_default_account(),
+    )
+    
+    # Verify deployment succeeded
+    assert tx_execution_succeeded(receipt)
+
+    # Get the contract address
+    contract_address = extract_contract_address(receipt)
 ```
 
 ### Read Methods

{genlayer_test-0.5.1 → genlayer_test-0.6.0}/genlayer_test.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: genlayer-test
-Version: 0.5.1
+Version: 0.6.0
 Summary: GenLayer Testing Suite
 Author: GenLayer
 License-Expression: MIT
@@ -365,17 +365,24 @@ Key features demonstrated in this contract:
 
 ### Contract Deployment
 
+The GenLayer Testing Suite provides two methods for deploying contracts:
+
+1. **`deploy()`** - Returns the deployed contract instance (recommended for most use cases)
+2. **`deploy_contract_tx()`** - Returns only the transaction receipt
+
 Here's how to deploy the Storage contract:
 
 ```python
 from gltest import get_contract_factory, get_default_account
+from gltest.assertions import tx_execution_succeeded
+from gltest.utils import extract_contract_address
 
 def test_deployment():
     # Get the contract factory for your contract
     # it will search in the contracts directory
     factory = get_contract_factory("Storage")
     
-    # Deploy the contract with constructor arguments
+    # Method 1: Deploy the contract with constructor arguments (recommended)
     contract = factory.deploy(
         args=["initial_value"],  # Constructor arguments
         account=get_default_account(),  # Account to deploy from
@@ -384,6 +391,18 @@ def test_deployment():
     
     # Contract is now deployed and ready to use
     assert contract.address is not None
+    
+    # Method 2: Deploy and get only the receipt
+    receipt = factory.deploy_contract_tx(
+        args=["initial_value"],
+        account=get_default_account(),
+    )
+    
+    # Verify deployment succeeded
+    assert tx_execution_succeeded(receipt)
+
+    # Get the contract address
+    contract_address = extract_contract_address(receipt)
 ```
 
 ### Read Methods

{genlayer_test-0.5.1 → genlayer_test-0.6.0}/genlayer_test.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ gltest/exceptions.py
 gltest/fixtures.py
 gltest/logging.py
 gltest/types.py
+gltest/utils.py
 gltest/artifacts/__init__.py
 gltest/artifacts/contract.py
 gltest/contracts/__init__.py
@@ -41,6 +42,7 @@ tests/conftest.py
 tests/examples/contracts/football_prediction_market.py
 tests/examples/contracts/intelligent_oracle.py
 tests/examples/contracts/intelligent_oracle_factory.py
+tests/examples/contracts/invalid_deploy.py
 tests/examples/contracts/llm_erc20.py
 tests/examples/contracts/log_indexer.py
 tests/examples/contracts/multi_read_erc20.py
@@ -53,6 +55,7 @@ tests/examples/contracts/multi_file_contract/__init__.py
 tests/examples/contracts/multi_file_contract/other.py
 tests/examples/tests/test_football_prediction_market.py
 tests/examples/tests/test_intelligent_oracle_factory.py
+tests/examples/tests/test_invalid_deploy.py
 tests/examples/tests/test_llm_erc20.py
 tests/examples/tests/test_llm_erc20_analyze.py
 tests/examples/tests/test_log_indexer.py

{genlayer_test-0.5.1 → genlayer_test-0.6.0}/gltest/contracts/contract_factory.py

@@ -17,10 +17,11 @@ from gltest.clients import (
 )
 from .contract import Contract
 from gltest.logging import logger
-from gltest.types import TransactionStatus
+from gltest.types import TransactionStatus, GenLayerTransaction, CalldataEncodable
 from gltest.assertions import tx_execution_failed
 from gltest.exceptions import DeploymentError
 from gltest_cli.config.general import get_general_config
+from gltest.utils import extract_contract_address
 
 
 @dataclass
@@ -104,7 +105,7 @@ class ContractFactory:
 
     def deploy(
         self,
-        args: List[Any] = [],
+        args: Optional[List[CalldataEncodable]] = None,
         account: Optional[LocalAccount] = None,
         consensus_max_rotations: Optional[int] = None,
         wait_interval: Optional[int] = None,
@@ -114,7 +115,41 @@ class ContractFactory:
         wait_triggered_transactions_status: TransactionStatus = TransactionStatus.ACCEPTED,
     ) -> Contract:
         """
-        Deploy the contract
+        Deploy the contract and return a Contract instance (convenience method).
+
+        This is a convenience method that handles receipt validation
+        and contract instantiation automatically.
+        """
+        receipt = self.deploy_contract_tx(
+            args=args,
+            account=account,
+            consensus_max_rotations=consensus_max_rotations,
+            wait_interval=wait_interval,
+            wait_retries=wait_retries,
+            wait_transaction_status=wait_transaction_status,
+            wait_triggered_transactions=wait_triggered_transactions,
+            wait_triggered_transactions_status=wait_triggered_transactions_status,
+        )
+
+        if tx_execution_failed(receipt):
+            raise DeploymentError(f"Deployment transaction failed: {receipt}")
+
+        contract_address = extract_contract_address(receipt)
+        return self.build_contract(contract_address=contract_address, account=account)
+
+    def deploy_contract_tx(
+        self,
+        args: Optional[List[CalldataEncodable]] = None,
+        account: Optional[LocalAccount] = None,
+        consensus_max_rotations: Optional[int] = None,
+        wait_interval: Optional[int] = None,
+        wait_retries: Optional[int] = None,
+        wait_transaction_status: TransactionStatus = TransactionStatus.ACCEPTED,
+        wait_triggered_transactions: bool = False,
+        wait_triggered_transactions_status: TransactionStatus = TransactionStatus.ACCEPTED,
+    ) -> GenLayerTransaction:
+        """
+        Deploy the contract and return the transaction receipt.
         """
         general_config = get_general_config()
         actual_wait_interval = (
@@ -148,11 +183,6 @@ class ContractFactory:
                 interval=actual_wait_interval,
                 retries=actual_wait_retries,
             )
-            if tx_execution_failed(tx_receipt):
-                raise ValueError(
-                    f"Deployment transaction finalized with error: {tx_receipt}"
-                )
-
             if wait_triggered_transactions:
                 triggered_transactions = tx_receipt.get("triggered_transactions", [])
                 for triggered_transaction in triggered_transactions:
@@ -162,26 +192,7 @@ class ContractFactory:
                         interval=actual_wait_interval,
                         retries=actual_wait_retries,
                     )
-
-            if (
-                "tx_data_decoded" in tx_receipt
-                and "contract_address" in tx_receipt["tx_data_decoded"]
-            ):
-                contract_address = tx_receipt["tx_data_decoded"]["contract_address"]
-            elif "data" in tx_receipt and "contract_address" in tx_receipt["data"]:
-                contract_address = tx_receipt["data"]["contract_address"]
-            else:
-                raise ValueError("Transaction receipt missing contract address")
-
-            schema = self._get_schema_with_fallback()
-            if schema is None:
-                raise ValueError(
-                    "Failed to get schema from all clients (default, hosted studio, and local)"
-                )
-
-            return Contract.new(
-                address=contract_address, schema=schema, account=account
-            )
+            return tx_receipt
         except Exception as e:
             raise DeploymentError(
                 f"Failed to deploy contract {self.contract_name}: {str(e)}"

genlayer_test-0.6.0/gltest/utils.py

@@ -0,0 +1,14 @@
+from genlayer_py.types import GenLayerTransaction
+
+
+def extract_contract_address(receipt: GenLayerTransaction) -> str:
+    """Extract contract address from a deployment transaction receipt."""
+    if (
+        "tx_data_decoded" in receipt
+        and "contract_address" in receipt["tx_data_decoded"]
+    ):
+        return receipt["tx_data_decoded"]["contract_address"]
+    elif "data" in receipt and "contract_address" in receipt["data"]:
+        return receipt["data"]["contract_address"]
+    else:
+        raise ValueError("Transaction receipt missing contract address")

{genlayer_test-0.5.1 → genlayer_test-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "genlayer-test"
-version = "0.5.1"
+version = "0.6.0"
 description = "GenLayer Testing Suite"
 authors = [
     { name = "GenLayer" }

genlayer_test-0.6.0/tests/examples/contracts/invalid_deploy.py

@@ -0,0 +1,10 @@
+# { "Depends": "py-genlayer:test" }
+
+import genlayer as gl
+
+
+class InvalidDeploy(gl.Contract):
+    """Contract that always fails during deployment"""
+
+    def __init__(self):
+        raise Exception("This is an invalid deploy")

genlayer_test-0.6.0/tests/examples/tests/test_invalid_deploy.py

@@ -0,0 +1,24 @@
+import pytest
+from gltest import get_contract_factory
+from gltest.assertions import tx_execution_failed
+from gltest.exceptions import DeploymentError
+
+
+def test_invalid_deploy_basic_exception(setup_validators):
+    """Test deployment failure with basic exception"""
+    setup_validators()
+    factory = get_contract_factory("InvalidDeploy")
+
+    # Deployment should fail with exception
+    with pytest.raises(DeploymentError):
+        factory.deploy()
+
+
+def test_invalid_deploy_receipt_only(setup_validators):
+    """Test deployment failure using deploy_contract_tx() method that returns receipt only"""
+    setup_validators()
+    factory = get_contract_factory("InvalidDeploy")
+
+    # Deploy and get receipt - should show failure
+    receipt = factory.deploy_contract_tx()
+    assert tx_execution_failed(receipt)