dao-treasury 0.0.41__cp310-cp310-win32.whl → 0.0.70__cp310-cp310-win32.whl

dao_treasury/sorting/rule.py

@@ -130,8 +130,6 @@ class _SortRule:
     func: Optional[SortFunction] = None
     """Custom matching function that takes a `TreasuryTx` and returns a bool or an awaitable that returns a bool."""
 
-    # __instances__: ClassVar[List[Self]] = []
-
     def __post_init__(self) -> None:
         """Validate inputs, checksum addresses, and register the rule.
 
@@ -235,7 +233,7 @@ class _InboundSortRule(_SortRule):
         return (
             tx.to_address is not None
             and TreasuryWallet.check_membership(tx.to_address.address, tx.block)
-            and await super().match(tx)
+            and await super(_InboundSortRule, self).match(tx)
         )
 
 
@@ -250,7 +248,7 @@ class _OutboundSortRule(_SortRule):
     async def match(self, tx: "TreasuryTx") -> bool:
         return TreasuryWallet.check_membership(
             tx.from_address.address, tx.block
-        ) and await super().match(tx)
+        ) and await super(_OutboundSortRule, self).match(tx)
 
 
 @mypyc_attr(native_class=False)
@@ -267,7 +265,7 @@ class RevenueSortRule(_InboundSortRule):
     def __post_init__(self) -> None:
         """Prepends `self.txgroup` with 'Revenue:'."""
         object.__setattr__(self, "txgroup", f"Revenue:{self.txgroup}")
-        super().__post_init__()
+        super(RevenueSortRule, self).__post_init__()
 
 
 @mypyc_attr(native_class=False)
@@ -280,7 +278,7 @@ class CostOfRevenueSortRule(_OutboundSortRule):
     def __post_init__(self) -> None:
         """Prepends `self.txgroup` with 'Cost of Revenue:'."""
         object.__setattr__(self, "txgroup", f"Cost of Revenue:{self.txgroup}")
-        super().__post_init__()
+        super(CostOfRevenueSortRule, self).__post_init__()
 
 
 @mypyc_attr(native_class=False)
@@ -293,7 +291,7 @@ class ExpenseSortRule(_OutboundSortRule):
     def __post_init__(self) -> None:
         """Prepends `self.txgroup` with 'Expenses:'."""
         object.__setattr__(self, "txgroup", f"Expenses:{self.txgroup}")
-        super().__post_init__()
+        super(ExpenseSortRule, self).__post_init__()
 
 
 @mypyc_attr(native_class=False)
@@ -306,7 +304,7 @@ class OtherIncomeSortRule(_InboundSortRule):
     def __post_init__(self) -> None:
         """Prepends `self.txgroup` with 'Other Income:'."""
         object.__setattr__(self, "txgroup", f"Other Income:{self.txgroup}")
-        super().__post_init__()
+        super(OtherIncomeSortRule, self).__post_init__()
 
 
 @mypyc_attr(native_class=False)
@@ -319,7 +317,7 @@ class OtherExpenseSortRule(_OutboundSortRule):
     def __post_init__(self) -> None:
         """Prepends `self.txgroup` with 'Other Expenses:'."""
         object.__setattr__(self, "txgroup", f"Other Expenses:{self.txgroup}")
-        super().__post_init__()
+        super(OtherExpenseSortRule, self).__post_init__()
 
 
 @mypyc_attr(native_class=False)
@@ -332,7 +330,7 @@ class IgnoreSortRule(_SortRule):
     def __post_init__(self) -> None:
         """Prepends `self.txgroup` with 'Ignore:'."""
         object.__setattr__(self, "txgroup", f"Ignore:{self.txgroup}")
-        super().__post_init__()
+        super(IgnoreSortRule, self).__post_init__()
 
 
 TRule = TypeVar(

dao_treasury/treasury.py

@@ -18,11 +18,11 @@ This is the main entry point for orchestrating DAO treasury analytics.
 from asyncio import create_task, gather
 from logging import getLogger
 from pathlib import Path
-from typing import Final, Iterable, List, Optional, Union
+from typing import Dict, Final, Iterable, List, Optional, Union
 
 import a_sync
 from a_sync.a_sync.abstract import ASyncABC
-from eth_typing import BlockNumber
+from eth_typing import BlockNumber, HexAddress
 from eth_portfolio.structs import LedgerEntry
 from eth_portfolio.typing import PortfolioBalances
 from eth_portfolio_scripts._portfolio import ExportablePortfolio
@@ -52,6 +52,7 @@ class Treasury(a_sync.ASyncGenericBase):  # type: ignore [misc]
         sort_rules: Optional[Path] = None,
         start_block: int = 0,
         label: str = "your org's treasury",
+        custom_buckets: Optional[Dict[HexAddress, str]] = None,
         asynchronous: bool = False,
     ) -> None:
         """Initialize the Treasury singleton for managing DAO funds.
@@ -124,6 +125,7 @@ class Treasury(a_sync.ASyncGenericBase):  # type: ignore [misc]
             start_block=start_block,
             label=label,
             load_prices=True,
+            custom_buckets=custom_buckets,
             asynchronous=asynchronous,
         )
         """An eth_portfolio.Portfolio object used for exporting tx and balance history"""

{dao_treasury-0.0.41.dist-info → dao_treasury-0.0.70.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dao_treasury
-Version: 0.0.41
+Version: 0.0.70
 Summary: Produce comprehensive financial reports for your on-chain org
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -14,7 +14,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.10,<3.13
 Description-Content-Type: text/markdown
-Requires-Dist: eth-portfolio-temp<0.1,>=0.0.38.dev0
+Requires-Dist: eth-portfolio-temp==0.3.1
 Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
@@ -29,6 +29,7 @@ DAO Treasury is a comprehensive financial reporting and treasury management solu
 - **Financial Reporting for DAOs:** Extends core portfolio functionalities to generate detailed reports tailored for on-chain organizations.
 - **Dashboard Provisioning:** Utilizes [Grafana](https://grafana.com/) dashboards—defined in JSON files within the .grafana/provisioning directories—to offer real-time, dynamic visualizations of treasury data.
 - **Automated Data Export:** Features a treasury export tool that, once configured (with a supported [brownie network](https://eth-brownie.readthedocs.io/en/stable/network-management.html) and [Docker](https://www.docker.com/get-started/)), continuously captures financial snapshots at set intervals.
+- **Custom Buckets for Wallets:** Assign custom categories ("buckets") to specific wallet addresses for more granular reporting using the `--custom-bucket` CLI option.
 - **Ease of Contribution:** Non-technical users can easily update or create dashboard visuals using Grafana’s intuitive UI. The [Contributing Guidelines](https://github.com/BobTheBuidler/dao-treasury/blob/master/CONTRIBUTING.md) document provides a step-by-step guide to defining new visuals and dashboards and integrating those changes into the repository, ensuring that anyone can contribute to the visual reporting aspect of the project.
 
 ## Requirements
@@ -41,7 +42,7 @@ DAO Treasury is a comprehensive financial reporting and treasury management solu
 - First, you will need to bring your own archive node. This can be one you run yourself, or one from one of the common providers (Tenderly, Alchemy, QuickNode, etc.). Your archive node must have tracing enabled (free-tier Alchemy nodes do not support this option).
 - You must configure a [brownie network](https://eth-brownie.readthedocs.io/en/stable/network-management.html) to use your RPC.
 - You will need an auth token for [Etherscan](https://etherscan.io/)'s API. Follow their [guide](https://docs.etherscan.io/etherscan-v2/getting-an-api-key) to get your key, and set env var `ETHERSCAN_TOKEN` with its value.
-- You'll also need [Docker](https://www.docker.com/get-started/) installed on your system. If on MacOS, you will need to leave Docker Desktop open while Yearn Treasury is running.
+- You'll also need [Docker](https://www.docker.com/get-started/) installed on your system. If on MacOS, you will need to leave Docker Desktop open while DAO Treasury is running.
 
 ## Installation
 
@@ -63,14 +64,28 @@ For local development (from source installation), use:
 poetry run dao-treasury run --wallet 0x123 --network mainnet --interval 12h
 ```
 
+**Assigning Custom Buckets to Wallets:**
+
+You can assign custom categories ("buckets") to specific wallet addresses for more granular reporting. Use the `--custom-bucket` option one or more times, each with the format `address:bucket_name`:
+
+```bash
+dao-treasury run --wallet 0x123 --network mainnet --custom-bucket "0x123:Operations" --custom-bucket "0x456:Grants" --custom-bucket "0x789:Investments"
+```
+
 **CLI Options:**
+> Only optional arguments are listed here. Required arguments (such as `--wallet` or `--wallets`) are shown in the usage examples above.
+
 - `--network`: The id of the brownie network the exporter will connect to (default: mainnet)
 - `--interval`: The time interval between each data snapshot (default: 12h)
+- `--concurrency`: The max number of historical blocks to export concurrently. (default: 30)
 - `--daemon`: Run the export process in the background (default: False) (NOTE: currently unsupported)
+- `--sort-rules`: Directory containing sort rules definitions for transaction categorization.
+- `--nicknames`: File containing address nicknames for reporting.
 - `--grafana-port`: Set the port for the Grafana dashboard where you can view data (default: 3004)
 - `--renderer-port`: Set the port for the report rendering service (default: 8091)
 - `--victoria-port`: Set the port for the Victoria metrics reporting endpoint (default: 8430)
 - `--start-renderer`: If set, both the Grafana and renderer containers will be started for dashboard image export. By default, only the grafana container is started.
+- `--custom-bucket`: Assign a custom bucket/category to a wallet address for reporting. Specify as `address:bucket_name`. Can be used multiple times.
 
 After running the command, the export script will run continuously until you close your terminal.
 To view the dashboards, just open your browser and navigate to [http://localhost:3004](http://localhost:3004)!

dao_treasury-0.0.70.dist-info/RECORD

@@ -0,0 +1,54 @@
+dao_treasury__mypyc.cp310-win32.pyd,sha256=4C-azMTuC8iUJ6EOP9OtfTPHdW_yr108bBUFmi_9R98,394752
+dao_treasury/ENVIRONMENT_VARIABLES.py,sha256=LS_D4ALB3BO-vYKyh1tzRHi10QBE6f654Zy8pmJ_xPY,656
+dao_treasury/__init__.py,sha256=ai8iALE_Zv43O9cH1jkNJ39bzhr60kBDX6L7C4Nj9FA,1539
+dao_treasury/_docker.cp310-win32.pyd,sha256=6K5ZsCE2V6B1leINcOQcm__0NTJRmRfNUQEe0UzeDC8,9216
+dao_treasury/_docker.py,sha256=Rki3eLKOmsNxN3nF-gmbM9UQV49SY7ToEHZboL_HYvA,6118
+dao_treasury/_nicknames.cp310-win32.pyd,sha256=XJPKnwMCnZV7Uw5HoyxltqG_y1FufA8vBHN94eGZ0IM,9216
+dao_treasury/_nicknames.py,sha256=n8c-JZhORYymCMv6jsC96IthAzAhpslyEn-KCk_YiSM,1049
+dao_treasury/_wallet.cp310-win32.pyd,sha256=hyIuUsq5TigPuExkYUQC7-HX6GC5eUM5KdiZRDILcdg,9216
+dao_treasury/_wallet.py,sha256=nHBAKFJstdKuYbvpskGVx2KU80YrZHGHsEh5V3TwIHs,10712
+dao_treasury/constants.cp310-win32.pyd,sha256=JT0bIUBainnd_-Jpz1jCoWDvQ1aevr9Al-rO1ZJiN5s,9216
+dao_treasury/constants.py,sha256=-T0oPw7lC5YeaiplHAtYL-2ss7knvKrJKQ1LCc8kX8g,1483
+dao_treasury/db.py,sha256=4Vc_U3mmrG8hOpsuDcgCQQuwGyL3pyfYH2jjktDXx48,50734
+dao_treasury/docker-compose.yaml,sha256=wNNE9xmkchcV-nJxzrmUkbUA0CW1qgdGQKJ7uw2P8nU,1350
+dao_treasury/main.py,sha256=_Q-Nhn9WJ6alovqxt8Aa2X24-cxPgH4b25ulj0mEygs,9611
+dao_treasury/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dao_treasury/treasury.py,sha256=K4XOg-5BHoP5HoRlHNu4afNpYs2-8sjCOOGwdt3M21w,7541
+dao_treasury/types.cp310-win32.pyd,sha256=a5wq7uL9_oMtUQ2otd6U8CqrczuW6blPm0chjH1s-Aw,9216
+dao_treasury/types.py,sha256=KFz4WKPp4t_RBwIT6YGwOcgbzw8tdHIOcXTFsUA0pJA,3818
+dao_treasury/.grafana/provisioning/dashboards/dashboards.yaml,sha256=to_cVfl8X6-5zVskkDxNtTE191TH52XO2peGfHPI5F0,201
+dao_treasury/.grafana/provisioning/dashboards/breakdowns/Expenses.json,sha256=seX4E48q7XTIDYTzwiZzDR_n-vii-MqfT8MJ4mIhpUc,19964
+dao_treasury/.grafana/provisioning/dashboards/breakdowns/Revenue.json,sha256=tdHBpE0gMk3tcVyT2rP4eMNUbTs5c98zjv_hPlMvhmM,19171
+dao_treasury/.grafana/provisioning/dashboards/streams/LlamaPay.json,sha256=rQ3-eFc9vk4AzQfwG5d1NlonyPTlHuBQfr-IdlAI-QE,7724
+dao_treasury/.grafana/provisioning/dashboards/summary/Monthly.json,sha256=6a-1pkN8yK1wk0imR6C0InYalgh2fEeCVjFdZClpmRw,10998
+dao_treasury/.grafana/provisioning/dashboards/transactions/Treasury Transactions.json,sha256=uDwsIgrHJoR5yp7177IpMXExp8o-vMQBMN9bzxzNI18,15064
+dao_treasury/.grafana/provisioning/dashboards/treasury/Cashflow (Including Unsorted).json,sha256=tzg4DcF5mFMvhveq6cfgB9CJWivxvbeN1Bo8L0ngx-I,28154
+dao_treasury/.grafana/provisioning/dashboards/treasury/Cashflow.json,sha256=DpAoMqDRo6xhn-QDT0tCCqk1yO6z5qQBMvOC8oXlViA,20239
+dao_treasury/.grafana/provisioning/dashboards/treasury/Current Treasury Assets.json,sha256=HCzFfESFmLruuKxMKOatkoFcHXgx90dnyuFgHmcocKk,26281
+dao_treasury/.grafana/provisioning/dashboards/treasury/Historical Treasury Balances.json,sha256=K8zqxPFlvde9lhopzvox-CM52rLP0lzZMATi7EcPOJ0,107548
+dao_treasury/.grafana/provisioning/dashboards/treasury/Operating Cashflow.json,sha256=KFmBbIdiiFdgc0qmQDbK_YAIn2b10H_e5K_3hifHWoM,15949
+dao_treasury/.grafana/provisioning/datasources/datasources.yaml,sha256=gLmJsOkEXNzWRDibShfHFySWeuExW-dSB_U0OSfH868,344
+dao_treasury/sorting/__init__.cp310-win32.pyd,sha256=rvdijFRKdAOFOiKkNRNcHp2pJW85ZoBP_cgKRwMCb-k,9216
+dao_treasury/sorting/__init__.py,sha256=_uxM_FE1paM8oDAhDdHSyhDwnrlxCYX_lGn2DOqCaHU,10666
+dao_treasury/sorting/_matchers.cp310-win32.pyd,sha256=9-45uc_UOwq2QRY3q3K2H935nCFhVuzijBhoEdbtcLk,9216
+dao_treasury/sorting/_matchers.py,sha256=ACi6aXZCKW5OTiztsID7CXCGJounj5c6ivhOCg2436M,14392
+dao_treasury/sorting/_rules.cp310-win32.pyd,sha256=i9BaLlavF33YNX2XwV5w_ibkzk6JHQNPeysokH9aZjM,9216
+dao_treasury/sorting/_rules.py,sha256=DxhdUgpS0q0LWeLl9W1Bjn5LZz9z4OLA03vQllPMH9k,9229
+dao_treasury/sorting/factory.cp310-win32.pyd,sha256=yN8WMppiPrxMBkddZuQEgE-pFqqKak77IgjsdpSVPNA,9216
+dao_treasury/sorting/factory.py,sha256=zlJ18xlMTxv8ACV6_MimCVIDsw3K5AZcyvKaNYY7R14,10484
+dao_treasury/sorting/rule.cp310-win32.pyd,sha256=yC7NHHTE2nGK69fFcA84i_AP_2bkDBFUmOrpTZdzIvM,9216
+dao_treasury/sorting/rule.py,sha256=wbL8s0-6dxcCKghUtEDSkLDBnyvggsJ3gt_RawQ6kB4,11972
+dao_treasury/sorting/rules/__init__.cp310-win32.pyd,sha256=fGqpAit9xppQYcjbKQTGW0LIhKCc4GhklJ3lrR-Irpc,9216
+dao_treasury/sorting/rules/__init__.py,sha256=hcLfejOEwD8RaM2RE-38Ej6_WkvL9BVGvIIGY848E6E,49
+dao_treasury/sorting/rules/ignore/__init__.cp310-win32.pyd,sha256=7f-jf8buVZL1vaOVDVk4XkJjVQW0xX5NKLjUdCqGBg0,9216
+dao_treasury/sorting/rules/ignore/__init__.py,sha256=16THKoGdj6qfkkytuCFVG_R1M6KSErMI4AVE1p0ukS4,58
+dao_treasury/sorting/rules/ignore/llamapay.cp310-win32.pyd,sha256=8PHU_ivt2-h6r2-tm9eqjQdSJWSNXVDeQsjOZZZP_PQ,9216
+dao_treasury/sorting/rules/ignore/llamapay.py,sha256=aYyAJRlmv419IeaqkcV5o3ffx0UVfteU0lTl80j0BGo,783
+dao_treasury/streams/__init__.cp310-win32.pyd,sha256=NaDQ4XjlkjKnV_zemyYHrSy7Ww5wlH-6Pp37uywELOM,9216
+dao_treasury/streams/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dao_treasury/streams/llamapay.cp310-win32.pyd,sha256=PbtMpLZkYCd4BKNDD1zhkJIcOK6iV_tpESreUkcRnOU,9216
+dao_treasury/streams/llamapay.py,sha256=rO1Mh2ndTziR6pnRkKHnQ22a_Yx9PM_-BG7I4dspEZ8,13535
+dao_treasury-0.0.70.dist-info/METADATA,sha256=zNKm5xmiLAurcHuLj1sct6NXQUprw7GXqsgGgrmq8Gk,8267
+dao_treasury-0.0.70.dist-info/WHEEL,sha256=GWZF0cboiU4MhsG0baPl8rrtCaXFSLW25384gp3vddM,97
+dao_treasury-0.0.70.dist-info/top_level.txt,sha256=CV8aYytuSYplDhLVY4n0GphckdysXCd1lHmbqfsPxNk,33
+dao_treasury-0.0.70.dist-info/RECORD,,

dao_treasury-0.0.70.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+dao_treasury
+dao_treasury__mypyc