feat: add note field support and input transaction ID retrieval

[drichar]

Summary

This adds the ability to set a custom note on the user-signed input transaction and retrieve its transaction ID for tracking purposes. This is useful for applications that need to track specific swap transactions by embedding a tracking identifier in the note field and then looking up the transaction by ID.

Changes

New Features

• note configuration option - Added to both SwapComposerConfig and newSwap() to set a custom note on the user-signed input transaction (payment or asset transfer)
• getInputTransactionId() method - Added to SwapComposer to retrieve the transaction ID of the user-signed input transaction after the group has been built

Implementation Details

• The note is only applied to the user-signed transaction (identified by signature === false), not pre-signed or middleware transactions
• The transaction ID is available after calling buildGroup(), sign(), or execute()
• The feature is fully additive and non-breaking for existing code

Files Changed

• packages/deflex/src/composer.ts - Core implementation
• packages/deflex/src/client.ts - Pass-through in newSwap() factory method
• packages/deflex/tests/composer.test.ts - Comprehensive test coverage
• packages/deflex/README.md - Documentation updates

Usage Example

const swap = await deflex.newSwap({
  quote,
  address: activeAddress,
  signer: transactionSigner,
  slippage: 1,
  note: new TextEncoder().encode('tracking-id-123'),
})

const result = await swap.execute()
const inputTxId = swap.getInputTransactionId()
console.log('Input transaction ID:', inputTxId)

[github-actions]

🎉 This PR is included in version 1.6.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀