QoL batch 3

[nazreen]

Solana OFT debug script: state that value 0 for confirmations means 'use default'

Closes DEVREL-1238

When running:

npx hardhat lz:oft:solana:debug --eid <eid> --dst-eids <dst-eids>  

Before:

           confirmations: 0                                        

After:

           confirmations: 0 (Use Pathway Defaults)

Solana OFT - updateMetadata script supports Token-2022 Metadata Update

Closes DEVREL-1239

Problem

• lz:oft:solana:update-metadata only supported Metaplex metadata, not Token-2022.

Solution

• Auto-detect metadata type: SPL Token → Metaplex; Token-2022 → probe Metaplex first, else Token Extensions.
• Add updateTokenExtensionsMetadata() with authority validation and rent handling for multisig.

Changes

• updateMetadata.ts: Auto-detect and support Token-2022 metadata with authority checks and rent top-up.

Example Run

pnpm hardhat lz:oft:solana:update-metadata --eid 40168 --mint <MINT> --name "New Name"

[github-actions]

🧪 E2E Test Status

E2E tests are non-blocking and validate real blockchain interactions. Failures may occur due to network issues, RPC rate limits, or external service downtime.

Test Runs (Newest First):

• ✅ Run #6749 - Passed - 2026-03-05 17:37 (UTC)
• ✅ Run #6713 - Passed - 2026-02-10 16:40 (UTC)
• ✅ Run #6709 - Passed - 2026-02-10 02:40 (UTC)
• ✅ Run #6673 - Passed - 2026-02-03 17:18 (UTC)
• ✅ Run #6661 - Passed - 2026-01-29 16:57 (UTC)
• ✅ Run #6628 - Passed - 2026-01-23 22:05 (UTC)

[cursor]

PR Summary

Medium Risk
Adds new transaction-building and rent-transfer behavior for Token-2022 metadata updates, which could fail or mis-estimate rent/authority in edge cases. Other changes are low risk output/UX tweaks.

Overview
Improves the Solana OFT Hardhat tooling UX.

lz:oft:solana:update-metadata now auto-detects whether a mint uses Metaplex metadata or Token-2022 Token Extensions and updates accordingly, including new authority validation and rent top-up logic when Token Extensions metadata needs more space (with Squads/multisig support via base58-encoded v0 tx output).

The lz:oft:solana:debug output now annotates confirmations: 0 as use pathway defaults, and getOftStoreAddress no longer emits a warning when the deployment file is absent (returning null silently) while still warning on malformed deployment data.

^{Written by Cursor Bugbot for commit 448ea6c. This will update automatically on new commits. Configure here.}

[nazreen]

bump @lzJxhn

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

[St0rmBr3w]

debug.ts and index.ts changes look good. The "Use Pathway Defaults" label for 0 confirmations is a nice touch, and silencing the warning when the deployment file doesn't exist yet makes the create flow much cleaner. Changesets are appropriate.

On updateMetadata: the auto-detection logic (SPL Token -> Metaplex, Token-2022 -> probe for Metaplex PDA first, fall back to Token Extensions) is solid. The early hasFieldUpdates check prevents the rent-only footgun that bugbot flagged, and keypair resolution goes through getSolanaKeypair() as expected.

Looks good to merge.

[St0rmBr3w]

LGTM!