chia-blockchain 2.4.2__tar.gz → 2.4.3__tar.gz

chia_blockchain-2.4.3/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.1
+Name: chia-blockchain
+Version: 2.4.3
+Summary: Chia blockchain full node, farmer, timelord, and wallet.
+Home-page: https://chia.net/
+License: Apache License
+Keywords: chia,blockchain,node
+Author: Mariano Sorgente
+Author-email: mariano@chia.net
+Requires-Python: >=3.8.10,<3.13
+Classifier: License :: Other/Proprietary License
+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
+Provides-Extra: dev
+Provides-Extra: legacy-keyring
+Provides-Extra: upnp
+Requires-Dist: aiofiles (==24.1.0)
+Requires-Dist: aiohttp (==3.9.5)
+Requires-Dist: aiohttp_cors (==0.7.0) ; extra == "dev"
+Requires-Dist: aiosqlite (==0.20.0)
+Requires-Dist: anyio (==4.3.0)
+Requires-Dist: bitstring (==4.1.4)
+Requires-Dist: black (==24.4.2) ; extra == "dev"
+Requires-Dist: boto3 (==1.34.143)
+Requires-Dist: build (==1.2.1) ; extra == "dev"
+Requires-Dist: chia_rs (==0.10.0)
+Requires-Dist: chiabip158 (==1.5.1)
+Requires-Dist: chiapos (==2.0.4)
+Requires-Dist: chiavdf (==1.1.4)
+Requires-Dist: click (==8.1.7)
+Requires-Dist: clvm (==0.9.10)
+Requires-Dist: clvm_tools (==0.4.9)
+Requires-Dist: clvm_tools_rs (==0.1.43)
+Requires-Dist: colorama (==0.4.6)
+Requires-Dist: colorlog (==6.8.2)
+Requires-Dist: concurrent_log_handler (==0.9.25)
+Requires-Dist: coverage (==7.5.3) ; extra == "dev"
+Requires-Dist: cryptography (==42.0.8)
+Requires-Dist: diff-cover (==9.0.0) ; extra == "dev"
+Requires-Dist: dnslib (==0.9.24)
+Requires-Dist: dnspython (==2.6.1)
+Requires-Dist: filelock (==3.15.4)
+Requires-Dist: flake8 (==7.0.0) ; extra == "dev"
+Requires-Dist: hsms (==0.3.1)
+Requires-Dist: importlib-resources (==6.4.0)
+Requires-Dist: isort (==5.13.2) ; extra == "dev"
+Requires-Dist: keyring (==25.2.1)
+Requires-Dist: keyrings.cryptfile (==1.3.9) ; extra == "legacy-keyring"
+Requires-Dist: lxml (==5.2.2) ; extra == "dev"
+Requires-Dist: miniupnpc (==2.2.2) ; extra == "upnp"
+Requires-Dist: mypy (==1.10.0) ; extra == "dev"
+Requires-Dist: packaging (==24.0)
+Requires-Dist: pip (==24.0)
+Requires-Dist: pre-commit (==3.5.0) ; (python_version < "3.9") and (extra == "dev")
+Requires-Dist: pre-commit (==3.7.1) ; (python_version >= "3.9") and (extra == "dev")
+Requires-Dist: psutil (==5.9.4) ; platform_machine != "aarch64"
+Requires-Dist: psutil (==5.9.4) ; platform_machine == "aarch64"
+Requires-Dist: py3createtorrent (==1.1.0) ; extra == "dev"
+Requires-Dist: pyinstaller (==6.9.0) ; extra == "dev"
+Requires-Dist: pylint (==3.2.2) ; extra == "dev"
+Requires-Dist: pytest (==8.1.1) ; extra == "dev"
+Requires-Dist: pytest-cov (==5.0.0) ; extra == "dev"
+Requires-Dist: pytest-mock (==3.14.0) ; extra == "dev"
+Requires-Dist: pytest-monitor (==1.6.6) ; (sys_platform == "linux") and (extra == "dev")
+Requires-Dist: pytest-xdist (==3.6.1) ; extra == "dev"
+Requires-Dist: pyupgrade (==3.15.2) ; extra == "dev"
+Requires-Dist: pyyaml (==6.0.1)
+Requires-Dist: setproctitle (==1.3.3)
+Requires-Dist: setuptools (==70.0.0)
+Requires-Dist: sortedcontainers (==2.4.0)
+Requires-Dist: types-aiofiles (==23.2.0.20240311) ; extra == "dev"
+Requires-Dist: types-cryptography (==3.3.23.2) ; extra == "dev"
+Requires-Dist: types-pyyaml (==6.0.12.20240311) ; extra == "dev"
+Requires-Dist: types-setuptools (==70.0.0.20240524) ; extra == "dev"
+Requires-Dist: typing-extensions (==4.11.0)
+Requires-Dist: watchdog (==4.0.1)
+Requires-Dist: zstd (==1.5.5.1) ; python_version < "3.12"
+Requires-Dist: zstd (==1.5.5.1) ; python_version == "3.12"
+Project-URL: Changelog, https://github.com/Chia-Network/chia-blockchain/blob/main/CHANGELOG.md
+Project-URL: Source, https://github.com/Chia-Network/chia-blockchain/
+Description-Content-Type: text/markdown
+
+# chia-blockchain
+
+[![Chia Network logo][logo-chia]][link-chia]
+
+| Releases                                                                                                                                        | Repo Stats                                                                                                                                                                                                           | Socials                                                                                                                                                                                   |
+| ----------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [![Latest Release][badge-release]][link-latest] <br /> [![Latest RC][badge-rc]][link-release] <br /> [![Latest Beta][badge-beta]][link-release] | [![Coverage][badge-coverage]][link-coverage] <br /> [![Downloads][badge-downloads]][link-downloads] <br /> [![Commits][badge-commits]][link-commits] <br /> [![Contributers][badge-contributers]][link-contributers] | [![Discord][badge-discord]][link-discord] <br /> [![YouTube][badge-youtube]][link-youtube] <br /> [![Reddit][badge-reddit]][link-reddit] <br /> [![Twitter][badge-twitter]][link-twitter] |
+
+Chia is a modern cryptocurrency built from scratch, designed to be efficient, decentralized, and secure. Here are some of the features and benefits:
+
+- [Proof of space and time][link-consensus] based consensus which allows anyone to farm with commodity hardware
+- Very easy to use full node and farmer GUI and cli (thousands of nodes active on mainnet)
+- [Chia seeder][link-seeder], which maintains a list of reliable nodes within the Chia network via a built-in DNS server.
+- Simplified UTXO based transaction model, with small on-chain state
+- Lisp-style Turing-complete functional [programming language][link-chialisp] for money related use cases
+- BLS keys and aggregate signatures (only one signature per block)
+- [Pooling protocol][link-pool] that allows farmers to have control of making blocks
+- Support for light clients with fast, objective syncing
+- A growing community of farmers and developers around the world
+
+Please check out the [Chia website][link-chia], the [Intro to Chia][link-intro], and [FAQ][link-faq] for information on this project.
+
+Python 3.8.1+ is required. Make sure your default python version is >=3.8.1 by typing `python3`.
+
+If you are behind a NAT, it can be difficult for peers outside your subnet to reach you when they start up. You can enable [UPnP][link-upnp]
+on your router or add a NAT (for IPv4 but not IPv6) and firewall rules to allow TCP port 8444 access to your peer.
+These methods tend to be router make/model specific.
+
+Most users should only install harvesters, farmers, plotter, full nodes, and wallets.
+Setting up a seeder is best left to more advanced users.
+Building Timelords and VDFs is for sophisticated users, in most environments.
+Chia Network and additional volunteers are running sufficient Timelords for consensus.
+
+## Installing
+
+Install instructions are available in the [Installation Details][link-install] section of the [Chia Docs][link-docs].
+
+## Running
+
+Once installed, an [Intro to Chia][link-intro] guide is available in the [Chia Docs][link-docs].
+
+[badge-beta]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdownload.chia.net%2Flatest%2Fbadge-data-beta.json&query=%24.message&logo=chianetwork&logoColor=black&label=Latest%20Beta&labelColor=%23e9fbbc&color=%231e2b2e
+[badge-beta2]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdownload.chia.net%2Flatest%2Fbadge-data-beta.json&query=%24.message&logo=chianetwork&logoColor=%23e9fbbc&label=Latest%20Beta&labelColor=%23474748&color=%231e2b2e&link=https%3A%2F%2Fgithub.com%2FChia-Network%2Fchia-blockchain%2Freleases&link=https%3A%2F%2Fgithub.com%2FChia-Network%2Fchia-blockchain%2Freleases
+[badge-commits]: https://img.shields.io/github/commit-activity/w/Chia-Network/chia-blockchain?logo=GitHub
+[badge-contributers]: https://img.shields.io/github/contributors/Chia-Network/chia-blockchain?logo=GitHub
+[badge-coverage]: https://img.shields.io/coverallsCoverage/github/Chia-Network/chia-blockchain?logo=Coveralls&logoColor=red&labelColor=%23212F39
+[badge-discord]: https://dcbadge.vercel.app/api/server/chia?style=flat-square&theme=full-presence
+[badge-discord2]: https://img.shields.io/discord/1034523881404370984.svg?label=Discord&logo=discord&colorB=1e2b2f
+[badge-downloads]: https://img.shields.io/github/downloads/Chia-Network/chia-blockchain/total?logo=GitHub
+[badge-rc]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdownload.chia.net%2Flatest%2Fbadge-data-rc.json&query=%24.message&logo=chianetwork&logoColor=white&label=Latest%20RC&labelColor=%230d3349&color=%23474748
+[badge-reddit]: https://img.shields.io/reddit/subreddit-subscribers/chia?style=flat-square&logo=reddit&labelColor=%230b1416&color=%23222222
+[badge-release]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdownload.chia.net%2Flatest%2Fbadge-data.json&query=%24.message&logo=chianetwork&label=Latest%20Release&labelColor=%231e2b2e&color=%230d3349
+[badge-twitter]: https://img.shields.io/twitter/follow/chia_project?style=flat-square&logo=x.org&logoColor=white&labelColor=black
+[badge-youtube]: https://img.shields.io/youtube/channel/subscribers/UChFkJ3OAUvnHZdiQISWdWPA?style=flat-square&logo=youtube&logoColor=%23ff0000&labelColor=%230f0f0f&color=%23272727
+[link-chia]: https://www.chia.net/
+[link-chialisp]: https://chialisp.com/
+[link-commits]: https://github.com/Chia-Network/chia-blockchain/commits/main/
+[link-consensus]: https://docs.chia.net/consensus-intro/
+[link-contributers]: https://github.com/Chia-Network/chia-blockchain/graphs/contributors
+[link-coverage]: https://coveralls.io/github/Chia-Network/chia-blockchain
+[link-discord]: https://discord.gg/chia
+[link-docs]: https://docs.chia.net/docs-home/
+[link-downloads]: https://www.chia.net/downloads/
+[link-faq]: https://docs.chia.net/faq/
+[link-install]: https://docs.chia.net/installation/
+[link-intro]: https://docs.chia.net/introduction/
+[link-latest]: https://github.com/Chia-Network/chia-blockchain/releases/latest
+[link-pool]: https://docs.chia.net/pool-farming/
+[link-reddit]: https://www.reddit.com/r/chia/
+[link-release]: https://github.com/Chia-Network/chia-blockchain/releases
+[link-seeder]: https://docs.chia.net/guides/seeder-user-guide/
+[link-twitter]: https://twitter.com/chia_project
+[link-upnp]: https://www.homenethowto.com/ports-and-nat/upnp-automatic-port-forward/
+[link-youtube]: https://www.youtube.com/chianetwork
+[logo-chia]: https://www.chia.net/wp-content/uploads/2022/09/chia-logo.svg "Chia logo"
+

chia_blockchain-2.4.3/README.md

@@ -0,0 +1,75 @@
+# chia-blockchain
+
+[![Chia Network logo][logo-chia]][link-chia]
+
+| Releases                                                                                                                                        | Repo Stats                                                                                                                                                                                                           | Socials                                                                                                                                                                                   |
+| ----------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [![Latest Release][badge-release]][link-latest] <br /> [![Latest RC][badge-rc]][link-release] <br /> [![Latest Beta][badge-beta]][link-release] | [![Coverage][badge-coverage]][link-coverage] <br /> [![Downloads][badge-downloads]][link-downloads] <br /> [![Commits][badge-commits]][link-commits] <br /> [![Contributers][badge-contributers]][link-contributers] | [![Discord][badge-discord]][link-discord] <br /> [![YouTube][badge-youtube]][link-youtube] <br /> [![Reddit][badge-reddit]][link-reddit] <br /> [![Twitter][badge-twitter]][link-twitter] |
+
+Chia is a modern cryptocurrency built from scratch, designed to be efficient, decentralized, and secure. Here are some of the features and benefits:
+
+- [Proof of space and time][link-consensus] based consensus which allows anyone to farm with commodity hardware
+- Very easy to use full node and farmer GUI and cli (thousands of nodes active on mainnet)
+- [Chia seeder][link-seeder], which maintains a list of reliable nodes within the Chia network via a built-in DNS server.
+- Simplified UTXO based transaction model, with small on-chain state
+- Lisp-style Turing-complete functional [programming language][link-chialisp] for money related use cases
+- BLS keys and aggregate signatures (only one signature per block)
+- [Pooling protocol][link-pool] that allows farmers to have control of making blocks
+- Support for light clients with fast, objective syncing
+- A growing community of farmers and developers around the world
+
+Please check out the [Chia website][link-chia], the [Intro to Chia][link-intro], and [FAQ][link-faq] for information on this project.
+
+Python 3.8.1+ is required. Make sure your default python version is >=3.8.1 by typing `python3`.
+
+If you are behind a NAT, it can be difficult for peers outside your subnet to reach you when they start up. You can enable [UPnP][link-upnp]
+on your router or add a NAT (for IPv4 but not IPv6) and firewall rules to allow TCP port 8444 access to your peer.
+These methods tend to be router make/model specific.
+
+Most users should only install harvesters, farmers, plotter, full nodes, and wallets.
+Setting up a seeder is best left to more advanced users.
+Building Timelords and VDFs is for sophisticated users, in most environments.
+Chia Network and additional volunteers are running sufficient Timelords for consensus.
+
+## Installing
+
+Install instructions are available in the [Installation Details][link-install] section of the [Chia Docs][link-docs].
+
+## Running
+
+Once installed, an [Intro to Chia][link-intro] guide is available in the [Chia Docs][link-docs].
+
+[badge-beta]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdownload.chia.net%2Flatest%2Fbadge-data-beta.json&query=%24.message&logo=chianetwork&logoColor=black&label=Latest%20Beta&labelColor=%23e9fbbc&color=%231e2b2e
+[badge-beta2]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdownload.chia.net%2Flatest%2Fbadge-data-beta.json&query=%24.message&logo=chianetwork&logoColor=%23e9fbbc&label=Latest%20Beta&labelColor=%23474748&color=%231e2b2e&link=https%3A%2F%2Fgithub.com%2FChia-Network%2Fchia-blockchain%2Freleases&link=https%3A%2F%2Fgithub.com%2FChia-Network%2Fchia-blockchain%2Freleases
+[badge-commits]: https://img.shields.io/github/commit-activity/w/Chia-Network/chia-blockchain?logo=GitHub
+[badge-contributers]: https://img.shields.io/github/contributors/Chia-Network/chia-blockchain?logo=GitHub
+[badge-coverage]: https://img.shields.io/coverallsCoverage/github/Chia-Network/chia-blockchain?logo=Coveralls&logoColor=red&labelColor=%23212F39
+[badge-discord]: https://dcbadge.vercel.app/api/server/chia?style=flat-square&theme=full-presence
+[badge-discord2]: https://img.shields.io/discord/1034523881404370984.svg?label=Discord&logo=discord&colorB=1e2b2f
+[badge-downloads]: https://img.shields.io/github/downloads/Chia-Network/chia-blockchain/total?logo=GitHub
+[badge-rc]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdownload.chia.net%2Flatest%2Fbadge-data-rc.json&query=%24.message&logo=chianetwork&logoColor=white&label=Latest%20RC&labelColor=%230d3349&color=%23474748
+[badge-reddit]: https://img.shields.io/reddit/subreddit-subscribers/chia?style=flat-square&logo=reddit&labelColor=%230b1416&color=%23222222
+[badge-release]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdownload.chia.net%2Flatest%2Fbadge-data.json&query=%24.message&logo=chianetwork&label=Latest%20Release&labelColor=%231e2b2e&color=%230d3349
+[badge-twitter]: https://img.shields.io/twitter/follow/chia_project?style=flat-square&logo=x.org&logoColor=white&labelColor=black
+[badge-youtube]: https://img.shields.io/youtube/channel/subscribers/UChFkJ3OAUvnHZdiQISWdWPA?style=flat-square&logo=youtube&logoColor=%23ff0000&labelColor=%230f0f0f&color=%23272727
+[link-chia]: https://www.chia.net/
+[link-chialisp]: https://chialisp.com/
+[link-commits]: https://github.com/Chia-Network/chia-blockchain/commits/main/
+[link-consensus]: https://docs.chia.net/consensus-intro/
+[link-contributers]: https://github.com/Chia-Network/chia-blockchain/graphs/contributors
+[link-coverage]: https://coveralls.io/github/Chia-Network/chia-blockchain
+[link-discord]: https://discord.gg/chia
+[link-docs]: https://docs.chia.net/docs-home/
+[link-downloads]: https://www.chia.net/downloads/
+[link-faq]: https://docs.chia.net/faq/
+[link-install]: https://docs.chia.net/installation/
+[link-intro]: https://docs.chia.net/introduction/
+[link-latest]: https://github.com/Chia-Network/chia-blockchain/releases/latest
+[link-pool]: https://docs.chia.net/pool-farming/
+[link-reddit]: https://www.reddit.com/r/chia/
+[link-release]: https://github.com/Chia-Network/chia-blockchain/releases
+[link-seeder]: https://docs.chia.net/guides/seeder-user-guide/
+[link-twitter]: https://twitter.com/chia_project
+[link-upnp]: https://www.homenethowto.com/ports-and-nat/upnp-automatic-port-forward/
+[link-youtube]: https://www.youtube.com/chianetwork
+[logo-chia]: https://www.chia.net/wp-content/uploads/2022/09/chia-logo.svg "Chia logo"

chia_blockchain-2.4.3/chia/_tests/blockchain/blockchain_test_utils.py

@@ -0,0 +1,177 @@
+from __future__ import annotations
+
+from typing import List, Optional
+
+from chia_rs import BLSCache
+
+from chia.consensus.block_body_validation import ForkInfo
+from chia.consensus.blockchain import AddBlockResult, Blockchain
+from chia.consensus.multiprocess_validation import PreValidationResult
+from chia.types.full_block import FullBlock
+from chia.util.errors import Err
+from chia.util.ints import uint32, uint64
+
+
+async def check_block_store_invariant(bc: Blockchain):
+    db_wrapper = bc.block_store.db_wrapper
+
+    if db_wrapper.db_version == 1:
+        return
+
+    in_chain = set()
+    max_height = -1
+    async with db_wrapper.writer_maybe_transaction() as conn:
+        async with conn.execute("SELECT height, in_main_chain FROM full_blocks") as cursor:
+            rows = await cursor.fetchall()
+            for row in rows:
+                height = row[0]
+
+                # if this block is in-chain, ensure we haven't found another block
+                # at this height that's also in chain. That would be an invariant
+                # violation
+                if row[1]:
+                    # make sure we don't have any duplicate heights. Each block
+                    # height can only have a single block with in_main_chain set
+                    assert height not in in_chain
+                    in_chain.add(height)
+                    max_height = max(max_height, height)
+
+            # make sure every height is represented in the set
+            assert len(in_chain) == max_height + 1
+
+
+async def _validate_and_add_block(
+    blockchain: Blockchain,
+    block: FullBlock,
+    *,
+    expected_result: Optional[AddBlockResult] = None,
+    expected_error: Optional[Err] = None,
+    skip_prevalidation: bool = False,
+    fork_info: Optional[ForkInfo] = None,
+    use_bls_cache: bool = False,
+) -> None:
+    # Tries to validate and add the block, and checks that there are no errors in the process and that the
+    # block is added to the peak.
+    # If expected_result is not None, that result will be enforced.
+    # If expected_error is not None, that error will be enforced. If expected_error is not None,
+    # add_block must return Err.INVALID_BLOCK.
+    # If expected_result == INVALID_BLOCK but expected_error is None, we will allow for errors to happen
+
+    await check_block_store_invariant(blockchain)
+    if skip_prevalidation:
+        results = PreValidationResult(None, uint64(1), None, False, uint32(0))
+    else:
+        # validate_signatures must be False in order to trigger add_block() to
+        # validate the signature.
+        pre_validation_results: List[PreValidationResult] = await blockchain.pre_validate_blocks_multiprocessing(
+            [block], {}, validate_signatures=False
+        )
+        assert pre_validation_results is not None
+        results = pre_validation_results[0]
+    if results.error is not None:
+        if expected_result == AddBlockResult.INVALID_BLOCK and expected_error is None:
+            # We expected an error but didn't specify which one
+            await check_block_store_invariant(blockchain)
+            return None
+        if expected_error is None:
+            # We did not expect an error
+            raise AssertionError(Err(results.error))
+        elif Err(results.error) != expected_error:
+            # We expected an error but a different one
+            raise AssertionError(f"Expected {expected_error} but got {Err(results.error)}")
+        await check_block_store_invariant(blockchain)
+        return None
+
+    if use_bls_cache:
+        bls_cache = BLSCache(100)
+    else:
+        bls_cache = None
+
+    (
+        result,
+        err,
+        _,
+    ) = await blockchain.add_block(block, results, bls_cache, fork_info=fork_info)
+    await check_block_store_invariant(blockchain)
+
+    if expected_error is None and expected_result != AddBlockResult.INVALID_BLOCK:
+        # Expecting an error here (but didn't specify which), let's check if we actually got an error
+        if err is not None:
+            # Got an error
+            raise AssertionError(err)
+    else:
+        # Here we will enforce checking of the exact error
+        if err != expected_error:
+            # Did not get the right error, or did not get an error
+            raise AssertionError(f"Expected {expected_error} but got {err}")
+
+    if expected_result is not None and expected_result != result:
+        raise AssertionError(f"Expected {expected_result} but got {result}")
+    elif expected_result is None:
+        # If we expected an error assume that expected_result = INVALID_BLOCK
+        if expected_error is not None and result != AddBlockResult.INVALID_BLOCK:
+            raise AssertionError(f"Block should be invalid, but received: {result}")
+        # Otherwise, assume that expected_result = NEW_PEAK
+        if expected_error is None and result != AddBlockResult.NEW_PEAK:
+            raise AssertionError(f"Block was not added: {result}")
+
+
+async def _validate_and_add_block_multi_error(
+    blockchain: Blockchain,
+    block: FullBlock,
+    expected_errors: List[Err],
+    skip_prevalidation: bool = False,
+    fork_info: Optional[ForkInfo] = None,
+) -> None:
+    # Checks that the blockchain returns one of the expected errors
+    try:
+        await _validate_and_add_block(blockchain, block, skip_prevalidation=skip_prevalidation, fork_info=fork_info)
+    except Exception as e:
+        assert isinstance(e, AssertionError)
+        assert e.args[0] in expected_errors
+        return
+
+    raise AssertionError("Did not return an error")
+
+
+async def _validate_and_add_block_multi_result(
+    blockchain: Blockchain,
+    block: FullBlock,
+    expected_result: List[AddBlockResult],
+    skip_prevalidation: bool = False,
+    fork_info: Optional[ForkInfo] = None,
+) -> None:
+    try:
+        await _validate_and_add_block(
+            blockchain,
+            block,
+            skip_prevalidation=skip_prevalidation,
+            fork_info=fork_info,
+        )
+    except Exception as e:
+        assert isinstance(e, AssertionError)
+        assert "Block was not added" in e.args[0]
+        expected_list: List[str] = [f"Block was not added: {res}" for res in expected_result]
+        if e.args[0] not in expected_list:
+            raise AssertionError(f"{e.args[0].split('Block was not added: ')[1]} not in {expected_result}")
+
+
+async def _validate_and_add_block_no_error(
+    blockchain: Blockchain,
+    block: FullBlock,
+    skip_prevalidation: bool = False,
+    fork_info: Optional[ForkInfo] = None,
+) -> None:
+    # adds a block and ensures that there is no error. However, does not ensure that block extended the peak of
+    # the blockchain
+    await _validate_and_add_block_multi_result(
+        blockchain,
+        block,
+        expected_result=[
+            AddBlockResult.ALREADY_HAVE_BLOCK,
+            AddBlockResult.NEW_PEAK,
+            AddBlockResult.ADDED_AS_ORPHAN,
+        ],
+        skip_prevalidation=skip_prevalidation,
+        fork_info=fork_info,
+    )