1.6 KiB
1.6 KiB
Why
Future Evelyn functionality needs a generic way to burn wallet-owned SPL tokens, including EVE under Token-2022. The existing wallet/blockchain separation for SPL transfers provides the right boundary for adding checked burn construction and a high-level validate-sign-submit operation without coupling confirmation or account cleanup to submission.
What Changes
- Add a public blockchain operation that builds one unsigned
BurnCheckedSPL-token transaction for either the legacy SPL Token Program or Token-2022. - Add a public wallet operation that validates blockchain state and an exact human-readable burn amount, then builds, signs, and submits the transaction once.
- Delegate burn transaction construction directly through the cached blockchain decorator without caching.
- Preserve submission-only behavior: no confirmation awaiting, retry, token-account closure, or rent recovery.
- Reuse the existing
ΩRawAmountΩ,ΩamountDecimalsΩ, address, amount, and transaction ValueTags without changing Detag configuration.
Capabilities
New Capabilities
solana-spl-token-burning: Defines safe checked SPL-token burn construction and wallet-owned submission for legacy SPL Token and Token-2022 mints.
Modified Capabilities
None.
Impact
The public SolanaBlockChain and SolanaWallet APIs gain burn operations. Their reference implementations and CachedSolanaBlockChain gain corresponding construction, validation, submission, and direct-delegation behavior. No consumers, configuration, tests, generated sources, or unrelated services change.