Balancer¶

Connector for Balancer V2 — flash loans only.

Flash-loan-only — no LP support

Balancer is integrated for FLASH_LOAN intents (via the Balancer Vault), not liquidity provision. Intent.lp_open(..., protocol="balancer") / lp_close(...) are not routable and fail at compile time with a capability error listing the protocols that do support LP (e.g. Uniswap V3/V4, Aerodrome, Curve, TraderJoe V2, …).

For Balancer-pool LP, no connector exists yet. The authoritative, intent-scoped capability list is almanak info matrix (Balancer appears under the flash_loan category only).

almanak.connectors.balancer_v2 ¶

Balancer Flash Loan Connector.

This module provides an adapter for executing flash loans via Balancer's Vault contract. Balancer flash loans have zero fees (no premium), making them ideal for arbitrage.

Balancer Vault features: - Zero-fee flash loans (no premium) - Single or multi-token flash loans - All supported tokens available from liquidity pools - Simple interface: flashLoan(recipient, tokens, amounts, userData)

Supported chains: - Ethereum - Arbitrum - Optimism - Polygon - Base - Avalanche

Example

from almanak.connectors.balancer_v2 import BalancerFlashLoanAdapter, BalancerFlashLoanConfig

config = BalancerFlashLoanConfig( chain="arbitrum", wallet_address="0x...", ) adapter = BalancerFlashLoanAdapter(config)

Execute flash loan¶

result = adapter.flash_loan( recipient="0x...", tokens=["USDC"], amounts=[Decimal("100000")], )

BalancerFlashLoanAdapter ¶

BalancerFlashLoanAdapter(
    chain: str, protocol: str = "balancer"
)

Adapter for Balancer Vault flash loans.

Balancer flash loans have zero fees, making them ideal for arbitrage strategies. The Vault contract holds all pool liquidity, enabling large flash loans.

Example

config = BalancerFlashLoanConfig( chain="arbitrum", wallet_address="0x...", ) adapter = BalancerFlashLoanAdapter(config)

Get flash loan calldata¶

calldata = adapter.get_flash_loan_calldata( recipient="0x...", tokens=["0x...USDC", "0x...WETH"], amounts=[1000000000, 500000000000000000], user_data=b"", )

Initialize the adapter.

参数：

名称	类型	描述	默认
`chain`	`str`	Target blockchain	必需
`protocol`	`str`	Protocol name (always "balancer")	`'balancer'`

get_vault_address ¶

get_vault_address() -> str

Get the Balancer Vault address.

get_flash_loan_calldata ¶

get_flash_loan_calldata(
    recipient: str,
    tokens: list[str],
    amounts: list[int],
    user_data: bytes = b"",
) -> bytes

Generate calldata for a Balancer flash loan.

Balancer flashLoan function: flashLoan( IFlashLoanRecipient recipient, IERC20[] memory tokens, uint256[] memory amounts, bytes memory userData )

参数：

名称	类型	描述	默认
`recipient`	`str`	Contract address that will receive and handle the flash loan	必需
`tokens`	`list[str]`	List of token addresses to borrow	必需
`amounts`	`list[int]`	List of amounts to borrow (in token's smallest units)	必需
`user_data`	`bytes`	Extra data to pass to receiver's receiveFlashLoan	`b''`

返回：

类型	描述
`bytes`	Encoded calldata for the flashLoan transaction

get_flash_loan_simple_calldata ¶

get_flash_loan_simple_calldata(
    recipient: str,
    token: str,
    amount: int,
    user_data: bytes = b"",
) -> bytes

Generate calldata for a single-token flash loan.

This is a convenience method that wraps get_flash_loan_calldata for single-token flash loans.

参数：

名称	类型	描述	默认
`recipient`	`str`	Contract address that will receive the flash loan	必需
`token`	`str`	Token address to borrow	必需
`amount`	`int`	Amount to borrow (in token's smallest units)	必需
`user_data`	`bytes`	Extra data to pass to receiver's receiveFlashLoan	`b''`

返回：

类型	描述
`bytes`	Encoded calldata for the flashLoan transaction

estimate_flash_loan_gas ¶

estimate_flash_loan_gas() -> int

Estimate gas for a multi-token flash loan (base only, not including callbacks).

estimate_flash_loan_simple_gas ¶

estimate_flash_loan_simple_gas() -> int

Estimate gas for a single-token flash loan (base only, not including callbacks).

BalancerFlashLoanConfig `dataclass` ¶

BalancerFlashLoanConfig(chain: str, wallet_address: str)

Configuration for Balancer flash loan adapter.

属性：

名称	类型	描述
`chain`	`str`	Target blockchain (ethereum, arbitrum, optimism, polygon, base, avalanche)
`wallet_address`	`str`	Address executing the flash loan

BalancerFlashLoanParams `dataclass` ¶

BalancerFlashLoanParams(
    recipient: str,
    tokens: list[str],
    amounts: list[int],
    user_data: bytes = bytes(),
)

Parameters for a Balancer flash loan.

属性：

名称	类型	描述
`recipient`	`str`	Contract that will receive the flash loan and handle callbacks
`tokens`	`list[str]`	List of token addresses to borrow
`amounts`	`list[int]`	List of amounts to borrow (in wei)
`user_data`	`bytes`	Arbitrary bytes to pass to the receiver's receiveFlashLoan()

TransactionResult `dataclass` ¶

TransactionResult(
    success: bool,
    calldata: bytes = bytes(),
    to: str = "",
    value: int = 0,
    gas_estimate: int = 0,
    error: str | None = None,
)

Result of a transaction operation.

属性：

名称	类型	描述
`success`	`bool`	Whether the operation succeeded
`calldata`	`bytes`	Generated calldata for the transaction
`to`	`str`	Target contract address
`value`	`int`	ETH value to send (always 0 for flash loans)
`gas_estimate`	`int`	Estimated gas for the transaction
`error`	`str \| None`	Error message if failed

getattr ¶

__getattr__(name: str) -> Any

PEP 562 lazy attribute access.