LagoonVault

Documentation for eth_defi.lagoon.vault.LagoonVault Python class.

class LagoonVault

Bases: eth_defi.erc_7540.vault.ERC7540Vault, eth_defi.erc_4626.vault_protocol.lagoon.vault.AutomatedSafe

Python interface for interacting with Lagoon Finance vaults.

For information see VaultBase base class documentation.

Example vault: https://basescan.org/address/0x6a5ea384e394083149ce39db29d5787a658aa98a#readContract

Notes

• Vault contract knows about Safe, Safe does not know about the Vault

• Ok so for settlement you dont have to worry about this metric, the only thing you have to value is the assets inside the safe (what you currently have under management) and update the NAV of the vault by calling updateNewTotalAssets (ex: if you have 1M inside the vault and 500K pending deposit you only need to call updateTotalAssets with the 1M that are currently inside the safe). Then, to settle you just call settleDeposit and the vault calculate everything for you.

• To monitor the pending deposits it’s a bit more complicated. You have to check the balanceOf the pendingSilo contract (0xAD1241Ba37ab07fFc5d38e006747F8b92BB217D5) in term of underlying (here USDC) for pending deposit and in term of shares (so the vault itself) for pending withdraw requests

Lagoon tokens can be in

• Safe: Tradeable assets

• Silo: pending deposits (USDC)

• Vault: pending redemptions (USDC)

• User wallets: after deposit() have been called share tokens are moved to the user wallet

Parameters

• spec – Address must be Lagoon vault address (not Safe address)

• trading_strategy_module_address –

  TradingStrategyModuleV0 enabled on Safe for automated trading.

  If not given, not known.

• vault_abi –

  ABI filename we use.

  Lagoon has different versions.

  None = autodetect.

• default_block_identifier –

  Override block identifier for on-chain metadata reads.

  See ERC4626Vault for details.

Attributes summary

address	Get the vault smart contract address.
chain_id	Chain this vault is on
denomination_token	Get the token which denominates the vault valuation
deposit_manager	Deposit manager assocaited with this vault
description	Full vault strategy description from Lagoon's offchain metadata.
erc_7540	Is this ERC-7540 vault with asynchronous deposits.
flow_manager	Flow manager associated with this vault
info	Get info dictionary related to this vault deployment.
lagoon_metadata	Offchain metadata from Lagoon's web app API.
name	Vault name.
safe	Get the underlying Safe object used as an API from safe-eth-py library.
safe_address	Get Safe multisig contract address
safe_contract	Safe multisig as a contract.
share_token	ERC-20 that presents vault shares.
short_description	Short one-liner vault summary from Lagoon's offchain metadata.
silo_address	Pending Silo contract address.
silo_contract	Pending Silo contract.
symbol	Vault share token symbol
trading_strategy_module	Get the TradingStrategyModuleV0 contract instance.
trading_strategy_module_address	Get TradingStrategyModuleV0 contract address.
trading_strategy_module_version	Get TradingStrategyModuleV0 contract ABI version.
underlying_token	Alias for denomination_token()
valuation_manager	Valuation manager role on the vault.
vault_address
vault_address_checksumless
vault_contract	Get vault deployment.
version	Get Lagoon version.

Methods summary

__init__(web3, spec[, ...])	param spec
can_check_deposit()	Lagoon's maxDeposit does not work correctly for deposit availability checks.
can_check_redeem()	Check if maxRedeem(address(0)) can be used to check global redemption availability.
check_version_compatibility()	Throw if there is mismatch between ABI and contract exposed EVM calls
fetch_available_liquidity([block_identifier])	Get the amount of denomination token available for immediate withdrawal.
fetch_denomination_token()	Read denomination token from onchain.
fetch_denomination_token_address()	Get the address for the denomination token.
fetch_deposit_closed_reason()	Check if deposits are closed using maxDeposit(address(0)).
fetch_deposit_next_open()	Get when deposits will next be open.
fetch_info()	Use info() property for cached access.
fetch_nav([block_identifier])	Fetch the most recent onchain NAV value.
fetch_portfolio(universe[, ...])	Read the current token balances of a vault.
fetch_redemption_closed_reason()	Check if redemptions are closed using maxRedeem(address(0)).
fetch_redemption_next_open()	Get when withdrawals/redemptions will next be open.
fetch_safe(address)	Create a Safe object from an address.
fetch_share_price(block_identifier)	Get the current share price.
fetch_share_token()	Read share token details onchain.
fetch_share_token_address([block_identifier])	Get share token of this vault.
fetch_total_assets(block_identifier)	What is the total NAV of the vault.
fetch_total_supply(block_identifier)	What is the current outstanding shares.
fetch_trading_strategy_module_version()	Perform deployed smart contract probing.
fetch_utilisation_percent([block_identifier])	Get the percentage of assets currently lent out.
fetch_vault_info()	Get all information we can extract from the vault smart contracts.
fetch_version()	Figure out Lagoon version.
finalise_deposit(depositor[, raw_amount])	Move shares we received to the user wallet.
finalise_redeem(depositor[, raw_amount])	Move redeemed assets to the user wallet.
get_deposit_fee(block_identifier)	Deposit fee is set to zero by default as vaults usually do not have deposit fees.
get_deposit_manager()	Get deposit manager to deposit/redeem from the vault.
get_estimated_lock_up()	ERC-7540 vaults have always a lock up.
get_fee_data()	Get fee data structure for this vault.
get_fee_mode()	Get how this vault accounts its fees.
get_flags()	Get vault flags, auto-flagging vaults missing from Lagoon's frontend.
get_flow_manager()	Get flow manager to read indiviaul settle events.
get_historical_reader(stateful)	Get share price reader to fetch historical returns.
get_link([referral])	Get a link to the vault dashboard on its native site.
get_management_fee(block_identifier)	Get Lagoon vault rates
get_notes()	Get notes for this vault.
get_performance_fee(block_identifier)	Get Lagoon vault rates
get_protocol_name()	Return the name of the vault protocol.
get_risk()	Get risk profile of this vault.
get_spec()
get_withdraw_fee(block_identifier)	Withdraw fee is set to zero by default as vaults usually do not have withdraw fees.
has_block_range_event_support()	Does this vault support block range-based event queries for deposits and redemptions.
has_custom_fees()	Does this vault have custom fee structure reading methods.
has_deposit_distribution_to_all_positions()	Deposits go automatically to all open positions.
is_trading_strategy_module_enabled()	Check if TradingStrategyModuleV0 is enabled on the Safe multisig.
is_valid()	Check if this vault is valid.
post_new_valuation(total_valuation)	Update the valuations of this vault.
post_valuation_and_settle(valuation, ...[, gas])	Do both new valuation and settle.
request_deposit(depositor, raw_amount[, ...])	Build a deposit transction.
request_redeem(depositor, raw_amount)	Build a redeem transction.
settle_via_trading_strategy_module([...])	Settle the new valuation and deposits.
transact_via_exec_module(func_call[, value, ...])	Create a multisig transaction using a module.
transact_via_trading_strategy_module(func_call)	Create a Safe multisig transaction using TradingStrategyModuleV0.

__init__(web3, spec, trading_strategy_module_address=None, token_cache=None, vault_abi=None, features=None, default_block_identifier=None, **kwargs)

Parameters

• spec (eth_defi.vault.base.VaultSpec) – Address must be Lagoon vault address (not Safe address)

• trading_strategy_module_address (Optional[eth_typing.evm.HexAddress]) –

  TradingStrategyModuleV0 enabled on Safe for automated trading.

  If not given, not known.

• vault_abi (str | None) –

  ABI filename we use.

  Lagoon has different versions.

  None = autodetect.

• default_block_identifier (Optional[Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]]) –

  Override block identifier for on-chain metadata reads.

  See ERC4626Vault for details.

• web3 (web3.main.Web3) –

• token_cache (dict | None) –

• features (set[eth_defi.erc_4626.core.ERC4626Feature]) –

fetch_version()

Figure out Lagoon version.

• Poke the smart contract with probe functions to get version

• Specifically call pendingSilo() that has been removed because the contract is too big

• Our ABI definitions and callign conventions change between Lagoon versions

Return type

eth_defi.erc_4626.vault_protocol.lagoon.vault.LagoonVersion

check_version_compatibility()

Throw if there is mismatch between ABI and contract exposed EVM calls

property version: eth_defi.erc_4626.vault_protocol.lagoon.vault.LagoonVersion

Get Lagoon version.

• Cached property to avoid multiple calls

property lagoon_metadata: eth_defi.erc_4626.vault_protocol.lagoon.offchain_metadata.LagoonVaultMetadata | None

Offchain metadata from Lagoon’s web app API.

• Fetched from app.lagoon.finance/api/vault endpoint

• Cached on first access

• Returns None if vault is not in Lagoon’s app database

property description: str | None

Full vault strategy description from Lagoon’s offchain metadata.

property short_description: str | None

Short one-liner vault summary from Lagoon’s offchain metadata.

get_flags()

Get vault flags, auto-flagging vaults missing from Lagoon’s frontend.

• If the vault has no metadata in Lagoon’s API, it is flagged as unofficial

• Manual flags from VAULT_FLAGS_AND_NOTES take precedence

Return type

set[eth_defi.vault.flag.VaultFlag]

get_notes()

Get notes for this vault.

• Returns manual notes from the vault flags if set

• If vault is missing from Lagoon’s frontend, returns the missing note

• Otherwise falls back to the full description from Lagoon’s offchain metadata

Return type

str | None

property vault_contract: web3.contract.contract.Contract

Get vault deployment.

has_block_range_event_support()

Does this vault support block range-based event queries for deposits and redemptions.

• If not we use chain balance polling-based approach

has_deposit_distribution_to_all_positions()

Deposits go automatically to all open positions.

• Deposits do not land into the vault as cash

• Instead, smart contracts automatically increase all open positions

• The behaviour of Velvet Capital

get_flow_manager()

Get flow manager to read indiviaul settle events.

• Only supported if has_block_range_event_support() is True

Return type

eth_defi.erc_4626.vault_protocol.lagoon.vault.LagoonFlowManager

fetch_vault_info()

Get all information we can extract from the vault smart contracts.

Return type

dict

fetch_info()

Use info() property for cached access.

Returns

See LagoonVaultInfo

Return type

eth_defi.erc_4626.vault_protocol.lagoon.vault.LagoonVaultInfo

property safe_address: eth_typing.evm.HexAddress

Get Safe multisig contract address

property safe: safe_eth.safe.safe.Safe

Get the underlying Safe object used as an API from safe-eth-py library.

• Warps Safe Contract using Gnosis’s in-house library

property safe_contract: web3.contract.contract.Contract

Safe multisig as a contract.

• Interact with Safe multisig ABI

property valuation_manager: eth_typing.evm.HexAddress

Valuation manager role on the vault.

property silo_address: eth_typing.evm.HexAddress

Pending Silo contract address.

Returns

Checksummed Silo contract addrewss “pendingSilo”.

property silo_contract: web3.contract.contract.Contract

Pending Silo contract.

• This contract does not have any functionality, but stores deposits (pending USDC) and redemptions (pending share token)

post_new_valuation(total_valuation)

Update the valuations of this vault.

• Lagoon vault does not currently track individual positions, but takes a “total value” number

• Updating this number also allows deposits and redemptions to proceed

Notes:

How can I post a valuation commitee update 1. as the valuationManager, call the function updateNewTotalAssets(_newTotalAssets) _newTotalAssets being expressed in underlying in its smallest unit for usdc, it would with its 6 decimals. Do not take into account requestDeposit and requestRedeem in your valuation

2. as the safe, call the function settleDeposit()

Parameters

total_valuation (decimal.Decimal) – The vault value nominated in denomination_token().

Returns

Bound contract function that can be turned to a transaction

Return type

web3.contract.contract.ContractFunction

settle_via_trading_strategy_module(valuation=None, abi_version=None)

Settle the new valuation and deposits.

• settleDeposit will also settle the redeems request if possible. If there are enough assets in the safe it will settleRedeem It there are not enough assets, it will only settleDeposit.

• if there is nothing to settle: no deposit and redeem requests you can still call settleDeposit/settleRedeem to validate the new nav

• If there is not enough USDC to redeem, the transaction will revert

Parameters

• abi_version (None) – Use specific ABI version.

• raw_amount – Needed in Lagoon v0.5+

• valuation (decimal.Decimal) –

Return type

web3.contract.contract.ContractFunction

post_valuation_and_settle(valuation, asset_manager, gas=1000000)

Do both new valuation and settle.

• Quickhand method for asset_manager code

• Only after this we can read back

• Broadcasts two transactions and waits for the confirmation

• If there is not enough USDC to redeem, the second transaction will fail with revert

Returns

The transaction hash of the settlement transaction

Parameters

• valuation (decimal.Decimal) –

• asset_manager (eth_typing.evm.HexAddress) –

Return type

hexbytes.main.HexBytes

request_deposit(depositor, raw_amount, check_allowance=True, check_balance=True)

Build a deposit transction.

• Phase 1 of deposit before settlement

• Used for testing

• Must be approved() first

• Uses the vault underlying token (USDC)

Note

Legacy. Use get_deposit_manager() instead.

Parameters

• raw_amount (int) – Raw amount in underlying token

• depositor (eth_typing.evm.HexAddress) –

Return type

web3.contract.contract.ContractFunction

finalise_deposit(depositor, raw_amount=None)

Move shares we received to the user wallet.

• Phase 2 of deposit after settlement

Parameters

• depositor (eth_typing.evm.HexAddress) –

• raw_amount (int | None) –

Return type

web3.contract.contract.ContractFunction

request_redeem(depositor, raw_amount)

Build a redeem transction.

• Phase 1 of redemption, before settlement

• Used for testing

• Sets up a redemption request for X shares

Parameters

• raw_amount (int) – Raw amount in share token

• depositor (eth_typing.evm.HexAddress) –

Return type

web3.contract.contract.ContractFunction

finalise_redeem(depositor, raw_amount=None)

Move redeemed assets to the user wallet.

• Phase 2 of the redemption

Parameters

• depositor (eth_typing.evm.HexAddress) –

• raw_amount (int | None) –

Return type

web3.contract.contract.ContractFunction

get_management_fee(block_identifier)

Get Lagoon vault rates

Parameters

block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]) –

Return type

float

get_performance_fee(block_identifier)

Get Lagoon vault rates

Parameters

block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]) –

Return type

float

is_trading_strategy_module_enabled()

Check if TradingStrategyModuleV0 is enabled on the Safe multisig.

Return type

bool

get_deposit_manager()

Get deposit manager to deposit/redeem from the vault.

Return type

eth_defi.lagoon.deposit_redeem.ERC7540DepositManager

can_check_deposit()

Lagoon’s maxDeposit does not work correctly for deposit availability checks.

Return type

bool

get_link(referral=None)

Get a link to the vault dashboard on its native site.

• By default, give RouteScan link

Parameters

referral (str | None) – Optional referral code to append to the URL.

Returns

URL string

Return type

str

property address: eth_typing.evm.HexAddress

Get the vault smart contract address.

can_check_redeem()

Check if maxRedeem(address(0)) can be used to check global redemption availability.

Most protocols return 0 for maxRedeem(address(0)) because that address has no balance/shares, not because redemptions are closed:

• Gearbox: maxRedeem returns min(balanceOf(owner), convertToShares(availableLiquidity))

• Most vaults: Return 0 because address(0) has no shares

Some protocols do use maxRedeem(address(0)) meaningfully:

• Morpho, IPOR, Plutus: Return 0 when redemptions are globally blocked

Override to return True in subclasses that support address(0) redemption checks.

Returns

True if maxRedeem(address(0)) returns meaningful values for global redemption availability checking.

Return type

bool

property chain_id: int

Chain this vault is on

property denomination_token: eth_defi.token.TokenDetails | None

Get the token which denominates the vault valuation

• Used in deposits and redemptions

• Used in NAV calculation

• Used in profit benchmarks

• Usually USDC

Returns

Token wrapper instance.

Maybe None for broken vaults like https://arbiscan.io/address/0x9d0fbc852deccb7dcdd6cb224fa7561efda74411#code

Note

None results are not cached — the next access will retry the on-chain call. This avoids permanently caching a transient RPC failure.

property deposit_manager: eth_defi.vault.deposit_redeem.VaultDepositManager

Deposit manager assocaited with this vault

property erc_7540: bool

Is this ERC-7540 vault with asynchronous deposits.

• For example previewDeposit() function and other functions will revert

fetch_available_liquidity(block_identifier='latest')

Get the amount of denomination token available for immediate withdrawal.

Only applicable to lending protocol vaults (IPOR, Euler, Morpho, Gearbox, etc.). Non-lending protocols should leave this method unimplemented.

Note: maxRedeem(address(0)) does NOT work as a proxy for available liquidity because it requires a specific address that has already deposited shares. For address(0), balanceOf is always 0, so maxRedeem returns 0 regardless of actual liquidity.

Parameters

block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]) – Block to query. Defaults to “latest”.

Raises

NotImplementedError – For non-lending protocol vaults.

Returns

Amount in denomination token units (human-readable Decimal).

Return type

decimal.Decimal | None

fetch_denomination_token()

Read denomination token from onchain.

Use denomination_token() for cached access.

Return type

eth_defi.token.TokenDetails | None

fetch_denomination_token_address()

Get the address for the denomination token.

Triggers RCP call

Return type

Optional[eth_typing.evm.HexAddress]

fetch_deposit_closed_reason()

Check if deposits are closed using maxDeposit(address(0)).

Uses the ERC-4626 standard maxDeposit function to determine if deposits are available. Returns a human-readable reason with the max deposit amount if deposits are restricted.

Returns

Human-readable string if deposits are closed/restricted, or None if deposits are open (maxDeposit > 0).

Return type

str | None

fetch_deposit_next_open()

Get when deposits will next be open.

• For epoch-based vaults (Ostium, D2), return calculated window open time

• For non-epoch vaults (Plutus, IPOR, Morpho), return None

• Override in protocol-specific subclasses

Returns

Naive UTC datetime when deposits will next be available, or None if:

• Deposits are currently open

• Timing is unpredictable (manually controlled)

• Protocol does not support timing information

Return type

datetime.datetime | None

fetch_nav(block_identifier=None)

Fetch the most recent onchain NAV value.

• In the case of Lagoon, this is the last value written in the contract with updateNewTotalAssets() and ` settleDeposit()`

• TODO: updateNewTotalAssets() there is no way to read pending asset update on chain

Returns

Vault NAV, denominated in denomination_token()

Return type

decimal.Decimal

fetch_portfolio(universe, block_identifier=None, allow_fallback=True)

Read the current token balances of a vault.

• SHould be supported by all implementations

Parameters

• universe (eth_defi.vault.base.TradingUniverse) –

• block_identifier (Optional[Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, hexbytes.main.HexBytes, int]]) –

• allow_fallback (bool) –

Return type

eth_defi.vault.base.VaultPortfolio

fetch_redemption_closed_reason()

Check if redemptions are closed using maxRedeem(address(0)).

Only works for protocols that implement maxRedeem in a way that returns meaningful values for address(0). Most protocols return 0 because address(0) has no shares, not because redemptions are closed.

Returns

Human-readable string if redemptions are closed, or None if redemptions are open or check is not supported.

Return type

str | None

fetch_redemption_next_open()

Get when withdrawals/redemptions will next be open.

• For epoch-based vaults (Ostium, D2), return calculated window open time

• For non-epoch vaults (Plutus, IPOR, Morpho), return None

• Override in protocol-specific subclasses

Returns

Naive UTC datetime when withdrawals will next be available, or None if:

• Withdrawals are currently open

• Timing is unpredictable (manually controlled)

• Protocol does not support timing information

Return type

datetime.datetime | None

fetch_safe(address)

Create a Safe object from an address.

Use safe property for cached access.

Parameters

address (Union[eth_typing.evm.HexAddress, str]) –

Return type

safe_eth.safe.safe.Safe

fetch_share_price(block_identifier)

Get the current share price.

Returns

The share price in underlying token.

If supply is zero return zero.

Parameters

block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, hexbytes.main.HexBytes, int]) –

Return type

decimal.Decimal

fetch_share_token()

Read share token details onchain.

Use share_token() for cached access.

Return type

eth_defi.token.TokenDetails

fetch_share_token_address(block_identifier='latest')

Get share token of this vault.

• Vault itself (ERC-4626)

• share() accessor (ERc-7575)

Parameters

block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, hexbytes.main.HexBytes, int]) –

Return type

eth_typing.evm.HexAddress

fetch_total_assets(block_identifier)

What is the total NAV of the vault.

Example:

assert vault.denomination_token.symbol == "USDC"
assert vault.share_token.symbol == "ipUSDCfusion"
assert vault.fetch_total_assets(block_identifier=test_block_number) == Decimal("1437072.77357")
assert vault.fetch_total_supply(block_identifier=test_block_number) == Decimal("1390401.22652875")

Parameters

block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, hexbytes.main.HexBytes, int]) –

Block number to read.

Use web3.eth.block_number for the last block.

Returns

The vault value in underlyinh token

Return type

decimal.Decimal | None

fetch_total_supply(block_identifier)

What is the current outstanding shares.

Example:

Parameters

block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, hexbytes.main.HexBytes, int]) –

Block number to read.

Use web3.eth.block_number for the last block.

Returns

The vault value in underlyinh token

Return type

decimal.Decimal

fetch_trading_strategy_module_version()

Perform deployed smart contract probing.

Returns

v0.1.0 or v0.1.1.

None if not TS module associated.

Return type

str | None

fetch_utilisation_percent(block_identifier='latest')

Get the percentage of assets currently lent out.

Only applicable to lending protocol vaults (IPOR, Euler, Morpho, Gearbox, etc.). Non-lending protocols should leave this method unimplemented.

Parameters

block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]) – Block to query. Defaults to “latest”.

Raises

NotImplementedError – For non-lending protocol vaults.

Returns

Utilisation as float between 0.0 and 1.0 (0% to 100%).

Return type

float | None

property flow_manager: eth_defi.vault.base.VaultFlowManager

Flow manager associated with this vault

get_deposit_fee(block_identifier)

Deposit fee is set to zero by default as vaults usually do not have deposit fees.

Internal: Use get_fee_data().

Parameters

block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]) –

Return type

float | None

get_estimated_lock_up()

ERC-7540 vaults have always a lock up.

Return type

datetime.timedelta | None

get_fee_data()

Get fee data structure for this vault.

Raises

ValueError – In the case of broken or unimplemented fee reading methods in the smart contract

Return type

eth_defi.vault.fee.FeeData

get_fee_mode()

Get how this vault accounts its fees.

Return type

eth_defi.vault.fee.VaultFeeMode | None

get_historical_reader(stateful)

Get share price reader to fetch historical returns.

Parameters

stateful – If True, use a stateful reading strategy.

Returns

None if unsupported

Return type

eth_defi.vault.base.VaultHistoricalReader

get_protocol_name()

Return the name of the vault protocol.

Return type

str

get_risk()

Get risk profile of this vault.

Return type

eth_defi.vault.risk.VaultTechnicalRisk | None

get_withdraw_fee(block_identifier)

Withdraw fee is set to zero by default as vaults usually do not have withdraw fees.

Internal: Use get_fee_data().

Parameters

block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]) –

Return type

float

has_custom_fees()

Does this vault have custom fee structure reading methods.

Causes risk in the vault comparison.

E.g.

• Withdraw fee

• Deposit fee

Returns

True if custom fee reading methods are implemented

Return type

bool

property info: eth_defi.vault.base.VaultInfo

Get info dictionary related to this vault deployment.

• Get cached data on the various vault parameters

Returns

Vault protocol specific information dictionary

is_valid()

Check if this vault is valid.

• Call a known smart contract function to verify the function exists

Return type

bool

property name: str

Vault name.

property share_token: eth_defi.token.TokenDetails

ERC-20 that presents vault shares.

• User gets shares on deposit and burns them on redemption

property symbol: str

Vault share token symbol

property trading_strategy_module: web3.contract.contract.Contract

Get the TradingStrategyModuleV0 contract instance.

property trading_strategy_module_address: Optional[eth_typing.evm.HexAddress]

Get TradingStrategyModuleV0 contract address.

property trading_strategy_module_version: str

Get TradingStrategyModuleV0 contract ABI version.

• Subject to change, development in progress

transact_via_exec_module(func_call, value=0, operation=0)

Create a multisig transaction using a module.

• Calls execTransactionFromModule on Gnosis Safe contract

• Executes a transaction as a multisig

• Mostly used for testing w/whitelist ignore

Warning

A special gas fix is needed, because eth_estimateGas seems to fail for these Gnosis Safe transactions.

Parameters

• func_call (web3.contract.contract.ContractFunction) – Bound smart contract function call

• value (int) – ETH attached to the transaction

• operation –

  Gnosis enum.

  Call = 0, DelegateCall = 1.

Return type

web3.contract.contract.ContractFunction

transact_via_trading_strategy_module(func_call, value=0, abi_version=None)

Create a Safe multisig transaction using TradingStrategyModuleV0.

Parameters

• func_call (web3.contract.contract.ContractFunction) – Bound smart contract function call

• value (int) – ETH value attached to the call.

• abi_version (str) – Use specific TradingStrategyModuleV0 ABI version.

Returns

Bound Solidity function call you need to turn to a transaction

Return type

web3.contract.contract.ContractFunction

property underlying_token: eth_defi.token.TokenDetails

Alias for denomination_token()

first_seen_at_block: int | None

Block number hint when this vault was deployed.

Must be set externally, as because of shitty Ethereum RPC we cannot query this. Allows us to avoid unnecessary work when scanning historical price data.