@w3lib/solana-batch-call 0.2.2 → 0.4.0

package/dist/write/transfer.d.ts

@@ -0,0 +1,72 @@
+import type { SolanaClient } from '../client.js';
+import { type SendOptions, type WriteResult } from './send.js';
+import { type ResolvedSigner, type SignerInput } from './signer.js';
+import type { Instruction } from './transaction.js';
+/** 一个收款项：amount（最小单位）和 formatted（按精度换算后，如 '1.5'）二选一 */
+export interface TransferItem {
+    /** 收款钱包地址（代币转到它的关联代币账户 ATA，没有时自动创建） */
+    to: string;
+    /** 数量，最小单位（lamports / 代币最小单位），bigint 或十进制字符串 */
+    amount?: bigint | number | string;
+    /** 按精度换算后的数量，如 '1.5'；小数位超过精度时报错（不四舍五入） */
+    formatted?: string;
+    /** 这一项转的代币 mint，默认 options.token */
+    token?: string;
+}
+/**
+ * - 'pack'（默认）：同一笔交易里打包多个收款人（Solana 原生支持一笔交易多条转账指令，不需要 Disperse 这样的合约），
+ *   按交易大小上限自动分笔；模拟失败的收款项（如收款账户被冻结）单独标记失败，其余照常发送
+ * - 'tx'：每个收款人一笔交易
+ */
+export type TransferMode = 'pack' | 'tx';
+export interface BatchTransferOptions extends SendOptions {
+    /** 默认转的代币 mint，默认原生 SOL（NATIVE_MINT）；每项也可以单独指定 token */
+    token?: string;
+    mode?: TransferMode;
+    /** 'pack' 时每笔交易最多几个收款人，默认不限（按交易大小，SOL 约 20 个一笔，代币约 10 个） */
+    batchSize?: number;
+    /** 发送前检查余额够不够（按代币汇总），不够时抛错、什么都不发。默认 true（SOL 不含手续费和新建账户的租金） */
+    checkBalance?: boolean;
+    /** 收款人没有该代币的 ATA 时自动创建（租金约 0.00204 SOL，由手续费支付者付）。默认 true；false 时这些收款项失败 */
+    createAccounts?: boolean;
+}
+/** 单个收款项的结果 */
+export interface TransferResult extends WriteResult {
+    /** 收款钱包 */
+    to: string;
+    token: string;
+    native: boolean;
+    /** 数量（最小单位） */
+    amount: string;
+    /** 按精度换算后的数量 */
+    formatted: string;
+    /** 是否为收款人新建了代币账户（这一项额外付了租金） */
+    createdAccount: boolean;
+}
+/** 解析后的收款项 */
+interface Planned {
+    index: number;
+    to: string;
+    token: string;
+    native: boolean;
+    amount: bigint;
+    decimals: number;
+    tokenProgram: string | null;
+}
+/**
+ * 一对多批量转账（SOL / SPL Token / Token-2022，可混合）。结果与 recipients 一一对应。
+ *
+ * ```ts
+ * await batchTransfer(client, privateKey, [
+ *   { to: a, formatted: '0.5' },                 // 默认代币（options.token，默认 SOL）
+ *   { to: b, token: USDC, formatted: '20' },     // 代币：收款人没有 ATA 时自动创建
+ * ])
+ * ```
+ */
+export declare function batchTransfer(client: SolanaClient, from: SignerInput, recipients: readonly TransferItem[], options?: BatchTransferOptions): Promise<TransferResult[]>;
+/** 转账指令：SOL 直接转；代币按需先创建收款人的 ATA，再 TransferChecked */
+export declare function transferInstructions(signer: ResolvedSigner, payer: ResolvedSigner, p: Pick<Planned, 'to' | 'token' | 'native' | 'amount' | 'tokenProgram'> & {
+    decimals: number | null;
+}, ata: string | null, create: boolean): Instruction[];
+export {};
+//# sourceMappingURL=transfer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/write/transfer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAKhD,OAAO,EAA0C,KAAK,WAAW,EAA6B,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AACjI,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;IACjC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,IAAI,CAAA;AAExC,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,eAAe;AACf,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,eAAe;IACf,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,cAAc;AACd,UAAU,OAAO;IACf,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAwC/K;AAED,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,cAAc,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,WAAW,EAAE,CAW7O"}

package/dist/write/transfer.js

@@ -0,0 +1,127 @@
+import { getAssociatedTokenAddress, isAddress } from '../address.js';
+import { NATIVE_MINT, SOL_DECIMALS } from '../constants.js';
+import { formatUnits, parseUnits } from '../layout.js';
+import { createAssociatedTokenAccountIdempotent, systemTransfer, transferChecked } from './instructions.js';
+import { emptyOutcome, sendUnits, toWriteResult } from './send.js';
+import { resolveSigner } from './signer.js';
+/**
+ * 一对多批量转账（SOL / SPL Token / Token-2022，可混合）。结果与 recipients 一一对应。
+ *
+ * ```ts
+ * await batchTransfer(client, privateKey, [
+ *   { to: a, formatted: '0.5' },                 // 默认代币（options.token，默认 SOL）
+ *   { to: b, token: USDC, formatted: '20' },     // 代币：收款人没有 ATA 时自动创建
+ * ])
+ * ```
+ */
+export async function batchTransfer(client, from, recipients, options = {}) {
+    const cache = new Map();
+    const signer = await resolveSigner(from, cache);
+    const payer = options.feePayer === undefined ? signer : await resolveSigner(options.feePayer, cache);
+    const planned = await plan(client, signer.address, recipients, options);
+    // 收款人的 ATA 是否存在：一次 getMultipleAccounts
+    const atas = planned.map((p) => (p.native ? null : getAssociatedTokenAddress(p.to, p.token, p.tokenProgram)));
+    const needed = [...new Set(atas.filter((a) => a !== null))];
+    const existing = new Set();
+    if (needed.length) {
+        const accounts = await client.accounts(needed, { signal: options.signal });
+        needed.forEach((a, i) => accounts[i] && existing.add(a));
+    }
+    const results = planned.map((p) => toTransferResult(p, toWriteResult(p.index, signer.address, emptyOutcome('skipped')), false));
+    const units = [];
+    /** 已经安排创建的 ATA：同一个收款人同一种代币有多项时只在第一项创建（后面的项在同一组里按顺序发送，模拟失败时会等前面的确认） */
+    const creating = new Set();
+    planned.forEach((p, i) => {
+        const ata = atas[i] ?? null;
+        const create = ata !== null && !existing.has(ata) && !creating.has(ata);
+        if (create)
+            creating.add(ata);
+        if (create && options.createAccounts === false) {
+            results[i] = toTransferResult(p, toWriteResult(p.index, signer.address, emptyOutcome('failed', 'recipient has no token account (createAccounts is false)')), false);
+            return;
+        }
+        units.push({
+            instructions: transferInstructions(signer, payer, p, ata, create),
+            payer,
+            signers: payer.address === signer.address ? [] : [signer],
+            continueOnError: true,
+            onUpdate: (outcome) => {
+                results[i] = toTransferResult(p, toWriteResult(p.index, signer.address, outcome), create && outcome.status === 'confirmed');
+                options.onUpdate?.(results[i]);
+            },
+        });
+    });
+    await sendUnits(client, units, options, { batchSize: (options.mode ?? 'pack') === 'tx' ? 1 : options.batchSize });
+    return results;
+}
+/** 转账指令：SOL 直接转；代币按需先创建收款人的 ATA，再 TransferChecked */
+export function transferInstructions(signer, payer, p, ata, create) {
+    if (p.native) {
+        return [systemTransfer(signer.address, p.to, p.amount)];
+    }
+    const program = p.tokenProgram;
+    const source = getAssociatedTokenAddress(signer.address, p.token, program);
+    const destination = ata ?? getAssociatedTokenAddress(p.to, p.token, program);
+    return [
+        ...(create ? [createAssociatedTokenAccountIdempotent(payer.address, destination, p.to, p.token, program)] : []),
+        transferChecked(source, p.token, destination, signer.address, p.amount, p.decimals, program),
+    ];
+}
+/** 解析数量（formatted 按精度换算）、代币程序，并检查余额 */
+async function plan(client, owner, recipients, options) {
+    const defaultToken = options.token ?? NATIVE_MINT;
+    const tokens = [...new Set(recipients.map((r) => r.token ?? defaultToken))];
+    const balances = tokens.length ? await client.balances(owner, tokens, { signal: options.signal }) : [];
+    const info = new Map(balances.map((b, i) => [tokens[i], b]));
+    const planned = recipients.map((item, index) => {
+        const token = item.token ?? defaultToken;
+        const balance = info.get(token);
+        if (!isAddress(item.to)) {
+            throw new Error(`recipients[${index}]: invalid address ${item.to}`);
+        }
+        if ((item.amount === undefined) === (item.formatted === undefined)) {
+            throw new Error(`recipients[${index}]: pass exactly one of amount / formatted`);
+        }
+        const native = client.isNativeMint(token);
+        if (!native && (!balance?.success || !balance.tokenProgram)) {
+            throw new Error(`recipients[${index}]: cannot read token ${token} (${balance?.error ?? 'unknown error'})`);
+        }
+        // 原生 SOL 的精度固定；代币读不到时上面已经报错
+        const decimals = native ? SOL_DECIMALS : balance.decimals;
+        let amount;
+        if (item.formatted !== undefined) {
+            amount = parseUnits(item.formatted, decimals);
+        }
+        else {
+            amount = BigInt(item.amount);
+        }
+        if (amount < 0n || amount >= 2n ** 64n) {
+            throw new Error(`recipients[${index}]: amount out of range`);
+        }
+        return { index, to: item.to, token, native, amount, decimals, tokenProgram: native ? null : (balance?.tokenProgram ?? null) };
+    });
+    if (options.checkBalance ?? true) {
+        const totals = new Map();
+        planned.forEach((p) => totals.set(p.token, (totals.get(p.token) ?? 0n) + p.amount));
+        for (const [token, total] of totals) {
+            // 读到这里时余额都读成功了（代币读不到时上面已经报错，原生 SOL 总能读到）
+            const balance = info.get(token);
+            if (BigInt(balance.balance) < total) {
+                throw new Error(`Insufficient balance of ${token}: need ${total}, have ${balance.balance}`);
+            }
+        }
+    }
+    return planned;
+}
+function toTransferResult(p, result, createdAccount) {
+    return {
+        ...result,
+        to: p.to,
+        token: p.token,
+        native: p.native,
+        amount: p.amount.toString(),
+        formatted: formatUnits(p.amount, p.decimals),
+        createdAccount,
+    };
+}
+//# sourceMappingURL=transfer.js.map

package/dist/write/transfer.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@w3lib/solana-batch-call",
-  "version": "0.2.2",
-  "description": "Batched Solana reads: SOL / SPL / Token-2022 balances, token metadata, NFTs. Auto-batching JSON-RPC, getMultipleAccounts chunking, RPC failover. No Solana SDK dependency.",
+  "version": "0.4.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",
     "spl-token",
@@ -9,7 +9,8 @@
     "metaplex",
     "batch",
     "getMultipleAccounts",
-    "json-rpc"
+    "json-rpc",
+    "batch-transfer"
   ],
   "license": "MIT",
   "author": "L",
@@ -20,6 +21,18 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./write": {
+      "types": "./dist/subpaths/write.d.ts",
+      "import": "./dist/subpaths/write.js"
+    },
+    "./lp": {
+      "types": "./dist/subpaths/lp.d.ts",
+      "import": "./dist/subpaths/lp.js"
+    },
+    "./liquidity": {
+      "types": "./dist/subpaths/liquidity.d.ts",
+      "import": "./dist/subpaths/liquidity.js"
     }
   },
   "files": [
@@ -38,7 +51,11 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "test:live": "LIVE=1 vitest run test/live.test.ts",
-    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build"
+    "test:live:lp": "LIVE=1 vitest run test/lp-live.test.ts",
+    "test:live:liquidity": "LIVE=1 vitest run test/liquidity-live.test.ts",
+    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build",
+    "demo": "vite demo",
+    "demo:build": "vite build demo"
   },
   "repository": {
     "type": "git",
@@ -57,6 +74,7 @@
     "@scure/base": "^2.4.0"
   },
   "devDependencies": {
-    "@noble/curves": "^2.4.0"
+    "@noble/curves": "^2.4.0",
+    "vite": "^8.3.4"
   }
 }

package/src/address.ts

@@ -130,6 +130,15 @@ export function findProgramAddress(seeds: Uint8Array[], programId: string): stri
   throw new Error('Unable to find a viable program address bump seed')
 }
 
+/** createProgramAddress：用给定的种子（含 bump / nonce）算 PDA；落在曲线上时报错（与 web3.js PublicKey.createProgramAddressSync 相同） */
+export function createProgramAddress(seeds: Uint8Array[], programId: string): string {
+  const hash = sha256(concat([...seeds, decodeAddress(programId), PDA_MARKER]))
+  if (isOnCurve(hash)) {
+    throw new Error('Invalid seeds: address is on the ed25519 curve')
+  }
+  return encodeAddress(hash)
+}
+
 /** 关联代币账户（ATA）地址 */
 export function getAssociatedTokenAddress(owner: string, mint: string, tokenProgram: string): string {
   return findProgramAddress([decodeAddress(owner), decodeAddress(tokenProgram), decodeAddress(mint)], ASSOCIATED_TOKEN_PROGRAM_ID)

package/src/client.ts

@@ -505,6 +505,16 @@ export class SolanaClient {
     return this.#cluster ?? clusterOfGenesis(await this.#genesis())
   }
 
+  /** 默认的 commitment（ClientConfig.commitment，默认 'confirmed'） */
+  get commitment(): Commitment {
+    return this.#commitment
+  }
+
+  /** 是否按原生 SOL 处理这个 mint（ClientConfig.nativeMints） */
+  isNativeMint(mint: string): boolean {
+    return this.#nativeMints.has(mint)
+  }
+
   /** 直接发 JSON-RPC 调用（同样参与自动合并与故障切换） */
   request<T = unknown>(method: string, params?: readonly unknown[], options: RequestOptions = {}): Promise<T> {
     return abortable(options.signal, () => this.transport.request<T>(method, params))

package/src/index.ts

@@ -64,7 +64,7 @@ export {
   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,
@@ -72,6 +72,7 @@ export {
   parseMint,
   parseTokenAccount,
   parseTransferFeeConfig,
+  parseUnits,
   type AccountInfo,
   type MetaplexMetadata,
   type MintInfo,

package/src/layout.ts

@@ -313,6 +313,23 @@ export function formatUnits(value: bigint, decimals: number): string {
   return `${negative ? '-' : ''}${whole}${fraction ? `.${fraction}` : ''}`
 }
 
+/**
+ * formatUnits 的逆运算（与 ethers 的 parseUnits 同名同义）：parseUnits('1.5', 9) === 1_500_000_000n。
+ * 小数位超过精度时报错（不四舍五入；多出的只有 0 时允许）
+ */
+export function parseUnits(value: string, decimals: number): bigint {
+  const match = /^(-)?(\d*)(?:\.(\d*))?$/.exec(value.trim())
+  if (!match || (!match[2] && !match[3])) {
+    throw new Error(`Invalid amount: ${JSON.stringify(value)}`)
+  }
+  const fraction = match[3] ?? ''
+  if (/[1-9]/.test(fraction.slice(decimals))) {
+    throw new Error(`Too many decimals: ${value} (max ${decimals})`)
+  }
+  const amount = BigInt((match[2] || '0') + fraction.slice(0, decimals).padEnd(decimals, '0'))
+  return match[1] ? -amount : amount
+}
+
 /**
  * 同 formatUnits。
  * @deprecated 改用 formatUnits：formatAmount 这个名字容易和项目里的数字展示函数撞名