eth-portfolio 0.5.0__cp312-cp312-win32.whl

eth_portfolio/typing/balance/single.py

@@ -0,0 +1,176 @@
+from typing import Literal, Optional, Union, final
+
+from dictstruct import DictStruct
+from eth_typing import BlockNumber, ChecksumAddress
+from mypy_extensions import mypyc_attr
+
+from eth_portfolio._decimal import Decimal
+
+
+@final
+@mypyc_attr(native_class=False)
+class Balance(
+    DictStruct, frozen=True, omit_defaults=True, repr_omit_defaults=True, forbid_unknown_fields=True
+):
+    """
+    Represents the balance of a single token, including its token amount and equivalent USD value.
+
+    Example:
+        >>> balance1 = Balance(Decimal('100'), Decimal('2000'))
+        >>> balance2 = Balance(Decimal('50'), Decimal('1000'))
+        >>> combined_balance = balance1 + balance2
+        >>> combined_balance.balance
+        Decimal('150')
+        >>> combined_balance.usd_value
+        Decimal('3000')
+    """
+
+    balance: Decimal = Decimal(0)
+    """
+    The amount of the token.
+    """
+
+    usd_value: Decimal = Decimal(0)
+    """
+    The USD equivalent value of the token amount.
+    """
+
+    token: Optional[ChecksumAddress] = None
+    """
+    The token the balance is of, if known.
+    """
+
+    block: Optional[BlockNumber] = None
+    """
+    The block from which the balance was taken, if known.
+    """
+
+    @property
+    def usd(self) -> Decimal:
+        """
+        An alias for `usd_value`. Returns the USD value of the token amount.
+        """
+        return self.usd_value
+
+    def __add__(self, other: "Balance") -> "Balance":
+        """
+        Adds two :class:`~eth_portfolio.typing.Balance` objects together. It is the user's responsibility to ensure that the two
+        :class:`~eth_portfolio.typing.Balance` instances represent the same token.
+
+        Args:
+            other: Another :class:`~eth_portfolio.typing.Balance` object.
+
+        Returns:
+            A new :class:`~eth_portfolio.typing.Balance` object with the summed values.
+
+        Raises:
+            TypeError: If the other object is not a :class:`~eth_portfolio.typing.Balance`.
+            Exception: If any other error occurs during addition.
+
+        Example:
+            >>> balance1 = Balance(Decimal('100'), Decimal('2000'))
+            >>> balance2 = Balance(Decimal('50'), Decimal('1000'))
+            >>> combined_balance = balance1 + balance2
+            >>> combined_balance.balance
+            Decimal('150')
+            >>> combined_balance.usd_value
+            Decimal('3000')
+        """
+        if not isinstance(other, Balance):
+            raise TypeError(f"{other} is not a `Balance` object")
+        if self.token != other.token:
+            raise ValueError(
+                f"These Balance objects represent balances of different tokens ({self.token} and {other.token})"
+            )
+        if self.block != other.block:
+            raise ValueError(
+                f"These Balance objects represent balances from different blocks ({self.block} and {other.block})"
+            )
+        try:
+            return Balance(
+                balance=self.balance + other.balance,
+                usd_value=self.usd_value + other.usd_value,
+                token=self.token,
+                block=self.block,
+            )
+        except Exception as e:
+            e.args = (f"Cannot add {self} and {other}: {e}", *e.args)
+            raise
+
+    def __radd__(self, other: Union["Balance", Literal[0]]) -> "Balance":
+        """
+        Supports the addition operation from the right side to enable use of `sum`.
+
+        Args:
+            other: Another :class:`~eth_portfolio.typing.Balance` object or zero.
+
+        Returns:
+            A new :class:`~eth_portfolio.typing.Balance` object with the summed values.
+
+        Raises:
+            TypeError: If the other object is not a :class:`~eth_portfolio.typing.Balance`.
+            Exception: If any other error occurs during addition.
+
+        Example:
+            >>> balance = Balance(Decimal('100'), Decimal('2000'))
+            >>> sum_balance = sum([balance, Balance()])
+            >>> sum_balance.balance
+            Decimal('100')
+        """
+        return self if other == 0 else self.__add__(other)  # type: ignore
+
+    def __sub__(self, other: "Balance") -> "Balance":
+        """
+        Subtracts one :class:`~eth_portfolio.typing.Balance` object from another. It is the user's responsibility to ensure that
+        the two :class:`~eth_portfolio.typing.Balance` instances represent the same token.
+
+        Args:
+            other: Another :class:`~eth_portfolio.typing.Balance` object.
+
+        Returns:
+            A new :class:`~eth_portfolio.typing.Balance` object with the subtracted values.
+
+        Raises:
+            TypeError: If the other object is not a :class:`~eth_portfolio.typing.Balance`.
+            Exception: If any other error occurs during subtraction.
+
+        Example:
+            >>> balance1 = Balance(Decimal('100'), Decimal('2000'))
+            >>> balance2 = Balance(Decimal('50'), Decimal('1000'))
+            >>> result_balance = balance1 - balance2
+            >>> result_balance.balance
+            Decimal('50')
+        """
+        if not isinstance(other, Balance):
+            raise TypeError(f"{other} is not a `Balance` object.")
+        if self.token != other.token:
+            raise ValueError(
+                f"These Balance objects represent balances of different tokens ({self.token} and {other.token})"
+            )
+        if self.block != other.block:
+            raise ValueError(
+                f"These Balance objects represent balances from different blocks ({self.block} and {other.block})"
+            )
+        try:
+            return Balance(
+                balance=self.balance - other.balance,
+                usd_value=self.usd_value - other.usd_value,
+                token=self.token,
+                block=self.block,
+            )
+        except Exception as e:
+            raise e.__class__(f"Cannot subtract {self} and {other}: {e}") from e
+
+    def __bool__(self) -> bool:
+        """
+        Evaluates the truth value of the :class:`~eth_portfolio.typing.Balance` object.
+
+        Returns:
+            True if either the balance or the USD value is non-zero, otherwise False.
+
+        Example:
+            >>> balance = Balance(Decimal('0'), Decimal('0'))
+            >>> bool(balance)
+            False
+        """
+        return self.balance != 0 or self.usd_value != 0

eth_portfolio-0.5.0.dist-info/METADATA

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: eth_portfolio
+Version: 0.5.0
+Summary: eth-portfolio makes it easy to analyze your portfolio.
+Home-page: https://github.com/BobTheBuidler/eth-portfolio
+Author: BobTheBuidler
+Author-email: bobthebuidlerdefi@gmail.com
+Requires-Python: >=3.10,<3.14
+Requires-Dist: checksum_dict>=2.1.7
+Requires-Dist: dank_mids>=4.20.154
+Requires-Dist: eth-brownie<1.23,>=1.22.0.dev0
+Requires-Dist: eth_retry<1,>=0.3.4
+Requires-Dist: evmspec>=0.4.1
+Requires-Dist: ez-a-sync>=0.33.6
+Requires-Dist: faster-async-lru==2.0.5.2
+Requires-Dist: faster-eth-utils
+Requires-Dist: numpy<3
+Requires-Dist: pandas<3,>=1.4.3
+Requires-Dist: typed-envs>=0.0.9
+Requires-Dist: ypricemagic<5.1,>=5
+Dynamic: author
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

eth_portfolio-0.5.0.dist-info/RECORD

@@ -0,0 +1,83 @@
+eth_portfolio__mypyc.cp312-win32.pyd,sha256=Ebtqi-lAmKXX6TYyqMSckyXD_Gq4PIwfR81QXpCcra0,267776
+eth_portfolio/__init__.py,sha256=5GmHYzhUX2gOC4MScgXnqS8x2MawbpWOuWPmqlvCotA,525
+eth_portfolio/_argspec.cp312-win32.pyd,sha256=Ww3JS1u5fCLffXVdSJbdGLCNH-fom0kBcIPebh39GJI,9216
+eth_portfolio/_argspec.py,sha256=au8ycJ56-7UzbQVzYUOoMX9sToH0QNi2tS1O820xB3A,1637
+eth_portfolio/_cache.py,sha256=OntwbiDOrBV5JzHHDzJlxcEVrmKK5GG0uXeLeoDDbpA,4926
+eth_portfolio/_config.cp312-win32.pyd,sha256=H_UEB92WJ6V7OGRx0r-zPamOPawTvSOP0a8I5DstIT4,9216
+eth_portfolio/_config.py,sha256=BSOvFS4D0oqgVTtBbtW2g2kpL8Mk6xiP0PipfXs_91A,102
+eth_portfolio/_decimal.py,sha256=DwLUg8pzeTIREG2sHgRK48hoWmjelWNvpEKj10Ra7to,5002
+eth_portfolio/_decorators.py,sha256=AvB-q69MvaFe0Ykh1os6hSewcUujURQ9onqobMaONOM,2899
+eth_portfolio/_exceptions.py,sha256=xb5VmCtBtXy9WXu_1ofoG4j9BJsMQXMVydCJNUulrNY,2500
+eth_portfolio/_shitcoins.cp312-win32.pyd,sha256=_Z6fv0mLcmSCZlrny6a5Rb1BuC36Hp-5aayYdqSJY2k,9216
+eth_portfolio/_shitcoins.py,sha256=TRK7b5bYj5rVUPn5QClDa5cnJxcx0zvEP8A3e8HvMSQ,17901
+eth_portfolio/_stableish.cp312-win32.pyd,sha256=TmlgeL4cgnublxxx0Iq4Z0WcK3xExQibhDFRNexMRxo,9216
+eth_portfolio/_stableish.py,sha256=8pdlYe2YcZ8rTzdCzg-ihRQLPtSFXBNDjtnvuTgPRcQ,2063
+eth_portfolio/_submodules.py,sha256=zne-2YyVFoKHwkLuHx8cdz5lpcwwSDw1edJ9v8G4c1A,2263
+eth_portfolio/_utils.py,sha256=iGck5SKUwpfnuZvLnKDR1A00obZNKx622Y9GY_TYiZA,7886
+eth_portfolio/address.py,sha256=RrFIWSx6jSITwh16Hqs6W6S9fz1KEaebQEk1vqL3HwI,14536
+eth_portfolio/buckets.py,sha256=n8FdgC_mf4DZPFkEu3v3LOamN1Kani8CIrhaLyg_6jY,7811
+eth_portfolio/constants.cp312-win32.pyd,sha256=Bruk66blVI9T41HAqjY0_AlEGgLW5h8ii1yyk1wFVMA,9216
+eth_portfolio/constants.py,sha256=IKMVKXjoQ74RRnpK3sEtqbbGmwKlYg0pXzuGVO0R0B8,4063
+eth_portfolio/portfolio.py,sha256=FSJ1_FG120dN5vWSPyhbHfyuFHdmFqTHJ5_Ci-4Rts4,24909
+eth_portfolio/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eth_portfolio/_db/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eth_portfolio/_db/decorators.py,sha256=RS-RiuOAgbrMKQpCwwAtP3lPRs8vKM6aPhh9LP4SwtI,5308
+eth_portfolio/_db/entities.py,sha256=1Z1AsR400SJYzDrDGxUJt1HuSKB3ErvxIytFtju7UHU,10345
+eth_portfolio/_db/utils.py,sha256=3P4EVQ5cHLbDrAnBESAIKhoDpJLXLS8IDJNnsh7T2Sc,21586
+eth_portfolio/_ledgers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eth_portfolio/_ledgers/address.py,sha256=wght92UXf6UIO9GNRzdMy3H43Em7kUk9ArtBsRF-xjw,33830
+eth_portfolio/_ledgers/portfolio.py,sha256=rAr5S1tksgLPUOK1J1FbIWgvTQNzTqrRp8oukiP2BTo,13427
+eth_portfolio/_loaders/__init__.py,sha256=YrBeRuA48cN2Bg2R2nXiNt1CsUIG_7N6ENIpY6aISPo,1735
+eth_portfolio/_loaders/_nonce.cp312-win32.pyd,sha256=HLxQnMsPf9yAsAWAUAXI8WCKzVPcilO5mrv4JhI-r1Y,9216
+eth_portfolio/_loaders/_nonce.py,sha256=bA-5fZG8ALuADgQGrnoxt6p6j7QEwI6vIGnZRF1Zx7M,6481
+eth_portfolio/_loaders/balances.cp312-win32.pyd,sha256=bosDMyqaaNuzC_NLXRLz4Zs54yefLWFrxvK7gO7TKKs,9216
+eth_portfolio/_loaders/balances.py,sha256=_v-x1M3lzDHPt8svHmCcpxZKw0BaGHfZimhkwgphY8A,3226
+eth_portfolio/_loaders/token_transfer.py,sha256=itaWVDyotG0EYPb4o94UOpxYvTdE6YIuUR2pzpXAnwI,8748
+eth_portfolio/_loaders/transaction.py,sha256=oOG3cFdLAa10k2hpN17GO7Wtq-rpUJ1oo7hLAKDjbDc,9393
+eth_portfolio/_loaders/utils.cp312-win32.pyd,sha256=Ym7DE_kmDTGaadrOkkIE370pbWe8HZvrV2dtCGOohSs,9216
+eth_portfolio/_loaders/utils.py,sha256=gJvIikinjCPj-elQVep55VTya9slSARApx-FJKYwnkE,2333
+eth_portfolio/_ydb/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eth_portfolio/_ydb/token_transfers.py,sha256=HUTeWShcQD4IzocTHmBOreml0jbVttLcaed1fNiJ2qg,5297
+eth_portfolio/protocols/__init__.py,sha256=k1e4MI8KPALIg7awaVA9LbBuEjqxWZF7uGgxysQ4y90,2623
+eth_portfolio/protocols/_base.py,sha256=nuMnnltg4HZ0Z5Nl83ofwAsTE3A9jLYhDZFkRhAKIIY,3793
+eth_portfolio/protocols/convex.py,sha256=az8FhxLtXf0WKo25Ke0IDRGF8x1yMlffoCRz9aG2fGE,535
+eth_portfolio/protocols/dsr.py,sha256=jn_4niDINXQxqu9Tfb77vsfbhv4oIRRFKsKvnMgEO4I,1806
+eth_portfolio/protocols/liquity.py,sha256=Ptiem5zd1op6qmZj2d6PmcgSqrKCLhlTw3CmIwII1Dc,656
+eth_portfolio/protocols/lending/README.md,sha256=0C941RnyfQwT1DE9bvxwLP-gBTHlQcQysF-75FXHINo,498
+eth_portfolio/protocols/lending/__init__.py,sha256=4jKDPx3sb7Iyi9kOdJRpM6LJy_GhUpviLIbpV_6noYU,1693
+eth_portfolio/protocols/lending/_base.py,sha256=_1zXroYHlliLP685xiRfw8I_tQOoZyaPlnxA_gzLytU,2311
+eth_portfolio/protocols/lending/compound.py,sha256=1aoksFSvIIsk-cNDs2-Kdwl-RtIdTzh3QgpksXG1kEs,7439
+eth_portfolio/protocols/lending/liquity.py,sha256=bJ5TKD-WTVn3S1tlbSGGVFCoKFvgStHVOzKBM2LbsRY,4294
+eth_portfolio/protocols/lending/maker.py,sha256=zXDeD9qS0hP1thEraQ_NlDkBOW5B-Lb2q3RcVWPzV80,4419
+eth_portfolio/protocols/lending/unit.py,sha256=OQGDZWdsTOUL4jOKJ1xef6wXhWLHnsRFJjAzn0XSBmM,2011
+eth_portfolio/structs/__init__.py,sha256=x-9CdKe8XMukp8Kjr_lD49ohrSd0iGEvvsMAHtAPrLI,1486
+eth_portfolio/structs/modified.py,sha256=QIuFh-u5VTHe0oborn3oHAiAGD0wqhUQW7XFJVZu2KI,1853
+eth_portfolio/structs/structs.py,sha256=TDJ4u3E_H8uG7iX-C1Pux8TesY2zXRhQUJxmN7cp4cc,20490
+eth_portfolio/typing/__init__.py,sha256=v_KbOgqTKcR4y-05Bel_mg6uAV-IsGurGR-jDW46SMg,58763
+eth_portfolio/typing/balance/single.py,sha256=NmtWXqCWMIkaoyvfL67Rh0wWurLf55fVaDkyUxZ27oY,6501
+eth_portfolio_scripts/__init__.py,sha256=DIBnQmjmhmNL1lO9Lq4QptrZmC7u6_N3p9zRjcZ9vbY,281
+eth_portfolio_scripts/_args.py,sha256=M33vPkja62XEJeCZAqacNSBCqbzse07wepwyBOtkvVo,682
+eth_portfolio_scripts/_logging.py,sha256=EgW8ozQZLAgt_cUgqe5BYZLMVQwB6X-0gq0T-BvqlTY,369
+eth_portfolio_scripts/_portfolio.py,sha256=b9TPX2c4Tg5FJLFEsaG45Ks4XYn0G--v746vpJdWnjU,8003
+eth_portfolio_scripts/_utils.py,sha256=lj2B79G8YX21ATNp_v-onsU_kNFZF3unBclCVp3AIn8,3163
+eth_portfolio_scripts/balances.cp312-win32.pyd,sha256=rzObhWlNFu7b5is0Ue2N91HJ858UyIRswUIg6opqi_A,9216
+eth_portfolio_scripts/balances.py,sha256=ttU2OlxIZY4cou7D_yLmIKd8vjdHLtddq2-PXCR7N0U,1801
+eth_portfolio_scripts/main.py,sha256=ToEwL5_bLEwZLasTV7FroQInjLe28l7J7FGzYdxZ8mY,3804
+eth_portfolio_scripts/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+eth_portfolio_scripts/docker/__init__.cp312-win32.pyd,sha256=ocquzT4zi7piXSkbTakT2-VoskU4nSAiw1L0BbKz-3U,9216
+eth_portfolio_scripts/docker/__init__.py,sha256=R27uZPLUEK2--fb9IrxrDUk6R5_IVFJSv7s_ia7p5Xk,409
+eth_portfolio_scripts/docker/check.cp312-win32.pyd,sha256=Ekx5hWwQefBewBnGlFCPmMt21vIQVgaIYBn0bO-Y_Og,9216
+eth_portfolio_scripts/docker/check.py,sha256=mf853kj0_M2iI3d2KuWuwsXtSieP9qWhvTJdrqX8iU8,1997
+eth_portfolio_scripts/docker/docker-compose.yaml,sha256=WecmD-VvS_78ay3waRjsH8Vch9gHXriaAYD34wFFWB0,1870
+eth_portfolio_scripts/docker/docker_compose.cp312-win32.pyd,sha256=0z5wpiq_Adqx-NYOscPUY6npvV0pHFdlAJP6mjTkyiE,9216
+eth_portfolio_scripts/docker/docker_compose.py,sha256=w1Z4XfSCC1vVLnss74XbkHUBVb0P2-zOIkMyidkZh38,2903
+eth_portfolio_scripts/docker/.grafana/dashboards/dashboards.yaml,sha256=wktTI-OAdF_khhbciZFo4Gt2V9bUjbe7GLqwdzTKf0U,212
+eth_portfolio_scripts/docker/.grafana/dashboards/Portfolio/Balances.json,sha256=XGMV8e4tDak53e9bmymwAB4uqZmAIcU5JlRT3OiwTeU,70750
+eth_portfolio_scripts/docker/.grafana/datasources/datasources.yml,sha256=8PPH_QDhfbRRh3IidskW46rifJejloa1a9I1KCw2FTk,199
+eth_portfolio_scripts/victoria/__init__.py,sha256=R0VvKiAC0e57zZNihcCptVkFO5CBHIbp2trFYuyY01M,2038
+eth_portfolio_scripts/victoria/types.py,sha256=KNq8aIiNXeiDnCKL7xycmouo0YeKI-sbQkIcTymcSYk,745
+eth_portfolio-0.5.0.dist-info/METADATA,sha256=K8pzlsm0OQ5wiUDNOtV2nwMtiZQzJm_EdrewQwHyLeI,832
+eth_portfolio-0.5.0.dist-info/WHEEL,sha256=LwxTQZ0gyDP_uaeNCLm-ZIktY9hv6x0e22Q-hgFd-po,97
+eth_portfolio-0.5.0.dist-info/entry_points.txt,sha256=yqoC6X3LU1NA_-oJ6mloEYEPNmS-0hPS9OtEwgIeDGU,66
+eth_portfolio-0.5.0.dist-info/top_level.txt,sha256=4MlbY-Yj8oGBGL8piXiO4SOpk2gZFF9ZXVTObTZOzqM,57
+eth_portfolio-0.5.0.dist-info/RECORD,,

eth_portfolio-0.5.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-win32
+

eth_portfolio-0.5.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+eth-portfolio = eth_portfolio_scripts.main:main

eth_portfolio-0.5.0.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+eth_portfolio
+eth_portfolio__mypyc
+eth_portfolio_scripts

eth_portfolio_scripts/__init__.py

@@ -0,0 +1,20 @@
+from os import environ
+
+
+environ["DANKMIDS_GANACHE_FORK"] = "0"
+environ["DANKMIDS_COLLECT_STATS"] = "0"
+
+
+from dotenv import load_dotenv
+
+
+load_dotenv()
+
+
+from eth_portfolio_scripts._logging import logger, setup_logging
+
+
+setup_logging()
+
+
+__all__ = ["logger"]

eth_portfolio_scripts/_args.py

@@ -0,0 +1,26 @@
+from argparse import ArgumentParser
+
+
+def get_arg_parser(description: str) -> ArgumentParser:
+    return ArgumentParser(description)
+
+
+def add_infra_port_args(parser: ArgumentParser) -> None:
+    parser.add_argument(
+        "--grafana-port",
+        type=int,
+        help="The port that will be used by grafana",
+        default=3000,
+    )
+    parser.add_argument(
+        "--renderer-port",
+        type=int,
+        help="The port that will be used by grafana",
+        default=8091,
+    )
+    parser.add_argument(
+        "--victoria-port",
+        type=int,
+        help="The port that will be used by victoria metrics",
+        default=8428,
+    )

eth_portfolio_scripts/_logging.py

@@ -0,0 +1,15 @@
+import warnings
+from logging import INFO, basicConfig, getLogger
+
+from brownie.exceptions import BrownieCompilerWarning, BrownieEnvironmentWarning
+
+
+logger = getLogger(__name__)
+
+
+def setup_logging() -> None:
+    basicConfig(level=INFO)
+
+
+warnings.simplefilter("ignore", BrownieCompilerWarning)
+warnings.simplefilter("ignore", BrownieEnvironmentWarning)

eth_portfolio_scripts/_portfolio.py

@@ -0,0 +1,209 @@
+import asyncio
+from datetime import datetime, timezone
+from logging import getLogger
+from math import floor
+from typing import Awaitable, Callable, Final, Iterator, List, Optional, Tuple, Dict
+
+import a_sync
+import eth_retry
+import y
+from a_sync.functools import cached_property_unsafe as cached_property
+from eth_typing import BlockNumber, ChecksumAddress
+from msgspec import ValidationError, json
+from y import ERC20, Network, NonStandardERC20
+from y.constants import CHAINID
+from y.time import NoBlockFound
+
+from eth_portfolio import Portfolio
+from eth_portfolio.buckets import get_token_bucket
+from eth_portfolio.portfolio import _DEFAULT_LABEL
+from eth_portfolio.typing import (
+    Addresses,
+    Balance,
+    RemoteTokenBalances,
+    PortfolioBalances,
+    TokenBalances,
+)
+from eth_portfolio_scripts import victoria
+
+
+NETWORK_LABEL: Final = Network.label(CHAINID)
+
+decode: Final = json.decode
+
+logger: Final = getLogger("eth_portfolio")
+log_debug: Final = logger.debug
+log_error: Final = logger.error
+
+_block_at_timestamp_semaphore: Final = a_sync.Semaphore(
+    50, name="eth-portfolio get_block_at_timestamp"
+)
+
+
+async def get_block_at_timestamp(dt: datetime) -> BlockNumber:
+    async with _block_at_timestamp_semaphore:
+        while True:
+            try:
+                return await y.get_block_at_timestamp(dt, sync=False)
+            except NoBlockFound:
+                await asyncio.sleep(10)
+
+
+class ExportablePortfolio(Portfolio):
+    """Adds methods to export full portoflio data."""
+
+    def __init__(
+        self,
+        addresses: Addresses,
+        *,
+        start_block: int = 0,
+        label: str = _DEFAULT_LABEL,
+        concurrency: int = 30,
+        load_prices: bool = True,
+        get_bucket: Callable[[ChecksumAddress], Awaitable[str]] = None,
+        num_workers_transactions: int = 1000,
+        asynchronous: bool = False,
+        custom_buckets: Optional[Dict[str, str]] = None,
+    ):
+        super().__init__(
+            addresses, start_block, label, load_prices, num_workers_transactions, asynchronous
+        )
+        self._semaphore = a_sync.Semaphore(concurrency)
+
+        # Lowercase all keys in custom_buckets if provided
+        self.custom_buckets = (
+            {k.lower(): v for k, v in custom_buckets.items()} if custom_buckets else None
+        )
+
+        # If get_bucket is not provided, use get_token_bucket with the lowercased mapping
+        if get_bucket is None:
+            self.get_bucket = lambda token: get_token_bucket(token, self.custom_buckets)
+        elif custom_buckets:
+            raise RuntimeError(
+                "You cannot pass in a custom get_bucket function AND a custom_buckets mapping, choose one."
+            )
+        else:
+            self.get_bucket = get_bucket
+
+    @cached_property
+    def _data_queries(self) -> Tuple[str, str]:
+        label = self.label.lower().replace(" ", "_")
+        return f"{label}_assets", f"{label}_debts"
+
+    @eth_retry.auto_retry
+    @a_sync.Semaphore(16)
+    async def data_exists(self, dt: datetime) -> bool:
+        # sourcery skip: use-contextlib-suppress
+        async for data in a_sync.as_completed(list(self.__get_data_exists_coros(dt)), aiter=True):
+            try:
+                result = decode(data, type=victoria.types.Response)
+            except ValidationError:
+                raise victoria.VictoriaMetricsError(data.decode()) from None
+            if result.status == "success" and len(result.data.result) > 0:
+                print(f"{dt} already loaded")
+                return True
+        return False
+
+    async def export_snapshot(self, dt: datetime) -> None:
+        log_debug("checking data at %s for %s", dt, self.label)
+        try:
+            if await self.data_exists(dt, sync=False):
+                return
+            block = await get_block_at_timestamp(dt)
+            log_debug("block at %s: %s", dt, block)
+            data = await self.get_data_for_export(block, dt, sync=False)
+            await victoria.post_data(data)
+        except Exception as e:
+            log_error("Error processing %s:", dt, exc_info=True)
+
+    async def get_data_for_export(self, block: BlockNumber, ts: datetime) -> List[victoria.Metric]:
+        async with self._semaphore:
+            print(f"exporting {ts} for {self.label}")
+            start = datetime.now(tz=timezone.utc)
+
+            metrics_to_export = []
+            data: PortfolioBalances = await self.describe(block, sync=False)
+
+            for wallet, wallet_data in dict.items(data):
+                for section, section_data in wallet_data.items():
+                    if isinstance(section_data, TokenBalances):
+                        for token, bals in dict.items(section_data):
+                            metrics_to_export.extend(
+                                await self.__process_token(ts, section, wallet, token, bals)
+                            )
+                    elif isinstance(section_data, RemoteTokenBalances):
+                        if section == "external":
+                            section = "assets"
+                        for protocol, token_bals in section_data.items():
+                            for token, bals in dict.items(token_bals):
+                                metrics_to_export.extend(
+                                    await self.__process_token(
+                                        ts, section, wallet, token, bals, protocol=protocol
+                                    )
+                                )
+                    else:
+                        raise NotImplementedError()
+
+            print(f"got data for {ts} in {datetime.now(tz=timezone.utc) - start}")
+            return metrics_to_export
+
+    def __get_data_exists_coros(self, dt: datetime) -> Iterator[str]:
+        for query in self._data_queries:
+            yield victoria.get(f"/api/v1/query?query={query}&time={int(dt.timestamp())}")
+
+    async def __process_token(
+        self,
+        ts: datetime,
+        section: str,
+        wallet: ChecksumAddress,
+        token: ChecksumAddress,
+        bal: Balance,
+        protocol: Optional[str] = None,
+    ) -> Tuple[victoria.types.PrometheusItem, victoria.types.PrometheusItem]:
+        # TODO wallet nicknames in grafana
+        # wallet = KNOWN_ADDRESSES[wallet] if wallet in KNOWN_ADDRESSES else wallet
+        if protocol is not None:
+            wallet = f"{protocol} | {wallet}"
+
+        label_and_section = f"{self.label}_{section}".lower().replace(" ", "_")
+        symbol = await _get_symbol(token)
+        bucket = await self.get_bucket(token)
+        ts_millis = floor(ts.timestamp()) * 1000
+
+        return (
+            victoria.types.PrometheusItem(
+                metric=victoria.Metric(
+                    param="balance",
+                    wallet=wallet,
+                    token_address=token,
+                    token=symbol,
+                    bucket=bucket,
+                    network=NETWORK_LABEL,
+                    __name__=label_and_section,
+                ),
+                values=[float(bal.balance)],
+                timestamps=[ts_millis],
+            ),
+            victoria.types.PrometheusItem(
+                metric=victoria.Metric(
+                    param="usd value",
+                    wallet=wallet,
+                    token_address=token,
+                    token=symbol,
+                    bucket=bucket,
+                    network=NETWORK_LABEL,
+                    __name__=label_and_section,
+                ),
+                values=[float(bal.usd)],
+                timestamps=[ts_millis],
+            ),
+        )
+
+
+async def _get_symbol(token: str) -> str:
+    if token == "ETH":
+        return "ETH"
+    try:
+        return await ERC20(token, asynchronous=True).symbol
+    except NonStandardERC20:
+        return "<NonStandardERC20>"