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

package/dist/constants.js

@@ -0,0 +1,35 @@
+export const SYSTEM_PROGRAM_ID = '11111111111111111111111111111111';
+export const TOKEN_PROGRAM_ID = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';
+export const TOKEN_2022_PROGRAM_ID = 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb';
+export const ASSOCIATED_TOKEN_PROGRAM_ID = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
+export const METADATA_PROGRAM_ID = 'metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s';
+/** Wrapped SOL 的 mint，按惯例也用来表示原生 SOL */
+export const NATIVE_MINT = 'So11111111111111111111111111111111111111112';
+/** 原生 SOL 的精度（lamports） */
+export const SOL_DECIMALS = 9;
+/** 各网络的创世区块哈希（getGenesisHash），用于识别节点所在网络 */
+export const GENESIS_HASHES = {
+    mainnet: '5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d',
+    devnet: 'EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG',
+    testnet: '4uhcVJyU9pJkvQyS88uRDiswHXSCkY3zQawwpjk2NsNY',
+};
+export function clusterOfGenesis(hash) {
+    for (const [cluster, genesis] of Object.entries(GENESIS_HASHES)) {
+        if (genesis === hash) {
+            return cluster;
+        }
+    }
+    return null;
+}
+/**
+ * 内置公共节点（按优先级排序，2026-10 实测）：
+ * - publicnode：放行跨域、支持批量请求，但不支持 getTokenAccountsByOwner 等需要索引的方法
+ * - 官方节点：对带浏览器 Origin 的请求返回 403，只能在服务端使用
+ * 公共节点限频严，生产环境建议传入自己的节点（Helius / QuickNode / Triton 等）。
+ */
+export const DEFAULT_RPC_URLS = {
+    mainnet: ['https://solana-rpc.publicnode.com', 'https://api.mainnet-beta.solana.com'],
+    devnet: ['https://api.devnet.solana.com'],
+    testnet: ['https://api.testnet.solana.com'],
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,kCAAkC,CAAA;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,6CAA6C,CAAA;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,6CAA6C,CAAA;AAClF,MAAM,CAAC,MAAM,2BAA2B,GAAG,8CAA8C,CAAA;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG,6CAA6C,CAAA;AAEhF,wCAAwC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,6CAA6C,CAAA;AAExE,2BAA2B;AAC3B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAA;AAI7B,4CAA4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAsC;IAC/D,OAAO,EAAE,8CAA8C;IACvD,MAAM,EAAE,8CAA8C;IACtD,OAAO,EAAE,8CAA8C;CACxD,CAAA;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAChE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,OAAkB,CAAA;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiD;IAC5E,OAAO,EAAE,CAAC,mCAAmC,EAAE,qCAAqC,CAAC;IACrF,MAAM,EAAE,CAAC,+BAA+B,CAAC;IACzC,OAAO,EAAE,CAAC,gCAAgC,CAAC;CAC5C,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { SolanaClient, type BalancesOptions, type ClientConfig, type OwnerTokensOptions, type TokensOptions } from './client.js';
+export { getBalances, getNftOwners, getNfts, getOwnerNfts, getOwnerTokens, getSolBalances, getTokens, type GetBalancesOptions, type GetOwnerTokensOptions, type GetTokensOptions, type ShortcutOptions, } from './shortcuts.js';
+export { DEFAULT_TOKEN_FIELDS, type Commitment, type DefaultTokenField, type NftDetails, type NftOwner, type OwnedToken, type SolBalance, type TokenBalance, type TokenDetails, type TokenField, type TokenStandard, } from './types.js';
+export { ASSOCIATED_TOKEN_PROGRAM_ID, DEFAULT_RPC_URLS, GENESIS_HASHES, METADATA_PROGRAM_ID, NATIVE_MINT, SOL_DECIMALS, SYSTEM_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID, clusterOfGenesis, type Cluster, } from './constants.js';
+export { decodeAddress, encodeAddress, findProgramAddress, getAssociatedTokenAddress, getMetadataAddress, isAddress } from './address.js';
+export { formatAmount, parseMetaplexMetadata, parseMint, parseTokenAccount, type AccountInfo, type MetaplexMetadata, type MintInfo, type TokenAccountInfo, type TokenMetadata, } from './layout.js';
+export { FallbackRpc, HttpError, HttpRpc, RpcError, isNodeFault, type FallbackOptions, type HttpRpcOptions, type RpcTransport } from './rpc.js';
+export { NetworkCheckedRpc, NetworkMismatchError, type RpcSource, type SourceOptions } from './source.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAChI,OAAO,EACL,WAAW,EACX,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,OAAO,GACb,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACzI,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,SAAS,EACT,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAA;AAC/I,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { SolanaClient } from './client.js';
+export { getBalances, getNftOwners, getNfts, getOwnerNfts, getOwnerTokens, getSolBalances, getTokens, } from './shortcuts.js';
+export { DEFAULT_TOKEN_FIELDS, } from './types.js';
+export { ASSOCIATED_TOKEN_PROGRAM_ID, DEFAULT_RPC_URLS, GENESIS_HASHES, METADATA_PROGRAM_ID, NATIVE_MINT, SOL_DECIMALS, SYSTEM_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID, clusterOfGenesis, } from './constants.js';
+export { decodeAddress, encodeAddress, findProgramAddress, getAssociatedTokenAddress, getMetadataAddress, isAddress } from './address.js';
+export { formatAmount, parseMetaplexMetadata, parseMint, parseTokenAccount, } from './layout.js';
+export { FallbackRpc, HttpError, HttpRpc, RpcError, isNodeFault } from './rpc.js';
+export { NetworkCheckedRpc, NetworkMismatchError } from './source.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAwF,MAAM,aAAa,CAAA;AAChI,OAAO,EACL,WAAW,EACX,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,GAKV,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,oBAAoB,GAWrB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,GAEjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACzI,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,SAAS,EACT,iBAAiB,GAMlB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAgE,MAAM,UAAU,CAAA;AAC/I,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAsC,MAAM,aAAa,CAAA"}

package/dist/layout.d.ts

@@ -0,0 +1,55 @@
+/** getMultipleAccounts 解析后的账户 */
+export interface AccountInfo {
+    address: string;
+    lamports: bigint;
+    /** 所属程序 */
+    owner: string;
+    data: Uint8Array;
+    executable: boolean;
+}
+export interface MintInfo {
+    mintAuthority: string | null;
+    supply: bigint;
+    decimals: number;
+    isInitialized: boolean;
+    freezeAuthority: string | null;
+    /** Token-2022 TokenMetadata 扩展（如有） */
+    metadata: TokenMetadata | null;
+}
+export interface TokenMetadata {
+    name: string;
+    symbol: string;
+    uri: string;
+}
+/** 解析 Mint 账户（SPL Token / Token-2022 通用，Token-2022 额外解析 TokenMetadata 扩展） */
+export declare function parseMint(data: Uint8Array): MintInfo;
+export interface TokenAccountInfo {
+    mint: string;
+    owner: string;
+    amount: bigint;
+}
+/** 解析代币账户（SPL Token / Token-2022 前 72 字节相同） */
+export declare function parseTokenAccount(data: Uint8Array): TokenAccountInfo;
+export interface MetaplexMetadata extends TokenMetadata {
+    updateAuthority: string;
+    mint: string;
+    sellerFeeBasisPoints: number;
+    creators: Array<{
+        address: string;
+        verified: boolean;
+        share: number;
+    }>;
+    primarySaleHappened: boolean;
+    isMutable: boolean;
+    /** 0 NonFungible，1 FungibleAsset，2 Fungible，3 NonFungibleEdition，4 ProgrammableNonFungible，5 ProgrammableNonFungibleEdition */
+    tokenStandard: number | null;
+    collection: {
+        address: string;
+        verified: boolean;
+    } | null;
+}
+/** 解析 Metaplex Token Metadata 账户；老版本账户缺少后面的字段时，缺的部分为默认值 */
+export declare function parseMetaplexMetadata(data: Uint8Array): MetaplexMetadata;
+/** 按精度格式化：formatAmount(1_500_000_000n, 9) === '1.5' */
+export declare function formatAmount(value: bigint, decimals: number): string;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAEA,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,UAAU,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;CACpB;AA4ED,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,OAAO,CAAA;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ;AAWD,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,CAqBpD;AAyBD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAMpE;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB,EAAE,MAAM,CAAA;IAC5B,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtE,mBAAmB,EAAE,OAAO,CAAA;IAC5B,SAAS,EAAE,OAAO,CAAA;IAClB,+HAA+H;IAC/H,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAC1D;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CA0CxE;AAED,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMpE"}

package/dist/layout.js

@@ -0,0 +1,177 @@
+import { encodeAddress } from './address.js';
+class Reader {
+    bytes;
+    #offset;
+    #view;
+    constructor(bytes, offset = 0) {
+        this.bytes = bytes;
+        this.#offset = offset;
+        this.#view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    }
+    get offset() {
+        return this.#offset;
+    }
+    #need(n) {
+        if (this.#offset + n > this.bytes.length) {
+            throw new RangeError('Account data is shorter than expected');
+        }
+    }
+    skip(n) {
+        this.#need(n);
+        this.#offset += n;
+    }
+    u8() {
+        this.#need(1);
+        return this.bytes[this.#offset++];
+    }
+    u16() {
+        this.#need(2);
+        const v = this.#view.getUint16(this.#offset, true);
+        this.#offset += 2;
+        return v;
+    }
+    u32() {
+        this.#need(4);
+        const v = this.#view.getUint32(this.#offset, true);
+        this.#offset += 4;
+        return v;
+    }
+    u64() {
+        this.#need(8);
+        const v = this.#view.getBigUint64(this.#offset, true);
+        this.#offset += 8;
+        return v;
+    }
+    pubkey() {
+        this.#need(32);
+        const v = encodeAddress(this.bytes.slice(this.#offset, this.#offset + 32));
+        this.#offset += 32;
+        return v;
+    }
+    /** borsh string：u32 长度 + UTF-8；去掉 Metaplex 用来补齐长度的 \0 */
+    string() {
+        const len = this.u32();
+        this.#need(len);
+        const v = new TextDecoder().decode(this.bytes.slice(this.#offset, this.#offset + len));
+        this.#offset += len;
+        return v.replace(/\0+$/, '').trim();
+    }
+    option(read) {
+        return this.u8() === 1 ? read() : null;
+    }
+}
+const MINT_SIZE = 82;
+const ACCOUNT_SIZE = 165;
+/** Token-2022 带扩展的账户：基础布局补齐到 165（Account 的大小），第 165 字节是账户类型，之后是扩展 */
+const ACCOUNT_TYPE_OFFSET = 165;
+const EXTENSIONS_OFFSET = 166;
+const ACCOUNT_TYPE_MINT = 1;
+const ACCOUNT_TYPE_ACCOUNT = 2;
+const EXTENSION_TOKEN_METADATA = 19;
+/** 解析 Mint 账户（SPL Token / Token-2022 通用，Token-2022 额外解析 TokenMetadata 扩展） */
+export function parseMint(data) {
+    // 只接受真正的 mint：SPL Token 恰好 82 字节；Token-2022 带扩展时账户类型必须是 Mint（避免把代币账户 / 多签账户当成 mint）
+    if (data.length !== MINT_SIZE && !(data.length > ACCOUNT_TYPE_OFFSET && data[ACCOUNT_TYPE_OFFSET] === ACCOUNT_TYPE_MINT)) {
+        throw new RangeError('Not a mint account');
+    }
+    const r = new Reader(data);
+    const hasMintAuthority = r.u32() === 1;
+    const mintAuthority = r.pubkey();
+    const supply = r.u64();
+    const decimals = r.u8();
+    const isInitialized = r.u8() === 1;
+    const hasFreezeAuthority = r.u32() === 1;
+    const freezeAuthority = r.pubkey();
+    return {
+        mintAuthority: hasMintAuthority ? mintAuthority : null,
+        supply,
+        decimals,
+        isInitialized,
+        freezeAuthority: hasFreezeAuthority ? freezeAuthority : null,
+        metadata: data.length > EXTENSIONS_OFFSET ? parseTokenMetadataExtension(data) : null,
+    };
+}
+function parseTokenMetadataExtension(data) {
+    try {
+        const r = new Reader(data, EXTENSIONS_OFFSET);
+        while (r.offset + 4 <= data.length) {
+            const type = r.u16();
+            const length = r.u16();
+            if (type === 0 && length === 0) {
+                return null; // 未初始化的填充
+            }
+            if (type === EXTENSION_TOKEN_METADATA) {
+                const m = new Reader(data.slice(r.offset, r.offset + length));
+                m.pubkey(); // updateAuthority
+                m.pubkey(); // mint
+                return { name: m.string(), symbol: m.string(), uri: m.string() };
+            }
+            r.skip(length);
+        }
+    }
+    catch {
+        // 扩展数据不完整：当作没有
+    }
+    return null;
+}
+/** 解析代币账户（SPL Token / Token-2022 前 72 字节相同） */
+export function parseTokenAccount(data) {
+    if (data.length !== ACCOUNT_SIZE && !(data.length > ACCOUNT_TYPE_OFFSET && data[ACCOUNT_TYPE_OFFSET] === ACCOUNT_TYPE_ACCOUNT)) {
+        throw new RangeError('Not a token account');
+    }
+    const r = new Reader(data);
+    return { mint: r.pubkey(), owner: r.pubkey(), amount: r.u64() };
+}
+/** 解析 Metaplex Token Metadata 账户；老版本账户缺少后面的字段时，缺的部分为默认值 */
+export function parseMetaplexMetadata(data) {
+    const r = new Reader(data);
+    if (r.u8() !== 4) {
+        throw new RangeError('Not a Metaplex metadata account'); // Key::MetadataV1 = 4
+    }
+    const updateAuthority = r.pubkey();
+    const mint = r.pubkey();
+    const name = r.string();
+    const symbol = r.string();
+    const uri = r.string();
+    const sellerFeeBasisPoints = r.u16();
+    const creators = r.option(() => {
+        const count = r.u32();
+        return Array.from({ length: count }, () => ({ address: r.pubkey(), verified: r.u8() === 1, share: r.u8() }));
+    }) ?? [];
+    const result = {
+        updateAuthority,
+        mint,
+        name,
+        symbol,
+        uri,
+        sellerFeeBasisPoints,
+        creators,
+        primarySaleHappened: false,
+        isMutable: false,
+        tokenStandard: null,
+        collection: null,
+    };
+    try {
+        result.primarySaleHappened = r.u8() === 1;
+        result.isMutable = r.u8() === 1;
+        r.option(() => r.u8()); // editionNonce
+        result.tokenStandard = r.option(() => r.u8());
+        result.collection = r.option(() => {
+            const verified = r.u8() === 1;
+            return { address: r.pubkey(), verified };
+        });
+    }
+    catch {
+        // 老版本账户没有这些字段
+    }
+    return result;
+}
+/** 按精度格式化：formatAmount(1_500_000_000n, 9) === '1.5' */
+export function formatAmount(value, decimals) {
+    const negative = value < 0n;
+    const digits = (negative ? -value : value).toString().padStart(decimals + 1, '0');
+    const whole = digits.slice(0, digits.length - decimals);
+    const fraction = digits.slice(digits.length - decimals).replace(/0+$/, '');
+    return `${negative ? '-' : ''}${whole}${fraction ? `.${fraction}` : ''}`;
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

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

package/dist/rpc.d.ts

@@ -0,0 +1,59 @@
+/** 最小的 JSON-RPC 传输接口：可以传入自己的实现（如包一层 @solana/kit 的 rpc） */
+export interface RpcTransport {
+    request<T = unknown>(method: string, params?: readonly unknown[]): Promise<T>;
+}
+/** 节点返回的 JSON-RPC 错误 */
+export declare class RpcError extends Error {
+    readonly code: number | undefined;
+    readonly data: unknown;
+    /** 是否是节点自身的限制（限频、需要 API Key、禁止访问等），换节点可能成功 */
+    readonly nodeFault: boolean;
+    constructor(message: string, code?: number, data?: unknown);
+}
+/** HTTP 层错误（非 2xx、网络错误、超时） */
+export declare class HttpError extends Error {
+    readonly status: number | undefined;
+    constructor(message: string, status?: number);
+}
+/** 是否是节点问题（应换节点重试）：除了确定性的 JSON-RPC 错误（如参数错误），其余都算 */
+export declare function isNodeFault(err: unknown): boolean;
+export interface HttpRpcOptions {
+    /** 单次 HTTP 请求超时（毫秒），<= 0 不限制。默认 10000 */
+    timeout?: number;
+    headers?: Record<string, string>;
+    /** 一个 HTTP 批量请求最多包含的调用数。默认 20 */
+    maxBatchSize?: number;
+    /** 是否合并成 JSON-RPC 批量请求。默认 true；节点不支持时会自动关闭 */
+    batch?: boolean;
+    /** 收集窗口（毫秒），窗口内的调用合并成一个 HTTP 请求。默认 0（同一 tick） */
+    batchWait?: number;
+    /** 遇到 HTTP 429 时的重试次数（指数退避，从 500ms 开始）。默认 2 */
+    retries?: number;
+    /** 自定义 fetch（如需要代理时） */
+    fetch?: typeof fetch;
+}
+/**
+ * 基于 fetch 的 JSON-RPC 传输：同一收集窗口内的调用合并成一个 JSON-RPC 批量请求。
+ * 节点不支持批量（返回非数组）或限制批量大小（如 drpc 免费档最多 3 条）时自动降级。
+ */
+export declare class HttpRpc implements RpcTransport {
+    #private;
+    readonly url: string;
+    constructor(url: string, options?: HttpRpcOptions);
+    request<T = unknown>(method: string, params?: readonly unknown[]): Promise<T>;
+}
+export interface FallbackOptions {
+    /** 出错节点的冷却时间（毫秒），期间排到最后。默认 30000 */
+    cooldown?: number;
+}
+/**
+ * 多节点故障切换：按顺序使用，节点问题（网络、超时、限频、需要 Key、403 等）换下一个；
+ * 参数错误等确定性错误直接抛出。出错的节点在冷却期内排到最后。
+ */
+export declare class FallbackRpc implements RpcTransport {
+    #private;
+    readonly nodes: readonly RpcTransport[];
+    constructor(nodes: readonly RpcTransport[], options?: FallbackOptions);
+    request<T = unknown>(method: string, params?: readonly unknown[]): Promise<T>;
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC9E;AAED,wBAAwB;AACxB,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;gBAEf,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAW3D;AAED,8BAA8B;AAC9B,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;gBAEvB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAK7C;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKjD;AAED,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAwBD;;;GAGG;AACH,qBAAa,OAAQ,YAAW,YAAY;;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAWR,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;IAWrD,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,SAAS,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAwJlF;AAsCD,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,qBAAa,WAAY,YAAW,YAAY;;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;gBAI3B,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,GAAE,eAAoB;IASnE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;CA0BpF"}