degenbot.builders.request
=========================

.. py:module:: degenbot.builders.request

.. autoapi-nested-parse::

   BuildPoolRequest — typed request object for pool construction.







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

.. py:class:: BuildPoolRequest

   Typed request object carrying optional parameters for pool construction.

   Carries all optional parameters for build_pool() and its dispatched
   builders. Required parameters (address, chain_id, io) remain on
   builder.build() as positional/keyword arguments.

   Builders read the fields they recognize and ignore the rest.


   .. py:attribute:: silent
      :type:  bool
      :value: False



   .. py:attribute:: state_block
      :type:  int | None
      :value: None



   .. py:attribute:: state_cache_depth
      :type:  int
      :value: 8



   .. py:attribute:: tick_bitmap
      :type:  dict[int, Any] | None
      :value: None



   .. py:attribute:: tick_data
      :type:  dict[int, Any] | None
      :value: None



   .. py:attribute:: construction_route
      :type:  ConstructionRoute | None
      :value: None



   .. py:attribute:: bpt_idx
      :type:  int | None
      :value: None



   .. py:attribute:: invariant_version
      :type:  int | None
      :value: None



.. py:class:: ConstructionRoute

   The resolved construction-route policy (CONTEXT.md, Construction route).

   ONE ordered attempt policy for constructing a family-unknown single-address
   pool: the factory rungs in policy order, terminating in the generic
   builder rung. A driver VALUE the cockpit resolves — the core route entry
   walks it and classifies every failure on the build-refusal taxonomy; the
   driver never re-implements the chain (the retired tracker fallback chain
   is the bug this replaces).


   .. py:attribute:: factories
      :type:  tuple[str, ...]
      :value: ()



   .. py:attribute:: generic
      :type:  bool
      :value: True



.. py:class:: BuildManagedPoolRequest

   Typed request object for V4 managed-pool construction.

   ``pool_id`` is required — V4 pools cannot be discovered without it.
   Immutable data (``state_view_address``, ``tokens``, ``fee``,
   ``tick_spacing``, ``hook_address``) is required when the pool is not
   in the database; otherwise it is fetched from DB.


   .. py:attribute:: pool_id
      :type:  str | bytes


   .. py:attribute:: silent
      :type:  bool
      :value: False



   .. py:attribute:: state_block
      :type:  int | None
      :value: None



   .. py:attribute:: state_cache_depth
      :type:  int
      :value: 8



   .. py:attribute:: state_view_address
      :type:  str | None
      :value: None



   .. py:attribute:: tokens
      :type:  collections.abc.Sequence[str] | None
      :value: None



   .. py:attribute:: fee
      :type:  int | None
      :value: None



   .. py:attribute:: tick_spacing
      :type:  int | None
      :value: None



   .. py:attribute:: hook_address
      :type:  str | None
      :value: None



   .. py:attribute:: tick_bitmap
      :type:  dict[int, Any] | None
      :value: None



   .. py:attribute:: tick_data
      :type:  dict[int, Any] | None
      :value: None



.. py:data:: BuildRequest