Specifying Treasury Wallets

The DAO Treasury CLI supports two modes for specifying wallets:

Simple Mode (default)

Use the --wallet flag to list one or more wallet addresses. Example:

dao-treasury --wallet 0xABC... 0xDEF...

Advanced Mode

Use the --wallets flag with a path to a YAML file, which will be parsed by load_wallets_from_yaml(). This YAML must map each wallet address to a configuration object using the pattern:

address:
  networks:                # optional list of chain IDs where this wallet is active
    - <chain-id>
    - <chain-id>
  start:
    timestamp: <unix-timestamp>        # universal for all chains
    <chain-id>:
      block: <block-number>           # chain-specific start block
  end:
    timestamp: <unix-timestamp>        # universal for all chains
    <chain-id>:
      block: <block-number>           # chain-specific end block

Only one of timestamp or a chain-specific block may be provided under start or under end.

Example YAML File

0xABCDEF0123456789ABCDEF0123456789ABCDEF01:
  networks:
    - 1
    - 420
  start:
    timestamp: 1600000000
    1:
      block: 1000000
  end:
    timestamp: 1700000000
    1:
      block: 2000000

0x1234567890ABCDEF1234567890ABCDEF12345678:
  start:
    timestamp: 1610000000
  end:
    1:
      block: 2500000

# Bare address entry (default settings, all chains)
0xAAAABBBBCCCCDDDDEEEEFFFF0000111122223333:

Notes

  • The top-level keys are wallet addresses.

  • Use the optional networks key (a list of integer chain IDs) to restrict a wallet to specific chains.

  • Under start or end, use timestamp for a universal timestamp setting.

  • For chain-specific block numbers, use the integer chain ID as a key mapping to a block value.

  • You may specify a bare address key with no nested config to include it with default settings.

  • Use either --wallet or --wallets, but not both.

  • Conflicting settings (e.g., both timestamp and a chain-specific block under the same section) will result in an error.

Once you’ve finished congifuring your DAO’s treasury wallets, the next step is [defining sort rules](https://bobthebuidler.github.io/dao-treasury/sort_rules.html)