eth-portfolio 0.5.8__cp311-cp311-musllinux_1_2_x86_64.whl

eth_portfolio/typing/balance/single.py

@@ -0,0 +1,176 @@
+from typing import Literal, 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: ChecksumAddress | None = None
+    """
+    The token the balance is of, if known.
+    """
+
+    block: BlockNumber | None = 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)
+
+    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.8.dist-info/METADATA

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: eth_portfolio
+Version: 0.5.8
+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.dev2
+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.3
+Requires-Dist: faster-eth-utils
+Requires-Dist: numpy<3
+Requires-Dist: pandas<3,>=1.4.3
+Requires-Dist: pandas-stubs<3,>=1.4.3
+Requires-Dist: typed-envs>=0.2.3
+Requires-Dist: types-tqdm
+Requires-Dist: ypricemagic<5.2,>=5.1.5
+Dynamic: author
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

eth_portfolio-0.5.8.dist-info/RECORD

@@ -0,0 +1,83 @@
+eth_portfolio__mypyc.cpython-311-x86_64-linux-musl.so,sha256=yro_HLC6MYaq3mgtgXi-hxVh-0Rwis_cu6Ckc0ypMi4,806872
+eth_portfolio/__init__.py,sha256=6LVvIubKt5md1EdMVTxHubZQqYZhYaA64v_UMrn-gTI,499
+eth_portfolio/_argspec.cpython-311-x86_64-linux-musl.so,sha256=NGQ-v_R3axHZlqApo5JB41uc2k7BrsWbNeuCwUN4LkY,17624
+eth_portfolio/_argspec.py,sha256=1hMCiTGt6BBiWkR9b1eFWxTNyEKXF_bgb4yOoH8Mitk,1603
+eth_portfolio/_cache.py,sha256=D0xI--BOsr37XAqqGCgcYN296X5RtQqBC_J6vJoNtTw,4728
+eth_portfolio/_config.cpython-311-x86_64-linux-musl.so,sha256=Lfhkma_f1sWGUyUSnb3-2gYLr8MCnhO05DvN2ubRa-M,17624
+eth_portfolio/_config.py,sha256=mw-OA3M8rUA2hqy5wNt30AZRHkWFgR8K2sJg0o5Baxg,98
+eth_portfolio/_decimal.py,sha256=8lCXpmzaAs2WGb4mzewHvGkVo50fZpXwdZeXpzYaSJU,4814
+eth_portfolio/_decorators.py,sha256=yC2jMj9KwcfYnKky54Sp-s2G3-SJffGIjpcEP5lCsFQ,2791
+eth_portfolio/_exceptions.py,sha256=pk4XFeTelD1-77iXAdIDlH6VzjfvsFBwmmEBkrHGsbI,2423
+eth_portfolio/_shitcoins.cpython-311-x86_64-linux-musl.so,sha256=3nmUKrqKdYZMxsDjH9DXk5NZEA0Mj_x6Skj0Ivcq3-8,17632
+eth_portfolio/_shitcoins.py,sha256=vMlyBMdhpvU7xocXVfK1zSqNo4K3AzzUgO-LcM2plLA,17664
+eth_portfolio/_stableish.cpython-311-x86_64-linux-musl.so,sha256=Jwngfv5kdpQx0Z0zaC7peIU4m9rpTUO3fHj8rcuKFHI,17632
+eth_portfolio/_stableish.py,sha256=kYnsk6aCA9RGQKcDPLML6LAPyc__YTsK5vJLzNxkh2g,2016
+eth_portfolio/_submodules.py,sha256=sGrgpcE0iQjsifbyG6_-cL5VSU_L9oZ8SDkQWfAwCjU,2161
+eth_portfolio/_utils.py,sha256=ci7y6GIJ3458eOgCowQ859EtpSWK89DifogV6dgh_YU,7935
+eth_portfolio/address.py,sha256=HLKXt36kEQ-vKCJjmaUdZMBcJsPDZ800eLeRYzqWojA,14085
+eth_portfolio/buckets.py,sha256=wIRM6YXwNVtsA5-p9HYr45FNJkl11x1uUjm92_SVpLU,7547
+eth_portfolio/constants.cpython-311-x86_64-linux-musl.so,sha256=VrIG6qkOZSgkU3ZF08idW-7t8rweAKrIaw2uhwFmF1M,17624
+eth_portfolio/constants.py,sha256=tR2QKapbutcGYjXdxwB23FICQlwyDPvgua-dhltYyDc,3976
+eth_portfolio/portfolio.py,sha256=qByA7pzFUHLi9wTdu3AgQNglubjquYw5KVWB0vEOvCg,24249
+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=lRRr6S43b4LQ-HQ-BbANpEl3D0DaaN421Zbk0KUKfv4,5187
+eth_portfolio/_db/entities.py,sha256=KjcMoJs9AcaIBDsb9XMBahB4iaxbvVELDU133V86DLw,10015
+eth_portfolio/_db/utils.py,sha256=r5wRnaPQ3-6pUSoBeTbyedl-tNt9eAvhHWRH0vfh4bk,21722
+eth_portfolio/_ledgers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eth_portfolio/_ledgers/address.py,sha256=p-_15b07TgZU12LMN0NIusDGSJ0O7ESqjhhkNArY5XY,32592
+eth_portfolio/_ledgers/portfolio.py,sha256=5CMrPLIUCBo0xihEEz3wd6tCctbjRMQ1YZfLWCCnDUY,13067
+eth_portfolio/_loaders/__init__.py,sha256=_7WwCsSCJH-muqXzUQL152fptzUlShgRkG6Gr0o-kmo,1702
+eth_portfolio/_loaders/_nonce.cpython-311-x86_64-linux-musl.so,sha256=bJHshOGQNa4u_ij7rvveyKPZoVN6lUTGiID2BIKFoiY,17640
+eth_portfolio/_loaders/_nonce.py,sha256=OgfAOgf95L775rSEGNJrmMGptT8CYBUNmFxV-fF-3AQ,6213
+eth_portfolio/_loaders/balances.cpython-311-x86_64-linux-musl.so,sha256=uNws78yBTRvUWaOY58MCm6IGzHc5VxGMCjFOtMzQoDc,17640
+eth_portfolio/_loaders/balances.py,sha256=qPo_-DjA0UfRnhyDJaelklZwrmjxQIgbJ-06cZ8pu1I,3364
+eth_portfolio/_loaders/token_transfer.py,sha256=jApqFEhjGOzIz9qqf-UjEnuy5XgSiTBcs7j7sHoZiss,8492
+eth_portfolio/_loaders/transaction.py,sha256=jgYg_vetemNeVwxjvkn7a-wVzoT65pOnj_ABLb4lj9M,9202
+eth_portfolio/_loaders/utils.cpython-311-x86_64-linux-musl.so,sha256=jprgMNFir9B0SmmDLk-FSuc7eIYADctTX2FZ1VGCvIQ,17624
+eth_portfolio/_loaders/utils.py,sha256=SLgU1UW6yiix4IZksqD421Yik5mUifH5jefmDVmDRSk,2264
+eth_portfolio/_ydb/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eth_portfolio/_ydb/token_transfers.py,sha256=oLhoumwgKJcLwpJuYrpLPhADai2YOrNA06irC5pE9QE,5205
+eth_portfolio/protocols/__init__.py,sha256=SK7-lE3h_0rpGFxPv7qgLh06n5LicxwJ-UEDBR3IkVE,2517
+eth_portfolio/protocols/_base.py,sha256=6wPaGNSvoYruYmyrGAF4K-XMvGNK0Gt7BnlemqpAQsI,3585
+eth_portfolio/protocols/convex.py,sha256=uNbXxEmhcpXulNkbxoqWl9eAJTZjPJlzXFtrBGvRXLo,518
+eth_portfolio/protocols/dsr.py,sha256=dpakgHDhcVvvthspQWiXRlb88CvWVqyfA2T1QlawOZE,1738
+eth_portfolio/protocols/liquity.py,sha256=i8auPyQC5chB1Q_jrMPnKOXqHoJitrZwWyYv5yXZL3M,641
+eth_portfolio/protocols/lending/README.md,sha256=OhZfsW8e-aD-q02g0maG9QGgW0IietkDRZc7PBakBvc,493
+eth_portfolio/protocols/lending/__init__.py,sha256=u5WITxFG1gsh1A2jG_kNKTNI58pQPmZ2-9zDVlkq03Q,1631
+eth_portfolio/protocols/lending/_base.py,sha256=NG3-LbDjHWjD7yF1H95kyJHNYgnDLiqaDlWrNem6kFI,2204
+eth_portfolio/protocols/lending/compound.py,sha256=r16i7Y8pq1XvNZya71GfhWzpZn8j-6MRJNAKrPxbHqA,7206
+eth_portfolio/protocols/lending/liquity.py,sha256=IC-Fky4A2fQH9sHnad6SKhMZZrRx6bNNRAhxkXLvoew,4149
+eth_portfolio/protocols/lending/maker.py,sha256=zIQyD3SDGPbD_yHqEfV4SKe1i05a8j2GjWZra283Wik,4282
+eth_portfolio/protocols/lending/unit.py,sha256=ozzqV_pciKgZCmbDIL8721j7M_r5nXIuWlnSW0hUOU0,1930
+eth_portfolio/structs/__init__.py,sha256=3EmfKoJGszobO7fCkERLXSN50V6dX3nfhvbiKIvJUZI,1443
+eth_portfolio/structs/modified.py,sha256=z75XDNXOfm3hDr7pj0PbmUvfPeQSFH9BJ9m0L2V_LFw,1784
+eth_portfolio/structs/structs.py,sha256=c4aAKTReZ1-_eWyzUm17rZzTbgFYbXN3V9JM-MSZ-qQ,19746
+eth_portfolio/typing/__init__.py,sha256=Lqp2_Qst0kPggjBJlDp9YOlaM2dNCdYpW601VuQ22gs,57118
+eth_portfolio/typing/balance/single.py,sha256=jBul4zMTJT8U_cP5DKxALBKMRGXIjQFx_WIesceSPl4,6293
+eth_portfolio_scripts/__init__.py,sha256=6Fc2KtR3RXEKp8aJos2EOtrtkgmn5-8XvVd8zzPzxzw,258
+eth_portfolio_scripts/_args.py,sha256=k6J6XkRe1VuN1DiyGuXLCR7NBSvzH5jnVChfzodKuB8,656
+eth_portfolio_scripts/_logging.py,sha256=We2lHgSbubNS-pac3Y_K0CU5JvJmsF37W4QeW4NPwyQ,353
+eth_portfolio_scripts/_portfolio.py,sha256=d3DSeaNdE2Fg3erRXqf1X73e6z3_R07qcwDgzet4E4E,7785
+eth_portfolio_scripts/_utils.py,sha256=EgJph58R9Rguj4r_lYeFuS8gScHFhtpTeoxPiXtL6f4,3058
+eth_portfolio_scripts/balances.cpython-311-x86_64-linux-musl.so,sha256=xjLbakQWm08p3losDaIX8zzf57caokn-zDW9ahci1EI,17640
+eth_portfolio_scripts/balances.py,sha256=LYqD4YPxlUIWdqiXAmtbp_MgVf1oWbDSskMtvz5T0jA,1724
+eth_portfolio_scripts/main.py,sha256=zlgeH2HYTmJ9F2GbB6l0I9QLOJy1z7Xe71bOHrAsYJs,3676
+eth_portfolio_scripts/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+eth_portfolio_scripts/docker/__init__.cpython-311-x86_64-linux-musl.so,sha256=V1G9iUfQ_VxAL86M-cY7ja_ZQr6JastV-MJb7LEVgkM,17632
+eth_portfolio_scripts/docker/__init__.py,sha256=7bRbWsRTk0OJgZChUVIV2a9313TQQv_8iCJCi0uRSBw,393
+eth_portfolio_scripts/docker/check.cpython-311-x86_64-linux-musl.so,sha256=DbQD0A7xHFDBY7HjEZwZG7B6zRMpV2yRSUqpogTHFjU,17640
+eth_portfolio_scripts/docker/check.py,sha256=3iqkx-_ftWpteYDVcO2kyJLY---gPWGO2o2HH2OarpM,1906
+eth_portfolio_scripts/docker/docker-compose.yaml,sha256=9detffYIxkgUg4h2_tOJx__Hrl8_xrIPlfEsYoH8RHc,1809
+eth_portfolio_scripts/docker/docker_compose.cpython-311-x86_64-linux-musl.so,sha256=qNax1x0Gr3ouQJU4N1Ytk65tMVOOyaXeECXKF7L23VM,17680
+eth_portfolio_scripts/docker/docker_compose.py,sha256=PvBBuUo-1wMaCC3KoBsWV_-AdET1bXbXGc0ngVa9Cgo,2788
+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/docker/.grafana/datasources/datasources.yml,sha256=pBE_0Nh_J7d9Fiy3Xu6vuac_HWCBcFsJJSV-ryjQR1Y,188
+eth_portfolio_scripts/victoria/__init__.py,sha256=6DfZfwW46gmClj1pUq6GwmumyL4XMMsOPUni8QHahEs,1964
+eth_portfolio_scripts/victoria/types.py,sha256=oIwswuWU1KWWM_CyUmGf2WVPzPai_JCN2mA9gEbb8uk,694
+eth_portfolio-0.5.8.dist-info/METADATA,sha256=neh_nI8wDret0cmjgMBtijOWoBZ65_tMjQev4Li34Io,875
+eth_portfolio-0.5.8.dist-info/WHEEL,sha256=J_Ko_zS6o8JXUfI9CaFd6O2wkMIFNryhqfb69cs30HY,113
+eth_portfolio-0.5.8.dist-info/entry_points.txt,sha256=yqoC6X3LU1NA_-oJ6mloEYEPNmS-0hPS9OtEwgIeDGU,66
+eth_portfolio-0.5.8.dist-info/top_level.txt,sha256=4MlbY-Yj8oGBGL8piXiO4SOpk2gZFF9ZXVTObTZOzqM,57
+eth_portfolio-0.5.8.dist-info/RECORD,,

eth_portfolio-0.5.8.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.1)
+Root-Is-Purelib: false
+Tag: cp311-cp311-musllinux_1_2_x86_64
+

eth_portfolio-0.5.8.dist-info/entry_points.txt

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

eth_portfolio-0.5.8.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,17 @@
+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,14 @@
+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 collections.abc import Awaitable, Callable, Iterator
+from datetime import datetime, timezone
+from logging import getLogger
+from math import floor
+from typing import Final
+
+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,
+    PortfolioBalances,
+    RemoteTokenBalances,
+    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: dict[str, str] | None = 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: str | None = 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>"