@exodus/solana-lib 3.20.1 → 3.21.0

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.21.0](https://github.com/ExodusMovement/assets/compare/@exodus/solana-lib@3.20.1...@exodus/solana-lib@3.21.0) (2026-03-10)
+
+
+### Features
+
+
+* feat: Solana add sponsored fee-payer tagging and instruction helpers (#7522)
+
+
+
 ## [3.20.1](https://github.com/ExodusMovement/assets/compare/@exodus/solana-lib@3.20.0...@exodus/solana-lib@3.20.1) (2026-02-03)
 
 **Note:** Version bump only for package @exodus/solana-lib

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/solana-lib",
-  "version": "3.20.1",
+  "version": "3.21.0",
   "description": "Solana utils, such as for cryptography, address encoding/decoding, transaction building, etc.",
   "type": "module",
   "main": "src/index.js",
@@ -48,5 +48,5 @@
     "type": "git",
     "url": "git+https://github.com/ExodusMovement/assets.git"
   },
-  "gitHead": "d844d6fa5e5eec3c7b279ee5317f676357eb82b2"
+  "gitHead": "7da7b29b3177ad6155d5018c297e795cd4d3bda8"
 }

package/src/tx/index.js

@@ -9,4 +9,5 @@ export * from './sign-hardware.js'
 export * from './prepare-for-signing.js'
 export * from './verify-only-fee-payer-changed.js'
 export * from './parse-tx-buffer.js'
+export * from './instruction-utils.js'
 export { transactionToBase58, deserializeTransaction } from './common.js'

package/src/tx/instruction-utils.js

@@ -0,0 +1,61 @@
+import { COMPUTE_BUDGET_PROGRAM_ID } from '../constants.js'
+import {
+  SystemInstruction,
+  TOKEN_INSTRUCTION_LAYOUTS,
+  TokenInstruction,
+  TRANSFER_FEE_SUB_INSTRUCTIONS,
+} from '../vendor/index.js'
+import { toBuffer } from '../vendor/utils/to-buffer.js'
+
+function getProgramId(instruction, accountKeys) {
+  if (!instruction || instruction.programIdIndex === undefined) return null
+  return accountKeys[instruction.programIdIndex]
+}
+
+export function isTokenProgramInstruction(instruction, accountKeys) {
+  return TokenInstruction.isProgramInstruction(instruction, accountKeys)
+}
+
+export function isSystemTransferInstruction(instruction, accountKeys) {
+  if (!SystemInstruction.isProgramInstruction(instruction, accountKeys)) return false
+  try {
+    SystemInstruction.validateInstruction(instruction)
+    return true
+  } catch {
+    return false
+  }
+}
+
+export function isComputeBudgetInstruction(instruction, accountKeys) {
+  const programId = getProgramId(instruction, accountKeys)
+  if (!programId) return false
+  return programId.equals(COMPUTE_BUDGET_PROGRAM_ID)
+}
+
+export function isSetAuthorityInstruction(instruction, accountKeys) {
+  if (!isTokenProgramInstruction(instruction, accountKeys)) return false
+  const buffer = toBuffer(instruction.data)
+  return buffer.length > 0 && buffer[0] === TOKEN_INSTRUCTION_LAYOUTS.SetAuthority.index
+}
+
+export function isTransferInstruction(instruction, accountKeys) {
+  if (!isTokenProgramInstruction(instruction, accountKeys)) return false
+  const buffer = toBuffer(instruction.data)
+  return buffer.length > 0 && buffer[0] === TOKEN_INSTRUCTION_LAYOUTS.Transfer.index
+}
+
+export function isTransferCheckedInstruction(instruction, accountKeys) {
+  if (!isTokenProgramInstruction(instruction, accountKeys)) return false
+  const buffer = toBuffer(instruction.data)
+  return buffer.length > 0 && buffer[0] === TOKEN_INSTRUCTION_LAYOUTS.TransferChecked.index
+}
+
+export function isTransferCheckedWithFeeInstruction(instruction, accountKeys) {
+  if (!isTokenProgramInstruction(instruction, accountKeys)) return false
+  const buffer = toBuffer(instruction.data)
+  return (
+    buffer.length >= 2 &&
+    buffer[0] === TOKEN_INSTRUCTION_LAYOUTS.TransferFeeExtension.index &&
+    buffer[1] === TRANSFER_FEE_SUB_INSTRUCTIONS.TransferCheckedWithFee
+  )
+}

package/src/tx/parse-tx-buffer.js

@@ -40,7 +40,7 @@ function getStakedAmountFromCreateWithSeed(stakeAddress, instructions, accountKe
 
 // TODO: Unify with parseTransaction in solana-api and use there as well?
 // TODO: add support for swap instructions
-export async function parseTxBuffer(buffer, api) {
+export async function parseTxBuffer(buffer, api, options = Object.create(null)) {
   const transaction = deserializeTransaction(buffer)
   const { message } = transaction
 
@@ -51,6 +51,10 @@ export async function parseTxBuffer(buffer, api) {
     throw new TypeError('Invalid transaction structure')
   }
 
+  const feePayerAddress = accountKeys[0]?.toBase58()
+  const { sponsors } = options
+  const isSponsoredBy = sponsors?.[feePayerAddress]
+
   const decodedEntries = []
 
   for (const [index, instruction] of instructions.entries()) {
@@ -75,7 +79,13 @@ export async function parseTxBuffer(buffer, api) {
       api,
       instructions,
     })
-    if (parsed) parsedInstructions.push(parsed)
+    if (parsed) {
+      parsedInstructions.push({
+        ...parsed,
+        feePayerAddress,
+        ...(isSponsoredBy && { isSponsoredBy }),
+      })
+    }
   }
 
   if (parsedInstructions.length === 0) {