Commands

A quick help can be displayed with --help :

./copychain --help

Usage: copychain [OPTIONS] <COMMAND>

Commands:
  copy     Copy other wallets as per config
  monitor  Monitor only, do not send any transaction
  update   Update to the latest version
  help     Print this message or the help of the given subcommand(s)

Options:
  -n, --no-logfile  Do not log to file, only to stdout
  -h, --help        Print help
  -V, --version     Print version

Monitor

You can start with this command and the default configuration Monitor only.

When tracking specific wallets, this command is perfect for:

• Understanding the best strategy to adopt for a specific wallet you're copying.

• Simply checking that everything is working properly (license, config, etc.).

• Monitor a wallet’s profit and loss over time.

Run with:

./copychain monitor copy-config.toml

This will never sends transactions.

This command starts a powerful Text User Interface (TUI):

Navigate through panels, filters rows, see it update live... feel free to try it yourself!

(Deprecated) old interface

The previous and now deprecated view is still available with --no-ui option.

Copy

This command runs the tool in live mode, sending actual transactions:

./copychain copy copy-config.toml

You should see something like:

[INFO ] Starting copychain v0.1.0
[INFO ] License valid (7 days 22 hours left)
[INFO ] Running with wallet xxx, copying [xxx, yyy]
[INFO ]        SOL: 5.523170690
[INFO ]       WSOL: 0.828791392
[INFO ] Starting SOL threshold monitor thread for threshold: 0.1

That means everything is working properly, and the tool is now waiting for transactions to copy.

Automation

When [automation] is enabled in your configuration, the tool will wait for specific filters to determine whether to start or stop copying wallets. In run mode, you can choose to monitor targeted wallets or all wallets.

At each interval (defined per filter), the tool checks every start filter [[automation.filters.start]]. If at least one passes, copying is triggered and the tool begins copying the wallet that matched the filter. CopyChain will then track your performance and evaluate the stop filters [[automation.filters.stop]] to determine if copying should stop.

About filter matching:

• Each filter has mandatory interval and lookback_window parameters. This means that every interval seconds, the tool checks the last lookback_window seconds of statistics.

• Filters are evaluated using OR logic: at least one must pass to trigger a start or stop.

• Within a filter, parameters (e.g. min_tx, min_fees, etc.) are evaluated using AND logic: all defined parameters must be valid for the filter itself to pass.

Check Automation for a quick configuration example.

Update

Run this command to update this tool to its latest version:

./copychain update