Added docs

Author: baitcode

docs/guide/account_and_client.rst

@@ -46,6 +46,15 @@ Account also provides a way of creating signed transaction without sending them.
     :language: python
     :dedent: 4
 
+Creating "Outside transaction" and executing it. (SNIP-9)[https://github.com/starknet-io/SNIPs/blob/main/SNIPS/snip-9.md]
+--------------------------------------------
+
+Account also provides a way of creating a call and signing to allow for another account (caller) to execute it later on original account behalf. This will also allow caller to execute calls encoded in that transaction for free (signer will pay the fee).
+
+.. codesnippet:: ../../starknet_py/tests/e2e/docs/guide/test_account_sign_outside_transaction.py
+    :language: python
+    :dedent: 4
+
 Multicall
 ---------
 

pyproject.toml

@@ -56,16 +56,15 @@ setuptools = "^70.3.0"
 test = [
     "clean_coverage",
     "test_ci_v1 --disable-warnings -qq",
-    # "test_ci_v2 --disable-warnings -qq",
-    # "test_ci_on_networks --disable-warnings -qq",
-    # "test_ci_docs_v1 --disable-warnings -qq",
-    # "test_ci_docs_v2 --disable-warnings -qq",
-    # "test_report --skip-covered"
+    "test_ci_v2 --disable-warnings -qq",
+    "test_ci_on_networks --disable-warnings -qq",
+    "test_ci_docs_v1 --disable-warnings -qq",
+    "test_ci_docs_v2 --disable-warnings -qq",
+    "test_report --skip-covered"
 ]
 
 test_ci = ["test_ci_v1", "test_ci_v2"]
-test_ci_v1 = "coverage run -a -m pytest --contract_dir=v1 starknet_py --ignore=starknet_py/tests/e2e/docs --ignore=starknet_py/tests/e2e/tests_on_networks starknet_py/tests/e2e/account"
-# test_ci_v1 = "coverage run -a -m pytest --contract_dir=v1 starknet_py --ignore=starknet_py/tests/e2e/docs --ignore=starknet_py/tests/e2e/tests_on_networks"
+test_ci_v1 = "coverage run -a -m pytest --contract_dir=v1 starknet_py --ignore=starknet_py/tests/e2e/docs --ignore=starknet_py/tests/e2e/tests_on_networks"
 test_ci_v2 = "coverage run -a -m pytest --contract_dir=v2 starknet_py --ignore=starknet_py/tests/e2e/docs --ignore=starknet_py/tests/e2e/tests_on_networks"
 
 test_ci_on_networks = "coverage run -a -m pytest --contract_dir=v2 starknet_py/tests/e2e/tests_on_networks"

starknet_py/tests/e2e/docs/guide/test_account_sign_outside_transaction.py

@@ -0,0 +1,76 @@
+
+import pytest
+
+from starknet_py.net.account.account import Account
+from starknet_py.net.client_models import (
+    TransactionFinalityStatus
+)
+
+@pytest.mark.asyncio
+async def test_account_outside_execution_any_caller(
+    client,
+    argent_account_class_hash,
+    deployed_balance_contract,
+    deploy_account_details_factory,
+):
+    # pylint: disable=import-outside-toplevel,too-many-locals
+    address, key_pair, salt, class_hash = await deploy_account_details_factory.get(
+        class_hash=argent_account_class_hash, argent_calldata=True
+    )
+
+    deploy_result = await Account.deploy_account_v1(
+        address=address,
+        class_hash=class_hash,
+        salt=salt,
+        key_pair=key_pair,
+        client=client,
+        constructor_calldata=[key_pair.public_key, 0],
+        max_fee=int(1e18),
+    )
+    await deploy_result.wait_for_acceptance()
+    account = deploy_result.account
+
+    # docs: start
+    import datetime
+
+    from starknet_py.constants import ANY_CALLER
+    from starknet_py.hash.selector import get_selector_from_name
+    from starknet_py.net.client_models import (
+        Call,
+        ExecutionTimeBounds,
+    )
+
+    # Create a call to increase the balance by 100. That will be executed
+    # as part of external execution
+
+    increase_balance_call = Call(
+        to_addr=deployed_balance_contract.address,
+        selector=get_selector_from_name("increase_balance"),
+        calldata=[100],
+    )
+
+    # Create a special signed execution call. This call now be executed by
+    # caller specified. In this case, it is ANY_CALLER, a special constant
+    # that allows any caller to execute the call.
+    call = await account.sign_outside_execution_call(
+        calls=[
+            increase_balance_call,
+        ],
+        execution_time_bounds=ExecutionTimeBounds(
+            execute_after=datetime.datetime.now() - datetime.timedelta(hours=1),
+            execute_before=datetime.datetime.now() + datetime.timedelta(hours=1),
+        ),
+        caller=ANY_CALLER,
+    )
+
+    # Execute the call as a normal invoke transaction
+    tx = await account.execute_v1(calls=[call], max_fee=int(1e18))
+    await account.client.wait_for_tx(tx.transaction_hash)
+
+    # docs: end
+
+    receipt = await account.client.get_transaction_receipt(
+        tx_hash=tx.transaction_hash
+    )
+
+    assert receipt.finality_status == TransactionFinalityStatus.ACCEPTED_ON_L2