Add stellar token set-admin subcommand

[fnando]

What

Adds stellar token set-admin, a SAC-admin write subcommand that transfers administration of a token. --source (the current admin) signs and authorizes the change, and --new-admin is the successor. Returns a JSON receipt with the tx hash.

Why

Part of #2620 (typed SEP-41 + SAC client), a SAC-admin command alongside mint/clawback. A thin wrapper over contract invoke reusing args::invoke_by_position and args::not_deployed_error. Like the other transaction commands it flattens config::Args, so the signer comes from the standard --source (env STELLAR_ACCOUNT, optional with stellar keys use); like the other admin commands, the signer only authorizes and is not a set_admin argument, so only [new_admin] is passed positionally. The happy-path test verifies control transferred behaviorally — after set-admin, the new admin can mint.

Known limitations

Muxed (M…) source accounts are rejected with a clear error (same constraint as transfer, see #2645).

[Copilot]

Pull request overview

Adds stellar token set-admin for transferring SAC administration through the existing contract invocation pipeline.

Changes:

• Adds command routing, typed errors, receipts, and help documentation.
• Adds integration coverage for transfer, undeployed SACs, and muxed sources.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
FULL_HELP_DOCS.md	Documents the subcommand.
cmd/soroban-cli/src/commands/token/set_admin.rs	Implements administration transfer.
cmd/soroban-cli/src/commands/token/mod.rs	Registers and dispatches the command.
cmd/soroban-cli/src/cli.rs	Enables JSON error formatting.
cmd/crates/soroban-test/tests/it/integration/token/set_admin.rs	Adds integration tests.
cmd/crates/soroban-test/tests/it/integration/token/mod.rs	Registers the test module.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

[Copilot]

Copilot review overview

🟡 Changes recommended

Accepting a muxed successor can leave administration unusable through the current CLI, and the administrator documentation is inaccurate.

Review effort: Balanced
Findings: 1 · 4

Open (5)

• Reject muxed successor addresses until admin signing is supported · New
• Clarify help text that issuer is only the initial admin · New
• Clarify issuer is only the initial SAC administrator · New
• The accepted native token reference is missing from this help text. UnresolvedToken parses…
• This generated help entry omits the supported native reference, unlike every other token command.…

[Copilot]

Copilot review overview

🟡 Changes recommended

Muxed successor addresses are advertised and forwarded even though the SAC set_admin parameter rejects them.

Review effort: Balanced
Findings: 1 · 1 · 4

Open (6)

• Reject muxed successor addresses until admin signing is supported
• Remove unsupported muxed successor from help text · New
• Clarify issuer is only the initial SAC administrator
• Clarify help text that issuer is only the initial admin
• The accepted native token reference is missing from this help text. UnresolvedToken parses…
• This generated help entry omits the supported native reference, unlike every other token command.…

[Copilot]

Copilot review overview

🟢 Approval recommended

The implementation follows established token-admin patterns and includes comprehensive integration coverage.

Review effort: Balanced
Findings: 1 · 1 · 2

Open (4)

• Reject muxed successor addresses until admin signing is supported
• Remove unsupported muxed successor from help text
• The accepted native token reference is missing from this help text. UnresolvedToken parses…
• This generated help entry omits the supported native reference, unlike every other token command.…

Resolved since last review (2)

• Clarify issuer is only the initial SAC administrator
• Clarify help text that issuer is only the initial admin

[Copilot]

Copilot review overview

🔵 Needs a closer look

The help text omits the accepted native token target.

Review effort: Balanced
Findings: 1 · 1 · 2

Open (4)

• Reject muxed successor addresses until admin signing is supported
• Remove unsupported muxed successor from help text
• The accepted native token reference is missing from this help text. UnresolvedToken parses…
• This generated help entry omits the supported native reference, unlike every other token command.…

[Copilot]

Copilot review overview

🟢 Approval recommended

The command is consistently integrated, validates current limitations, and has comprehensive integration coverage.

Review effort: Balanced
Findings: None

Resolved since last review (4)

• Reject muxed successor addresses until admin signing is supported
• Remove unsupported muxed successor from help text
• The accepted native token reference is missing from this help text. UnresolvedToken parses…
• This generated help entry omits the supported native reference, unlike every other token command.…