feat!: prevent implicit asset burn

[petertonysmith94]

• Closes Prevent implicit burn #3489

Release notes

In this release, we:

• Added a guard to sendTransaction to ensure that we prevent implicit asset burns

Summary

Users can add inputs to a transaction in two ways:

1. transactionRequest.addCoinInput() or transactionRequest.addMessageInput()
   • These methods automatically adds change outputs if there are none, preventing involuntary asset burn.
2. transactionRequest.inputs.push({ ... })
   • This, however, is less safe and can result in assets being burned by mistake if users don't also explicitly add output changes via transactionRequest.outputs.push({ ... }).

This PR focuses on the second, less safe method and adds a new check to prevent implicit asset burn unless the enableAssetBurn flag is set to true in the <wallet|provider>.sendTransaction() method.

Breaking Changes

// before
const transactionRequest = new ScriptTransactionRequest();
transactionRequest.inputs.push({ ... });

// since outputs weren't added, assets would be burned
await sender.sendTransaction(transactionRequest);

// after
const transactionRequest = new ScriptTransactionRequest();
transactionRequest.inputs.push({ ... });

// now, an error will be thrown unless `enableAssetBurn`is true,
// in which case, assets can still be burned
await sender.sendTransaction(transactionRequest, {
  enableAssetBurn: true,
});

Checklist

• All changes are covered by tests (or not applicable)
• All changes are documented (or not applicable)
• I reviewed the entire PR myself (preferably, on GH UI)
• I described all Breaking Changes (or there's none)

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
fuels-template	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jan 10, 2025 11:12am
ts-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jan 10, 2025 11:12am
ts-docs-api	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jan 10, 2025 11:12am

[github-actions]

Coverage Report:

Lines	Branches	Functions	Statements
77.03%(+0.05%)	70.62%(+0.2%)	75.14%(+0.09%)	77.04%(+0.06%)

Changed Files:

Ok	File (✨=New File)	Lines	Branches	Functions	Statements
🔴	packages/account/src/account.ts	80.58% (+0%)	71.23% (+1.37%)	82.5% (+0%)	80.34% (+0%)
🔴	packages/account/src/providers/provider.ts	68.76% (+0.07%)	58.58% (+0.5%)	70.21% (+0%)	68.49% (+0.07%)
🔴	packages/account/src/providers/transaction-request/helpers.ts	100% (+0%)	97.14% (+0.99%)	100% (+0%)	100% (+0%)
🔴	packages/account/src/providers/transaction-request/transaction-request.ts	88.57% (+0%)	78.08% (+1.37%)	84% (+0%)	88.81% (+0%)
🔴	packages/account/src/wallet/base-wallet-unlocked.ts	96.29% (+0.14%)	75% (+0%)	100% (+0%)	96.42% (+0.13%)