degenbot.exceptions.rpc
=======================

.. py:module:: degenbot.exceptions.rpc

.. autoapi-nested-parse::

   Provider/RPC-layer exceptions owned by degenbot.

   These are the degenbot-owned equivalents of the ``web3.exceptions`` types the
   codebase previously imported: ``Web3Exception`` (the broad RPC base),
   ``ContractLogicError`` (an ``eth_call`` execution revert), and
   ``TransactionNotFound`` (a transaction hash the provider could not find).

   Owning them here lets probe sites throughout the codebase
   (:mod:`degenbot.builders.type_resolution`, :mod:`degenbot.builders.erc20_builder`)
   catch a single degenbot-owned type regardless of which provider backend raised
   the failure. ``degenbot.provider.alloy_errors`` converts the backend's native
   failure into these types so downstream code is backend-agnostic.

   Layering note: these are **provider-layer** exceptions — the RPC node reported a
   revert or a missing transaction. They are distinct from the pool-math-layer
   :exc:`~degenbot.exceptions.EVMRevertError` (a local pool-state simulation that
   would revert). :meth:`CurveDataProvider._wrap_revert` bridges the two:
   provider-layer :exc:`ContractLogicError` → pool-layer :exc:`EVMRevertError`.





Module Contents
---------------

.. py:class:: RpcError

   Bases: :py:obj:`degenbot.exceptions.base.DegenbotError`


   Base for provider/RPC-layer failures.

   The degenbot-owned equivalent of ``web3.exceptions.Web3Exception``: the
   broad base a caller can catch to mean "an RPC call failed for some reason."
   Probe sites catch this instead of backend-specific native types, so they
   remain backend-agnostic.


.. py:class:: ContractLogicError(message: str = '')

   Bases: :py:obj:`RpcError`


   An ``eth_call`` execution revert reported by the provider.

   The degenbot-owned equivalent of ``web3.exceptions.ContractLogicError``.
   Raised at the provider adapter seam (see
   :func:`degenbot.provider.alloy_errors.alloy_revert_error`) so probe sites
   catch one type regardless of backend.

   Constructed with a positional revert message (mirroring the web3 type's
   constructor) so call sites can write ``ContractLogicError("... reverted")
   `` and ``str(exc)`` returns that message.


   .. py:attribute:: message
      :value: None



.. py:class:: TransactionNotFound

   Bases: :py:obj:`RpcError`


   A transaction hash the provider could not find.

   The degenbot-owned equivalent of
   ``web3.exceptions.TransactionNotFound``. Raised by the provider adapter
   seam when a receipt lookup misses.