eth-portfolio 0.5.4__cp310-cp310-macosx_11_0_arm64.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.4.dist-info/METADATA

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: eth_portfolio
+Version: 0.5.4
+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.192
+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.10
+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.2.3
+Requires-Dist: ypricemagic<5.2,>=5.1.3
+Dynamic: author
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

eth_portfolio-0.5.4.dist-info/RECORD

@@ -0,0 +1,83 @@
+eth_portfolio__mypyc.cpython-310-darwin.so,sha256=ayl8R6LOEMFJ7TxO1LGEJDFPSQz-t3Wpb-XDB9TRqc8,696024
+eth_portfolio/address.py,sha256=LvBh4Vp2DBC3gQ0WD-TZ6jfe9s6FZbET1krYG9_KMAA,14139
+eth_portfolio/_cache.py,sha256=IOeMXvMgOlEEk01yHP0RARRZXyonuKXUNZbNLFM_KBU,4805
+eth_portfolio/_stableish.cpython-310-darwin.so,sha256=44bUpDJBVRooC24jBlbTby-kWFnDSWaPuU6R1sMqCro,50656
+eth_portfolio/_argspec.py,sha256=VzUZkbDkmOSgNUZBGbGblqtxBfDcmBAB89dY2OX0j-U,1595
+eth_portfolio/_submodules.py,sha256=J8ht9bAAvblUXqwOGN7UIOXUPxrTiq7m1RWiB0-ObaE,2190
+eth_portfolio/constants.py,sha256=tR2QKapbutcGYjXdxwB23FICQlwyDPvgua-dhltYyDc,3976
+eth_portfolio/__init__.py,sha256=0sO4cSJaLYwJfnfVOJRFw7p5_Lzhsr95YuJ1aNQM83A,500
+eth_portfolio/_argspec.cpython-310-darwin.so,sha256=biss2x6eM4nlRKgbGGC6lj4Krc6gNCegmnRTaZa8qUY,50640
+eth_portfolio/_decimal.py,sha256=tYS0miNoQYZguy0yd1bb3bf49l9F3YICyN8ov6r7VBs,4846
+eth_portfolio/_config.cpython-310-darwin.so,sha256=a0fNnCHhfOi4ic0CQbu3LACg9GMpRMwcSUqtA48fRDc,50640
+eth_portfolio/buckets.py,sha256=-eG-F_Ke0meR_pdA8uYQQuO0lkVgbizTUG3Xhe8o5dE,7599
+eth_portfolio/_shitcoins.cpython-310-darwin.so,sha256=uVMPYFae8SP4YUSkJPnFlsyxTKxBgn6fnz3UJvbbPWA,50656
+eth_portfolio/_decorators.py,sha256=_ZSurUFEIwZRiMFMhLcIXkD-Ey1CqfBqGaE24hLzOuA,2815
+eth_portfolio/_stableish.py,sha256=VTv69Q91AHxbNbbY0LB4PFwKEseHdkE4_6fLPKH1uW0,2021
+eth_portfolio/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eth_portfolio/_shitcoins.py,sha256=-Ja3mVtMiQ6dBvIBcYlAfJ36OFE3boDP-jLroBiBKVg,17669
+eth_portfolio/constants.cpython-310-darwin.so,sha256=eXKJq4x8gLOv9zcyVZX-vVnXvoyOpP0s3fLVcRL13jw,50656
+eth_portfolio/_config.py,sha256=mw-OA3M8rUA2hqy5wNt30AZRHkWFgR8K2sJg0o5Baxg,98
+eth_portfolio/_exceptions.py,sha256=bw3IdXhqrWxeFqYLm7pJZqRHKZas_cCg8A5Ih1WQEqQ,2433
+eth_portfolio/portfolio.py,sha256=MP_0Y6fXw8TNoyoFCPiu-MUA44jnMm0L_33gec6MjKU,24248
+eth_portfolio/_utils.py,sha256=8403ioVA6VX4XaF56CDI9IA4ilTZUf_TrdlQ78chXbQ,7661
+eth_portfolio/_loaders/_nonce.cpython-310-darwin.so,sha256=v3qSrDM1JRX0R-NGXvCw5hboJXsHLztYsi8-J-PjhBg,50656
+eth_portfolio/_loaders/transaction.py,sha256=rg2QucrsWndQzNeGMSOXBIoK11u8_1LhIoiUvWLo9B0,9151
+eth_portfolio/_loaders/__init__.py,sha256=lb45_0ak32Z7N3-Nx1CAoRKiZ1_w-_YGbmSCNuunro8,1702
+eth_portfolio/_loaders/_nonce.py,sha256=T1XLV69eBYnSE422G8zsqPzzB7f679Xpp5z3kXf6UNk,6256
+eth_portfolio/_loaders/utils.py,sha256=aoGgWl9ra9F-qb0wA-sX3qelUNGI-fGvM90297L7xWM,2265
+eth_portfolio/_loaders/balances.cpython-310-darwin.so,sha256=Mg1gGciYlvLNs43yEWlAKjmYkf91MKe4fe7ylFtojXo,50656
+eth_portfolio/_loaders/balances.py,sha256=BTWfkJIoSraUMe94Wuj8NPyg5EO0OByIjbXu7j6PZEo,3132
+eth_portfolio/_loaders/token_transfer.py,sha256=AD8-pZPDH1xslUqepewRm4NJj60q2HXaU0e1mQb3qjU,8510
+eth_portfolio/_loaders/utils.cpython-310-darwin.so,sha256=tu4ddqSAEr5I4ZFEJ570tNp2OeytmgloyT1tPxWWGKM,50648
+eth_portfolio/_ydb/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eth_portfolio/_ydb/token_transfers.py,sha256=KFsapzGfNWEv2eM-7qYMdIIA1aHs80CikQ-DPT4_un4,5179
+eth_portfolio/_db/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eth_portfolio/_db/utils.py,sha256=rKRXMYTYGG2GHnqWx7UCbxCqENqQkoxObpG5xp05QE8,21275
+eth_portfolio/_db/entities.py,sha256=KjcMoJs9AcaIBDsb9XMBahB4iaxbvVELDU133V86DLw,10015
+eth_portfolio/_db/decorators.py,sha256=3wbtiYUSfYAeXYRLCLQ-la5_E-ARbp_8De02_v6ywWo,5188
+eth_portfolio/typing/__init__.py,sha256=-HL9aMdaEpKNergleZW8nUBSDp-WGI-wusUww8-zZpc,57061
+eth_portfolio/typing/balance/single.py,sha256=_HhJL21jOs4IPjRsYbjZVficsNWCS0fcpBryr3JFt7s,6325
+eth_portfolio/_ledgers/address.py,sha256=13LnkGG1wS_sRXnM2NdCzJWewUbp9KMoMRCcCC7B85U,32776
+eth_portfolio/_ledgers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eth_portfolio/_ledgers/portfolio.py,sha256=7wLEx2zhvHmY9xMtJy_Jk-LAPIKo6K1lV_DcnOjLwWU,13083
+eth_portfolio/structs/modified.py,sha256=z75XDNXOfm3hDr7pj0PbmUvfPeQSFH9BJ9m0L2V_LFw,1784
+eth_portfolio/structs/__init__.py,sha256=3EmfKoJGszobO7fCkERLXSN50V6dX3nfhvbiKIvJUZI,1443
+eth_portfolio/structs/structs.py,sha256=AYRgwtyg8fLbIvEO2mKtJ6_9hQKl6EiHEPpR3UGD6rs,19708
+eth_portfolio/protocols/_base.py,sha256=0-ZAENGqP4VSZHcIxE7NQdQTBtYbwd1p99yDWfJdybQ,3633
+eth_portfolio/protocols/liquity.py,sha256=sTUoVtFYj-OWUamwCnJyqna-eAa5Ww7-qGA0St1OTMQ,640
+eth_portfolio/protocols/__init__.py,sha256=T-IscXbHIJq5AtOjJ2gb_wDaBauwt6UKmQk-5gBKGAc,2518
+eth_portfolio/protocols/convex.py,sha256=uNbXxEmhcpXulNkbxoqWl9eAJTZjPJlzXFtrBGvRXLo,518
+eth_portfolio/protocols/dsr.py,sha256=eCAVu-B15D5dRJ1iQbHIkO5RAO-tChzdVQMsE_gj2Ps,1739
+eth_portfolio/protocols/lending/_base.py,sha256=UBdJ5eV2baewEvppjES72eOJzKTK2XHGYnySQNBcack,2254
+eth_portfolio/protocols/lending/liquity.py,sha256=N45LTa2VTcj3UDygn76iwaG_l0AYXOWh-9n5YBqkQNM,4184
+eth_portfolio/protocols/lending/maker.py,sha256=myyz167mO3tX10JN_D5-dJrcPaHabeb0_Sf_AdXjK2k,4308
+eth_portfolio/protocols/lending/__init__.py,sha256=BZtCOglz6R12wqETlECbCEITdtIT9J6bYzy61iDencI,1643
+eth_portfolio/protocols/lending/README.md,sha256=OhZfsW8e-aD-q02g0maG9QGgW0IietkDRZc7PBakBvc,493
+eth_portfolio/protocols/lending/compound.py,sha256=bqnIevm7NWhk6nMfkMZUKlQuVWr-tXnuntX-4De1YZM,7252
+eth_portfolio/protocols/lending/unit.py,sha256=7oRvIkoKUm8IOnDv59pILSSJWFNNjwr4CR1gg2psW9M,1965
+eth_portfolio_scripts/_logging.py,sha256=B_rQMYt_1PhpwCOLBRpkKK6M1ljcF0wAIgqfPIsFUGU,354
+eth_portfolio_scripts/_args.py,sha256=k6J6XkRe1VuN1DiyGuXLCR7NBSvzH5jnVChfzodKuB8,656
+eth_portfolio_scripts/__init__.py,sha256=TC5c4WZdzSHhTIBYuwzrAyzFuGzBmHiDX_g6ghO09jQ,261
+eth_portfolio_scripts/balances.cpython-310-darwin.so,sha256=QijgnWM3r0BnanZDb3hx_pOxLbA-K1yK_JDNivY7WKY,50656
+eth_portfolio_scripts/_portfolio.py,sha256=oNTXtxV4jYhQCk4DIc6hHLltZxC09OVoGlAE7COjGc4,7794
+eth_portfolio_scripts/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+eth_portfolio_scripts/balances.py,sha256=1GEoGsGDj9gocBP1mQ2-maxJqLlA1YLZHcf90mRTWqc,1744
+eth_portfolio_scripts/main.py,sha256=jc2o45OS-xzjwwNLgCOn9lwEzZJEhVFyAM4kesSwW6Q,3685
+eth_portfolio_scripts/_utils.py,sha256=-JiZLpSa8P2_ZFXw1AfpVmTO6X65yPeVVdnrDpNFzNQ,3057
+eth_portfolio_scripts/docker/docker_compose.cpython-310-darwin.so,sha256=-Q0-Cg9Bwp_McAFs3qHpv_0LryctCvX-Re7MH-uWRnM,50712
+eth_portfolio_scripts/docker/docker-compose.yaml,sha256=K1iLHZcOVrnpb9Nb9gtcFaVosjjfjjfXGp6WkStBLQk,1809
+eth_portfolio_scripts/docker/docker_compose.py,sha256=1q77B02vdadwlVP1LpB4V7sgcGnABPSSnbAZdYxyMWk,2859
+eth_portfolio_scripts/docker/check.cpython-310-darwin.so,sha256=rIzcPxi0-_PxSz0YuOufBQY6ilmkDUW6R_lSALLZ1iU,50664
+eth_portfolio_scripts/docker/check.py,sha256=_UdwuLCwzJUHvpGFzDxk5GbYAafG-A-jL1YDaq4TU1E,1930
+eth_portfolio_scripts/docker/__init__.py,sha256=ZXSIYcjp94c0O9o39BDGWju3YrCMLl4gtov7YChc9Ig,393
+eth_portfolio_scripts/docker/__init__.cpython-310-darwin.so,sha256=AXj1Zh_BRG6RTvtA9RPu1evwoKGlyGGfWNIfjnDVPuU,50656
+eth_portfolio_scripts/docker/.grafana/datasources/datasources.yml,sha256=pBE_0Nh_J7d9Fiy3Xu6vuac_HWCBcFsJJSV-ryjQR1Y,188
+eth_portfolio_scripts/docker/.grafana/dashboards/dashboards.yaml,sha256=MynNDOk69IihoYdd2bL7j8CnRb2Co4gdqW7T4m6AaEU,202
+eth_portfolio_scripts/docker/.grafana/dashboards/Portfolio/Balances.json,sha256=dBmjogLJRuixCHWSs4ROE0_FXb-PUbqWBHEdLoP-1MU,68788
+eth_portfolio_scripts/victoria/__init__.py,sha256=6rDSJ1OBup2feCuFmGbJt5F3ie3XKtdiVezldWB4PUE,1965
+eth_portfolio_scripts/victoria/types.py,sha256=jsqWM5QxrhuTHbbxnfjd1PlwJIjybIbK-6gGwcNYiLY,707
+eth_portfolio-0.5.4.dist-info/RECORD,,
+eth_portfolio-0.5.4.dist-info/WHEEL,sha256=11kMdE9gzbsaQG30fRcsAYxBLEVRsqJo098Y5iL60Xo,136
+eth_portfolio-0.5.4.dist-info/entry_points.txt,sha256=yqoC6X3LU1NA_-oJ6mloEYEPNmS-0hPS9OtEwgIeDGU,66
+eth_portfolio-0.5.4.dist-info/top_level.txt,sha256=4MlbY-Yj8oGBGL8piXiO4SOpk2gZFF9ZXVTObTZOzqM,57
+eth_portfolio-0.5.4.dist-info/METADATA,sha256=TspSUD60rskBh1Vev8G-_BXszkmJVa-Y22lh0cAz1DE,811

eth_portfolio-0.5.4.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp310-cp310-macosx_11_0_arm64
+Generator: delocate 0.13.0
+

eth_portfolio-0.5.4.dist-info/entry_points.txt

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

eth_portfolio-0.5.4.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>"