@exodus/solana-lib 3.22.1 → 3.22.4

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.22.4](https://github.com/ExodusMovement/assets/compare/@exodus/solana-lib@3.22.2...@exodus/solana-lib@3.22.4) (2026-03-30)
+
+
+### Bug Fixes
+
+
+* fix: SOL memo program (#7696)
+
+
+
+## [3.22.3](https://github.com/ExodusMovement/assets/compare/@exodus/solana-lib@3.22.2...@exodus/solana-lib@3.22.3) (2026-03-30)
+
+**Note:** Version bump only for package @exodus/solana-lib
+
+
+
+
+
+## [3.22.2](https://github.com/ExodusMovement/assets/compare/@exodus/solana-lib@3.22.1...@exodus/solana-lib@3.22.2) (2026-03-27)
+
+**Note:** Version bump only for package @exodus/solana-lib
+
+
+
+
+
 ## [3.22.1](https://github.com/ExodusMovement/assets/compare/@exodus/solana-lib@3.22.0...@exodus/solana-lib@3.22.1) (2026-03-18)
 
 **Note:** Version bump only for package @exodus/solana-lib

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/solana-lib",
-  "version": "3.22.1",
+  "version": "3.22.4",
   "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": "e746a88ef78a0e7167587bfa14068ceb494d6fd7"
+  "gitHead": "0d8639ef50e192df1f302f0ac7ff378d919cc536"
 }

package/src/constants.js

@@ -1,4 +1,5 @@
 import {
+  ComputeBudgetProgram,
   PublicKey,
   StakeProgram,
   SystemProgram,
@@ -15,9 +16,7 @@ export const STAKE_PROGRAM_ID = StakeProgram.programId
 
 export const TOKEN_PROGRAM_ID = TokenProgram.programId
 
-export const COMPUTE_BUDGET_PROGRAM_ID = new PublicKey(
-  'ComputeBudget111111111111111111111111111111'
-)
+export const COMPUTE_BUDGET_PROGRAM_ID = ComputeBudgetProgram.programId
 
 export const TOKEN_2022_PROGRAM_ID = Token2022Program.programId
 

package/src/helpers/memo.js

@@ -0,0 +1,18 @@
+import assert from 'minimalistic-assert'
+
+import { MEMO_PROGRAM_ID } from '../constants.js'
+import { TransactionInstruction } from '../vendor/index.js'
+
+/**
+ * Builds a legacy Memo program instruction (spl-memo).
+ * @see https://spl.solana.com/memo
+ */
+export function createMemoInstruction(memo) {
+  assert(typeof memo === 'string', 'memo must be a string')
+
+  return new TransactionInstruction({
+    keys: [],
+    programId: MEMO_PROGRAM_ID,
+    data: Buffer.from(memo, 'utf8'),
+  })
+}

package/src/helpers/metaplex-transfer.js

@@ -2,6 +2,7 @@ import * as BufferLayout from '@exodus/buffer-layout'
 
 import {
   MPL_TOKEN_METADATA_PROGRAM_ID,
+  SPL_ASSOCIATED_TOKEN_ACCOUNT_PROGRAM_ID,
   SYSTEM_PROGRAM_ID,
   SYSVAR_INSTRUCTIONS_PUBKEY,
   TOKEN_PROGRAM_ID,
@@ -13,7 +14,6 @@ import {
   getTokenRecordPDA,
 } from '../encode.js'
 import { PublicKey, Transaction, TransactionInstruction } from '../vendor/index.js'
-import { ASSOCIATED_TOKEN_PROGRAM_ID } from './spl-token.js'
 
 const TRANSFER_INSTRUCTION_DISCRIMINATOR = 49
 const TOKEN_AUTH_RULES_ID = new PublicKey('auth9SigNpDKz4sJJ1DfCTuZrZNSAgh9sFD3rboVmgg')
@@ -127,7 +127,7 @@ export const prepareMetaplexTransferTx = ({
       isSigner: false,
     },
     {
-      pubkey: ASSOCIATED_TOKEN_PROGRAM_ID,
+      pubkey: SPL_ASSOCIATED_TOKEN_ACCOUNT_PROGRAM_ID,
       isWritable: false,
       isSigner: false,
     },

package/src/helpers/spl-token.js

@@ -12,11 +12,6 @@ import * as Layout from '../vendor/utils/layout.js'
 
 // Extracted from https://github.com/ExodusMovement/solana-spl-token/blob/master/src/index.js#L263
 
-export const ASSOCIATED_TOKEN_PROGRAM_ID = new PublicKey(
-  'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL'
-)
-export const TOKEN_PROGRAM_ID = new PublicKey('TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA')
-
 /**
  * 64-bit value
  */

package/src/index.js

@@ -13,6 +13,7 @@ export {
   SystemProgram,
 } from './vendor/index.js'
 export { default as Transaction } from './transaction.js'
+export { createMemoInstruction } from './helpers/memo.js'
 export { U64, Token } from './helpers/spl-token.js'
 export { createGetKeyIdentifier, getSupportedPurposes } from './key-identifier.js'
 export { createAgentTokenInitTx } from './helpers/create-agent-token-init-tx.js'

package/src/transaction.js

@@ -2,7 +2,7 @@ import BN from 'bn.js'
 import bs58 from 'bs58'
 import assert from 'minimalistic-assert'
 
-import { MEMO_PROGRAM_ID, SEED, STAKE_PROGRAM_ID, TOKEN_2022_PROGRAM_ID } from './constants.js'
+import { SEED, STAKE_PROGRAM_ID, TOKEN_2022_PROGRAM_ID } from './constants.js'
 import { createStakeAddress, findAssociatedTokenAddress } from './encode.js'
 import { createTransferCheckedWithFeeInstruction } from './helpers/spl-token-2022.js'
 import {
@@ -20,9 +20,21 @@ import {
   StakeProgram,
   SystemProgram,
   Transaction,
-  TransactionInstruction,
 } from './vendor/index.js'
 
+function normalizeReferencePublicKeys(reference) {
+  if (reference == null) return null
+
+  const entries = Array.isArray(reference) ? reference : [reference]
+  if (entries.length === 0) return null
+
+  return entries.map((key) => {
+    if (key instanceof PublicKey) return key
+    assert(typeof key === 'string', 'reference must be base58 string(s) or PublicKey(s)')
+    return new PublicKey(key)
+  })
+}
+
 class Tx {
   constructor(
     {
@@ -38,7 +50,6 @@ class Tx {
       fromTokenAddresses, // sender token addresses
       instructions,
       feePayer,
-      memo,
       reference,
     } = {},
     options = {}
@@ -87,17 +98,6 @@ class Tx {
       // SOL tx
       this.buildSOLtransaction(this.txObj)
     }
-
-    // If a memo is provided, add it to the transaction before adding the transfer instruction
-    if (memo) {
-      this.transaction.add(
-        new TransactionInstruction({
-          programId: MEMO_PROGRAM_ID,
-          keys: [],
-          data: Buffer.from(memo, 'utf8'),
-        })
-      )
-    }
   }
 
   buildSOLtransaction({ from, to, amount, recentBlockhash, feePayer, reference }) {
@@ -107,13 +107,9 @@ class Tx {
       lamports: new BN(amount),
     })
 
-    // If reference accounts are provided, add them to the transfer instruction
-    if (reference) {
-      if (!Array.isArray(reference)) {
-        reference = [reference]
-      }
-
-      for (const pubkey of reference) {
+    const refKeys = normalizeReferencePublicKeys(reference)
+    if (refKeys) {
+      for (const pubkey of refKeys) {
         txInstruction.keys.push({ pubkey, isWritable: false, isSigner: false })
       }
     }
@@ -231,13 +227,9 @@ class Tx {
         )
       }
 
-      // If reference accounts are provided, add them to the transfer instruction
-      if (reference) {
-        if (!Array.isArray(reference)) {
-          reference = [reference]
-        }
-
-        for (const pubkey of reference) {
+      const refKeys = normalizeReferencePublicKeys(reference)
+      if (refKeys) {
+        for (const pubkey of refKeys) {
           tokenTransferInstruction.keys.push({ pubkey, isWritable: false, isSigner: false })
         }
       }

package/src/tx/create-unsigned-tx.js

@@ -36,6 +36,9 @@ export function createUnsignedTx({
   // Wallet Connect
   instructions,
   feePayer,
+  memo,
+  /** Base58 string(s) and/or PublicKey; normalized when building transactions. */
+  reference,
 }) {
   return {
     txData: {
@@ -72,6 +75,8 @@ export function createUnsignedTx({
       // Wallet Connect
       instructions,
       feePayer,
+      memo,
+      reference,
     },
     txMeta: {
       assetName: asset.name,

package/src/tx/decode-tx-instructions.js

@@ -1,8 +1,9 @@
 import * as BufferLayout from '@exodus/buffer-layout'
 import bs58 from 'bs58'
 
-import { ASSOCIATED_TOKEN_PROGRAM_ID, TOKEN_PROGRAM_ID } from '../helpers/spl-token.js'
-import { SystemInstruction, SystemProgram } from './../vendor/index.js'
+import { TOKEN_PROGRAM_ID } from '../constants.js'
+import { SystemInstruction } from './../vendor/index.js'
+import { isATAProgram, isSystemProgram } from './instruction-utils.js'
 import * as TokenInstructions from './token-instructions.js'
 
 const INSTRUCTION_LAYOUT = BufferLayout.union(BufferLayout.u8('instruction'))
@@ -184,7 +185,7 @@ function decodeTokenInstruction(instruction) {
       return decodeTokenProgramInstruction(instruction)
     }
 
-    if (programId.equals(ASSOCIATED_TOKEN_PROGRAM_ID)) {
+    if (isATAProgram(programId)) {
       return decodeAssociatedTokenProgramInstruction(instruction)
     }
   } catch (err) {
@@ -216,7 +217,7 @@ export function decodeTransactionInstructions(transactionMessages) {
     return [...prevInstructions, ...instructions]
   }, [])
   return transactionInstructions.map((instruction) => {
-    if (instruction.programId.equals(SystemProgram.programId)) {
+    if (isSystemProgram(instruction.programId)) {
       return decodeSystemInstruction(instruction)
     }
 

package/src/tx/instruction-utils.js

@@ -1,5 +1,6 @@
 import {
   COMPUTE_BUDGET_PROGRAM_ID,
+  SPL_ASSOCIATED_TOKEN_ACCOUNT_PROGRAM_ID,
   SYSTEM_PROGRAM_ID,
   TOKEN_2022_PROGRAM_ID,
   TOKEN_PROGRAM_ID,
@@ -62,15 +63,30 @@ export function hasValidShape(instruction, reqs) {
   )
 }
 
-export function isTokenProgramInstruction(instruction) {
-  const programId = instruction?.programId
+export function isTokenProgram(programId) {
+  if (!programId) return false
+  const id = programId.toString()
+  return id === TOKEN_PROGRAM_ID.toString() || id === TOKEN_2022_PROGRAM_ID.toString()
+}
+
+export function isATAProgram(programId) {
   if (!programId) return false
-  return programId.equals(TOKEN_PROGRAM_ID) || programId.equals(TOKEN_2022_PROGRAM_ID)
+  return programId.toString() === SPL_ASSOCIATED_TOKEN_ACCOUNT_PROGRAM_ID.toString()
+}
+
+export function isSystemProgram(programId) {
+  if (!programId) return false
+  return programId.toString() === SYSTEM_PROGRAM_ID.toString()
+}
+
+/** @deprecated Use `isTokenProgram(instruction.programId)` instead. */
+export function isTokenProgramInstruction(instruction) {
+  return isTokenProgram(instruction?.programId)
 }
 
 export function isSystemTransferInstruction(instruction) {
-  const programId = instruction?.programId
-  if (!programId || !programId.equals(SYSTEM_PROGRAM_ID)) return false
+  if (!isSystemProgram(instruction?.programId)) return false
+
   const reqs = SYSTEM_INSTRUCTION_REQUIREMENTS[SYSTEM_INSTRUCTION_LAYOUTS.Transfer.index]
   if (!hasValidShape(instruction, reqs)) return false
   try {
@@ -81,14 +97,18 @@ export function isSystemTransferInstruction(instruction) {
   }
 }
 
-export function isComputeBudgetInstruction(instruction) {
-  const programId = instruction?.programId
+export function isComputeBudgetProgram(programId) {
   if (!programId) return false
-  return programId.equals(COMPUTE_BUDGET_PROGRAM_ID)
+  return programId.toString() === COMPUTE_BUDGET_PROGRAM_ID.toString()
+}
+
+/** @deprecated Use `isComputeBudgetProgram(instruction.programId)` instead. */
+export function isComputeBudgetInstruction(instruction) {
+  return isComputeBudgetProgram(instruction?.programId)
 }
 
 export function isSetAuthorityInstruction(instruction) {
-  if (!isTokenProgramInstruction(instruction)) return false
+  if (!isTokenProgram(instruction?.programId)) return false
   const reqs = TOKEN_INSTRUCTION_REQUIREMENTS[TOKEN_INSTRUCTION_LAYOUTS.SetAuthority.index]
   if (!hasValidShape(instruction, reqs)) return false
   const buffer = toBuffer(instruction.data)
@@ -96,7 +116,7 @@ export function isSetAuthorityInstruction(instruction) {
 }
 
 export function isTransferInstruction(instruction) {
-  if (!isTokenProgramInstruction(instruction)) return false
+  if (!isTokenProgram(instruction?.programId)) return false
   const reqs = TOKEN_INSTRUCTION_REQUIREMENTS[TOKEN_INSTRUCTION_LAYOUTS.Transfer.index]
   if (!hasValidShape(instruction, reqs)) return false
   const buffer = toBuffer(instruction.data)
@@ -104,7 +124,7 @@ export function isTransferInstruction(instruction) {
 }
 
 export function isTransferCheckedInstruction(instruction) {
-  if (!isTokenProgramInstruction(instruction)) return false
+  if (!isTokenProgram(instruction?.programId)) return false
   const reqs = TOKEN_INSTRUCTION_REQUIREMENTS[TOKEN_INSTRUCTION_LAYOUTS.TransferChecked.index]
   if (!hasValidShape(instruction, reqs)) return false
   const buffer = toBuffer(instruction.data)
@@ -112,7 +132,7 @@ export function isTransferCheckedInstruction(instruction) {
 }
 
 export function isTransferCheckedWithFeeInstruction(instruction) {
-  if (!isTokenProgramInstruction(instruction)) return false
+  if (!isTokenProgram(instruction?.programId)) return false
   const reqs = TOKEN_INSTRUCTION_REQUIREMENTS[TOKEN_INSTRUCTION_LAYOUTS.TransferFeeExtension.index]
   if (!hasValidShape(instruction, reqs)) return false
   const buffer = toBuffer(instruction.data)

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

@@ -1,4 +1,3 @@
-import { SYSTEM_PROGRAM_ID } from '../constants.js'
 import {
   StakeInstruction,
   SYSTEM_INSTRUCTION_LAYOUTS,
@@ -8,6 +7,7 @@ import {
 import { toBuffer } from '../vendor/utils/to-buffer.js'
 import { deserializeTransaction } from './common.js'
 import { getAccountKeys, getNormalizedInstructions } from './instruction-normalizer.js'
+import { isSystemProgram } from './instruction-utils.js'
 
 const InstructionKind = {
   TOKEN: 'token',
@@ -19,7 +19,7 @@ const InstructionKind = {
 function getStakedAmountFromCreateWithSeed(stakeAddress, instructions, accountKeys) {
   for (const instruction of instructions) {
     const programId = accountKeys[instruction.programIdIndex]
-    if (!programId.equals(SYSTEM_PROGRAM_ID)) continue
+    if (!isSystemProgram(programId)) continue
 
     const buffer = toBuffer(instruction.data)
     if (

package/src/tx/prepare-for-signing.js

@@ -4,6 +4,7 @@ import { VersionedTransaction } from '@exodus/solana-web3.js'
 import BN from 'bn.js'
 import assert from 'minimalistic-assert'
 
+import { createMemoInstruction } from '../helpers/memo.js'
 import { createMetaplexTransferTransaction } from '../helpers/metaplex-transfer.js'
 import Transaction from '../transaction.js'
 import { ComputeBudgetProgram, PublicKey } from '../vendor/index.js'
@@ -125,6 +126,11 @@ const createTx = ({ txData, method, from }, options) => {
     addComputeBudgetToTransaction({ transaction: tx, computeUnits: txData.computeUnits })
   }
 
+  if (txData.memo) {
+    const prependCount = (txData.computeUnits ? 1 : 0) + (txData.priorityFee ? 1 : 0)
+    tx.instructions.splice(prependCount, 0, createMemoInstruction(txData.memo))
+  }
+
   const publicKey = new PublicKey(from)
   if (!tx.feePayer) {
     tx.feePayer = publicKey
@@ -227,7 +233,6 @@ const createTokenTransaction = (
     recentBlockhash,
     to,
     tokenMintAddress,
-    memo,
     reference,
   },
   options
@@ -245,7 +250,6 @@ const createTokenTransaction = (
       recentBlockhash,
       to,
       tokenMintAddress,
-      memo,
       reference,
     },
     options

package/src/tx/simulate-and-sign-tx.js

@@ -1,5 +1,6 @@
 import { Token, U64 } from '../helpers/spl-token.js'
 import { PublicKey } from '../vendor/index.js'
+import { isSystemProgram } from './instruction-utils.js'
 
 export function computeBalance(futureAccountBalance, currentAccountBalance) {
   return new U64(futureAccountBalance).sub(new U64(currentAccountBalance))
@@ -59,8 +60,6 @@ export function getTransactionSimulationParams(transactionMessage) {
   }
 }
 
-const isSolAccount = (account) => account === '11111111111111111111111111111111'
-
 export function filterAccountsByOwner(futureAccountsState, accountAddresses, publicKey) {
   const solAccounts = []
   const tokenAccounts = []
@@ -75,7 +74,7 @@ export function filterAccountsByOwner(futureAccountsState, accountAddresses, pub
       const accountAddress = accountAddresses[index]
 
       // Check if it's SOL account (not token)
-      if (isSolAccount(futureAccount.owner.toString())) {
+      if (isSystemProgram(futureAccount.owner)) {
         if (accountAddress.toString() === publicKey.toString()) {
           solAccounts.push({
             amount: futureAccount.lamports,

package/src/tx/verify-only-fee-payer-changed.js

@@ -2,13 +2,13 @@ import lodash from 'lodash'
 import assert from 'minimalistic-assert'
 
 import {
+  SPL_ASSOCIATED_TOKEN_ACCOUNT_PROGRAM_ID,
   SPL_TOKEN_AUTHORITY_TYPE,
   SPL_TOKEN_INSTRUCTION_TYPE,
-  TOKEN_2022_PROGRAM_ID,
   TOKEN_PROGRAM_ID,
 } from '../constants.js'
-import { ASSOCIATED_TOKEN_PROGRAM_ID } from '../helpers/spl-token.js'
 import { SYSVAR_RENT_PUBKEY } from '../vendor/index.js'
+import { isATAProgram, isTokenProgram } from './instruction-utils.js'
 
 export function verifyOnlyFeePayerChanged(beforeTx, afterTx) {
   assert(
@@ -72,7 +72,7 @@ export function verifyOnlyFeePayerChanged(beforeTx, afterTx) {
       return keyStr === SYSVAR_RENT_PUBKEY.toString()
     })
 
-    if (containsRentSysvar && isATAProgram(programId)) {
+    if (containsRentSysvar && (isATAProgram(programId) || isTokenProgram(programId))) {
       const adjustedBeforeAccounts = [...beforeAccounts]
       adjustedBeforeAccounts[0] = afterTx.message.accountKeys[0]
       assert(
@@ -237,19 +237,6 @@ export function verifyOnlyFeePayerChanged(beforeTx, afterTx) {
   )
 }
 
-function isTokenProgram(programId) {
-  const programIdStr = programId.toString()
-  return (
-    programIdStr === TOKEN_PROGRAM_ID.toString() ||
-    programIdStr === TOKEN_2022_PROGRAM_ID.toString()
-  )
-}
-
-function isATAProgram(programId) {
-  const programIdStr = programId.toString()
-  return isTokenProgram(programId) || programIdStr === ASSOCIATED_TOKEN_PROGRAM_ID.toString()
-}
-
 function getTokenAccountCreations(transaction) {
   const createdAccounts = []
 
@@ -258,7 +245,7 @@ function getTokenAccountCreations(transaction) {
 
     // Check for ATA creation (Associated Token Account Program)
     if (
-      programId === ASSOCIATED_TOKEN_PROGRAM_ID.toString() && // For ATA creation, the new account is typically at index 1
+      programId === SPL_ASSOCIATED_TOKEN_ACCOUNT_PROGRAM_ID.toString() && // For ATA creation, the new account is typically at index 1
       // Index 0 is payer, Index 1 is the ATA being created, Index 5 is the token program
       instruction.accounts?.length >= 2
     ) {