@exodus/solana-api 3.27.7 → 3.27.8

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.27.8](https://github.com/ExodusMovement/assets/compare/@exodus/solana-api@3.27.7...@exodus/solana-api@3.27.8) (2026-01-27)
+
+
+### Bug Fixes
+
+
+* fix: Solana Normalize Clarity API responses for contract compatibility (#7334)
+
+
+
 ## [3.27.7](https://github.com/ExodusMovement/assets/compare/@exodus/solana-api@3.27.6...@exodus/solana-api@3.27.7) (2026-01-26)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/solana-api",
-  "version": "3.27.7",
+  "version": "3.27.8",
   "description": "Transaction monitors, fee monitors, RPC with the blockchain node, and other networking code for Solana",
   "type": "module",
   "main": "src/index.js",
@@ -49,7 +49,7 @@
     "@exodus/assets-testing": "^1.0.0",
     "@exodus/solana-web3.js": "^1.63.1-exodus.9-rc3"
   },
-  "gitHead": "5194ac4148f9b6d08ec0b9b14ae1e111af04ae1a",
+  "gitHead": "8975d39bf67554be2555effb3d3cd9d9e0b2d84b",
   "bugs": {
     "url": "https://github.com/ExodusMovement/assets/issues?q=is%3Aissue+is%3Aopen+label%3Asolana-api"
   },

package/src/clarity-api.js

@@ -13,6 +13,8 @@ const cleanQuery = (obj) => omitBy(obj, (v) => v === undefined)
 
 // Tokens + SOL api support
 export class ClarityApi extends RpcApi {
+  // NOTE: getTokenByAddress(mint) is inherited from RpcApi (uses this.tokens Map)
+
   getSupply = memoize(async (mintAddress) => {
     // cached getSupply
     return this.request(`/util/get-token-supply/${encodeURIComponent(mintAddress)}`)
@@ -45,7 +47,7 @@ export class ClarityApi extends RpcApi {
   }
 
   async getTransactions(address, { cursor, limit, includeUnparsed = false } = Object.create(null)) {
-    return this.request(`/addresses/${encodeURIComponent(address)}/transactions`)
+    const result = await this.request(`/addresses/${encodeURIComponent(address)}/transactions`)
       .query(
         cleanQuery({
           cursor,
@@ -55,6 +57,33 @@ export class ClarityApi extends RpcApi {
       )
       .get()
       .json()
+
+    // Normalize token metadata: fill in tokenName, ticker, decimals from assets registry if missing.
+    // This ensures compatibility with consumers that expect these fields populated.
+    let transactions
+    if (Array.isArray(result?.transactions)) {
+      transactions = result.transactions.map((tx) => {
+        const mintAddress = tx?.token?.mintAddress
+        if (!mintAddress) return tx
+
+        const token = this.getTokenByAddress(mintAddress)
+        if (!token) return tx
+
+        return {
+          ...tx,
+          token: {
+            ...tx.token,
+            tokenName: tx.token.tokenName ?? token.name,
+            ticker: tx.token.ticker ?? token.ticker,
+            decimals: tx.token.decimals ?? token.decimals,
+          },
+        }
+      })
+    } else {
+      transactions = result?.transactions
+    }
+
+    return { ...result, transactions }
   }
 
   async getTransactionById(txId) {
@@ -63,10 +92,55 @@ export class ClarityApi extends RpcApi {
       .json()
   }
 
-  async getTokensBalancesAndAccounts({ address }) {
-    return this.request(`/addresses/${encodeURIComponent(address)}/tokens-balance`)
+  async getTokensBalancesAndAccounts({ address, filterByTokens } = Object.create(null)) {
+    const result = await this.request(`/addresses/${encodeURIComponent(address)}/tokens-balance`)
       .get()
       .json()
+
+    const rawAccounts = Array.isArray(result?.accounts) ? result.accounts : []
+    const rawBalances =
+      result?.balances && typeof result.balances === 'object' ? result.balances : {}
+
+    // Normalize accounts: add tokenName, ticker, decimals, and standard field names.
+    const accounts = rawAccounts.map((account) => {
+      const mintAddress = account?.mintAddress ?? account?.mint
+      const token = mintAddress ? this.getTokenByAddress(mintAddress) : null
+      const tokenProgram =
+        account?.tokenProgram ??
+        account?.program ??
+        token?.tokenProgram ??
+        TOKEN_PROGRAM_ID.toBase58()
+
+      return {
+        tokenAccountAddress: account?.tokenAccountAddress ?? account?.address ?? account?.pubkey,
+        owner: account?.owner ?? address,
+        tokenName: token?.name ?? 'unknown',
+        ticker: token?.ticker ?? 'UNKNOWN',
+        balance: account?.balance ?? account?.amount ?? rawBalances[mintAddress] ?? '0',
+        mintAddress,
+        tokenProgram,
+        decimals: token?.decimals ?? 0,
+        feeBasisPoints: account?.feeBasisPoints ?? 0,
+        maximumFee: account?.maximumFee ?? 0,
+      }
+    })
+
+    // Normalize balances: map from mint address keys to asset name keys.
+    // This ensures compatibility with existing callers that expect `{ serum: 100 }` shape.
+    const balances = Object.create(null)
+    for (const [mintAddress, amount] of Object.entries(rawBalances)) {
+      const token = this.getTokenByAddress(mintAddress)
+      if (!token) continue
+      balances[token.name] = Number(amount)
+    }
+
+    if (Array.isArray(filterByTokens) && filterByTokens.length > 0) {
+      for (const key of Object.keys(balances)) {
+        if (!filterByTokens.includes(key)) delete balances[key]
+      }
+    }
+
+    return { balances, accounts }
   }
 
   async getTokenAccountsByOwner(address, tokenTicker) {