y.prices.dex.balancer package

Submodules

y.prices.dex.balancer.balancer module

class y.prices.dex.balancer.balancer.BalancerMultiplexer

Bases: ASyncGenericBase

__init__(asynchronous=False)

Parameters:

asynchronous (bool)

Return type:

None

__v1__: HiddenMethodDescriptor[Self, BalancerV1 | None]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__v2__: HiddenMethodDescriptor[Self, BalancerV2 | None]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__versions__: HiddenMethodDescriptor[Self, List[BalancerV1 | BalancerV2]]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

get_pool_price

Parameters:

• token_address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

UsdPrice | None

get_price

Since get_price is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

• token_address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

UsdPrice | None

get_version

Since get_version is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

token_address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

Return type:

BalancerABC

is_balancer_pool

Parameters:

token_address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

Return type:

bool

v1

v2

versions

y.prices.dex.balancer.v1 module

class y.prices.dex.balancer.v1.BalancerV1

Bases: BalancerABC[BalancerV1Pool]

__init__(asynchronous=False)

Parameters:

asynchronous (bool)

Return type:

None

check_liquidity

Parameters:

• token (str | HexBytes | AnyAddress | EthAddress)

• block (int | BlockNumber)

• ignore_pools (Tuple[UniswapV2Pool | CurvePool, ...])

Return type:

int

check_liquidity_against

Parameters:

• token_in (str | HexBytes | AnyAddress | EthAddress | Contract)

• token_out (str | HexBytes | AnyAddress | EthAddress | Contract)

• scale (int)

• block (int | BlockNumber | None)

Return type:

int | None

get_pool_price

Parameters:

• pool_address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

UsdPrice

get_some_output

Parameters:

• token_in (str | HexBytes | AnyAddress | EthAddress | Contract)

• scale (int)

• block (int | BlockNumber | None)

Return type:

Tuple[EthAddress, int] | None

get_token_price

Parameters:

• token_address (str | HexBytes | AnyAddress | EthAddress | Contract)

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

UsdPrice | None

is_pool

Since is_pool is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

token_address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

Return type:

bool

class y.prices.dex.balancer.v1.BalancerV1Pool

Bases: BalancerPool

ASyncFunction_decimals(block: int | eth_typing.evm.BlockNumber | NoneType = None) → int

used to fetch decimals at specific block

Since _decimals is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

block (int | BlockNumber | None)

Return type:

int

ASyncFunction_scale(block: int | eth_typing.evm.BlockNumber | NoneType = None) → int

Since _scale is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

block (int | BlockNumber | None)

Return type:

int

__eq__(_ContractBase__o)

Return self==value.

Parameters:

_ContractBase__o (object)

Return type:

bool

__init__(address, asynchronous=False, _deploy_block=None)

Parameters:

• address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• asynchronous (bool)

• _deploy_block (int | None)

Return type:

None

__str__()

Return the contract address as a string.

Returns:

The contract address as a string.

Return type:

str

__build_name__: HiddenMethodDescriptor[Self, str]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__decimals__: HiddenMethodDescriptor[Self, int]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__name__: HiddenMethodDescriptor[Self, str] = 'BalancerV1Pool'

__scale__: HiddenMethodDescriptor[Self, int]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__symbol__: HiddenMethodDescriptor[Self, str]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__tokens__: HiddenMethodDescriptor[Self, List[ERC20]]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

address: Address

The contract address of the token.

asynchronous: bool = False

balance_of

Query the balance of the token for a given address at a specific block.

Parameters:

• address (str | HexBytes | AnyAddress | EthAddress | Contract | int) – The address to query.

• block (optional) – The block number to query. Defaults to latest block.

Returns:

The balance of the token held by address at block block.

Return type:

int

balance_of_readable

Parameters:

• address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• block (int | BlockNumber | None)

Return type:

float

build_name

Get the contract’s build name.

Returns:

The contract’s build name.

check_liquidity

Since check_liquidity is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

• token (str | HexBytes | AnyAddress | EthAddress)

• block (int | BlockNumber)

Return type:

int

property contract: Contract

decimals

The number of decimal places for the token.

Returns:

The number of decimal places for the token.

deploy_block: ASyncBoundMethod[Self, Any, int]

Parameters:

when_no_history_return_0 (bool)

Return type:

int

get_balance

Parameters:

• token (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• block (int | BlockNumber)

Return type:

Decimal

get_balances

Parameters:

block (int | BlockNumber | None)

Return type:

Dict[ERC20, Decimal]

get_pool_price

Calculate the price of the liquidity pool token.

This method calculates the price of a single liquidity pool token by dividing the total value locked (TVL) by the total supply of the pool tokens.

Parameters:

• block (int | BlockNumber | None) – The block number at which to calculate the price. If None, uses the latest block.

• skip_cache (bool) – If True, bypasses ypricemagic’s local caching mechanisms and forces a fresh calculation.

Returns:

The price of a single liquidity pool token as a UsdPrice object.

Return type:

UsdPrice | None

get_tvl

Parameters:

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

UsdValue | None

has_method

Parameters:

• method (str)

• return_response (bool)

Return type:

bool | Any

name

The token’s name.

Returns:

The token’s name.

price

Get the price of the token in USD.

Parameters:

• block (optional) – The block number to query. Defaults to latest block.

• return_None_on_failure (bool) – If True, return None instead of raising a yPriceMagicError on failure.

• skip_cache (bool) – If True, skip using the cache while fetching price data.

• ignore_pools (Tuple[UniswapV2Pool | CurvePool, ...]) – An optional tuple of pools to ignore when calculating the price.

Returns:

The price of the token in USD, or None if return_None_on_failure is True and the price cannot be retrieved.

Raises:

yPriceMagicError – If return_None_on_failure is False and the price cannot be retrieved.

Return type:

UsdPrice | None

scale

Get the scaling factor for the token.

Returns:

The scaling factor for the token.

symbol

The token’s symbol.

Returns:

The token’s symbol.

tokens

total_supply

Get the total supply of the token.

Parameters:

block (optional) – The block number to query. Defaults to latest block.

Returns:

The total supply of the token.

Return type:

int

total_supply_readable

Get the total supply of the token scaled to a human-readable decimal.

Parameters:

block (optional) – The block number to query.

Returns:

The total supply of the token scaled to a decimal.

Return type:

float

y.prices.dex.balancer.v2 module

class y.prices.dex.balancer.v2.BalancerEvents

Bases: ProcessedEvents[Tuple[HexBytes, EthAddress, int | BlockNumber]]

When awaited, a list of all elements will be returned.

obj_type

alias of _EventItem

__aiter__()

Return an async iterator that yields T objects from the ASyncIterable.

Return type:

AsyncIterator[T]

__await__()

Asynchronously iterate through the ASyncIterable and return all objects.

Returns:

A list of the objects yielded by the ASyncIterable.

Return type:

Generator[Any, Any, List[T]]

__init__(vault, *args, asynchronous=False, **kwargs)

Initialize a LogFilter instance.

Parameters:

• addresses – List of contract addresses to fetch logs from.

• topics – List of event topics to filter logs by.

• from_block – The starting block to fetch logs from.

• chunk_size – The number of blocks to fetch in each chunk.

• chunks_per_batch – The number of chunks to fetch in each batch.

• semaphore – A semaphore for limiting concurrent requests.

• executor – An executor for running tasks asynchronously.

• is_reusable – Whether the filter is reusable.

• verbose – Verbosity level for logging.

• vault (BalancerV2Vault)

• asynchronous (bool)

__iter__()

Return an iterator that yields T objects from the ASyncIterable.

Return type:

Iterator[T]

_objects_thru(block)

Parameters:

block (int | None)

Return type:

AsyncIterator[T]

events(to_block)

Get events up to a given block.

Parameters:

to_block (int) – The ending block to fetch events to.

Yields:

A decoded event.

Return type:

ASyncIterator[_EventItem]

filter(function)

Filters the contents of the ASyncIterable based on a function.

Parameters:

function (Callable[[T], Awaitable[bool]] | Callable[[T], bool]) – A function that returns a boolean that indicates if an item should be included in the filtered result. Can be sync or async.

Returns:

An instance of ASyncFilter that yields the filtered objects from the ASyncIterable.

Return type:

ASyncFilter[T]

logs(to_block)

Get logs up to a given block.

Parameters:

to_block (int | None) – The ending block to fetch logs to.

Yields:

A decoded event log.

Return type:

ASyncIterator[Log]

objects(to_block)

Get an ASyncIterator that yields all events up to a given block.

Parameters:

to_block (int) – The ending block to fetch events to.

Returns:

An ASyncIterator that yields all included events.

Return type:

ASyncIterator[_EventItem]

sort(*, key=None, reverse=False)

Sort the contents of the ASyncIterable.

Parameters:

• key (optional) – A function of one argument that is used to extract a comparison key from each list element. If None, the elements themselves will be sorted. Defaults to None.

• reverse (optional) – If True, the yielded elements will be sorted in reverse order. Defaults to False.

Returns:

An instance of ASyncSorter that will yield the objects yielded from this ASyncIterable, but sorted.

Return type:

ASyncSorter[T]

classmethod wrap(wrapped)

Class method to wrap an AsyncIterable for backward compatibility.

Parameters:

wrapped (AsyncIterable[T])

Return type:

ASyncIterable[T]

__wrapped__: AsyncIterable[T]

The wrapped async iterable object.

addresses

asynchronous

property bulk_insert: Callable[[List[Log]], Awaitable[None]]

Get the function for bulk inserting logs into the database.

Returns:

A function for bulk inserting logs.

property cache: LogCache

property executor: _AsyncExecutorMixin

from_block

property insert_to_db: Callable[[Log], None]

Get the function for inserting logs into the database.

Raises:

NotImplementedError – If this method is not implemented in the subclass.

property is_asleep: bool

is_reusable

property materialized: List[T]

Synchronously iterate through the ASyncIterable and return all objects.

Returns:

A list of the objects yielded by the ASyncIterable.

property semaphore: BlockSemaphore

threads = <PruningThreadPoolExecutor object at 0x7f2bc539dda0 [0/6 threads]>

to_block

topics

class y.prices.dex.balancer.v2.BalancerV2

Bases: BalancerABC[BalancerV2Pool]

__init__(asynchronous=False)

Parameters:

asynchronous (bool)

Return type:

None

deepest_pool_for

Parameters:

• token_address (str | HexBytes | AnyAddress | EthAddress)

• block (int | BlockNumber | None)

Return type:

BalancerV2Pool | None

get_pool_price

Parameters:

• pool_address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

UsdPrice

get_token_price

Parameters:

• token_address (str | HexBytes | AnyAddress | EthAddress)

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

UsdPrice

is_pool

Since is_pool is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

token_address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

Return type:

bool

class y.prices.dex.balancer.v2.BalancerV2Pool

Bases: BalancerPool

A pool from Balancer Protocol v2

ASyncFunction_decimals(block: int | eth_typing.evm.BlockNumber | NoneType = None) → int

used to fetch decimals at specific block

Since _decimals is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

block (int | BlockNumber | None)

Return type:

int

ASyncFunction_scale(block: int | eth_typing.evm.BlockNumber | NoneType = None) → int

Since _scale is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

block (int | BlockNumber | None)

Return type:

int

__eq__(_ContractBase__o)

Return self==value.

Parameters:

_ContractBase__o (object)

Return type:

bool

__init__(address, *, id=None, specialization=None, vault=None, asynchronous=False, _deploy_block=None)

Parameters:

• address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• id (HexBytes | None)

• specialization (PoolSpecialization | None)

• vault (BalancerV2Vault | None)

• asynchronous (bool)

• _deploy_block (int | BlockNumber | None)

__str__()

Return the contract address as a string.

Returns:

The contract address as a string.

Return type:

str

__build_name__: HiddenMethodDescriptor[Self, str]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__decimals__: HiddenMethodDescriptor[Self, int]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__id__: HiddenMethodDescriptor[Self, PoolId]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__name__: HiddenMethodDescriptor[Self, str] = 'BalancerV2Pool'

__pool_type__: HiddenMethodDescriptor[Self, PoolSpecialization | None]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__scale__: HiddenMethodDescriptor[Self, int]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__symbol__: HiddenMethodDescriptor[Self, str]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

__vault__: HiddenMethodDescriptor[Self, BalancerV2Vault | None]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

address: Address

The contract address of the token.

asynchronous: bool = False

balance_of

Query the balance of the token for a given address at a specific block.

Parameters:

• address (str | HexBytes | AnyAddress | EthAddress | Contract | int) – The address to query.

• block (optional) – The block number to query. Defaults to latest block.

Returns:

The balance of the token held by address at block block.

Return type:

int

balance_of_readable

Parameters:

• address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• block (int | BlockNumber | None)

Return type:

float

build_name

Get the contract’s build name.

Returns:

The contract’s build name.

property contract: Contract

decimals

The number of decimal places for the token.

Returns:

The number of decimal places for the token.

deploy_block: ASyncBoundMethod[Self, Any, int]

Parameters:

when_no_history_return_0 (bool)

Return type:

int

get_balance

Parameters:

• token_address (str | HexBytes | AnyAddress | EthAddress)

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

WeiBalance | None

get_balances

Since get_balances is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

Dict[ERC20, WeiBalance]

get_pool_price

Calculate the price of the liquidity pool token.

This method calculates the price of a single liquidity pool token by dividing the total value locked (TVL) by the total supply of the pool tokens.

Parameters:

• block (int | BlockNumber | None) – The block number at which to calculate the price. If None, uses the latest block.

• skip_cache (bool) – If True, bypasses ypricemagic’s local caching mechanisms and forces a fresh calculation.

Returns:

The price of a single liquidity pool token as a UsdPrice object.

Return type:

UsdPrice | None

get_token_price

Parameters:

• token_address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

UsdPrice | None

get_tvl

Parameters:

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

UsdValue | None

has_method

Parameters:

• method (str)

• return_response (bool)

Return type:

bool | Any

id

name

The token’s name.

Returns:

The token’s name.

pool_type

price

Get the price of the token in USD.

Parameters:

• block (optional) – The block number to query. Defaults to latest block.

• return_None_on_failure (bool) – If True, return None instead of raising a yPriceMagicError on failure.

• skip_cache (bool) – If True, skip using the cache while fetching price data.

• ignore_pools (Tuple[UniswapV2Pool | CurvePool, ...]) – An optional tuple of pools to ignore when calculating the price.

Returns:

The price of the token in USD, or None if return_None_on_failure is True and the price cannot be retrieved.

Raises:

yPriceMagicError – If return_None_on_failure is False and the price cannot be retrieved.

Return type:

UsdPrice | None

scale

Get the scaling factor for the token.

Returns:

The scaling factor for the token.

symbol

The token’s symbol.

Returns:

The token’s symbol.

tokens

Since tokens is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

• block (int | BlockNumber | None)

• skip_cache (bool)

Return type:

Tuple[ERC20, …]

total_supply

Get the total supply of the token.

Parameters:

block (optional) – The block number to query. Defaults to latest block.

Returns:

The total supply of the token.

Return type:

int

total_supply_readable

Get the total supply of the token scaled to a human-readable decimal.

Parameters:

block (optional) – The block number to query.

Returns:

The total supply of the token scaled to a decimal.

Return type:

float

vault

weights

Since weights is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

block (int | BlockNumber | None)

Return type:

List[int]

class y.prices.dex.balancer.v2.BalancerV2Vault

Bases: ContractBase

__eq__(_ContractBase__o)

Return self==value.

Parameters:

_ContractBase__o (object)

Return type:

bool

__init__(address, asynchronous=False)

Parameters:

• address (str | HexBytes | AnyAddress | EthAddress | Contract | int)

• asynchronous (bool)

Return type:

None

__str__()

Return the contract address as a string.

Returns:

The contract address as a string.

Return type:

str

pools(block=None)

Parameters:

block (int | BlockNumber | None)

Return type:

AsyncIterator[BalancerV2Pool]

pools_for_token(token, block=None)

Parameters:

• token (str | HexBytes | AnyAddress | EthAddress)

• block (int | BlockNumber | None)

Return type:

AsyncIterator[BalancerV2Pool]

__build_name__: HiddenMethodDescriptor[Self, str]

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

The original docstring for get() is shown below:

Asynchronously retrieves the property value.

Args:

instance: The instance from which the property is accessed. owner: The owner class of the property.

Returns:

The property value.

Parameters:

• instance (I)

• owner (Type[I] | None)

Return type:

T

address

asynchronous: bool = False

build_name

Get the contract’s build name.

Returns:

The contract’s build name.

property contract: Contract

deepest_pool_for

Since deepest_pool_for is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

• token_address (str | HexBytes | AnyAddress | EthAddress)

• block (int | BlockNumber | None)

Return type:

BalancerV2Pool

deploy_block: ASyncBoundMethod[Self, Any, int]

Parameters:

when_no_history_return_0 (bool)

Return type:

int

get_pool_info

Since get_pool_info is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

• poolids (Tuple[HexBytes, ...])

• block (int | BlockNumber | None)

Return type:

List[Tuple]

get_pool_tokens

Since get_pool_tokens is an ASyncFunctionAsyncDefault, you can optionally pass sync=True or asynchronous=False to force it to run synchronously and return a value. Without either kwarg, it will return a coroutine for you to await.

Parameters:

• pool_id (HexBytes)

• block (int | BlockNumber | None)

has_method

Parameters:

• method (str)

• return_response (bool)

Return type:

bool | Any

class y.prices.dex.balancer.v2.PoolSpecialization

Bases: IntEnum

An enumeration.

__add__(value, /)

Return self+value.

__and__(value, /)

Return self&value.

__bool__()

True if self else False

__eq__(value, /)

Return self==value.

__floordiv__(value, /)

Return self//value.

__ge__(value, /)

Return self>=value.

__getattribute__(name, /)

Return getattr(self, name).

__gt__(value, /)

Return self>value.

__index__()

Return self converted to an integer, if self is suitable for use as an index into a list.

__invert__()

~self

__le__(value, /)

Return self<=value.

__lshift__(value, /)

Return self<<value.

__lt__(value, /)

Return self<value.

__mul__(value, /)

Return self*value.

__or__(value, /)

Return self|value.

__pow__(value, mod=None, /)

Return pow(self, value, mod).

__radd__(value, /)

Return value+self.

__rand__(value, /)

Return value&self.

__rlshift__(value, /)

Return value<<self.

__ror__(value, /)

Return value|self.

__rrshift__(value, /)

Return value>>self.

__rshift__(value, /)

Return self>>value.

__rxor__(value, /)

Return value^self.

__sizeof__()

Returns size in memory, in bytes.

__sub__(value, /)

Return self-value.

__truediv__(value, /)

Return self/value.

__xor__(value, /)

Return self^value.

from_bytes(byteorder, *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value.

signed

Indicates whether two’s complement is used to represent the integer.

to_bytes(length, byteorder, *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

static with_immutable_tokens()

Return type:

List[PoolSpecialization]

ComposableStablePool = 0

CronV1Pool = -1

WeightedPool = 1

WeightedPool2Tokens = 2

denominator

the denominator of a rational number in lowest terms

numerator

the numerator of a rational number in lowest terms

Module contents