Skip to content

Add stellar token burn command - #2744

Merged
fnando merged 1 commit into
mainfrom
token-burn
Sep 23, 2026
Merged

fnando merged 1 commit into
mainfrom
token-burn

Conversation

@fnando

@fnando fnando commented Sep 22, 2026

Copy link
Copy Markdown
Member

What

Adds a stellar token burn command that destroys amount of a token from an account, implementing SEP-41's burn(from, amount). The signing account is passed with --from, which also authorizes the call. Mirrors the existing transfer command minus the destination.

Why

The CLI already exposes most of the SEP-41 token interface under stellar token … (transfer, transfer-from, approve, allowance, balance, name, symbol, decimals) but had no way to burn tokens. This adds it.

Known limitations

Copilot AI lite review requested due to automatic review settings September 22, 2026 17:02
@github-project-automation github-project-automation Bot moved this to Backlog (Not Ready) in DevX Sep 22, 2026
@fnando
fnando added this pull request to stack #2745 September 22, 2026 17:03

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

No unresolved blocking issues were identified.

Review effort: Lite
Findings: None

What changed in this PR

Adds stellar token burn for SEP-41-compatible contracts, including validation, JSON errors, documentation, and integration tests.

Changes:

  • Implements burn(from, amount) with muxed-account and negative-amount validation.
  • Registers the command and structured JSON error handling.
  • Adds help documentation and integration coverage.
File Description
FULL_HELP_DOCS.md Documents the new command.
cmd/​soroban-cli/​src/​commands/​token/​mod.rs Registers the burn command and errors.
cmd/​soroban-cli/​src/​commands/​token/​burn.rs Implements token burning.
cmd/​soroban-cli/​src/​cli.rs Adds JSON error-output support.
cmd/​crates/​soroban-test/​tests/​it/​integration/​token/​mod.rs Registers burn tests.
cmd/​crates/​soroban-test/​tests/​it/​integration/​token/​burn.rs Tests successful burns and validation behavior.

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

Copilot AI review requested due to automatic review settings September 22, 2026 17:12

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🔵 Needs a closer look

Direct-contract burn coverage is still missing for a supported path.

Review effort: Lite
Findings: None

Copilot AI review requested due to automatic review settings September 22, 2026 23:21

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

No unresolved blocking issues were identified.

Review effort: Lite
Findings: None

Copilot AI review requested due to automatic review settings September 22, 2026 23:27

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

No unresolved review comments remain, and integration coverage is included.

Review effort: Lite
Findings: None

Base automatically changed from token-transfer-from to main September 23, 2026 00:10
@fnando fnando self-assigned this Sep 23, 2026
@fnando fnando moved this from Backlog (Not Ready) to Needs Review in DevX Sep 23, 2026
@fnando
fnando requested review from a team and leighmcculloch September 23, 2026 00:11
@fnando
fnando merged commit 5a20214 into main Sep 23, 2026
243 of 244 checks passed
@fnando
fnando deleted the token-burn branch September 23, 2026 19:34
@github-project-automation github-project-automation Bot moved this from Needs Review to Done in DevX Sep 23, 2026
@fnando fnando mentioned this pull request Oct 7, 2026
4 tasks done
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants