@w3lib/solana-batch-call 0.3.0 → 0.5.0

package/dist/approvals.d.ts.map

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

package/dist/approvals.js

@@ -0,0 +1,221 @@
+/**
+ * 授权管理（子路径 `@w3lib/solana-batch-call/approvals`）：Solana 上的“授权”是代币账户的 delegate（Approve 设置，可以转走 delegatedAmount 以内的代币）。
+ * 批量查一个地址的代币账户给出的授权、可以关闭回收租金的空账户；批量撤销（Revoke）、关闭（CloseAccount，租金退回）
+ */
+import { base64 } from '@scure/base';
+import { encodeAddress, getAssociatedTokenAddress, getMetadataAddress, isAddress } from './address.js';
+import { TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID } from './constants.js';
+import { findExtension, formatUnits, parseMetaplexMetadata, parseMint } from './layout.js';
+import { methodUnavailable } from './lp.js';
+import { closeAccount, harvestWithheldTokensToMint, revoke } from './write/instructions.js';
+const ACCOUNT_SIZE = 165;
+const ACCOUNT_TYPE_ACCOUNT = 2;
+const EXT_TRANSFER_FEE_AMOUNT = 2;
+const EXT_CONFIDENTIAL_TRANSFER_ACCOUNT = 5;
+const EXT_PERMANENT_DELEGATE = 12;
+const EXT_CONFIDENTIAL_TRANSFER_FEE_AMOUNT = 17;
+const ZERO_PUBKEY = '11111111111111111111111111111111';
+/** 解析代币账户；不是已初始化的代币账户时为 null */
+export function parseTokenAccountState(data) {
+    if (data.length !== ACCOUNT_SIZE && !(data.length > ACCOUNT_SIZE && data[ACCOUNT_SIZE] === ACCOUNT_TYPE_ACCOUNT)) {
+        return null;
+    }
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const pubkey = (offset) => encodeAddress(data.slice(offset, offset + 32));
+    // COption：u32 标记（1 有、0 没有）+ 值
+    const option = (offset) => view.getUint32(offset, true) === 1;
+    const state = data[108];
+    if (state === 0) {
+        return null; // 未初始化
+    }
+    const withheld = findExtension(data, EXT_TRANSFER_FEE_AMOUNT);
+    // 机密转账：待入账（lo / hi）和可用余额的密文全为 0 才能关闭；手续费扩展同理（Token-2022 的 closable 检查）
+    const confidential = findExtension(data, EXT_CONFIDENTIAL_TRANSFER_ACCOUNT);
+    const confidentialFee = findExtension(data, EXT_CONFIDENTIAL_TRANSFER_FEE_AMOUNT);
+    const nonZero = (bytes, from, to) => !!bytes && bytes.slice(from, to).some((b) => b !== 0);
+    return {
+        mint: pubkey(0),
+        owner: pubkey(32),
+        amount: view.getBigUint64(64, true),
+        delegate: option(72) ? pubkey(76) : null,
+        frozen: state === 2,
+        native: option(109),
+        delegatedAmount: view.getBigUint64(121, true),
+        closeAuthority: option(129) ? pubkey(133) : null,
+        withheldAmount: withheld && withheld.length >= 8 ? new DataView(withheld.buffer, withheld.byteOffset).getBigUint64(0, true) : 0n,
+        confidentialBalance: nonZero(confidential, 33, 225) || nonZero(confidentialFee, 0, 64),
+    };
+}
+/**
+ * 查一个地址的代币账户给出的授权，和可以关闭回收租金的空账户（结果按账户，同一账户的授权和关闭状态在一起）。
+ * 传 mints 时读这些代币的 ATA（一次 getMultipleAccounts，免费公共节点也能用）；不传时列出全部代币账户（需要支持 getTokenAccountsByOwner 的节点）
+ *
+ * ```ts
+ * await approvals(client, owner, { mints: [USDC, BONK] })
+ * // [{ account: '…', mint: USDC, delegate: 'JUP…', delegatedAmount: '1000000', revocable: true, closable: false, closeBlocker: 'balance', … }]
+ * await approvals(new SolanaClient('https://my-rpc…'), owner)   // 全部代币账户
+ * ```
+ */
+export async function approvals(client, owner, query = {}) {
+    if (!isAddress(owner)) {
+        throw new Error(`Invalid owner address: ${owner}`);
+    }
+    const { signal } = query;
+    const found = query.mints ? await ataAccounts(client, owner, query.mints, signal) : await listAccounts(client, owner, signal);
+    // 只看 owner 自己的账户（ATA 的 owner 可能被改过：SPL Token 的 ATA 能 SetAuthority 换 owner）
+    const mine = found.filter((f) => f.parsed.owner === owner);
+    const mints = [...new Set(mine.map((f) => f.parsed.mint))];
+    const metaAddresses = mints.flatMap((m) => [m, getMetadataAddress(m)]);
+    const metaAccounts = metaAddresses.length ? await client.accounts(metaAddresses, { signal }) : [];
+    const meta = new Map(mints.map((mint, i) => [mint, mintMeta(metaAccounts[2 * i] ?? null, metaAccounts[2 * i + 1] ?? null)]));
+    const list = mine.map((f) => {
+        const p = f.parsed;
+        const m = meta.get(p.mint) ?? { decimals: null, symbol: null, permanentDelegate: null };
+        const format = (v) => (m.decimals === null ? null : formatUnits(v, m.decimals));
+        const closeBlocker = p.closeAuthority !== null && p.closeAuthority !== owner ? 'close-authority' : !p.native && p.amount > 0n ? 'balance' : p.confidentialBalance ? 'confidential-balance' : null;
+        return {
+            account: f.address,
+            mint: p.mint,
+            owner: p.owner,
+            tokenProgram: f.program,
+            ata: getAssociatedTokenAddress(owner, p.mint, f.program) === f.address,
+            native: p.native,
+            symbol: m.symbol,
+            decimals: m.decimals,
+            amount: p.amount.toString(),
+            formatted: format(p.amount),
+            delegate: p.delegate,
+            delegatedAmount: p.delegatedAmount.toString(),
+            delegatedFormatted: format(p.delegatedAmount),
+            closeAuthority: p.closeAuthority,
+            permanentDelegate: m.permanentDelegate,
+            frozen: p.frozen,
+            lamports: f.lamports.toString(),
+            withheldAmount: p.withheldAmount.toString(),
+            revocable: p.delegate !== null && !p.frozen,
+            closable: closeBlocker === null,
+            closeBlocker,
+        };
+    });
+    return query.all ? list : list.filter((a) => a.delegate !== null || a.closeBlocker === 'close-authority' || BigInt(a.amount) === 0n);
+}
+/** 指定 mints：两个程序的 ATA 都读（mint 所属程序未知时只有一个存在） */
+async function ataAccounts(client, owner, mints, signal) {
+    const targets = [...new Set(mints.filter((m) => isAddress(m)))].flatMap((mint) => [TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID].map((program) => ({ program, address: getAssociatedTokenAddress(owner, mint, program) })));
+    const accounts = targets.length ? await client.accounts(targets.map((t) => t.address), { signal }) : [];
+    return targets.flatMap((t, i) => {
+        const account = accounts[i];
+        const parsed = account && account.owner === t.program ? parseTokenAccountState(account.data) : null;
+        return parsed && account ? [{ address: t.address, program: t.program, lamports: account.lamports, parsed }] : [];
+    });
+}
+/** 不传 mints：用 getTokenAccountsByOwner 列出两个程序的全部代币账户（base64，自己解析扩展） */
+async function listAccounts(client, owner, signal) {
+    const lists = await Promise.all([TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID].map((programId) => client.request('getTokenAccountsByOwner', [owner, { programId }, { encoding: 'base64', commitment: client.commitment }], { signal }).then((res) => ({ programId, value: res.value ?? [] })))).catch((err) => {
+        if (signal?.aborted || !methodUnavailable(err)) {
+            throw err; // 取消、限频、超时等原样抛出（保留错误类型）
+        }
+        throw new Error(`Listing the token accounts of ${owner} failed (${err instanceof Error ? err.message : String(err)}). ` +
+            'Listing needs getTokenAccountsByOwner (most free public nodes do not support it): pass the mints in `mints`, or use a node that supports it', { cause: err });
+    });
+    return lists.flatMap(({ programId, value }) => value.flatMap((entry) => {
+        const parsed = entry.account.owner === programId ? parseTokenAccountState(base64.decode(entry.account.data[0])) : null;
+        return parsed ? [{ address: entry.pubkey, program: programId, lamports: BigInt(entry.account.lamports), parsed }] : [];
+    }));
+}
+/** mint 的精度、symbol（Token-2022 TokenMetadata 扩展或 Metaplex 元数据）、永久授权 */
+function mintMeta(mint, metadata) {
+    if (!mint) {
+        return { decimals: null, symbol: null, permanentDelegate: null };
+    }
+    let decimals = null;
+    let symbol = null;
+    try {
+        const info = parseMint(mint.data);
+        decimals = info.decimals;
+        symbol = info.metadata?.symbol || null;
+    }
+    catch {
+        // 不是 mint
+    }
+    if (!symbol && metadata) {
+        try {
+            symbol = parseMetaplexMetadata(metadata.data).symbol || null;
+        }
+        catch {
+            // 元数据格式不对
+        }
+    }
+    const ext = findExtension(mint.data, EXT_PERMANENT_DELEGATE);
+    const delegate = ext && ext.length >= 32 ? encodeAddress(ext.slice(0, 32)) : null;
+    return { decimals, symbol, permanentDelegate: delegate && delegate !== ZERO_PUBKEY ? delegate : null };
+}
+/** 撤销授权的指令：每个有 delegate、没有冻结的账户一条 Revoke；其他的跳过 */
+export function buildRevokes(list) {
+    return list
+        .filter((a) => a.revocable)
+        .map((a) => ({ kind: 'revoke', account: a.account, owner: a.owner, instructions: [revoke(a.account, a.owner, a.tokenProgram)], approval: a }));
+}
+/**
+ * 关闭账户的指令：每个 closable 的账户一条 CloseAccount（关闭同时去掉授权）；Token-2022 账户里有暂存的转账手续费时，
+ * 先加一条 HarvestWithheldTokensToMint（不需要签名）。关不掉的跳过。
+ * 注意 Wrapped SOL 账户有余额时也能关闭（余额作为 SOL 退回 destination）：只想回收空账户时先按 amount 过滤
+ */
+export function buildCloses(list, options = {}) {
+    if (options.destination !== undefined && !isAddress(options.destination)) {
+        throw new Error(`Invalid destination: ${options.destination}`);
+    }
+    return list
+        .filter((a) => a.closable)
+        .map((a) => ({
+        kind: 'close',
+        account: a.account,
+        owner: a.owner,
+        instructions: [
+            ...(a.tokenProgram === TOKEN_2022_PROGRAM_ID && BigInt(a.withheldAmount) > 0n ? [harvestWithheldTokensToMint(a.mint, [a.account])] : []),
+            closeAccount(a.account, options.destination ?? a.owner, a.owner, a.tokenProgram),
+        ],
+        approval: a,
+    }));
+}
+/**
+ * 撤销授权：构建（同 buildRevokes）后用 owner 签名发送，钱包和选项同 batchCall（多个账户打包进同一笔交易，feePayer 可以替 owner 付手续费）。
+ * 默认一个失败不影响后面的（continueOnError: true）；结果与构建出的调用一一对应
+ *
+ * ```ts
+ * const list = await approvals(client, owner, { mints })
+ * await revokeApprovals(client, key, list)
+ * ```
+ */
+export function revokeApprovals(client, from, list, options = {}) {
+    return send(client, from, buildRevokes(list), options);
+}
+/**
+ * 关闭代币账户回收租金（同 buildCloses），发送同 revokeApprovals。
+ *
+ * ```ts
+ * const empty = (await approvals(client, owner, { mints })).filter((a) => a.amount === '0')
+ * await closeTokenAccounts(client, key, empty)   // 租金退回 owner
+ * ```
+ */
+export function closeTokenAccounts(client, from, list, options = {}) {
+    const { destination, ...rest } = options;
+    return send(client, from, buildCloses(list, { destination }), rest);
+}
+async function send(client, from, calls, options) {
+    if (!calls.length)
+        return [];
+    // 发送的代码按需加载：只查授权时打包不会带上
+    const [{ batchCall }, { resolveSigner }] = await Promise.all([import('./write/batch.js'), import('./write/signer.js')]);
+    const { address } = await resolveSigner(from);
+    const other = calls.find((c) => c.owner !== address);
+    if (other) {
+        throw new Error(`Token account ${other.account} belongs to ${other.owner}, not the signer ${address}`);
+    }
+    const results = await batchCall(client, calls.map((c) => ({ from, instructions: c.instructions })), { continueOnError: true, ...options });
+    return results.map((r, i) => {
+        const call = calls[i];
+        return { ...r, kind: call.kind, account: call.account, approval: call.approval };
+    });
+}
+//# sourceMappingURL=approvals.js.map

package/dist/approvals.js.map

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

package/dist/fees.d.ts

@@ -0,0 +1,89 @@
+import type { RequestOptions, SolanaClient } from './client.js';
+import type { InstructionInput } from './write/transaction.js';
+export type FeeLevel = 'slow' | 'normal' | 'fast';
+/** 三档优先费单价（每个计算单元多少 micro-lamports，十进制字符串） */
+export interface PriorityFeeEstimate {
+    slow: string;
+    normal: string;
+    fast: string;
+    /** 统计了多少个 slot（节点返回最近 150 个） */
+    slots: number;
+}
+export interface EstimateFeesOptions extends RequestOptions {
+    /** 只看会写这些账户的交易（如交易的可写账户，最多 128 个）；不传时看全网 */
+    accounts?: readonly string[];
+    /** 三档取各 slot 最低落块费用的百分位，默认 [50, 75, 90]（normal 与 /write 的 priorityFee: 'auto' 相同） */
+    percentiles?: readonly [number, number, number];
+}
+/**
+ * 当前的优先费建议：getRecentPrioritizationFees 返回最近 150 个 slot 里（会写这些账户的）落块交易的最低单价，三档取它们的百分位。
+ * 不传 accounts 时大多是 0（每个区块总有不加优先费的交易），要估某笔交易时传它的可写账户（estimateCost 自动这样做）
+ *
+ * ```ts
+ * await estimateFees(client, { accounts: [poolAddress] })   // { slow: '0', normal: '12000', fast: '150000', slots: 150 }
+ * ```
+ */
+export declare function estimateFees(client: SolanaClient, options?: EstimateFeesOptions): Promise<PriorityFeeEstimate>;
+/**
+ * 要估算的交易：
+ * - 指令 + 手续费支付者：按 /write 的方式发送时的花费（计算单元上限 = 模拟值 × 1.1 + 1000，单价按这一档）。指令里自带的计算预算指令会被去掉
+ * - 已经构建好的交易（序列化的字节或 base64，legacy / v0，签名可以是空的）：按交易自带的计算预算指令算（没有 SetComputeUnitPrice 时优先费为 0）
+ */
+export type CostInput = {
+    feePayer: string;
+    instructions: InstructionInput | readonly InstructionInput[];
+} | {
+    transaction: Uint8Array | string;
+};
+export interface EstimateCostOptions extends Omit<EstimateFeesOptions, 'accounts'> {
+    /** 用哪一档优先费，默认 'normal'（只对指令有效） */
+    level?: FeeLevel;
+    /** 直接指定优先费单价（micro-lamports / 计算单元），不查建议（只对指令有效） */
+    priorityFee?: number | bigint;
+    /** 已经查好的费用建议（多笔交易共用）；不传时按交易的可写账户查 */
+    fees?: PriorityFeeEstimate;
+}
+export interface CreatedAccount {
+    address: string;
+    /** 所属程序 */
+    owner: string;
+    /** 数据大小（字节） */
+    space: number;
+    /** 免租押金（lamports） */
+    rent: string;
+}
+export interface CostEstimate {
+    /** 模拟消耗的计算单元 */
+    computeUnits: number;
+    /** 计算单元上限（优先费按它收） */
+    computeUnitLimit: number;
+    /** 优先费单价（micro-lamports / 计算单元） */
+    priorityFee: string;
+    signatures: number;
+    /** 基础费：每个签名 5000 lamports */
+    baseFee: string;
+    /** 优先费：单价 × 上限（lamports，向上取整） */
+    priorityFeeLamports: string;
+    /** 手续费：baseFee + priorityFeeLamports（lamports） */
+    fee: string;
+    /** 新建账户的免租押金合计（lamports，关闭账户时退回） */
+    rent: string;
+    createdAccounts: CreatedAccount[];
+    /** fee + rent（lamports）和按 SOL 换算的值 */
+    total: string;
+    totalFormatted: string;
+    symbol: 'SOL';
+}
+/**
+ * 估算一笔交易的花费（模拟一次，sigVerify: false，不需要签名、不会发送）。模拟失败时抛出（带程序日志里的原因）。
+ * 新建账户：交易前不存在（lamports 为 0）、模拟后存在、有数据或不归 System Program 的可写账户，押金按 getMinimumBalanceForRentExemption 算；
+ * 普通转账给新地址（System 账户、没有数据）不算押金
+ *
+ * ```ts
+ * await estimateCost(client, { feePayer: owner, instructions: [ix1, ix2] })
+ * // { computeUnits: 41230, computeUnitLimit: 46353, priorityFee: '12000', fee: '5557', rent: '1488440', totalFormatted: '0.001493997', … }
+ * await estimateCost(client, { transaction: base64FromJupiter })
+ * ```
+ */
+export declare function estimateCost(client: SolanaClient, input: CostInput, options?: EstimateCostOptions): Promise<CostEstimate>;
+//# sourceMappingURL=fees.d.ts.map

package/dist/fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fees.d.ts","sourceRoot":"","sources":["../src/fees.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEjD,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,qFAAqF;IACrF,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAChD;AAOD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAWxH;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,gBAAgB,GAAG,SAAS,gBAAgB,EAAE,CAAA;CAAE,GAAG;IAAE,WAAW,EAAE,UAAU,GAAG,MAAM,CAAA;CAAE,CAAA;AAEjJ,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC;IAChF,kCAAkC;IAClC,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC7B,qCAAqC;IACrC,IAAI,CAAC,EAAE,mBAAmB,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IACb,eAAe;IACf,KAAK,EAAE,MAAM,CAAA;IACb,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,qBAAqB;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,iCAAiC;IACjC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAA;IACX,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,cAAc,EAAE,CAAA;IACjC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,KAAK,CAAA;CACd;AAoBD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0GnI"}

package/dist/fees.js

@@ -0,0 +1,166 @@
+/**
+ * 手续费估算（子路径 `@w3lib/solana-batch-call/fees`）：三档优先费（getRecentPrioritizationFees 的百分位，可以只看交易会写的账户），
+ * 一笔交易的花费：基础费（每个签名 5000 lamports）+ 优先费（模拟得到的计算单元上限 × 单价）+ 新建账户的免租押金
+ */
+import { base64 } from '@scure/base';
+import { encodeAddress } from './address.js';
+import { SOL_DECIMALS, SYSTEM_PROGRAM_ID } from './constants.js';
+import { formatUnits } from './layout.js';
+/**
+ * 当前的优先费建议：getRecentPrioritizationFees 返回最近 150 个 slot 里（会写这些账户的）落块交易的最低单价，三档取它们的百分位。
+ * 不传 accounts 时大多是 0（每个区块总有不加优先费的交易），要估某笔交易时传它的可写账户（estimateCost 自动这样做）
+ *
+ * ```ts
+ * await estimateFees(client, { accounts: [poolAddress] })   // { slow: '0', normal: '12000', fast: '150000', slots: 150 }
+ * ```
+ */
+export async function estimateFees(client, options = {}) {
+    const [p1, p2, p3] = options.percentiles ?? [50, 75, 90];
+    const accounts = [...new Set(options.accounts ?? [])].slice(0, 128);
+    const list = await client.request('getRecentPrioritizationFees', accounts.length ? [accounts] : [], { signal: options.signal });
+    const fees = list.map((f) => BigInt(f.prioritizationFee)).sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+    // 与 /write 的 'auto' 相同的取法：排序后第 ⌊n × p⌋ 个
+    const pick = (p) => (fees.length ? fees[Math.min(fees.length - 1, Math.max(0, Math.floor((fees.length * p) / 100)))] : 0n);
+    const slow = pick(p1);
+    const normal = pick(p2) > slow ? pick(p2) : slow;
+    const fast = pick(p3) > normal ? pick(p3) : normal;
+    return { slow: slow.toString(), normal: normal.toString(), fast: fast.toString(), slots: list.length };
+}
+/** 没有 SetComputeUnitLimit 时每条（非计算预算）指令的默认上限 */
+const DEFAULT_UNITS_PER_INSTRUCTION = 200_000;
+/** 地址查找表账户的头部大小，之后每 32 字节一个地址 */
+const LOOKUP_TABLE_META_SIZE = 56;
+/**
+ * 估算一笔交易的花费（模拟一次，sigVerify: false，不需要签名、不会发送）。模拟失败时抛出（带程序日志里的原因）。
+ * 新建账户：交易前不存在（lamports 为 0）、模拟后存在、有数据或不归 System Program 的可写账户，押金按 getMinimumBalanceForRentExemption 算；
+ * 普通转账给新地址（System 账户、没有数据）不算押金
+ *
+ * ```ts
+ * await estimateCost(client, { feePayer: owner, instructions: [ix1, ix2] })
+ * // { computeUnits: 41230, computeUnitLimit: 46353, priorityFee: '12000', fee: '5557', rent: '1488440', totalFormatted: '0.001493997', … }
+ * await estimateCost(client, { transaction: base64FromJupiter })
+ * ```
+ */
+export async function estimateCost(client, input, options = {}) {
+    const { signal } = options;
+    // 构建交易的代码按需加载：只查费用建议时打包不会带上
+    const [{ MAX_COMPUTE_UNITS, COMPUTE_BUDGET_PROGRAM_ID, setComputeUnitLimit, setComputeUnitPrice }, tx, { transactionErrorText, transactionFee }] = await Promise.all([
+        import('./write/instructions.js'),
+        import('./write/transaction.js'),
+        import('./write/send.js'),
+    ]);
+    let raw;
+    let signatures;
+    let writable;
+    /** 交易自带的计算预算（只对构建好的交易） */
+    let budget = null;
+    if ('transaction' in input) {
+        const bytes = typeof input.transaction === 'string' ? base64.decode(input.transaction) : input.transaction;
+        // legacy / v0 的交易以签名数（compact-u16，不会超过 127）开头；v1 等新格式以版本字节（0x80 | 版本）开头，布局不同
+        if (((bytes[0] ?? 0) & 0x80) !== 0) {
+            throw new Error(`Unsupported transaction format (version ${bytes[0] & 0x7f}); only legacy and v0 transactions can be estimated, pass the instructions instead`);
+        }
+        const message = tx.parseMessage(tx.splitTransaction(bytes).message);
+        raw = base64.encode(bytes);
+        signatures = message.signatures;
+        writable = [...message.writable, ...(await lookupWritable(client, message.lookups, signal))];
+        let limit = null;
+        let price = 0n;
+        for (const ix of message.instructions) {
+            if (ix.programId !== COMPUTE_BUDGET_PROGRAM_ID)
+                continue;
+            const view = new DataView(ix.data.buffer, ix.data.byteOffset, ix.data.byteLength);
+            if (ix.data[0] === 2 && ix.data.length >= 5)
+                limit = view.getUint32(1, true);
+            if (ix.data[0] === 3 && ix.data.length >= 9)
+                price = view.getBigUint64(1, true);
+        }
+        const others = message.instructions.filter((ix) => ix.programId !== COMPUTE_BUDGET_PROGRAM_ID).length;
+        budget = { limit: Math.min(MAX_COMPUTE_UNITS, limit ?? DEFAULT_UNITS_PER_INSTRUCTION * others), price };
+    }
+    else {
+        const list = Array.isArray(input.instructions) ? input.instructions : [input.instructions];
+        // 和 batchCall 一样：去掉自带的计算单元上限 / 单价指令，模拟时上限取最大、单价为 0
+        const instructions = list.map(tx.normalizeInstruction).filter((ix) => !(ix.programId === COMPUTE_BUDGET_PROGRAM_ID && (ix.data[0] === 2 || ix.data[0] === 3)));
+        const message = tx.compileMessage(input.feePayer, [setComputeUnitLimit(MAX_COMPUTE_UNITS), setComputeUnitPrice(0n), ...instructions], SYSTEM_PROGRAM_ID);
+        raw = base64.encode(tx.serializeTransaction(message, message.signers.map(() => null)));
+        signatures = message.signers.length;
+        writable = message.writable;
+    }
+    // 交易前不存在的可写账户：模拟后读回它们的状态，判断是否新建
+    const before = writable.length ? await client.solBalances(writable, { signal }) : [];
+    const fresh = writable.filter((_, i) => before[i]?.balance === '0');
+    const priceFor = async () => {
+        if (budget)
+            return budget.price;
+        if (options.priorityFee !== undefined)
+            return BigInt(options.priorityFee);
+        const fees = options.fees ?? (await estimateFees(client, { accounts: writable, percentiles: options.percentiles, signal }));
+        return BigInt(fees[options.level ?? 'normal']);
+    };
+    const [simulation, price] = await Promise.all([
+        client.request('simulateTransaction', [
+            raw,
+            {
+                encoding: 'base64',
+                sigVerify: false,
+                replaceRecentBlockhash: true,
+                commitment: 'confirmed',
+                ...(fresh.length ? { accounts: { encoding: 'base64', addresses: fresh } } : {}),
+            },
+        ], { signal }),
+        priceFor(),
+    ]);
+    const sim = simulation.value;
+    if (sim.err) {
+        throw new Error(`Simulation failed: ${transactionErrorText(sim.err, sim.logs)}`);
+    }
+    const consumed = sim.unitsConsumed ?? 0;
+    const limit = budget?.limit ?? Math.min(MAX_COMPUTE_UNITS, Math.ceil(consumed * 1.1) + 1000);
+    const created = fresh.flatMap((address, i) => {
+        const a = sim.accounts?.[i];
+        if (!a || !(a.lamports > 0))
+            return [];
+        const space = base64.decode(a.data[0]).length;
+        return space > 0 || a.owner !== SYSTEM_PROGRAM_ID ? [{ address, owner: a.owner, space }] : [];
+    });
+    const sizes = [...new Set(created.map((c) => c.space))];
+    const rents = await Promise.all(sizes.map((size) => client.request('getMinimumBalanceForRentExemption', [size], { signal })));
+    const rentOf = new Map(sizes.map((size, i) => [size, BigInt(rents[i])]));
+    const createdAccounts = created.map((c) => ({ ...c, rent: rentOf.get(c.space).toString() }));
+    const rent = createdAccounts.reduce((sum, c) => sum + BigInt(c.rent), 0n);
+    const fee = transactionFee(signatures, limit, price);
+    const baseFee = 5000n * BigInt(signatures);
+    const total = fee + rent;
+    return {
+        computeUnits: consumed,
+        computeUnitLimit: limit,
+        priorityFee: price.toString(),
+        signatures,
+        baseFee: baseFee.toString(),
+        priorityFeeLamports: (fee - baseFee).toString(),
+        fee: fee.toString(),
+        rent: rent.toString(),
+        createdAccounts,
+        total: total.toString(),
+        totalFormatted: formatUnits(total, SOL_DECIMALS),
+        symbol: 'SOL',
+    };
+}
+/** v0 交易的地址查找表里要写的账户（读查找表账户：56 字节头部之后每 32 字节一个地址）；表读不到时跳过 */
+async function lookupWritable(client, lookups, signal) {
+    const used = lookups.filter((l) => l.writable.length);
+    if (!used.length)
+        return [];
+    const tables = await client.accounts(used.map((l) => l.table), { signal });
+    return used.flatMap((l, i) => {
+        const data = tables[i]?.data;
+        if (!data)
+            return [];
+        return l.writable.flatMap((index) => {
+            const start = LOOKUP_TABLE_META_SIZE + 32 * index;
+            return start + 32 <= data.length ? [encodeAddress(data.slice(start, start + 32))] : [];
+        });
+    });
+}
+//# sourceMappingURL=fees.js.map

package/dist/fees.js.map

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

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { SolanaClient, exportTokenMetaCache, importTokenMetaCache, persistTokenM
 export { getBalances, getMultiBalances, getNftOwners, getNfts, getOwnerNfts, getOwnerTokens, getSolBalances, getTokens, watchBalances, type GetBalancesOptions, type GetNftsOptions, type GetOwnerTokensOptions, type GetSolBalancesOptions, type GetTokensOptions, type WatchBalancesOptions, type ShortcutOptions, } from './shortcuts.js';
 export { DEFAULT_TOKEN_FIELDS, type Commitment, type DefaultTokenField, type FailureReason, type NftDetails, type NftOwner, type OwnedToken, type SolBalance, type TokenBalance, type TokenDetails, type TokenField, type TokenProgramName, type TokenProgramOption, type TokenStandard, type TransferFee, type TransferFeeConfig, } 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, isOnCurve } from './address.js';
+export { createProgramAddress, decodeAddress, encodeAddress, findProgramAddress, getAssociatedTokenAddress, getMetadataAddress, isAddress, isOnCurve } from './address.js';
 export { formatAmount, formatUnits, parseMetaplexMetadata, parseMint, parseTokenAccount, parseTransferFeeConfig, parseUnits, type AccountInfo, type MetaplexMetadata, type MintInfo, type TokenAccountInfo, type TokenMetadata, type TransferFeeConfigInfo, type TransferFeeInfo, } from './layout.js';
 export { AllNodesFailedError, FallbackRpc, HttpError, HttpRpc, MIN_CONTEXT_SLOT_NOT_REACHED, RpcError, isNodeFault, nodeLabel, onRequest, type FallbackOptions, type HttpRpcOptions, type RequestEvent, type RpcTransport, } from './rpc.js';
 export { NetworkCheckedRpc, NetworkMismatchError, type RpcSource, type SourceOptions } from './source.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,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,SAAS,EAAE,MAAM,cAAc,CAAA;AACpJ,OAAO,EACL,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,SAAS,EACT,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,OAAO,EACP,4BAA4B,EAC5B,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,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,oBAAoB,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC1K,OAAO,EACL,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,SAAS,EACT,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,OAAO,EACP,4BAA4B,EAC5B,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -2,7 +2,7 @@ export { SolanaClient, exportTokenMetaCache, importTokenMetaCache, persistTokenM
 export { getBalances, getMultiBalances, getNftOwners, getNfts, getOwnerNfts, getOwnerTokens, getSolBalances, getTokens, watchBalances, } 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, isOnCurve } from './address.js';
+export { createProgramAddress, decodeAddress, encodeAddress, findProgramAddress, getAssociatedTokenAddress, getMetadataAddress, isAddress, isOnCurve } from './address.js';
 export { formatAmount, formatUnits, parseMetaplexMetadata, parseMint, parseTokenAccount, parseTransferFeeConfig, parseUnits, } from './layout.js';
 export { AllNodesFailedError, FallbackRpc, HttpError, HttpRpc, MIN_CONTEXT_SLOT_NOT_REACHED, RpcError, isNodeFault, nodeLabel, onRequest, } from './rpc.js';
 export { NetworkCheckedRpc, NetworkMismatchError } from './source.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GAYtB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,aAAa,GAQd,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,oBAAoB,GAgBrB,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,SAAS,EAAE,MAAM,cAAc,CAAA;AACpJ,OAAO,EACL,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,SAAS,EACT,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,GAQX,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,OAAO,EACP,4BAA4B,EAC5B,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,GAKV,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAsC,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GAYtB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,aAAa,GAQd,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,oBAAoB,GAgBrB,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,oBAAoB,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC1K,OAAO,EACL,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,SAAS,EACT,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,GAQX,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,OAAO,EACP,4BAA4B,EAC5B,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,GAKV,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAsC,MAAM,aAAa,CAAA"}

package/dist/layout.d.ts

@@ -23,6 +23,8 @@ export interface TokenMetadata {
 }
 /** 解析 Mint 账户（SPL Token / Token-2022 通用，Token-2022 额外解析 TokenMetadata 扩展） */
 export declare function parseMint(data: Uint8Array): MintInfo;
+/** 在 Token-2022 账户的扩展（TLV：u16 类型 + u16 长度 + 数据）里找指定类型，返回其数据；没有或数据不完整时为 null（包内使用，不从主入口导出） */
+export declare function findExtension(data: Uint8Array, extensionType: number): Uint8Array | null;
 /** Token-2022 转账手续费的一套配置：从 epoch 开始生效，费率 basisPoints（万分比），单笔最多 maximumFee（最小单位） */
 export interface TransferFeeInfo {
     epoch: bigint;

package/dist/layout.d.ts.map

@@ -1 +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;AAYD,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,CAqBpD;AA4CD,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAA;IACxC,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,KAAK,EAAE,eAAe,CAAA;IACtB,4BAA4B;IAC5B,KAAK,EAAE,eAAe,CAAA;CACvB;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,qBAAqB,GAAG,IAAI,CA2BrF;AAED,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,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,oBAAc,CAAA"}
+{"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;AAYD,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,CAqBpD;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAwBxF;AAiBD,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAA;IACxC,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,KAAK,EAAE,eAAe,CAAA;IACtB,4BAA4B;IAC5B,KAAK,EAAE,eAAe,CAAA;CACvB;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,qBAAqB,GAAG,IAAI,CA2BrF;AAED,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,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,oBAAc,CAAA"}

package/dist/layout.js

@@ -92,8 +92,8 @@ export function parseMint(data) {
         metadata: data.length > EXTENSIONS_OFFSET ? parseTokenMetadataExtension(data) : null,
     };
 }
-/** 在 Token-2022 账户的扩展（TLV：u16 类型 + u16 长度 + 数据）里找指定类型，返回其数据；没有或数据不完整时为 null */
-function findExtension(data, extensionType) {
+/** 在 Token-2022 账户的扩展（TLV：u16 类型 + u16 长度 + 数据）里找指定类型，返回其数据；没有或数据不完整时为 null（包内使用，不从主入口导出） */
+export function findExtension(data, extensionType) {
     if (data.length <= EXTENSIONS_OFFSET) {
         return null;
     }