feat: add --tokens flag to list deployment-specific tokens

[hardyjosh]

Motivation

Non-interactive strategy-builder users need the valid token addresses for a deployment to populate --select-token KEY=<address> flags. The webapp resolves this dynamically by reading the registry's token-list; CLI users currently have no equivalent.

Inlining the full token list in --describe output was considered and rejected: a registry can have hundreds of tokens and the list is typically only needed for the one deployment the caller is working with.

Solution

Add a --tokens flag that scopes to a single strategy + deployment and emits a markdown table of the tokens the registry has registered for that deployment.

raindex strategy-builder --tokens \
  --registry <url> --strategy <key> --deployment <key>

Output:

# Available tokens — `fixed-limit` / `base`

14 tokens. Use any address as the value of a `--select-token KEY=<address>` flag.

| Symbol | Name | Address | Decimals |
|--------|------|---------|----------|
| `wtIAU` | Wrapped iShares Gold Trust ST0x | `0x1E46...` | 18 |
...

Any ERC20 address is accepted for --select-token; the list is a curated convenience subset. --describe links to this command so agents fetch scoped lists on demand.

Checks

• made this PR as small as possible
• unit-tested any new functionality
• linked any relevant issues or PRs
• included screenshots (if this involves a front-end change)

[hardyjosh]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• feat: template fallback operator ${expr || 'default'} #2551 : 2 dependent PRs (#2548 , #2552 )
• feat: add --tokens flag to list deployment-specific tokens #2549 👈 (View in Graphite)
• feat: add interactive mode to strategy-builder CLI #2546
• feat: add strategy-builder CLI subcommand #2544
• Consolidate JS API gui module into common crate and rename GUI to OrderBuilder #2479
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 21e46ac9-987d-4473-bce8-3fcfb80e6b70

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• ✅ Review completed - (🔄 Check again to review again)

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch list-tokens

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[hardyjosh]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[hardyjosh]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.