How to use

Monitor

You can start with this command, leaving copy_pubkeys configuration empty, so that every wallets is monitored.

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

If that’s what you need, run it with:

./copychain monitor copy-config.toml

This will never sends transactions.

Run

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

./copychain run 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.

PreviousExamplesNextLogs

Last updated