@w3lib/solana-batch-call 0.5.0 → 0.6.0

package/dist/subpaths/lp.js

@@ -12,7 +12,7 @@
 import { lpPositions } from '../lp.js';
 import { resolve } from '../shortcuts.js';
 export { ORCA_WHIRLPOOL_PROGRAM_ID, RAYDIUM_AMM_PROGRAM_ID, RAYDIUM_CLMM_PROGRAM_ID, RAYDIUM_CPMM_PROGRAM_ID, SOLANA_LP_PROTOCOLS, defillamaPrices, lpPositions, } from '../lp.js';
-export { MAX_TICK, MIN_TICK, getAmountsForLiquidity, getFeeGrowthInside, getFeesOwed, getLiquidityForAmounts, getMaxAmounts, getMinAmounts, getMintAmounts, nearestUsableTick, orcaSqrtPriceAtTick, priceToTick, raydiumSqrtPriceAtTick, sqrtPriceAtTick, sqrtPriceToPrice, tickAtSqrtPrice, tickToPrice, } from '../lpMath.js';
+export { MAX_TICK, MIN_TICK, getAmountsForLiquidity, getFeeGrowthInside, getFeesOwed, getLiquidityForAmounts, getMaxAmounts, getMinAmounts, getMintAmounts, getRewardGrowthInside, nearestUsableTick, orcaSqrtPriceAtTick, priceToTick, raydiumSqrtPriceAtTick, rewardGrowthGlobal, sqrtPriceAtTick, sqrtPriceToPrice, tickAtSqrtPrice, tickToPrice, } from '../lpMath.js';
 /**
  * 查一个地址的 LP 仓位。
  *
@@ -27,7 +27,7 @@ export { MAX_TICK, MIN_TICK, getAmountsForLiquidity, getFeeGrowthInside, getFees
  */
 export function getLpPositions(owner, options = {}) {
     // fetch 同时给节点请求（客户端配置）和查价用，与其他快捷函数一致
-    const { client, own } = resolve(options, ['protocols', 'mints', 'pools', 'includeClosed', 'prices', 'onPriceError', 'signal']);
+    const { client, own } = resolve(options, ['protocols', 'mints', 'pools', 'includeClosed', 'rewards', 'now', 'prices', 'onPriceError', 'signal']);
     return lpPositions(client, owner, { ...own, ...(options.fetch ? { fetch: options.fetch } : {}) });
 }
 //# sourceMappingURL=lp.js.map

package/dist/subpaths/lp.js.map

@@ -1 +1 @@
-{"version":3,"file":"lp.js","sourceRoot":"","sources":["../../src/subpaths/lp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAkD,MAAM,UAAU,CAAA;AACtF,OAAO,EAAE,OAAO,EAAwB,MAAM,iBAAiB,CAAA;AAE/D,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,WAAW,GAQZ,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,WAAW,GAGZ,MAAM,cAAc,CAAA;AAIrB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,UAAiC,EAAE;IAC/E,qCAAqC;IACrC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC9H,OAAO,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AACnG,CAAC"}
+{"version":3,"file":"lp.js","sourceRoot":"","sources":["../../src/subpaths/lp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAkD,MAAM,UAAU,CAAA;AACtF,OAAO,EAAE,OAAO,EAAwB,MAAM,iBAAiB,CAAA;AAE/D,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,WAAW,GASZ,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,WAAW,GAIZ,MAAM,cAAc,CAAA;AAIrB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,UAAiC,EAAE;IAC/E,qCAAqC;IACrC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAA;IAChJ,OAAO,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AACnG,CAAC"}

package/dist/subpaths/reclaim.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 账户回收（子路径 `@w3lib/solana-batch-call/reclaim`）：扫描钱包里关闭后能退回租金（SOL）的账户并批量关闭：空的代币账户、垃圾币（销毁后关闭）、
+ * Wrapped SOL（解包）、已清空的 Orca Whirlpool / Raydium CLMM 仓位。给出每项和合计能拿回多少 lamports，发送前用 /simulate 模拟。
+ * 不放在主入口，不用时打包不会带上这部分代码；发送的代码按需加载。
+ *
+ * ```ts
+ * import { getReclaimable, reclaim } from '@w3lib/solana-batch-call/reclaim'
+ *
+ * const r = await getReclaimable(owner, { provider: 'https://my-rpc…' })
+ * r.totalLamports                                          // 全部能拿回的 lamports
+ * const { simulation, results } = await reclaim(client, key, r.items.filter((i) => i.selected))
+ * ```
+ */
+import { type Reclaimable, type ReclaimQuery } from '../reclaim.js';
+import { type ShortcutOptions } from '../shortcuts.js';
+export { buildReclaim, reclaim, reclaimable, simulateReclaim, type BuildReclaimOptions, type JunkContext, type ReclaimBlocker, type ReclaimCall, type ReclaimCallResult, type ReclaimItem, type ReclaimKind, type ReclaimOptions, type ReclaimPlan, type ReclaimQuery, type ReclaimResult, type ReclaimSimulation, type ReclaimSimulationOptions, type Reclaimable, } from '../reclaim.js';
+export type { PlanSimulation } from '../batchPlan.js';
+export { burnChecked, closeAccount, harvestWithheldTokensToMint } from '../write/instructions.js';
+export interface GetReclaimableOptions extends ReclaimQuery, ShortcutOptions {
+}
+/**
+ * 扫描钱包里能回收租金的账户，节点参数与 getBalances 相同。默认列出全部代币账户（需要支持 getTokenAccountsByOwner 的节点），
+ * 免费公共节点传 `mints` 只看指定代币的 ATA。
+ *
+ * ```ts
+ * const r = await getReclaimable(owner, { provider: 'https://my-rpc…' })
+ * // { totalLamports: '45862080', selectedLamports: '41302080',
+ * //   items: [{ kind: 'empty-token', account, mint, lamports: '2039280', selected: true, reasons: ['empty'] },
+ * //           { kind: 'junk-token', symbol: 'claim-rewards.xyz', lamports: '2039280', selected: true, reasons: ['no-price', 'spam-name'] }, …],
+ * //   blocked: [{ kind: 'empty-token', blocker: 'frozen', … }] }
+ * ```
+ */
+export declare function getReclaimable(owner: string, options?: GetReclaimableOptions): Promise<Reclaimable>;
+//# sourceMappingURL=reclaim.d.ts.map

package/dist/subpaths/reclaim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reclaim.d.ts","sourceRoot":"","sources":["../../src/subpaths/reclaim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAe,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAChF,OAAO,EAAW,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAE/D,OAAO,EACL,YAAY,EACZ,OAAO,EACP,WAAW,EACX,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA;AAEjG,MAAM,WAAW,qBAAsB,SAAQ,YAAY,EAAE,eAAe;CAAG;AAE/E;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,WAAW,CAAC,CAGvG"}

package/dist/subpaths/reclaim.js

@@ -0,0 +1,34 @@
+/**
+ * 账户回收（子路径 `@w3lib/solana-batch-call/reclaim`）：扫描钱包里关闭后能退回租金（SOL）的账户并批量关闭：空的代币账户、垃圾币（销毁后关闭）、
+ * Wrapped SOL（解包）、已清空的 Orca Whirlpool / Raydium CLMM 仓位。给出每项和合计能拿回多少 lamports，发送前用 /simulate 模拟。
+ * 不放在主入口，不用时打包不会带上这部分代码；发送的代码按需加载。
+ *
+ * ```ts
+ * import { getReclaimable, reclaim } from '@w3lib/solana-batch-call/reclaim'
+ *
+ * const r = await getReclaimable(owner, { provider: 'https://my-rpc…' })
+ * r.totalLamports                                          // 全部能拿回的 lamports
+ * const { simulation, results } = await reclaim(client, key, r.items.filter((i) => i.selected))
+ * ```
+ */
+import { reclaimable } from '../reclaim.js';
+import { resolve } from '../shortcuts.js';
+export { buildReclaim, reclaim, reclaimable, simulateReclaim, } from '../reclaim.js';
+export { burnChecked, closeAccount, harvestWithheldTokensToMint } from '../write/instructions.js';
+/**
+ * 扫描钱包里能回收租金的账户，节点参数与 getBalances 相同。默认列出全部代币账户（需要支持 getTokenAccountsByOwner 的节点），
+ * 免费公共节点传 `mints` 只看指定代币的 ATA。
+ *
+ * ```ts
+ * const r = await getReclaimable(owner, { provider: 'https://my-rpc…' })
+ * // { totalLamports: '45862080', selectedLamports: '41302080',
+ * //   items: [{ kind: 'empty-token', account, mint, lamports: '2039280', selected: true, reasons: ['empty'] },
+ * //           { kind: 'junk-token', symbol: 'claim-rewards.xyz', lamports: '2039280', selected: true, reasons: ['no-price', 'spam-name'] }, …],
+ * //   blocked: [{ kind: 'empty-token', blocker: 'frozen', … }] }
+ * ```
+ */
+export function getReclaimable(owner, options = {}) {
+    const { client, own } = resolve(options, ['mints', 'junk', 'positions', 'prices', 'maxJunkUsd', 'risk', 'isJunk', 'signal']);
+    return reclaimable(client, owner, { ...own, ...(options.fetch ? { fetch: options.fetch } : {}) });
+}
+//# sourceMappingURL=reclaim.js.map

package/dist/subpaths/reclaim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reclaim.js","sourceRoot":"","sources":["../../src/subpaths/reclaim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,WAAW,EAAuC,MAAM,eAAe,CAAA;AAChF,OAAO,EAAE,OAAO,EAAwB,MAAM,iBAAiB,CAAA;AAE/D,OAAO,EACL,YAAY,EACZ,OAAO,EACP,WAAW,EACX,eAAe,GAehB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA;AAIjG;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,UAAiC,EAAE;IAC/E,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC5H,OAAO,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AACnG,CAAC"}

package/dist/subpaths/simulate.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 交易模拟（子路径 `@w3lib/solana-batch-call/simulate`）：不签名、不发送，在主网模拟一笔交易，给出余额变化、授权变化（delegate / SetAuthority / 关闭账户）、
+ * 指令说明、程序错误、手续费和警告。输入可以是 base64 的交易，也可以直接是本库构建器的输出。不放在主入口，不用时打包不会带上这部分代码；价格、风险检查按需加载。
+ *
+ * ```ts
+ * import { buildSwap } from '@w3lib/solana-batch-call/swap'
+ * import { getSimulation } from '@w3lib/solana-batch-call/simulate'
+ *
+ * const plan = await getSwapQuote(owner, { tokenIn: NATIVE_MINT, tokenOut: USDC, amountInFormatted: '0.5' })
+ * const sim = await getSimulation(plan)            // 或 getSimulation(base64Tx, { owner })
+ * if (!sim.success || sim.warnings.some((w) => w.severity === 'danger')) throw new Error(sim.error ?? sim.warnings[0].message)
+ * ```
+ */
+import { type ShortcutOptions } from '../shortcuts.js';
+import { type SimulateInput, type SimulateOptions, type SimulationResult } from '../simulate.js';
+export { failureText, simulate, type ApprovalChange, type ApprovalChangeKind, type SimulateInput, type SimulateOptions, type SimulatedBalanceChange, type SimulationResult, type SimulationWarning, type WarningSeverity, } from '../simulate.js';
+export { decodeInstruction, type DecodedInstruction } from '../decode.js';
+export interface GetSimulationOptions extends SimulateOptions, ShortcutOptions {
+}
+/** 模拟一笔交易，节点参数与 getBalances 相同 */
+export declare function getSimulation(input: SimulateInput, options?: GetSimulationOptions): Promise<SimulationResult>;
+//# sourceMappingURL=simulate.d.ts.map

package/dist/subpaths/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../src/subpaths/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAW,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAY,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAE1G,OAAO,EACL,WAAW,EACX,QAAQ,EACR,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEzE,MAAM,WAAW,oBAAqB,SAAQ,eAAe,EAAE,eAAe;CAAG;AAEjF,kCAAkC;AAClC,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGjH"}

package/dist/subpaths/simulate.js

@@ -0,0 +1,23 @@
+/**
+ * 交易模拟（子路径 `@w3lib/solana-batch-call/simulate`）：不签名、不发送，在主网模拟一笔交易，给出余额变化、授权变化（delegate / SetAuthority / 关闭账户）、
+ * 指令说明、程序错误、手续费和警告。输入可以是 base64 的交易，也可以直接是本库构建器的输出。不放在主入口，不用时打包不会带上这部分代码；价格、风险检查按需加载。
+ *
+ * ```ts
+ * import { buildSwap } from '@w3lib/solana-batch-call/swap'
+ * import { getSimulation } from '@w3lib/solana-batch-call/simulate'
+ *
+ * const plan = await getSwapQuote(owner, { tokenIn: NATIVE_MINT, tokenOut: USDC, amountInFormatted: '0.5' })
+ * const sim = await getSimulation(plan)            // 或 getSimulation(base64Tx, { owner })
+ * if (!sim.success || sim.warnings.some((w) => w.severity === 'danger')) throw new Error(sim.error ?? sim.warnings[0].message)
+ * ```
+ */
+import { resolve } from '../shortcuts.js';
+import { simulate } from '../simulate.js';
+export { failureText, simulate, } from '../simulate.js';
+export { decodeInstruction } from '../decode.js';
+/** 模拟一笔交易，节点参数与 getBalances 相同 */
+export function getSimulation(input, options = {}) {
+    const { client, own } = resolve(options, ['owner', 'signers', 'watch', 'step', 'prices', 'risk', 'fetch', 'signal']);
+    return simulate(client, input, own);
+}
+//# sourceMappingURL=simulate.js.map

package/dist/subpaths/simulate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.js","sourceRoot":"","sources":["../../src/subpaths/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,OAAO,EAAwB,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAmE,MAAM,gBAAgB,CAAA;AAE1G,OAAO,EACL,WAAW,EACX,QAAQ,GAST,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAA2B,MAAM,cAAc,CAAA;AAIzE,kCAAkC;AAClC,MAAM,UAAU,aAAa,CAAC,KAAoB,EAAE,UAAgC,EAAE;IACpF,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;IACpH,OAAO,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;AACrC,CAAC"}

package/dist/write/instructions.d.ts

@@ -10,6 +10,8 @@ export declare function transferChecked(source: string, mint: string, destinatio
 export declare function createAssociatedTokenAccountIdempotent(payer: string, ata: string, owner: string, mint: string, tokenProgram: string): Instruction;
 /** 关闭代币账户（余额必须为 0），租金退给 destination */
 export declare function closeAccount(account: string, destination: string, owner: string, tokenProgram: string): Instruction;
+/** SPL Token / Token-2022 BurnChecked：销毁代币账户里的代币（校验 mint 和精度），owner 签名 */
+export declare function burnChecked(account: string, mint: string, owner: string, amount: bigint, decimals: number, tokenProgram: string): Instruction;
 /** 撤销代币账户的授权（Approve 设置的 delegate），owner 签名 */
 export declare function revoke(account: string, owner: string, tokenProgram: string): Instruction;
 /**

package/dist/write/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/write/instructions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,eAAO,MAAM,yBAAyB,gDAAgD,CAAA;AAEtF,kBAAkB;AAClB,eAAO,MAAM,iBAAiB,UAAY,CAAA;AAQ1C,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAYtF;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAerK;AAED,sCAAsC;AACtC,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAajJ;AAED,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAUnH;AAED,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CASxF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAOlG;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAS9D;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAStE"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/write/instructions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,eAAO,MAAM,yBAAyB,gDAAgD,CAAA;AAEtF,kBAAkB;AAClB,eAAO,MAAM,iBAAiB,UAAY,CAAA;AAQ1C,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAYtF;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAerK;AAED,sCAAsC;AACtC,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAajJ;AAED,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAUnH;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAc7I;AAED,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CASxF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAOlG;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAS9D;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAStE"}

package/dist/write/instructions.js

@@ -65,6 +65,22 @@ export function closeAccount(account, destination, owner, tokenProgram) {
         data: new Uint8Array([9]),
     };
 }
+/** SPL Token / Token-2022 BurnChecked：销毁代币账户里的代币（校验 mint 和精度），owner 签名 */
+export function burnChecked(account, mint, owner, amount, decimals, tokenProgram) {
+    return {
+        programId: tokenProgram,
+        keys: [
+            { pubkey: account, isSigner: false, isWritable: true },
+            { pubkey: mint, isSigner: false, isWritable: true },
+            { pubkey: owner, isSigner: true, isWritable: false },
+        ],
+        data: bytes(10, (v) => {
+            v.setUint8(0, 15);
+            v.setBigUint64(1, amount, true);
+            v.setUint8(9, decimals);
+        }),
+    };
+}
 /** 撤销代币账户的授权（Approve 设置的 delegate），owner 签名 */
 export function revoke(account, owner, tokenProgram) {
     return {

package/dist/write/instructions.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w3lib/solana-batch-call",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Batched Solana reads: SOL / SPL / Token-2022 balances, token metadata, NFTs; batch transfer, collect and program calls (packed transactions, fee payer). Auto-batching JSON-RPC, getMultipleAccounts chunking, RPC failover. No Solana SDK dependency.",
   "keywords": [
     "solana",
@@ -60,6 +60,22 @@
     "./risk": {
       "types": "./dist/subpaths/risk.d.ts",
       "import": "./dist/subpaths/risk.js"
+    },
+    "./simulate": {
+      "types": "./dist/subpaths/simulate.d.ts",
+      "import": "./dist/subpaths/simulate.js"
+    },
+    "./history": {
+      "types": "./dist/subpaths/history.d.ts",
+      "import": "./dist/subpaths/history.js"
+    },
+    "./reclaim": {
+      "types": "./dist/subpaths/reclaim.d.ts",
+      "import": "./dist/subpaths/reclaim.js"
+    },
+    "./claim": {
+      "types": "./dist/subpaths/claim.d.ts",
+      "import": "./dist/subpaths/claim.js"
     }
   },
   "files": [
@@ -106,6 +122,10 @@
     "test:live:fees": "LIVE=1 vitest run test/fees-live.test.ts",
     "test:live:swap": "LIVE=1 vitest run test/swap-live.test.ts",
     "test:live:risk": "LIVE=1 vitest run test/risk-live.test.ts",
+    "test:live:simulate": "LIVE=1 vitest run test/simulate-live.test.ts",
+    "test:live:history": "LIVE=1 vitest run test/history-live.test.ts",
+    "test:live:reclaim": "LIVE=1 vitest run test/reclaim-live.test.ts",
+    "test:live:claim": "LIVE=1 vitest run test/claim-live.test.ts",
     "demo": "vite demo",
     "demo:build": "vite build demo"
   }

package/src/batchPlan.ts

@@ -0,0 +1,137 @@
+/**
+ * 批量计划的公共部分（/reclaim、/claim 用）：一组“调用”（每个调用的指令原子执行）按交易大小打包、先模拟再发送。
+ * 打包规则同 batchCall（相邻的调用放进同一笔交易，不超过 1232 字节和 64 个账户）
+ */
+import type { SolanaClient } from './client.js'
+import { isAddress } from './address.js'
+import type { SimulationResult } from './simulate.js'
+import type { BatchCallOptions } from './write/batch.js'
+import { MAX_COMPUTE_UNITS, setComputeUnitLimit, setComputeUnitPrice } from './write/instructions.js'
+import type { WriteResult } from './write/send.js'
+import type { SignerInput } from './write/signer.js'
+import { MAX_ACCOUNT_LOCKS, PACKET_DATA_SIZE, compileMessage, transactionSize, type Instruction } from './write/transaction.js'
+
+/** 一个调用：要签名的地址（代币账户 / 仓位的 owner）和原子执行的指令 */
+export interface PlannedCall {
+  owner: string
+  instructions: Instruction[]
+}
+
+/** 把调用按顺序打包成交易，返回每笔交易包含的调用下标。单个调用放不进一笔交易时自己成一笔（发送时会报“transaction too large”） */
+export function packCalls(payer: string, calls: readonly PlannedCall[], batchSize = Number.POSITIVE_INFINITY): number[][] {
+  const packs: number[][] = []
+  let current: number[] = []
+  let instructions: Instruction[] = []
+  const fits = (list: readonly Instruction[]) => {
+    const probe = compileMessage(payer, [setComputeUnitLimit(MAX_COMPUTE_UNITS), setComputeUnitPrice(1n), ...list], '11111111111111111111111111111111')
+    return transactionSize(probe) <= PACKET_DATA_SIZE && probe.accountKeys.length <= MAX_ACCOUNT_LOCKS
+  }
+  calls.forEach((call, i) => {
+    const next = [...instructions, ...call.instructions]
+    if (current.length && (current.length >= batchSize || !fits(next))) {
+      packs.push(current)
+      current = []
+      instructions = []
+    }
+    current.push(i)
+    instructions.push(...call.instructions)
+  })
+  if (current.length) {
+    packs.push(current)
+  }
+  return packs
+}
+
+export interface PlanSimulationOptions {
+  /** 手续费支付者，默认第一个调用的 owner */
+  feePayer?: string
+  /** 每笔交易最多几个调用，默认不限（只受交易大小限制） */
+  batchSize?: number
+  /** 额外要看的地址（如收款地址） */
+  watch?: readonly string[]
+  signal?: AbortSignal
+  /** 算美元价值（/simulate 的 prices） */
+  prices?: boolean
+  fetch?: typeof fetch
+}
+
+export interface PlanSimulation {
+  /** 所有交易都模拟通过 */
+  success: boolean
+  /** 打包后的每笔交易：包含的调用下标和 /simulate 的结果 */
+  transactions: Array<{ calls: number[]; simulation: SimulationResult }>
+  /** 模拟失败的调用（整笔失败时逐个重新模拟找出来）：下标和原因 */
+  failed: Array<{ index: number; error: string }>
+  /** 各笔交易手续费之和（lamports，十进制字符串） */
+  fee: string
+  /** 手续费支付者的 SOL 变化之和（lamports，带符号，不含手续费：/simulate 的 SOL 余额变化已经把手续费加回） */
+  payerNativeDelta: string
+}
+
+/** 打包后逐笔用 /simulate 模拟（不签名、不发送）；失败的交易逐个调用重新模拟，找出是哪些调用失败 */
+export async function simulatePlan(client: SolanaClient, calls: readonly PlannedCall[], options: PlanSimulationOptions = {}): Promise<PlanSimulation> {
+  const first = calls[0]
+  if (!first) {
+    return { success: true, transactions: [], failed: [], fee: '0', payerNativeDelta: '0' }
+  }
+  const payer = options.feePayer ?? first.owner
+  if (!isAddress(payer)) {
+    throw new Error(`Invalid fee payer: ${payer}`)
+  }
+  const { simulate } = await import('./simulate.js')
+  const run = (list: readonly PlannedCall[]) =>
+    simulate(
+      client,
+      { feePayer: payer, instructions: list.flatMap((c) => c.instructions) },
+      { signers: [...new Set(list.map((c) => c.owner))], watch: options.watch, signal: options.signal, prices: options.prices, fetch: options.fetch },
+    )
+  const packs = packCalls(payer, calls, options.batchSize)
+  const transactions: PlanSimulation['transactions'] = []
+  const failed: PlanSimulation['failed'] = []
+  for (const pack of packs) {
+    const simulation = await run(pack.map((i) => calls[i] as PlannedCall))
+    transactions.push({ calls: pack, simulation })
+    if (!simulation.success) {
+      if (pack.length === 1) {
+        failed.push({ index: pack[0] as number, error: simulation.error ?? 'simulation failed' })
+        continue
+      }
+      for (const i of pack) {
+        const single = await run([calls[i] as PlannedCall])
+        if (!single.success) {
+          failed.push({ index: i, error: single.error ?? 'simulation failed' })
+        }
+      }
+    }
+  }
+  let fee = 0n
+  let delta = 0n
+  for (const { simulation } of transactions) {
+    fee += BigInt(simulation.fee ?? '0')
+    for (const change of simulation.balanceChanges) {
+      if (change.address === payer && change.asset === 'native') {
+        delta += BigInt(change.delta)
+      }
+    }
+  }
+  return { success: transactions.every((t) => t.simulation.success), transactions, failed, fee: fee.toString(), payerNativeDelta: delta.toString() }
+}
+
+/** 用 from 签名发送：调用的 owner 都必须是签名者本人；一个调用失败不影响后面的（continueOnError），feePayer 可以替 owner 付手续费 */
+export async function sendCalls(client: SolanaClient, from: SignerInput, calls: readonly PlannedCall[], options: BatchCallOptions = {}): Promise<WriteResult[]> {
+  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(`The account belongs to ${other.owner}, not the signer ${address}`)
+  }
+  return batchCall(
+    client,
+    calls.map((c) => ({ from, instructions: c.instructions })),
+    { continueOnError: true, ...options },
+  )
+}