1. Program Configurations

Program Configurations

Overview

The configuration system in WalletWave allows users to customize the behavior of the program by editing config.yaml file or passing command-line arguments. These configurations control how the program scans for wallets, processes data, and outputs results

Default Configuration File: config.yaml

The config.yaml file is located in:

src/WalletWave/config.yaml

Structure

Below is an example structure of the config.yaml file:

program_settings:
  #### Path to export wallet data
  export_path: "data"

  #### Export settings
  # csv or txt
  export_format: "csv"

  # set True if you want results to be exported to a file
  # set False if you don't want results to be exported
  export_enabled: True

  #### Logging setting
  logging_level: "INFO" # Options: DEBUG, INFO, WARNING

plugin_settings:
  #### Wallet Search settings
  # timeframe options - 1d, 7d, 30d
  #
  # wallet tags options -
  #   all = all tags
  #   pump_smart = Pump.Fun Smart Money
  #   smart_degen = Smart Money (default)
  #   reowned = KOL/VC/Influencer
  #   snipe_bot = Snipe Bot
  #
  # winrate - set 0 to 100 (default is 60)

  TopWallets:
    timeframe: "7d"
    wallet_tag: "smart_degen"
    win_rate: 80

  SolanaWalletScanner:
    timeframe: "7d"

Command-Line Arguments

Users can override the config.yaml settings via command-line arguments

Argument	Type	Default	Description
--config	String	config.yaml	Path to the configuration file.
--path	String	data	Output path for exported files.
--export-format	String	csv	Output format (csv or txt).
--timeframe	String	7d	Wallet scan timeframe (1d, 7d, or 30d).
--winrate	Integer	60	Minimum win rate for wallet filtering.

Configuration Hierarchy

1. Command-Line Arguments

• Command-Line args take precedence over the config file
• Example: walletwave --export_path "custom_folder" --export-format csv

2. Configuration File (config.yaml):

• Provides default settings and loaded automatically if no command-line arguments are supplied