Libeara API
The adapter covers the Ethereum CMTAT CUMIU and BELIF shares and the Arbitrum ULTRA deployment. CMTAT products expose issuer-maintained NAV, while ULTRA is reported as supply-only because it has no verified public NAV/share source.
Read-only adapter for reviewed Libeara tokenised fund shares.
The reviewed CUMIU and BELIF Ethereum proxies use CMTA’s CMTAT framework. They provide an issuer-maintained NAV record but their transfer rule engine and off-chain eligibility process mean that neither public subscriptions nor redemptions are implemented here. ULTRA on Arbitrum is tracked as supply-only because no verified public NAV/share source has been identified.
- class LibearaVaultInfo
Bases:
eth_defi.vault.base.VaultInfoLibeara fund scan metadata.
- __init__(*args, **kwargs)
- __new__(**kwargs)
- clear()
Remove all items from the dict.
- copy()
Return a shallow copy of the dict.
- fromkeys(value=None, /)
Create a new dictionary with keys from iterable and values set to value.
- get(key, default=None, /)
Return the value for key if key is in the dictionary, else default.
- items()
Return a set-like object providing a view on the dict’s items.
- keys()
Return a set-like object providing a view on the dict’s keys.
- pop(k[, d]) v, remove specified key and return the corresponding value.
If the key is not found, return the default if given; otherwise, raise a KeyError.
- popitem()
Remove and return a (key, value) pair as a 2-tuple.
Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.
- setdefault(key, default=None, /)
Insert key with a value of default if key is not in the dictionary.
Return the value for key if key is in the dictionary, else default.
- update([E, ]**F) None. Update D from mapping/iterable E and F.
If E is present and has a .keys() method, then does: for k in E.keys(): D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k]
- values()
Return an object providing a view on the dict’s values.
- class LibearaVault
Bases:
eth_defi.tokenised_fund.vault.TokenisedFundVaultRead supply and any reviewed NAV for Libeara fund shares.
Create a CMTAT fund-share adapter.
- Parameters
web3 – Web3 connection to the deployment chain.
spec – Chain and reviewed fund-share address.
token_cache – Optional ERC-20 metadata cache.
features – Shared classification features.
default_block_identifier – Default archive block for metadata reads.
require_denomination_token – Retained shared-adapter compatibility flag.
- __init__(web3, spec, token_cache=None, features=None, default_block_identifier=None, require_denomination_token=False)
Create a CMTAT fund-share adapter.
- Parameters
web3 (web3.main.Web3) – Web3 connection to the deployment chain.
spec (eth_defi.vault.base.VaultSpec) – Chain and reviewed fund-share address.
token_cache (Optional[dict]) – Optional ERC-20 metadata cache.
features (Optional[set[eth_defi.erc_4626.core.ERC4626Feature]]) – Shared classification features.
default_block_identifier (Optional[Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]]) – Default archive block for metadata reads.
require_denomination_token (bool) – Retained shared-adapter compatibility flag.
- property address: eth_typing.evm.HexAddress
Return the fund-share token address.
- property vault_address: eth_typing.evm.HexAddress
Return the scanner-compatible token address.
- property cmtat_contract: web3.contract.contract.Contract
Return the stable CMTAT NAV interface.
The ABI is sourced from the verified CUMIU proxy implementation and reference CMTAT contract family documented at https://github.com/CMTA/CMTAT.
Return the fund share token.
Fetch ERC-20 share-token metadata.
- Returns
Fund-share token details.
- Return type
- fetch_denomination_token_address()
Return no transferable denomination token.
- Returns
Nonebecause the public dealing asset is not exposed.- Return type
- fetch_denomination_token()
Return no public denomination token.
- Returns
None.- Return type
Read CMTAT’s issuer-maintained NAV/share.
- Parameters
block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]) – EVM archive block.
- Returns
NAV divided by the contract-declared scale.
- Raises
ValueError – If the reported scale is zero.
- Return type
- fetch_total_supply(block_identifier='latest')
Read outstanding human-readable fund shares.
- fetch_total_assets(block_identifier='latest')
Calculate USD value from CMTAT NAV and supply.
Return NAV-derived total assets.
- fetch_info()
Export integration metadata.
- Returns
Token identity and issuer-NAV source information.
- Return type
- fetch_scan_record_extra_data()
Export restricted-flow and valuation diagnostics.
- fetch_portfolio(universe, block_identifier=None)
Return no token-held on-chain portfolio.
- Parameters
universe (eth_defi.vault.base.TradingUniverse) – Ignored.
block_identifier (Optional[Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]]) – Ignored.
- Returns
Empty spot portfolio.
- Return type
- has_block_range_event_support()
Return whether servicing-flow event accounting is implemented.
- Returns
Always
False.- Return type
- has_deposit_distribution_to_all_positions()
Return whether deposits reach an on-chain portfolio.
- Returns
Always
False.- Return type
- get_flow_manager()
Reject unimplemented issuer servicing flows.
- Raises
NotImplementedError – Always.
- Return type
- fetch_deposit_closed_reason()
Explain unavailable subscriptions.
- Returns
Compliance restriction description.
- Return type
- fetch_redemption_closed_reason()
Explain unavailable redemptions.
- Returns
Compliance restriction description.
- Return type
- get_historical_reader(stateful)
Create the product-specific supply and valuation reader.
- Parameters
stateful (bool) – Retained shared-reader API parameter.
- Returns
Libeara historical reader.
- Return type
- get_fee_data()
Return unavailable product fee data.
- Returns
Broken fee data placeholder.
- Return type
- get_management_fee(block_identifier)
Return no on-chain management fee.
- get_performance_fee(block_identifier)
Return no on-chain performance fee.
- get_notes()
Describe the integration boundary.
- Returns
Valuation and transfer-compliance caveat.
- Return type
- get_link(referral=None)
Return the fund’s reviewed product-information URL.
- property denomination_token: Optional[eth_defi.token.TokenDetails]
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
Noneresults 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
- 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
- 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
- fetch_minimum_deposit(block_identifier='latest')
Fetch a source-proven minimum deposit in decimal token units.
A
Noneresult means this adapter does not expose a known minimum; it does not prove the protocol accepts arbitrarily small deposits. A zero result means the adapter positively established that the vault has no minimum deposit.- Parameters
block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]) – Block at which to read the protocol configuration.
- Returns
Decimal denomination-token minimum, or
Nonewhen unknown.- Return type
- fetch_minimum_redemption(block_identifier='latest')
Fetch a source-proven redemption minimum in decimal share units.
A
Noneresult means this adapter does not expose a known minimum; it does not prove the protocol accepts arbitrarily small redemptions. A zero result means the adapter positively established that the vault has no minimum redemption.- Parameters
block_identifier (Union[Literal['latest', 'earliest', 'pending', 'safe', 'finalized'], eth_typing.evm.BlockNumber, eth_typing.evm.Hash32, eth_typing.encoding.HexStr, int]) – Block at which to read the protocol configuration.
- Returns
Decimal vault-share minimum, or
Nonewhen unknown.- Return type
- 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
- 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
- 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().
- get_deposit_manager()
Return a manager that explicitly refuses public fund operations.
The manager gives runtime callers a typed refusal, while
get_deposit_manager_capability()provides the corresponding report metadata. Concrete issuer integrations must replace both only after implementing their complete permission-aware dealing lifecycle.- Returns
Non-operational tokenised-fund deposit manager.
- Return type
- get_deposit_manager_capability()
Report explicit lack of public deposit and redemption support.
- Returns
A two-direction capability with both operations disabled.
- Return type
- get_estimated_lock_up()
What is the estimated lock-up period for this vault.
- Returns
None if not know
- Return type
- get_fee_mode()
Get how this vault accounts its fees.
- Return type
- get_flags()
Return vault flags including the tokenised fund classification.
Preserve address- and protocol-specific flags supplied by the generic vault implementation, then add the descriptive flag used by tokenised fund listings.
- Returns
A new set containing all generic flags and
VaultFlag.tokenised_fund.- Return type
- get_risk()
Get risk profile of this vault.
- Return type
Return the source used for share-price observations.
Vault integrations override this method when they expose a share price. Returning
Nonedistinguishes unsupported or unknown pricing from a known source classification.- Returns
Share-price source, or
Nonewhen the adapter does not provide one.- Return type
- get_whitelist_notes()
Return an export caveat for the vault-wide whitelist status.
Adapters may attach a concise, stable explanation when a classification is an explicitly requested operating assumption or excludes an integration-specific permission mechanism. The note describes the policy classification only; it must not be used to report temporary deposit availability.
- 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().
- has_custom_fees()
Does this vault have fees outside the shared fee model.
Custom fees cause risk in vault comparison because the shared management/performance/deposit/withdraw fee fields cannot describe the full fee structure.
Do not return
Truemerely because a vault implements custom accessors for ordinary management, performance, deposit, or withdraw fees. ReturnTrueonly when some vault fee cannot be reflected in those standard fields as a fee-like value.- Returns
Trueif the vault has fees outside the shared fee model.- Return type
- 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_account_whitelisted(address)
Determine whether an account has completed the vault’s KYC policy.
The result concerns KYC or manual identity-approval membership only. A protocol may still require scheduling, a token balance, an allowance, available capacity, or an open epoch before a deposit can be submitted. Callers must use the relevant deposit manager pre-flight before broadcasting a transaction.
- Parameters
address (eth_typing.evm.HexAddress) – Account whose deposit-policy membership is queried.
- Returns
Truewhen the account has the required KYC/identity approval.- Raises
NotImplementedError – If the adapter cannot safely query account membership.
- Return type
- is_whitelisted_deposit()
Classify tokenised-fund subscriptions as permissioned.
Tokenised-fund adapters model issuer-operated products whose subscriptions require investor eligibility, issuer approval, or both. This is a vault-wide classification: individual adapters may expose different KYC, allow-list, transfer-agent, or offchain settlement mechanisms, so
is_account_whitelisted()remains protocol-specific.- Returns
Always
Truebecause tokenised-fund deposits are permissioned.- Return type
ERC-20 that presents vault shares.
User gets shares on deposit and burns them on redemption
Reviewed Libeara CMTAT fund-share deployments on Ethereum.
- class LibearaProduct
Bases:
objectOne reviewed Libeara platform tokenised-fund share.
- Parameters
chain_id – EVM chain hosting the proxy.
token – CMTAT proxy address.
symbol – ERC-20 token symbol.
product_name – Issuer-provided product name.
description – Short public product description.
manager_name – Organisation responsible for portfolio management.
curator_slug – Curator metadata slug used by vault exports.
homepage – Product-specific public information page.
first_seen_at_block – First block with proxy bytecode.
first_seen_at – Proxy deployment timestamp as naive UTC.
- __init__(chain_id, token, symbol, product_name, description, manager_name, curator_slug, homepage, first_seen_at_block, first_seen_at)
- Parameters
chain_id (int) –
token (eth_typing.evm.HexAddress) –
symbol (str) –
product_name (str) –
description (str) –
manager_name (str) –
curator_slug (str) –
homepage (str) –
first_seen_at_block (int) –
first_seen_at (datetime.datetime) –
- Return type
None
- CUMIU_ETHEREUM = LibearaProduct(chain_id=1, token='0x85d38585c3ac08268f598282a84b7c0ddfc0d04f', symbol='CUMIU', product_name='ChinaAMC USD Digital Money Market Fund Class I USD', description='US-dollar digital money-market strategy.', manager_name='China Asset Management', curator_slug='chinaamc-hong-kong', homepage='https://www.chinaamc.com.hk/product/chinaamc-usd-digital-money-market-fund-listedclass/', first_seen_at_block=23038326, first_seen_at=datetime.datetime(2025, 7, 31, 6, 34, 35))
ChinaAMC USD Digital Money Market Fund Class I USD. Source: https://etherscan.io/token/0x85d38585c3ac08268f598282a84b7c0ddfc0d04f
- BELIF_ETHEREUM = LibearaProduct(chain_id=1, token='0x237c717df1b60501f8d029d3fe7385fd090df180', symbol='BELIF', product_name='Bosera Liquidity Income Fund SP', description='Liquidity-income strategy.', manager_name='Bosera Asset Management (International)', curator_slug='bosera-asset-management-international', homepage='https://app.rwa.xyz/assets/BELIF', first_seen_at_block=23595754, first_seen_at=datetime.datetime(2025, 10, 17, 9, 1, 23))
Bosera Liquidity Income Fund SP. Source: https://etherscan.io/token/0x237c717df1b60501f8d029d3fe7385fd090df180
- LIBEARA_ULTRA_ARBITRUM = LibearaProduct(chain_id=42161, token='0xc26af85ede9cc25d449bcebef866bb85afd5d346', symbol='ULTRA', product_name='Delta Wellington Ultra Short Treasury On-Chain Fund', description='Ultra-short U.S. Treasury strategy.', manager_name='Wellington Management', curator_slug='wellington-management', homepage='https://libeara.com/libeara-partners-with-wellington-and-fundbridge-capital-to-launch-a-u-s-treasuries-fund-tokenised-on-public-blockchain/', first_seen_at_block=358954981, first_seen_at=datetime.datetime(2025, 7, 18, 7, 9, 32))
Delta Wellington Ultra Short Treasury On-Chain Fund on Arbitrum.
- LIBEARA_ULTRA_ETHEREUM = LibearaProduct(chain_id=1, token='0x50293dd8889b931eb3441d2664dce8396640b419', symbol='ULTRA', product_name='Delta Wellington Ultra Short Treasury Fund', description='Ultra-short U.S. Treasury strategy.', manager_name='Wellington Management', curator_slug='wellington-management', homepage='https://libeara.com/libeara-partners-with-wellington-and-fundbridge-capital-to-launch-a-u-s-treasuries-fund-tokenised-on-public-blockchain/', first_seen_at_block=21469784, first_seen_at=datetime.datetime(2024, 12, 24, 3, 55, 23))
Delta Wellington Ultra Short Treasury On-Chain Fund on Ethereum.
This is a distinct deployment from the Arbitrum representation. In particular, it must retain its own history reader state and must not reuse Arbitrum’s external manager assumptions.
Backfill only reviewed Libeara CMTAT fund histories.
This migration preserves all unrelated vault metadata, discovery cursors,
reader states and raw/cleaned Parquet histories. It only replaces CUMIU and
BELIF rows after their known deployment blocks. It defaults to DRY_RUN;
set DRY_RUN=false only after reviewing the displayed plan.
- upsert_libeara_metadata_preserving_discovery_cursor(vault_db, leads, rows)
Upsert reviewed rows without changing the Ethereum discovery cursor.
VaultDatabase.update_leads_and_rowsis intentionally unsuitable here: it advances the chain-wide discovery watermark, which would skip unrelated vault discovery after a targeted repair. Updating these known addresses directly preserves both an existing cursor and an absent cursor.- Parameters
vault_db (eth_defi.vault.vaultdb.VaultDatabase) – Existing vault metadata database.
leads (dict) – CUMIU and BELIF hardcoded leads keyed by token address.
rows (dict) – Fresh CUMIU and BELIF scan rows keyed by
VaultSpec.
- Returns
None.
- Return type
None
- backfill_cmtat()
Run the address-scoped metadata and price-history migration.
- Returns
None.
- Return type
None
- main()
Backfill all reviewed Libeara products.
CUMIU and BELIF use their reviewed CMTAT NAV history. ULTRA is registered separately because no verified public NAV/share source is available.
- Returns
None.
- Return type
None