dao-treasury 0.0.35__cp311-cp311-win_amd64.whl → 0.1.1__cp311-cp311-win_amd64.whl

dao_treasury/docker-compose.yaml

@@ -3,9 +3,12 @@ networks:
   docker_eth_portfolio:
     external: true
 
+volumes:
+  dao_treasury_pgdata:
+
 services:
   grafana:
-    image: grafana/grafana:10.2.0
+    image: grafana/grafana:12.2.1
     ports:
       - 127.0.0.1:${DAO_TREASURY_GRAFANA_PORT:-3004}:3000
     environment:
@@ -18,9 +21,8 @@ services:
       - GF_RENDERING_SERVER_URL=http://renderer:8091/render
       - GF_RENDERING_CALLBACK_URL=http://grafana:3000/
       - GF_LOG_FILTERS=rendering:debug
-      - GF_INSTALL_PLUGINS=volkovlabs-variable-panel,frser-sqlite-datasource
+      - GF_INSTALL_PLUGINS=volkovlabs-variable-panel
     volumes:
-      - ~/.dao-treasury/:/app/dao-treasury-data
       - ./.grafana/provisioning/:/etc/grafana/provisioning/
     networks:
       - dao_treasury
@@ -39,3 +41,17 @@ services:
       - dao_treasury
       - docker_eth_portfolio
     restart: always
+
+  postgres:
+    image: postgres:18
+    restart: always
+    environment:
+      POSTGRES_USER: dao_treasury
+      POSTGRES_PASSWORD: dao_treasury
+      POSTGRES_DB: dao_treasury
+    volumes:
+      - dao_treasury_pgdata:/var/lib/postgresql
+    ports:
+      - 127.0.0.1:${DAO_TREASURY_POSTGRES_PORT:-8675}:5432
+    networks:
+      - dao_treasury

dao_treasury/main.py

@@ -2,7 +2,7 @@
 
 This module parses command-line arguments, sets up environment variables for
 Grafana and its renderer, and defines the entrypoint for a one-time export of
-DAO treasury transactions. It populates the local SQLite database and starts
+DAO treasury transactions. It populates the local PostgreSQL database and starts
 the required Docker services for Grafana dashboards. Transactions are fetched
 via :class:`dao_treasury.Treasury`, sorted according to optional rules, and
 inserted using the database routines (:func:`dao_treasury.db.TreasuryTx.insert`).
@@ -29,6 +29,7 @@ from pathlib import Path
 import brownie
 import yaml
 from a_sync import create_task
+from dao_treasury._nicknames import setup_address_nicknames_in_db
 from dao_treasury._wallet import load_wallets_from_yaml
 from eth_portfolio_scripts.balances import export_balances
 from eth_typing import BlockNumber
@@ -97,6 +98,12 @@ parser.add_argument(
     help="The time interval between datapoints. default: 1d",
     default="1d",
 )
+parser.add_argument(
+    "--concurrency",
+    type=int,
+    help="The max number of historical blocks to export concurrently. default: 30",
+    default=30,
+)
 parser.add_argument(
     "--daemon",
     action="store_true",
@@ -119,6 +126,18 @@ parser.add_argument(
     help="Port for the Grafana rendering service. Default: 8091",
     default=8091,
 )
+parser.add_argument(
+    "--custom-bucket",
+    type=str,
+    action="append",
+    help=(
+        "Custom bucket mapping for a wallet address. "
+        "Specify as 'address:bucket_name'. "
+        "Can be used multiple times. Example: "
+        "--custom-bucket '0x123:My Bucket' --custom-bucket '0x456:Other Bucket'"
+    ),
+    default=None,
+)
 
 args = parser.parse_args()
 
@@ -203,13 +222,35 @@ async def export(args) -> None:
             for address in addresses:
                 db.Address.set_nickname(address, nickname)
 
-    treasury = Treasury(wallets, args.sort_rules, asynchronous=True)
+    # Parse custom_buckets from --custom-bucket arguments
+    custom_buckets = None
+    if args.custom_bucket:
+        custom_buckets = {}
+        for item in args.custom_bucket:
+            if ":" not in item:
+                parser.error(
+                    f"Invalid format for --custom-bucket: '{item}'. Must be 'address:bucket_name'."
+                )
+            address, bucket = item.split(":", 1)
+            address = address.strip()
+            bucket = bucket.strip()
+            if not address or not bucket:
+                parser.error(
+                    f"Invalid format for --custom-bucket: '{item}'. Both address and bucket_name are required."
+                )
+            custom_buckets[address] = bucket
+
+    treasury = Treasury(
+        wallets, args.sort_rules, custom_buckets=custom_buckets, asynchronous=True
+    )
 
     # Start only the requested containers
     if args.start_renderer is True:
         _docker.up()
     else:
-        _docker.up("grafana")
+        _docker.up("grafana", "postgres")
+
+    setup_address_nicknames_in_db()
 
     # eth-portfolio needs this present
     # TODO: we need to update eth-portfolio to honor wallet join and exit times

dao_treasury/sorting/__init__.py

@@ -88,13 +88,8 @@ __all__ = [
 
 # C constants
 TxGroup: Final = db.TxGroup
-MUST_SORT_INBOUND_TXGROUP_DBID: Final = db.must_sort_inbound_txgroup_dbid
-MUST_SORT_OUTBOUND_TXGROUP_DBID: Final = db.must_sort_outbound_txgroup_dbid
 
-INTERNAL_TRANSFER_TXGROUP_DBID: Final = TxGroup.get_dbid(
-    name="Internal Transfer",
-    parent=TxGroup.get_dbid("Ignore"),
-)
+INTERNAL_TRANSFER_TXGROUP_DBID: int | None = None
 """Database ID for the 'Internal Transfer' transaction group.
 
 This group represents transactions that occur internally between treasury-owned wallets.
@@ -104,9 +99,7 @@ See Also:
     :class:`dao_treasury.db.TxGroup`
 """
 
-OUT_OF_RANGE_TXGROUP_DBID = TxGroup.get_dbid(
-    name="Out of Range", parent=TxGroup.get_dbid("Ignore")
-)
+OUT_OF_RANGE_TXGROUP_DBID: int | None = None
 """Database ID for the 'Out of Range' transaction group.
 
 This category is assigned to transactions where neither the sender nor the recipient
@@ -143,6 +136,9 @@ def sort_basic(entry: LedgerEntry) -> TxGroupDbid:
         :func:`sort_advanced`
         :class:`dao_treasury.sorting.HashMatcher`
     """
+    global INTERNAL_TRANSFER_TXGROUP_DBID
+    global OUT_OF_RANGE_TXGROUP_DBID
+
     from_address = entry.from_address
     to_address = entry.to_address
     block = entry.block_number
@@ -150,8 +146,17 @@ def sort_basic(entry: LedgerEntry) -> TxGroupDbid:
     txgroup_dbid: Optional[TxGroupDbid] = None
     if TreasuryWallet.check_membership(from_address, block):
         if TreasuryWallet.check_membership(to_address, block):
+            if INTERNAL_TRANSFER_TXGROUP_DBID is None:
+                INTERNAL_TRANSFER_TXGROUP_DBID = TxGroup.get_dbid(
+                    name="Internal Transfer",
+                    parent=TxGroup.get_dbid("Ignore"),
+                )
             txgroup_dbid = INTERNAL_TRANSFER_TXGROUP_DBID
     elif not TreasuryWallet.check_membership(to_address, block):
+        if OUT_OF_RANGE_TXGROUP_DBID is None:
+            OUT_OF_RANGE_TXGROUP_DBID = TxGroup.get_dbid(
+                name="Out of Range", parent=TxGroup.get_dbid("Ignore")
+            )
         txgroup_dbid = OUT_OF_RANGE_TXGROUP_DBID
 
     if txgroup_dbid is None:
@@ -167,10 +172,10 @@ def sort_basic(entry: LedgerEntry) -> TxGroupDbid:
 
     if txgroup_dbid is None:
         if TreasuryWallet.check_membership(from_address, block):
-            txgroup_dbid = MUST_SORT_OUTBOUND_TXGROUP_DBID
+            txgroup_dbid = db.must_sort_outbound_txgroup_dbid
 
         elif TreasuryWallet.check_membership(to_address, block):
-            txgroup_dbid = MUST_SORT_INBOUND_TXGROUP_DBID
+            txgroup_dbid = db.must_sort_inbound_txgroup_dbid
 
         else:
             raise NotImplementedError("this isnt supposed to happen")
@@ -197,6 +202,9 @@ def sort_basic_entity(tx: db.TreasuryTx) -> TxGroupDbid:
         :func:`sort_basic`
         :func:`sort_advanced`
     """
+    global INTERNAL_TRANSFER_TXGROUP_DBID
+    global OUT_OF_RANGE_TXGROUP_DBID
+
     from_address = tx.from_address.address
     to_address = tx.to_address
     block = tx.block
@@ -204,11 +212,20 @@ def sort_basic_entity(tx: db.TreasuryTx) -> TxGroupDbid:
     txgroup_dbid: Optional[TxGroupDbid] = None
     if TreasuryWallet.check_membership(from_address, block):
         if TreasuryWallet.check_membership(tx.to_address.address, block):
+            if INTERNAL_TRANSFER_TXGROUP_DBID is None:
+                INTERNAL_TRANSFER_TXGROUP_DBID = TxGroup.get_dbid(
+                    name="Internal Transfer",
+                    parent=TxGroup.get_dbid("Ignore"),
+                )
             txgroup_dbid = INTERNAL_TRANSFER_TXGROUP_DBID
     elif not (
         TreasuryWallet.check_membership(tx.to_address.address, tx.block)
         or from_address in constants.DISPERSE_APP
     ):
+        if OUT_OF_RANGE_TXGROUP_DBID is None:
+            OUT_OF_RANGE_TXGROUP_DBID = TxGroup.get_dbid(
+                name="Out of Range", parent=TxGroup.get_dbid("Ignore")
+            )
         txgroup_dbid = OUT_OF_RANGE_TXGROUP_DBID
 
     if txgroup_dbid is None:
@@ -222,23 +239,23 @@ def sort_basic_entity(tx: db.TreasuryTx) -> TxGroupDbid:
 
     if txgroup_dbid is None:
         if TreasuryWallet.check_membership(from_address, block):
-            txgroup_dbid = MUST_SORT_OUTBOUND_TXGROUP_DBID
+            txgroup_dbid = db.must_sort_outbound_txgroup_dbid
 
         elif TreasuryWallet.check_membership(to_address.address, block):
-            txgroup_dbid = MUST_SORT_INBOUND_TXGROUP_DBID
+            txgroup_dbid = db.must_sort_inbound_txgroup_dbid
 
         elif from_address in constants.DISPERSE_APP:
-            txgroup_dbid = MUST_SORT_OUTBOUND_TXGROUP_DBID
+            txgroup_dbid = db.must_sort_outbound_txgroup_dbid
 
         elif from_address in constants.DISPERSE_APP:
-            txgroup_dbid = MUST_SORT_OUTBOUND_TXGROUP_DBID
+            txgroup_dbid = db.must_sort_outbound_txgroup_dbid
 
         else:
             raise NotImplementedError("this isnt supposed to happen")
 
     if txgroup_dbid not in (
-        MUST_SORT_INBOUND_TXGROUP_DBID,
-        MUST_SORT_OUTBOUND_TXGROUP_DBID,
+        db.must_sort_inbound_txgroup_dbid,
+        db.must_sort_outbound_txgroup_dbid,
     ):
         logger.info("Sorted %s to %s", tx, TxGroup.get_fullname(txgroup_dbid))
 
@@ -274,8 +291,8 @@ async def sort_advanced(entry: db.TreasuryTx) -> TxGroupDbid:
     txgroup_dbid = sort_basic_entity(entry)
 
     if txgroup_dbid in (
-        MUST_SORT_INBOUND_TXGROUP_DBID,
-        MUST_SORT_OUTBOUND_TXGROUP_DBID,
+        db.must_sort_inbound_txgroup_dbid,
+        db.must_sort_outbound_txgroup_dbid,
     ):
         for rules in SORT_RULES.values():
             for rule in rules:
@@ -286,8 +303,8 @@ async def sort_advanced(entry: db.TreasuryTx) -> TxGroupDbid:
                 except ContractNotVerified:
                     continue
     if txgroup_dbid not in (
-        MUST_SORT_INBOUND_TXGROUP_DBID,
-        MUST_SORT_OUTBOUND_TXGROUP_DBID,
+        db.must_sort_inbound_txgroup_dbid,
+        db.must_sort_outbound_txgroup_dbid,
     ):
         logger.info("Sorted %s to %s", entry, TxGroup.get_fullname(txgroup_dbid))
         await entry._set_txgroup(txgroup_dbid)

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/streams/llamapay.py

@@ -22,7 +22,7 @@ from eth_typing import BlockNumber, ChecksumAddress, HexAddress, HexStr
 from tqdm.asyncio import tqdm_asyncio
 
 import y
-from y.time import UnixTimestamp
+from y.time import NoBlockFound, UnixTimestamp
 from y.utils.events import decode_logs, get_logs_asap
 
 from dao_treasury import constants
@@ -338,7 +338,19 @@ class LlamaPayProcessor:
         check_at = date_obj + timedelta(days=1) - timedelta(seconds=1)
         if check_at > now(tz=_UTC):
             await sleep((check_at - now(tz=_UTC)).total_seconds())
-        block = await get_block_at_timestamp(check_at, sync=False)
+
+        while True:
+            try:
+                block = await get_block_at_timestamp(check_at, sync=False)
+            except NoBlockFound:
+                sleep_time = (check_at - now(tz=_UTC)).total_seconds()
+                logger.debug(
+                    "no block found for %s, sleeping %ss", check_at, sleep_time
+                )
+                await sleep(sleep_time)
+            else:
+                break
+
         price_fut = create_task(get_price(stream_token, block, sync=False))
         start_timestamp = await _get_start_timestamp(stream_id, block)
         if start_timestamp == 0:

dao_treasury/treasury.py

@@ -1,11 +1,28 @@
+"""Treasury orchestration and analytics interface.
+
+This module defines the Treasury class, which aggregates DAO wallets, sets up
+sorting rules, and manages transaction ingestion and streaming analytics.
+It coordinates the end-to-end flow from wallet configuration to database
+population and dashboard analytics.
+
+Key Responsibilities:
+    - Aggregate and manage DAO-controlled wallets.
+    - Ingest and process on-chain transactions.
+    - Apply sorting/categorization rules.
+    - Integrate with streaming protocols (e.g., LlamaPay).
+    - Populate the database for analytics and dashboards.
+
+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
@@ -35,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.
@@ -59,20 +77,22 @@ class Treasury(a_sync.ASyncGenericBase):  # type: ignore [misc]
             TypeError: If any item in `wallets` is not a str or TreasuryWallet.
 
         Examples:
-            Create a synchronous Treasury:
-            >>> treasury = Treasury(
-            ...     wallets=["0xAbc123...", TreasuryWallet("0xDef456...", start_block=1000)],
-            ...     sort_rules=Path("/path/to/rules"),
-            ...     start_block=500,
-            ...     label="DAO Treasury",
-            ...     asynchronous=False
-            ... )
-
-            Create an asynchronous Treasury:
-            >>> treasury_async = Treasury(
-            ...     wallets=["0xAbc123..."],
-            ...     asynchronous=True
-            ... )
+            .. code-block:: python
+
+                # Create a synchronous Treasury
+                treasury = Treasury(
+                    wallets=["0xAbc123...", TreasuryWallet("0xDef456...", start_block=1000)],
+                    sort_rules=Path("/path/to/rules"),
+                    start_block=500,
+                    label="DAO Treasury",
+                    asynchronous=False
+                )
+
+                # Create an asynchronous Treasury
+                treasury_async = Treasury(
+                    wallets=["0xAbc123..."],
+                    asynchronous=True
+                )
         """
         global TREASURY
         if TREASURY is not None:
@@ -105,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.35.dist-info → dao_treasury-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dao_treasury
-Version: 0.0.35
+Version: 0.1.1
 Summary: Produce comprehensive financial reports for your on-chain org
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -14,7 +14,8 @@ 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.30.dev0
+Requires-Dist: eth-portfolio-temp==0.3.2
+Requires-Dist: psycopg2-binary==2.9.11
 Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
@@ -29,6 +30,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 +43,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 +65,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.1.1.dist-info/RECORD

@@ -0,0 +1,53 @@
+dao_treasury__mypyc.cp311-win_amd64.pyd,sha256=EgbH2bP9FGZEWLznZ58naiEBC2wdcoK92hcAkaK4tgc,279552
+dao_treasury/ENVIRONMENT_VARIABLES.py,sha256=LS_D4ALB3BO-vYKyh1tzRHi10QBE6f654Zy8pmJ_xPY,656
+dao_treasury/__init__.py,sha256=fEHZYMeNqVUI9YAVXCHozxDB7cvJJnaF4HBRyeAlOiw,1435
+dao_treasury/_docker.cp311-win_amd64.pyd,sha256=xV1vXf4k0Y1UpJ6T0gZCPG0zAXY9Yz8Mb6yGEh5rKZk,10752
+dao_treasury/_docker.py,sha256=yAMcwXl48hGPN2sH5b56O_XP3wrd1gap959Xrk8KpKM,6337
+dao_treasury/_nicknames.cp311-win_amd64.pyd,sha256=vWALUm21t1Z0aSs2aSAOXaItPZWghXYpfKlmr88Zb3k,10752
+dao_treasury/_nicknames.py,sha256=4Smlv4y5248PM-yDEyybbR1Of1-tIHgf0PCBAXTE3Aw,1071
+dao_treasury/_wallet.cp311-win_amd64.pyd,sha256=xqt3Fl8cMmttAxP75ysWjLFr4OJ_O7keT9QOy4NC6FI,10752
+dao_treasury/_wallet.py,sha256=nHBAKFJstdKuYbvpskGVx2KU80YrZHGHsEh5V3TwIHs,10712
+dao_treasury/constants.cp311-win_amd64.pyd,sha256=8TqggPTdOS0Q6m5HRHKPBWrMXKALR3VcaAhJ3przuwo,10752
+dao_treasury/constants.py,sha256=-T0oPw7lC5YeaiplHAtYL-2ss7knvKrJKQ1LCc8kX8g,1483
+dao_treasury/db.py,sha256=5-S8Ax2Buwhfg8Mo9Jad1hbn7hrbWj_r6HgCzgCmsZg,59827
+dao_treasury/docker-compose.yaml,sha256=Javd6LIxF2nOpKWRsDYe-VVWBjMGprsXyUK4DGaLLO8,1670
+dao_treasury/main.py,sha256=THzDHwJQPbLXUpHqbiCncQeqpvKQUz6ae63frX5LlzU,9733
+dao_treasury/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dao_treasury/treasury.py,sha256=K4XOg-5BHoP5HoRlHNu4afNpYs2-8sjCOOGwdt3M21w,7541
+dao_treasury/types.cp311-win_amd64.pyd,sha256=j3AKrqWkPJ0r7-LHv8OEmkpD1_bH2qOQELzhQPy5N6Q,10752
+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=aBwKDj5HBkSXlSt5L7Cg_Ce5yK0VaRKAWVe19j-HCgQ,17809
+dao_treasury/.grafana/provisioning/dashboards/breakdowns/Revenue.json,sha256=xzvFemq3hYoXdoOafspsuCU8jHCbC2JOtgOq_a_aFPU,17517
+dao_treasury/.grafana/provisioning/dashboards/streams/LlamaPay.json,sha256=ukfBKgqIF7I43Lv8SfEnLrrYqCmRQbmSiumwd2h1a8A,6657
+dao_treasury/.grafana/provisioning/dashboards/summary/Monthly.json,sha256=KMGAaagwRWBHw3IN4NljCUIIOwu-3Gp0VSnkMzDrcO4,12708
+dao_treasury/.grafana/provisioning/dashboards/transactions/Treasury Transactions.json,sha256=lRPynOn4Zy6WpZLz8-Px2kjflZLRcT8TA6VIz-_VGNM,13815
+dao_treasury/.grafana/provisioning/dashboards/transactions/Unsorted Transactions.json,sha256=cBY3EqFpf9F7B8TaM9yESQatBpe4yFFmyLAiZEul_IE,19107
+dao_treasury/.grafana/provisioning/dashboards/treasury/Cashflow (Including Unsorted).json,sha256=k6hU_pZTmaWd2bYP8762yF_WoqR0PlVuoyiVgfrfwoM,24542
+dao_treasury/.grafana/provisioning/dashboards/treasury/Cashflow.json,sha256=GZmgROCKfRQnCV7TP_yBJZRFdPy3TsTs6d6GNilqyP8,17829
+dao_treasury/.grafana/provisioning/dashboards/treasury/Current Treasury Assets.json,sha256=4tsEWzkBM9eQVNnDECM9lGOO26mvcFJofltY-QDfU2M,25112
+dao_treasury/.grafana/provisioning/dashboards/treasury/Historical Treasury Balances.json,sha256=53fCotzJSElELRS1ABNkXX0_CG1_gBLHpjOthhYTDnw,136157
+dao_treasury/.grafana/provisioning/dashboards/treasury/Operating Cashflow.json,sha256=78QjkFAWl6ySUvLvpbDt0OE-WzL2hg_qC_YLYOq_faY,14155
+dao_treasury/.grafana/provisioning/datasources/datasources.yaml,sha256=TGuZ9h4aHsDkDW39aSjoy9HZYwvht7zX_0oosAGdE98,427
+dao_treasury/sorting/__init__.cp311-win_amd64.pyd,sha256=K0OwfCF8aRJ2cPq5t4cTYbD1TLvlHkOnidUAdVa__is,10752
+dao_treasury/sorting/__init__.py,sha256=z3Bd2HUZjilZfV1cWSHUHagAPEPGyI0S8h6DtBf6w78,11448
+dao_treasury/sorting/_matchers.cp311-win_amd64.pyd,sha256=Jf3u9eQTe3i3hw2RA7e29LNlZIqijhLOVfy_bweNh1k,10752
+dao_treasury/sorting/_matchers.py,sha256=ACi6aXZCKW5OTiztsID7CXCGJounj5c6ivhOCg2436M,14392
+dao_treasury/sorting/_rules.cp311-win_amd64.pyd,sha256=jsRhrWLOhe10xwle2cg-GUMPCF8E0sHt0iBg10udFFY,10752
+dao_treasury/sorting/_rules.py,sha256=DxhdUgpS0q0LWeLl9W1Bjn5LZz9z4OLA03vQllPMH9k,9229
+dao_treasury/sorting/factory.cp311-win_amd64.pyd,sha256=i98SUhA_kb7wyYOqghKyLa1mWgBv0lXPAM0YojZyDjU,10752
+dao_treasury/sorting/factory.py,sha256=zlJ18xlMTxv8ACV6_MimCVIDsw3K5AZcyvKaNYY7R14,10484
+dao_treasury/sorting/rule.cp311-win_amd64.pyd,sha256=_S3RF2vIzjsDe7V330EZK7eKt7C8JBB464eMpmphHmI,10752
+dao_treasury/sorting/rule.py,sha256=wbL8s0-6dxcCKghUtEDSkLDBnyvggsJ3gt_RawQ6kB4,11972
+dao_treasury/sorting/rules/__init__.cp311-win_amd64.pyd,sha256=KEH83Ia6RAmo1Phl5zQedQKEd5KqEfKmKlLXWjOaJsM,10752
+dao_treasury/sorting/rules/__init__.py,sha256=hcLfejOEwD8RaM2RE-38Ej6_WkvL9BVGvIIGY848E6E,49
+dao_treasury/sorting/rules/ignore/__init__.cp311-win_amd64.pyd,sha256=TUcCLsbINFEULPu-LttiHbWLwC_xOXbXvAryu2nAgmM,10752
+dao_treasury/sorting/rules/ignore/__init__.py,sha256=16THKoGdj6qfkkytuCFVG_R1M6KSErMI4AVE1p0ukS4,58
+dao_treasury/sorting/rules/ignore/llamapay.cp311-win_amd64.pyd,sha256=vmHBl6ISIERhg-svL_on-2re5DU2UH-idfrBQ78wEpg,10752
+dao_treasury/sorting/rules/ignore/llamapay.py,sha256=aYyAJRlmv419IeaqkcV5o3ffx0UVfteU0lTl80j0BGo,783
+dao_treasury/streams/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dao_treasury/streams/llamapay.py,sha256=rO1Mh2ndTziR6pnRkKHnQ22a_Yx9PM_-BG7I4dspEZ8,13535
+dao_treasury-0.1.1.dist-info/METADATA,sha256=mJmkyOOAPKNQD6_VxkS-TzRCLT9DJtpPVP2xyii3lOA,8306
+dao_treasury-0.1.1.dist-info/WHEEL,sha256=JLOMsP7F5qtkAkINx5UnzbFguf8CqZeraV8o04b0I8I,101
+dao_treasury-0.1.1.dist-info/top_level.txt,sha256=CV8aYytuSYplDhLVY4n0GphckdysXCd1lHmbqfsPxNk,33
+dao_treasury-0.1.1.dist-info/RECORD,,

dao_treasury-0.1.1.dist-info/top_level.txt

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