feat(iota): allow // comments in iota client ptb commands

[Thoralf-M]

Description of change

Allow // comments in iota client ptb commands, the comments must be finished with \ to continue with the commands. This is a limitation of bash/zsh and also the reason why # can't be used, as the parts afterwards wouldn't be visible to the iota client ptb command.

This allows

iota client ptb \
// Get the sender address \
--move-call iota::tx_context::sender \
--assign sender \
// Split 1 NANOS from gas coin \
--split-coins gas "[1]" \
--assign coin \
// Transfer the new coin to the sender \
--transfer-objects "[coin]" sender \
--dry-run

# normal comment
iota client ptb \
// another test \
--dry-run

# commented PTB call
iota client ptb \
// another test \
// --split-coins gas "[1]" works as comment \
--dry-run

# commented PTB call, but with text before, still runs
iota client ptb \
// will still run: --split-coins gas "[1]" \
--dry-run

# empty comment, next PTB call will be ignored
iota client ptb \
// \
// --split-coins gas "[1]" \
--dry-run

Links to any relevant issues

Fixes #9432

How the change has been tested

• Basic tests (linting, compilation, formatting, unit/integration tests)
• Patch-specific tests (correctness, functionality coverage)
• I have added tests that prove my fix is effective or that my feature works
• I have checked that new and existing unit tests pass locally with my changes

Release Notes

• Protocol:
• Nodes (Validators and Full nodes):
• Indexer:
• JSON-RPC:
• GraphQL:
• CLI: Add // comment support in iota client ptb commands
• Rust SDK:
• REST API:

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

6 Skipped Deployments

Project	Deployment	Preview	Comments	Updated (UTC)
apps-backend	Ignored	Preview		Dec 7, 2025 7:35am
apps-ui-kit	Ignored	Preview		Dec 7, 2025 7:35am
iota-evm-bridge	Ignored	Preview		Dec 7, 2025 7:35am
iota-multisig-toolkit	Ignored	Preview		Dec 7, 2025 7:35am
rebased-explorer	Ignored	Preview		Dec 7, 2025 7:35am
wallet-dashboard	Ignored	Preview		Dec 7, 2025 7:35am

[github-actions]

✅ Vercel Preview Deployment is ready!

View Preview

[github-actions]

✅ Vercel Preview Deployment is ready!

View Preview

[thibault-martinez]

Maybe I misunderstand but shouldn't we skip until an EOL? Otherwise we can run a commented command?

[Thoralf-M]

Hm good point, the problem is we can't detect end of lines in the parser since the shell removes this information before
What we could do is to ignore -- if it comes directly after //, but if we have an empty line, so just // \ and then a command again, it would also ignore this command

[DaughterOfMars]

tbh I'm not sure I see the utility here

[Thoralf-M]

tbh I'm not sure I see the utility here

Explaining what happens in a PTB could be useful and also commenting out part of a PTB for testing different combinations

[DaughterOfMars]

tbh I'm not sure I see the utility here

Explaining what happens in a PTB could be useful and also commenting out part of a PTB for testing different combinations

The problem I see is that this doesn't allow you to write a shell file and then copy paste it into the command line because of the comments having a different format. So this allows you to write commands instead in, what, a .md file? I suppose this helps for our examples in docs... I just don't know.

[github-actions]

✅ Vercel Preview Deployment is ready!

View Preview