@w3lib/solana-batch-call 0.0.0-stage → 0.1.0

package/dist/source.js

@@ -0,0 +1,126 @@
+import { DEFAULT_RPC_URLS, GENESIS_HASHES } from './constants.js';
+import { FallbackRpc, HttpRpc } from './rpc.js';
+/** @param failFast 多个自定义节点时为 true：不在单节点内重试 429，直接切到下一个节点 */
+function toTransport(source, options, failFast) {
+    if (typeof source === 'string') {
+        return new HttpRpc(source, { ...options, retries: failFast ? 0 : options.retries });
+    }
+    if (typeof source.request === 'function') {
+        return source;
+    }
+    const endpoint = source.rpcEndpoint;
+    if (typeof endpoint === 'string') {
+        return new HttpRpc(endpoint, { ...options, retries: failFast ? 0 : options.retries });
+    }
+    throw new Error('Unsupported RPC source: expected a URL, a web3.js Connection or an object with request(method, params)');
+}
+// 各节点的创世区块哈希缓存：失败（含超时）时删除，下次重试
+const genesisCache = new WeakMap();
+export function genesisOf(transport) {
+    let cached = genesisCache.get(transport);
+    if (!cached) {
+        const promise = transport.request('getGenesisHash');
+        genesisCache.set(transport, promise);
+        promise.catch(() => {
+            if (genesisCache.get(transport) === promise) {
+                genesisCache.delete(transport);
+            }
+        });
+        cached = promise;
+    }
+    return cached;
+}
+/** 识别失败后多久内不再重试（期间请求照常发出，不做校验） */
+const CHECK_RETRY_INTERVAL = 60_000;
+export class NetworkMismatchError extends Error {
+    constructor(expected, actual) {
+        super(`Network mismatch: expected genesis ${expected}, but the node is on ${actual}`);
+        this.name = 'NetworkMismatchError';
+    }
+}
+/**
+ * 校验节点所在的网络（创世区块哈希），避免把 devnet 的数据当成 mainnet 的返回。
+ * 校验与请求并行发出，不增加延迟；结果缓存，每个节点只多一次请求；识别失败时不拦截，并在一段时间内不再重试。
+ */
+export class NetworkCheckedRpc {
+    inner;
+    expected;
+    #checkFailedAt = 0;
+    constructor(inner, expected) {
+        this.inner = inner;
+        this.expected = expected;
+    }
+    async #check() {
+        if (this.#checkFailedAt && Date.now() - this.#checkFailedAt < CHECK_RETRY_INTERVAL) {
+            return;
+        }
+        let expected;
+        let actual;
+        try {
+            ;
+            [expected, actual] = await Promise.all([this.expected(), genesisOf(this.inner)]);
+        }
+        catch {
+            this.#checkFailedAt = Date.now();
+            return;
+        }
+        this.#checkFailedAt = 0;
+        if (expected !== actual) {
+            throw new NetworkMismatchError(expected, actual);
+        }
+    }
+    async request(method, params) {
+        const [checked, result] = await Promise.allSettled([this.#check(), this.inner.request(method, params)]);
+        if (checked.status === 'rejected') {
+            throw checked.reason;
+        }
+        if (result.status === 'rejected') {
+            throw result.reason;
+        }
+        return result.value;
+    }
+}
+export function resolveSource(source, cluster, options = {}) {
+    const isDefault = source === undefined;
+    const list = isDefault ? DEFAULT_RPC_URLS[cluster ?? 'mainnet'] : Array.isArray(source) ? source : [source];
+    if (!list.length) {
+        throw new Error('RPC source list is empty');
+    }
+    const multiple = list.length > 1;
+    // 内置节点保留 429 重试：浏览器里官方节点总是 403，实际只有 publicnode 一个可用节点
+    const raw = list.map((item) => toTransport(item, options, multiple && !isDefault));
+    let detecting = null;
+    const genesis = () => {
+        if (cluster) {
+            return Promise.resolve(GENESIS_HASHES[cluster]);
+        }
+        if (!detecting) {
+            const promise = (async () => {
+                let lastError;
+                for (const node of raw) {
+                    try {
+                        return await genesisOf(node);
+                    }
+                    catch (err) {
+                        lastError = err;
+                    }
+                }
+                throw lastError;
+            })();
+            detecting = promise;
+            promise.catch(() => {
+                if (detecting === promise)
+                    detecting = null;
+            });
+        }
+        return detecting;
+    };
+    // 内置节点本来就是按 cluster 选的，不校验；单个节点且没指定 cluster 时，期望值就是它自己，也不需要校验
+    const check = !isDefault && (multiple || cluster !== undefined);
+    const nodes = check ? raw.map((node) => new NetworkCheckedRpc(node, genesis)) : raw;
+    return {
+        transport: multiple ? new FallbackRpc(nodes, options) : nodes[0],
+        genesis,
+    };
+}
+//# sourceMappingURL=source.js.map

package/dist/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,104 @@
+export type Commitment = 'processed' | 'confirmed' | 'finalized';
+/** balances() 的单项结果，字段都是字符串 / 数字 / 布尔 / null，可以直接 JSON.stringify */
+export interface TokenBalance {
+    /** 代币的 mint（原样） */
+    token: string;
+    /** 是否按原生 SOL 查询 */
+    native: boolean;
+    /** 余额（最小单位的十进制字符串）；需要计算时用 BigInt(balance) */
+    balance: string;
+    decimals: number;
+    /** 按 decimals 换算后的十进制字符串，如 "1234.5"；整数不带小数点 */
+    formatted: string;
+    /** 代币所属程序（SPL Token / Token-2022）；主币或未知时为 null */
+    tokenProgram: string | null;
+    /** 仅在 symbol: true 时返回；读不到时为 null */
+    symbol?: string | null;
+    /** 查询失败（mint 不存在、地址非法等）时为 false，balance / formatted 为 "0" */
+    success: boolean;
+}
+/** ownerTokens() / getOwnerTokens() 的单项结果 */
+export interface OwnedToken extends Omit<TokenBalance, 'symbol'> {
+    /** 该代币的代币账户数量；大于 1 时 balance 为所有账户的合计 */
+    accounts: number;
+    /** metadata 为 true（默认）时返回；没有元数据或读取失败时为 null（见 metadataStatus） */
+    name?: string | null;
+    symbol?: string | null;
+    /** metadata 为 true 时返回：ok 读到了；missing 确认没有元数据；failed 节点问题没能读到（可以稍后单独用 getTokens 重查） */
+    metadataStatus?: 'ok' | 'missing' | 'failed';
+}
+export interface SolBalance {
+    address: string;
+    /** lamports（十进制字符串） */
+    balance: string;
+    /** 按 9 位精度换算后的 SOL */
+    formatted: string;
+    success: boolean;
+}
+/** tokens() / getTokens() 可选的字段 */
+export type TokenField = 'name' | 'symbol' | 'uri' | 'decimals' | 'supply' | 'tokenProgram' | 'mintAuthority' | 'freezeAuthority';
+export declare const DEFAULT_TOKEN_FIELDS: readonly ["name", "symbol", "decimals"];
+export type DefaultTokenField = (typeof DEFAULT_TOKEN_FIELDS)[number];
+interface TokenFieldTypes {
+    /** 优先取 Token-2022 TokenMetadata 扩展，其次 Metaplex 元数据 */
+    name: string | null;
+    symbol: string | null;
+    uri: string | null;
+    decimals: number | null;
+    /** 最小单位的十进制字符串 */
+    supply: string | null;
+    tokenProgram: string | null;
+    /** 没有 mint 权限（已放弃）时为 null */
+    mintAuthority: string | null;
+    freezeAuthority: string | null;
+}
+/**
+ * tokens() / getTokens() 的单项结果，只包含请求的字段。
+ * 请求 supply 时额外带 supplyFormatted（按 decimals 换算）。
+ */
+export type TokenDetails<F extends TokenField = DefaultTokenField> = {
+    /** mint 地址 */
+    address: string;
+    native: boolean;
+    /** mint 存在且请求的 name / symbol / uri / decimals / supply 都读到时为 true */
+    success: boolean;
+} & {
+    [K in F]: TokenFieldTypes[K];
+} & ('supply' extends F ? {
+    supplyFormatted: string | null;
+} : unknown);
+export type TokenStandard = 'NonFungible' | 'FungibleAsset' | 'Fungible' | 'NonFungibleEdition' | 'ProgrammableNonFungible' | 'ProgrammableNonFungibleEdition';
+/** nfts() / getNfts() 的单项结果（Metaplex 元数据；Token-2022 NFT 只有 name / symbol / uri） */
+export interface NftDetails {
+    mint: string;
+    name: string | null;
+    symbol: string | null;
+    /** 链下元数据 JSON 的地址 */
+    uri: string | null;
+    /** 所属集合；verified 为 false 表示未经集合方签名确认 */
+    collection: {
+        address: string;
+        verified: boolean;
+    } | null;
+    creators: Array<{
+        address: string;
+        verified: boolean;
+        share: number;
+    }>;
+    /** 版税，万分比 */
+    sellerFeeBasisPoints: number | null;
+    tokenStandard: TokenStandard | null;
+    isMutable: boolean | null;
+    updateAuthority: string | null;
+    success: boolean;
+}
+export interface NftOwner {
+    mint: string;
+    /** 持有人钱包地址 */
+    owner: string | null;
+    /** 持有该 NFT 的代币账户 */
+    tokenAccount: string | null;
+    success: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAA;AAEhE,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,mBAAmB;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC;IAC9D,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,uFAAuF;IACvF,cAAc,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAA;CAC7C;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,mCAAmC;AACnC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,eAAe,GAAG,iBAAiB,CAAA;AAEjI,eAAO,MAAM,oBAAoB,yCAA0E,CAAA;AAE3G,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAErE,UAAU,eAAe;IACvB,sDAAsD;IACtD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,kBAAkB;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,6BAA6B;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,UAAU,GAAG,iBAAiB,IAAI;IACnE,cAAc;IACd,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAA;CACjB,GAAG;KAAG,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;CAAE,GAAG,CAAC,QAAQ,SAAS,CAAC,GAAG;IAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,CAAA;AAE1G,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,eAAe,GACf,UAAU,GACV,oBAAoB,GACpB,yBAAyB,GACzB,gCAAgC,CAAA;AAEpC,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,qBAAqB;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,wCAAwC;IACxC,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;IACzD,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtE,aAAa;IACb,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAA;IACnC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAA;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,oBAAoB;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,EAAE,OAAO,CAAA;CACjB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const DEFAULT_TOKEN_FIELDS = ['name', 'symbol', 'decimals'];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAA0C,CAAA"}

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@w3lib/solana-batch-call",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Batched Solana reads: SOL / SPL / Token-2022 balances, token metadata, NFTs. Auto-batching JSON-RPC, getMultipleAccounts chunking, RPC failover. No Solana SDK dependency.",
+  "keywords": [
+    "solana",
+    "spl-token",
+    "token-2022",
+    "metaplex",
+    "batch",
+    "getMultipleAccounts",
+    "json-rpc"
+  ],
+  "license": "MIT",
+  "author": "L",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/web3-lib/libs.git",
+    "directory": "packages/solana-batch-call"
+  },
+  "homepage": "https://github.com/web3-lib/libs/tree/main/packages/solana-batch-call#readme",
+  "bugs": {
+    "url": "https://github.com/web3-lib/libs/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@noble/curves": "^2.4.0",
+    "@noble/hashes": "^2.4.0",
+    "@scure/base": "^2.4.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:live": "LIVE=1 vitest run test/live.test.ts"
+  }
 }

package/src/address.ts

@@ -0,0 +1,92 @@
+import { ed25519 } from '@noble/curves/ed25519.js'
+import { sha256 } from '@noble/hashes/sha2.js'
+import { base58 } from '@scure/base'
+
+import { ASSOCIATED_TOKEN_PROGRAM_ID, METADATA_PROGRAM_ID } from './constants.js'
+
+/** 是否是合法的 Solana 地址（base58，32 字节） */
+export function isAddress(value: unknown): value is string {
+  if (typeof value !== 'string' || value.length < 32 || value.length > 44) {
+    return false
+  }
+  try {
+    return base58.decode(value).length === 32
+  } catch {
+    return false
+  }
+}
+
+export function decodeAddress(address: string): Uint8Array {
+  const bytes = base58.decode(address)
+  if (bytes.length !== 32) {
+    throw new Error(`Invalid Solana address: ${address}`)
+  }
+  return bytes
+}
+
+export function encodeAddress(bytes: Uint8Array): string {
+  return base58.encode(bytes)
+}
+
+/** 32 字节是否在 ed25519 曲线上（PDA 必须不在曲线上） */
+function isOnCurve(bytes: Uint8Array): boolean {
+  try {
+    ed25519.Point.fromBytes(bytes)
+    return true
+  } catch {
+    return false
+  }
+}
+
+const PDA_MARKER = new TextEncoder().encode('ProgramDerivedAddress')
+
+function concat(parts: Uint8Array[]): Uint8Array {
+  const out = new Uint8Array(parts.reduce((n, p) => n + p.length, 0))
+  let offset = 0
+  for (const part of parts) {
+    out.set(part, offset)
+    offset += part.length
+  }
+  return out
+}
+
+// PDA 推导是纯计算但要做多次 sha256 + 曲线判断，结果缓存
+const pdaCache = new Map<string, string>()
+
+/**
+ * 推导 PDA（与 web3.js PublicKey.findProgramAddressSync 相同），返回地址。
+ * seeds 每项不超过 32 字节。
+ */
+export function findProgramAddress(seeds: Uint8Array[], programId: string): string {
+  const key = `${programId}:${seeds.map((s) => encodeAddress(s)).join(',')}`
+  const cached = pdaCache.get(key)
+  if (cached) {
+    return cached
+  }
+  const program = decodeAddress(programId)
+  for (let bump = 255; bump >= 0; bump--) {
+    const hash = sha256(concat([...seeds, new Uint8Array([bump]), program, PDA_MARKER]))
+    if (!isOnCurve(hash)) {
+      const address = encodeAddress(hash)
+      if (pdaCache.size > 10_000) {
+        pdaCache.clear()
+      }
+      pdaCache.set(key, address)
+      return address
+    }
+  }
+  throw new Error('Unable to find a viable program address bump seed')
+}
+
+/** 关联代币账户（ATA）地址 */
+export function getAssociatedTokenAddress(owner: string, mint: string, tokenProgram: string): string {
+  return findProgramAddress([decodeAddress(owner), decodeAddress(tokenProgram), decodeAddress(mint)], ASSOCIATED_TOKEN_PROGRAM_ID)
+}
+
+/** Metaplex Token Metadata 账户地址 */
+export function getMetadataAddress(mint: string): string {
+  return findProgramAddress(
+    [new TextEncoder().encode('metadata'), decodeAddress(METADATA_PROGRAM_ID), decodeAddress(mint)],
+    METADATA_PROGRAM_ID,
+  )
+}