@w3lib/solana-batch-call 0.6.0 → 0.7.0

package/src/simulate.ts

@@ -9,7 +9,7 @@ import type { RequestOptions, SolanaClient } from './client.js'
 import { NATIVE_MINT, SOL_DECIMALS, SYSTEM_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID } from './constants.js'
 import { decodeInstruction, type DecodedInstruction } from './decode.js'
 import { classify, describe, type AssetDelta, type TxKind } from './describe.js'
-import { formatUnits, parseMint, type AccountInfo } from './layout.js'
+import { computeBudgetOf, formatUnits, parseMint, parseTokenAccountState, type AccountInfo } from './layout.js'
 import { BPF_LOADER_UPGRADEABLE, COMPUTE_BUDGET, PROGRAMS, programErrorName } from './programs.js'
 import type { SolanaPriceSource } from './price.js'
 import {
@@ -222,18 +222,7 @@ interface TokenState {
 function tokenState(snap: Snap | null): TokenState | null {
   const d = snap?.data
   if (!snap || !d || (snap.owner !== TOKEN_PROGRAM_ID && snap.owner !== TOKEN_2022_PROGRAM_ID)) return null
-  if (d.length !== 165 && !(d.length > 165 && d[165] === 2)) return null
-  const view = new DataView(d.buffer, d.byteOffset, d.byteLength)
-  const key = (o: number) => encodeAddress(d.slice(o, o + 32))
-  if (d[108] === 0) return null
-  return {
-    mint: key(0),
-    owner: key(32),
-    amount: view.getBigUint64(64, true),
-    delegate: view.getUint32(72, true) === 1 ? key(76) : null,
-    delegatedAmount: view.getBigUint64(121, true),
-    closeAuthority: view.getUint32(129, true) === 1 ? key(133) : null,
-  }
+  return parseTokenAccountState(d)
 }
 
 function mintAuthorities(snap: Snap | null): { mintAuthority: string | null; freezeAuthority: string | null } | null {
@@ -338,14 +327,7 @@ export async function simulate(client: SolanaClient, input: SimulateInput, optio
   }
 
   // 手续费：签名费 + 计算单元上限 × 单价
-  let limit: bigint | null = null
-  let price = 0n
-  for (const ix of tx.instructions) {
-    if (ix.programId !== COMPUTE_BUDGET) continue
-    const view = new DataView(ix.data.buffer, ix.data.byteOffset, ix.data.byteLength)
-    if (ix.data[0] === 2 && ix.data.length >= 5) limit = BigInt(view.getUint32(1, true))
-    if (ix.data[0] === 3 && ix.data.length >= 9) price = view.getBigUint64(1, true)
-  }
+  const { limit, price } = computeBudgetOf(tx.instructions)
   const nonBudget = tx.instructions.filter((ix) => ix.programId !== COMPUTE_BUDGET).length
   const units = BigInt(Math.min(1_400_000, limit !== null ? Number(limit) : 200_000 * nonBudget))
   const fee = 5000n * BigInt(tx.signers.length) + (price * units + 999_999n) / 1_000_000n

package/src/source.ts

@@ -1,11 +1,11 @@
 import { DEFAULT_RPC_URLS, GENESIS_HASHES, type Cluster } from './constants.js'
-import { FallbackRpc, HttpRpc, type FallbackOptions, type HttpRpcOptions, type RpcTransport } from './rpc.js'
+import { FallbackRpc, HttpRpc, type FallbackOptions, type HttpRpcOptions, type RpcRequestOptions, type RpcTransport } from './rpc.js'
 
 /**
  * 节点来源（也可以传数组：主节点 + 备用节点）：
  * - RPC URL 字符串
  * - @solana/web3.js 的 Connection（使用其 rpcEndpoint）
- * - 自定义传输：实现 `request(method, params)` 的对象（如包一层 @solana/kit 的 rpc）
+ * - 自定义传输：实现 `request(method, params)` 的对象（如包一层 @solana/kit 的 rpc）；可选的第三个参数 `{ signal }` 用于取消
  */
 export type RpcSource = string | RpcTransport | { rpcEndpoint: string }
 
@@ -84,8 +84,8 @@ export class NetworkCheckedRpc implements RpcTransport {
     }
   }
 
-  async request<T = unknown>(method: string, params?: readonly unknown[]): Promise<T> {
-    const [checked, result] = await Promise.allSettled([this.#check(), this.inner.request<T>(method, params)])
+  async request<T = unknown>(method: string, params?: readonly unknown[], options?: RpcRequestOptions): Promise<T> {
+    const [checked, result] = await Promise.allSettled([this.#check(), options ? this.inner.request<T>(method, params, options) : this.inner.request<T>(method, params)])
     if (checked.status === 'rejected') {
       throw checked.reason
     }
@@ -102,10 +102,16 @@ export interface ResolvedSource {
   genesis: () => Promise<string>
 }
 
+export { clientSourceConfigs, type ClientSourceConfig } from './clientConfig.js'
+
+/**
+ * @param expectedGenesis 期望的创世哈希（如 sendRpc 要和 client 在同一个网络）：传了时总是校验节点所在网络，不一致时报 NetworkMismatchError
+ */
 export function resolveSource(
   source: RpcSource | readonly RpcSource[] | undefined,
   cluster: Cluster | undefined,
   options: SourceOptions = {},
+  expectedGenesis?: () => Promise<string>,
 ): ResolvedSource {
   const isDefault = source === undefined
   const list: readonly RpcSource[] = isDefault ? DEFAULT_RPC_URLS[cluster ?? 'mainnet'] : Array.isArray(source) ? source : [source as RpcSource]
@@ -118,6 +124,9 @@ export function resolveSource(
 
   let detecting: Promise<string> | null = null
   const genesis = (): Promise<string> => {
+    if (expectedGenesis) {
+      return expectedGenesis()
+    }
     if (cluster) {
       return Promise.resolve(GENESIS_HASHES[cluster])
     }
@@ -142,7 +151,7 @@ export function resolveSource(
   }
 
   // 内置节点本来就是按 cluster 选的，不校验；单个节点且没指定 cluster 时，期望值就是它自己，也不需要校验
-  const check = !isDefault && (multiple || cluster !== undefined)
+  const check = !isDefault && (multiple || cluster !== undefined || expectedGenesis !== undefined)
   const nodes = check ? raw.map((node) => new NetworkCheckedRpc(node, genesis)) : raw
   // 单个节点也包一层 FallbackRpc：统一 onRequest 事件和健康状态（单节点失败时抛原始错误）
   return { transport: new FallbackRpc(nodes, options), genesis }

package/src/subpaths/approvals.ts

@@ -10,7 +10,7 @@
  * await closeTokenAccounts(client, key, list.filter((a) => a.amount === '0'))
  * ```
  */
-import { approvals, type ApprovalsQuery, type TokenAccountApproval } from '../approvals.js'
+import { approvals, type ApprovalsOptions, type TokenAccountApproval } from '../approvals.js'
 import { resolve, type ShortcutOptions } from '../shortcuts.js'
 
 export {
@@ -22,6 +22,7 @@ export {
   revokeApprovals,
   type ApprovalCall,
   type ApprovalResult,
+  type ApprovalsOptions,
   type ApprovalsQuery,
   type BuildClosesOptions,
   type CloseAccountsOptions,
@@ -30,7 +31,7 @@ export {
 } from '../approvals.js'
 export { closeAccount, harvestWithheldTokensToMint, revoke } from '../write/instructions.js'
 
-export interface GetApprovalsOptions extends ApprovalsQuery, ShortcutOptions {}
+export interface GetApprovalsOptions extends ApprovalsOptions, ShortcutOptions {}
 
 /**
  * 查地址的代币账户给出的授权和可以关闭的空账户，节点参数与 getBalances 相同。

package/src/subpaths/claim.ts

@@ -11,7 +11,7 @@
  * await claimAll(client, key, c.positions)                                  // 批量领取
  * ```
  */
-import { claimable, type Claimable, type ClaimQuery } from '../claim.js'
+import { claimable, type Claimable, type ClaimableOptions } from '../claim.js'
 import { resolve, type ShortcutOptions } from '../shortcuts.js'
 
 export {
@@ -25,6 +25,7 @@ export {
   type ClaimOptions,
   type ClaimPlan,
   type ClaimProtocol,
+  type ClaimableOptions,
   type ClaimQuery,
   type ClaimResult,
   type ClaimSimulation,
@@ -35,7 +36,7 @@ export {
 } from '../claim.js'
 export type { PlanSimulation } from '../batchPlan.js'
 
-export interface GetClaimableOptions extends ClaimQuery, ShortcutOptions {}
+export interface GetClaimableOptions extends ClaimableOptions, ShortcutOptions {}
 
 /**
  * 预览一个地址能领取的手续费和挖矿奖励（只读取），节点参数与 getBalances 相同。默认列出全部代币账户（需要支持 getTokenAccountsByOwner 的节点），

package/src/subpaths/reclaim.ts

@@ -11,7 +11,7 @@
  * const { simulation, results } = await reclaim(client, key, r.items.filter((i) => i.selected))
  * ```
  */
-import { reclaimable, type Reclaimable, type ReclaimQuery } from '../reclaim.js'
+import { reclaimable, type Reclaimable, type ReclaimableOptions } from '../reclaim.js'
 import { resolve, type ShortcutOptions } from '../shortcuts.js'
 
 export {
@@ -28,6 +28,7 @@ export {
   type ReclaimKind,
   type ReclaimOptions,
   type ReclaimPlan,
+  type ReclaimableOptions,
   type ReclaimQuery,
   type ReclaimResult,
   type ReclaimSimulation,
@@ -37,7 +38,7 @@ export {
 export type { PlanSimulation } from '../batchPlan.js'
 export { burnChecked, closeAccount, harvestWithheldTokensToMint } from '../write/instructions.js'
 
-export interface GetReclaimableOptions extends ReclaimQuery, ShortcutOptions {}
+export interface GetReclaimableOptions extends ReclaimableOptions, ShortcutOptions {}
 
 /**
  * 扫描钱包里能回收租金的账户，节点参数与 getBalances 相同。默认列出全部代币账户（需要支持 getTokenAccountsByOwner 的节点），

package/src/swap/index.ts

@@ -3,7 +3,7 @@
  * （直接兑换，或经过 SOL / USDC / USDT 的两跳），按链上状态在本地报价（照搬各程序的计算），选输出最多的；
  * 按滑点算最少收到的数量，构建指令（SOL 自动包装 / 解包、缺少的代币账户自动创建），发送同 /write
  */
-import { getAssociatedTokenAddress, isAddress } from '../address.js'
+import { getAssociatedTokenAddress, InvalidAddressError, isAddress } from '../address.js'
 import type { SolanaClient } from '../client.js'
 import { NATIVE_MINT, TOKEN_PROGRAM_ID } from '../constants.js'
 import { formatUnits, parseTokenAccount, type AccountInfo } from '../layout.js'
@@ -180,7 +180,7 @@ export async function buildSwap(client: SolanaClient, owner: string, params: Sol
   const tokenIn = nativeIn ? NATIVE_MINT : params.tokenIn
   const tokenOut = nativeOut ? NATIVE_MINT : params.tokenOut
   for (const mint of [tokenIn, tokenOut]) {
-    if (!isAddress(mint)) throw new Error(`Invalid mint address: ${mint}`)
+    if (!isAddress(mint)) throw new InvalidAddressError(`Invalid mint address: ${mint}`, mint)
   }
   if (tokenIn === tokenOut) throw new Error(nativeIn || nativeOut ? 'Wrapping / unwrapping SOL is not a swap' : 'tokenIn and tokenOut are the same')
   const protocols = new Set(options.protocols ?? SWAP_PROTOCOLS)
@@ -192,7 +192,7 @@ export async function buildSwap(client: SolanaClient, owner: string, params: Sol
     if (!isAddress(m)) throw new Error(`Invalid intermediate mint: ${m}`)
   }
   for (const p of options.pools ?? []) {
-    if (!isAddress(p)) throw new Error(`Invalid pool address: ${p}`)
+    if (!isAddress(p)) throw new InvalidAddressError(`Invalid pool address: ${p}`, p)
   }
 
   // 1. 一次读：候选池子（PDA 推导 + 传入的）、Clock、各代币的 mint

package/src/tokenDetails.ts

@@ -0,0 +1,240 @@
+// 代币详情（tokens）、NFT 元数据（nfts）、NFT 持有人（nftOwners）
+
+import type { AccountInfo, TransferFeeInfo } from './layout.js'
+import { getMetadataAddress, isAddress } from './address.js'
+import type { RequestOptions, TokensOptions } from './client.js'
+import { SOL_DECIMALS, TOKEN_2022_PROGRAM_ID } from './constants.js'
+import { formatUnits, parseTokenAccount, parseTransferFeeConfig } from './layout.js'
+import { RpcError } from './rpc.js'
+import type { ReadContext } from './balances.js'
+import type { QueryContext } from './accountReader.js'
+import { getMeta, learnMeta, safeParseMetaplex, safeParseMint } from './tokenMeta.js'
+import {
+  DEFAULT_TOKEN_FIELDS,
+  type FailureReason,
+  type NftDetails,
+  type NftOwner,
+  type TokenDetails,
+  type TokenField,
+  type TokenStandard,
+  type TransferFee,
+  type TransferFeeConfig,
+} from './types.js'
+
+const TOKEN_STANDARDS: readonly TokenStandard[] = [
+  'NonFungible',
+  'FungibleAsset',
+  'Fungible',
+  'NonFungibleEdition',
+  'ProgrammableNonFungible',
+  'ProgrammableNonFungibleEdition',
+]
+
+export async function tokensOf<F extends TokenField>(rc: ReadContext, mints: readonly string[], options: TokensOptions<F>): Promise<TokenDetails<F>[]> {
+  const fields = (options.fields ?? DEFAULT_TOKEN_FIELDS) as readonly F[]
+  const wanted = new Set<TokenField>(fields)
+  const scope = rc.scope
+  const ctx: QueryContext = { signal: options.signal }
+  const needsNames = wanted.has('name') || wanted.has('symbol') || wanted.has('uri')
+  const addresses: string[] = []
+  const plan = mints.map((mint) => {
+    if (rc.nativeMints.has(mint) || !isAddress(mint)) {
+      return { mint, mintIndex: -1, metadataIndex: -1 }
+    }
+    const meta = getMeta(scope, mint)
+    // uri / supply / 权限 / 手续费不缓存，需要时总要读 mint；name / symbol 命中缓存时可以省掉元数据账户
+    const cachedOnly =
+      !wanted.has('uri') &&
+      !wanted.has('supply') &&
+      !wanted.has('mintAuthority') &&
+      !wanted.has('freezeAuthority') &&
+      !wanted.has('transferFee') &&
+      (!wanted.has('decimals') || meta.decimals !== undefined) &&
+      (!wanted.has('tokenProgram') || meta.tokenProgram !== undefined) &&
+      (!wanted.has('name') || meta.name !== undefined) &&
+      (!wanted.has('symbol') || meta.symbol !== undefined)
+    if (cachedOnly) {
+      return { mint, mintIndex: -1, metadataIndex: -1 }
+    }
+    const namesCached = (!wanted.has('name') || meta.name !== undefined) && (!wanted.has('symbol') || meta.symbol !== undefined) && !wanted.has('uri')
+    return {
+      mint,
+      mintIndex: addresses.push(mint) - 1,
+      metadataIndex: needsNames && !namesCached ? addresses.push(getMetadataAddress(mint)) - 1 : -1,
+    }
+  })
+  const [accounts, epoch] = await Promise.all([
+    addresses.length ? rc.reader.accounts(addresses, ctx) : Promise.resolve([] as (AccountInfo | null)[]),
+    // 手续费按当前 epoch 选新 / 旧配置；和账户读取在同一个批量请求里
+    wanted.has('transferFee') && addresses.length
+      ? rc.reader.call<{ epoch: number | string }>(ctx, 'getEpochInfo', [{ commitment: rc.commitment }]).then((res) => BigInt(res.epoch))
+      : Promise.resolve(null),
+  ])
+
+  return plan.map(({ mint, mintIndex, metadataIndex }) => {
+    const native = rc.nativeMints.has(mint)
+    const values: Record<TokenField, unknown> & { exists: boolean } = native
+      ? { exists: true, name: 'Solana', symbol: 'SOL', uri: null, decimals: SOL_DECIMALS, supply: null, tokenProgram: null, mintAuthority: null, freezeAuthority: null, transferFee: null }
+      : tokenValues(
+          rc,
+          mint,
+          mintIndex === -1 ? null : (accounts[mintIndex] ?? null),
+          metadataIndex === -1 ? null : (accounts[metadataIndex] ?? null),
+          mintIndex !== -1,
+          mintIndex !== -1 && metadataIndex !== -1,
+          epoch,
+        )
+    const out: Record<string, unknown> = { address: mint, native }
+    let missing: F | undefined
+    for (const field of fields) {
+      out[field] = values[field] ?? null
+      // 权限为 null 表示没有权限、手续费为 null 表示没有手续费，都是有效值；主币没有 uri / supply / tokenProgram
+      const nullable =
+        field === 'mintAuthority' || field === 'freezeAuthority' || field === 'transferFee' || (native && (field === 'uri' || field === 'supply' || field === 'tokenProgram'))
+      if (out[field] === null && !nullable) {
+        missing ??= field
+      }
+    }
+    if (wanted.has('supply')) {
+      const supply = values.supply as string | null
+      const decimals = values.decimals as number | null
+      out.supplyFormatted = supply === null || decimals === null ? null : formatUnits(BigInt(supply), decimals)
+    }
+    const error: FailureReason | undefined = native
+      ? undefined
+      : !isAddress(mint)
+        ? 'invalid-address'
+        : !values.exists
+          ? accounts[mintIndex]
+            ? 'not-token'
+            : 'not-found'
+          : missing
+            ? 'missing-field'
+            : undefined
+    out.success = error === undefined
+    if (error) {
+      out.error = error
+      if (error === 'missing-field') {
+        out.errorField = missing
+      }
+    }
+    return out as TokenDetails<F>
+  })
+}
+
+function tokenValues(
+  rc: ReadContext,
+  mint: string,
+  mintAccount: AccountInfo | null,
+  metadataAccount: AccountInfo | null,
+  fetchedMint: boolean,
+  lookedForNames: boolean,
+  epoch: bigint | null,
+): Record<TokenField, unknown> & { exists: boolean } {
+  const scope = rc.scope
+  const meta = learnMeta(scope, mint, mintAccount, metadataAccount, lookedForNames)
+  const info = mintAccount ? safeParseMint(mintAccount) : null
+  const uri = info?.metadata?.uri ?? (metadataAccount ? (safeParseMetaplex(metadataAccount)?.uri ?? null) : null)
+  const feeConfig = info && mintAccount?.owner === TOKEN_2022_PROGRAM_ID ? parseTransferFeeConfig(mintAccount.data) : null
+  return {
+    // 读了 mint 账户就以它为准（不存在则 false）；没读说明请求的字段全部命中缓存
+    exists: fetchedMint ? info !== null : true,
+    name: meta.name ?? null,
+    symbol: meta.symbol ?? null,
+    uri,
+    decimals: meta.decimals ?? null,
+    supply: info ? info.supply.toString() : null,
+    tokenProgram: meta.tokenProgram ?? null,
+    mintAuthority: info?.mintAuthority ?? null,
+    freezeAuthority: info?.freezeAuthority ?? null,
+    transferFee: feeConfig ? toTransferFeeConfig(feeConfig.older, feeConfig.newer, epoch) : null,
+  }
+}
+
+function toTransferFee(fee: TransferFeeInfo): TransferFee {
+  return { basisPoints: fee.basisPoints, maximumFee: fee.maximumFee.toString(), epoch: fee.epoch.toString() }
+}
+
+/** 当前生效的配置：epoch >= newer.epoch 用 newer，否则 older；不知道当前 epoch 时按 newer */
+function toTransferFeeConfig(older: TransferFeeInfo, newer: TransferFeeInfo, epoch: bigint | null): TransferFeeConfig {
+  const current = epoch === null || epoch >= newer.epoch ? newer : older
+  return { ...toTransferFee(current), older: toTransferFee(older), newer: toTransferFee(newer) }
+}
+
+/** 批量查 NFT 元数据（Metaplex；Token-2022 NFT 取 TokenMetadata 扩展），一次 getMultipleAccounts */
+export async function nftsOf(rc: ReadContext, mints: readonly string[], options: RequestOptions): Promise<NftDetails[]> {
+  const scope = rc.scope
+  const addresses: string[] = []
+  const plan = mints.map((mint) =>
+    isAddress(mint) ? { mint, metadataIndex: addresses.push(getMetadataAddress(mint)) - 1, mintIndex: addresses.push(mint) - 1 } : { mint, metadataIndex: -1, mintIndex: -1 },
+  )
+  const accounts = addresses.length ? await rc.reader.accounts(addresses, { signal: options.signal }) : []
+  return plan.map(({ mint, metadataIndex, mintIndex }): NftDetails => {
+    const metadataAccount = metadataIndex === -1 ? null : (accounts[metadataIndex] ?? null)
+    const mintAccount = mintIndex === -1 ? null : (accounts[mintIndex] ?? null)
+    learnMeta(scope, mint, mintAccount, metadataAccount, mintIndex !== -1)
+    const metaplex = metadataAccount ? safeParseMetaplex(metadataAccount) : null
+    const ext = mintAccount ? (safeParseMint(mintAccount)?.metadata ?? null) : null
+    if (!metaplex && !ext) {
+      const error: FailureReason = mintIndex === -1 ? 'invalid-address' : !mintAccount ? 'not-found' : !safeParseMint(mintAccount) ? 'not-token' : 'no-metadata'
+      return { mint, name: null, symbol: null, uri: null, collection: null, creators: [], sellerFeeBasisPoints: null, tokenStandard: null, isMutable: null, updateAuthority: null, success: false, error }
+    }
+    return {
+      mint,
+      name: ext?.name ?? metaplex?.name ?? null,
+      symbol: ext?.symbol ?? metaplex?.symbol ?? null,
+      uri: ext?.uri ?? metaplex?.uri ?? null,
+      collection: metaplex?.collection ?? null,
+      creators: metaplex?.creators ?? [],
+      sellerFeeBasisPoints: metaplex?.sellerFeeBasisPoints ?? null,
+      tokenStandard: metaplex?.tokenStandard == null ? null : (TOKEN_STANDARDS[metaplex.tokenStandard] ?? null),
+      isMutable: metaplex?.isMutable ?? null,
+      updateAuthority: metaplex?.updateAuthority ?? null,
+      success: true,
+    }
+  })
+}
+
+/**
+ * 批量查 NFT 持有人：getTokenLargestAccounts（合并成一个批量请求）+ 一次 getMultipleAccounts。
+ * 节点拒绝的 mint（不存在 / 不是代币）在同一次 getMultipleAccounts 里读 mint 账户区分原因
+ */
+export async function nftOwnersOf(rc: ReadContext, mints: readonly string[], options: RequestOptions): Promise<NftOwner[]> {
+  const ctx: QueryContext = { signal: options.signal }
+  const largest = await Promise.all(
+    mints.map((mint): Promise<{ tokenAccount: string | null; rejected: boolean }> =>
+      isAddress(mint)
+        ? rc.reader.call<{ value: Array<{ address: string; amount: string }> }>(ctx, 'getTokenLargestAccounts', [mint, { commitment: rc.commitment }])
+            .then((res) => ({ tokenAccount: res.value.find((a) => a.amount !== '0')?.address ?? null, rejected: false }))
+            .catch((err: unknown) => {
+              // mint 不存在 / 不是代币：该项失败；节点问题照常抛出
+              if (err instanceof RpcError && !err.nodeFault) return { tokenAccount: null, rejected: true }
+              throw err
+            })
+        : Promise.resolve({ tokenAccount: null, rejected: false }),
+    ),
+  )
+  const toRead = largest.flatMap(({ tokenAccount, rejected }, i) => (tokenAccount ? [tokenAccount] : rejected ? [mints[i] as string] : []))
+  const accounts = toRead.length ? await rc.reader.accounts(toRead, ctx) : []
+  const byAddress = new Map(toRead.map((a, i) => [a, accounts[i] ?? null]))
+  return mints.map((mint, i): NftOwner => {
+    const { tokenAccount, rejected } = largest[i] ?? { tokenAccount: null, rejected: false }
+    if (!isAddress(mint)) {
+      return { mint, owner: null, tokenAccount: null, success: false, error: 'invalid-address' }
+    }
+    if (rejected) {
+      return { mint, owner: null, tokenAccount: null, success: false, error: byAddress.get(mint) ? 'not-token' : 'not-found' }
+    }
+    const account = tokenAccount ? byAddress.get(tokenAccount) : null
+    let owner: string | null = null
+    if (account) {
+      try {
+        owner = parseTokenAccount(account.data).owner
+      } catch {
+        owner = null
+      }
+    }
+    // 没有余额大于 0 的代币账户（供应量为 0 / 已销毁），或代币账户刚被关闭
+    return owner ? { mint, owner, tokenAccount, success: true } : { mint, owner: null, tokenAccount: null, success: false, error: 'no-holder' }
+  })
+}