@w3lib/solana-batch-call 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (223) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/README.md +343 -3
  3. package/dist/approvals.d.ts +129 -0
  4. package/dist/approvals.d.ts.map +1 -0
  5. package/dist/approvals.js +221 -0
  6. package/dist/approvals.js.map +1 -0
  7. package/dist/batchPlan.d.ts +52 -0
  8. package/dist/batchPlan.d.ts.map +1 -0
  9. package/dist/batchPlan.js +85 -0
  10. package/dist/batchPlan.js.map +1 -0
  11. package/dist/claim.d.ts +161 -0
  12. package/dist/claim.d.ts.map +1 -0
  13. package/dist/claim.js +197 -0
  14. package/dist/claim.js.map +1 -0
  15. package/dist/decode.d.ts +22 -0
  16. package/dist/decode.d.ts.map +1 -0
  17. package/dist/decode.js +187 -0
  18. package/dist/decode.js.map +1 -0
  19. package/dist/describe.d.ts +26 -0
  20. package/dist/describe.d.ts.map +1 -0
  21. package/dist/describe.js +58 -0
  22. package/dist/describe.js.map +1 -0
  23. package/dist/fees.d.ts +89 -0
  24. package/dist/fees.d.ts.map +1 -0
  25. package/dist/fees.js +166 -0
  26. package/dist/fees.js.map +1 -0
  27. package/dist/history.d.ts +125 -0
  28. package/dist/history.d.ts.map +1 -0
  29. package/dist/history.js +231 -0
  30. package/dist/history.js.map +1 -0
  31. package/dist/historyHelius.d.ts +52 -0
  32. package/dist/historyHelius.d.ts.map +1 -0
  33. package/dist/historyHelius.js +125 -0
  34. package/dist/historyHelius.js.map +1 -0
  35. package/dist/layout.d.ts +2 -0
  36. package/dist/layout.d.ts.map +1 -1
  37. package/dist/layout.js +2 -2
  38. package/dist/layout.js.map +1 -1
  39. package/dist/liquidity/orca.d.ts +6 -0
  40. package/dist/liquidity/orca.d.ts.map +1 -1
  41. package/dist/liquidity/orca.js +14 -3
  42. package/dist/liquidity/orca.js.map +1 -1
  43. package/dist/liquidity/raydiumClmm.d.ts +6 -0
  44. package/dist/liquidity/raydiumClmm.d.ts.map +1 -1
  45. package/dist/liquidity/raydiumClmm.js +12 -5
  46. package/dist/liquidity/raydiumClmm.js.map +1 -1
  47. package/dist/lp.d.ts +55 -15
  48. package/dist/lp.d.ts.map +1 -1
  49. package/dist/lp.js +98 -46
  50. package/dist/lp.js.map +1 -1
  51. package/dist/lpMath.d.ts +22 -0
  52. package/dist/lpMath.d.ts.map +1 -1
  53. package/dist/lpMath.js +21 -0
  54. package/dist/lpMath.js.map +1 -1
  55. package/dist/names.d.ts +68 -0
  56. package/dist/names.d.ts.map +1 -0
  57. package/dist/names.js +257 -0
  58. package/dist/names.js.map +1 -0
  59. package/dist/pools.d.ts +9 -0
  60. package/dist/pools.d.ts.map +1 -0
  61. package/dist/pools.js +45 -0
  62. package/dist/pools.js.map +1 -0
  63. package/dist/portfolio.d.ts +64 -0
  64. package/dist/portfolio.d.ts.map +1 -0
  65. package/dist/portfolio.js +57 -0
  66. package/dist/portfolio.js.map +1 -0
  67. package/dist/price.d.ts +90 -0
  68. package/dist/price.d.ts.map +1 -0
  69. package/dist/price.js +287 -0
  70. package/dist/price.js.map +1 -0
  71. package/dist/programs.d.ts +19 -0
  72. package/dist/programs.d.ts.map +1 -0
  73. package/dist/programs.js +175 -0
  74. package/dist/programs.js.map +1 -0
  75. package/dist/reclaim.d.ts +190 -0
  76. package/dist/reclaim.d.ts.map +1 -0
  77. package/dist/reclaim.js +399 -0
  78. package/dist/reclaim.js.map +1 -0
  79. package/dist/risk.d.ts +84 -0
  80. package/dist/risk.d.ts.map +1 -0
  81. package/dist/risk.js +211 -0
  82. package/dist/risk.js.map +1 -0
  83. package/dist/rpc.d.ts +2 -0
  84. package/dist/rpc.d.ts.map +1 -1
  85. package/dist/rpc.js +36 -10
  86. package/dist/rpc.js.map +1 -1
  87. package/dist/simulate.d.ts +106 -0
  88. package/dist/simulate.d.ts.map +1 -0
  89. package/dist/simulate.js +418 -0
  90. package/dist/simulate.js.map +1 -0
  91. package/dist/subpaths/approvals.d.ts +29 -0
  92. package/dist/subpaths/approvals.d.ts.map +1 -0
  93. package/dist/subpaths/approvals.js +30 -0
  94. package/dist/subpaths/approvals.js.map +1 -0
  95. package/dist/subpaths/claim.d.ts +31 -0
  96. package/dist/subpaths/claim.d.ts.map +1 -0
  97. package/dist/subpaths/claim.js +31 -0
  98. package/dist/subpaths/claim.js.map +1 -0
  99. package/dist/subpaths/fees.d.ts +23 -0
  100. package/dist/subpaths/fees.d.ts.map +1 -0
  101. package/dist/subpaths/fees.js +25 -0
  102. package/dist/subpaths/fees.js.map +1 -0
  103. package/dist/subpaths/history.d.ts +21 -0
  104. package/dist/subpaths/history.d.ts.map +1 -0
  105. package/dist/subpaths/history.js +22 -0
  106. package/dist/subpaths/history.js.map +1 -0
  107. package/dist/subpaths/lp.d.ts +2 -2
  108. package/dist/subpaths/lp.d.ts.map +1 -1
  109. package/dist/subpaths/lp.js +2 -2
  110. package/dist/subpaths/lp.js.map +1 -1
  111. package/dist/subpaths/names.d.ts +37 -0
  112. package/dist/subpaths/names.d.ts.map +1 -0
  113. package/dist/subpaths/names.js +27 -0
  114. package/dist/subpaths/names.js.map +1 -0
  115. package/dist/subpaths/price.d.ts +40 -0
  116. package/dist/subpaths/price.d.ts.map +1 -0
  117. package/dist/subpaths/price.js +43 -0
  118. package/dist/subpaths/price.js.map +1 -0
  119. package/dist/subpaths/reclaim.d.ts +34 -0
  120. package/dist/subpaths/reclaim.d.ts.map +1 -0
  121. package/dist/subpaths/reclaim.js +34 -0
  122. package/dist/subpaths/reclaim.js.map +1 -0
  123. package/dist/subpaths/risk.d.ts +28 -0
  124. package/dist/subpaths/risk.d.ts.map +1 -0
  125. package/dist/subpaths/risk.js +30 -0
  126. package/dist/subpaths/risk.js.map +1 -0
  127. package/dist/subpaths/simulate.d.ts +22 -0
  128. package/dist/subpaths/simulate.d.ts.map +1 -0
  129. package/dist/subpaths/simulate.js +23 -0
  130. package/dist/subpaths/simulate.js.map +1 -0
  131. package/dist/subpaths/swap.d.ts +22 -0
  132. package/dist/subpaths/swap.d.ts.map +1 -0
  133. package/dist/subpaths/swap.js +21 -0
  134. package/dist/subpaths/swap.js.map +1 -0
  135. package/dist/subpaths/write.d.ts +1 -1
  136. package/dist/subpaths/write.d.ts.map +1 -1
  137. package/dist/subpaths/write.js +1 -1
  138. package/dist/subpaths/write.js.map +1 -1
  139. package/dist/swap/amm.d.ts +20 -0
  140. package/dist/swap/amm.d.ts.map +1 -0
  141. package/dist/swap/amm.js +77 -0
  142. package/dist/swap/amm.js.map +1 -0
  143. package/dist/swap/clmmMath.d.ts +24 -0
  144. package/dist/swap/clmmMath.d.ts.map +1 -0
  145. package/dist/swap/clmmMath.js +82 -0
  146. package/dist/swap/clmmMath.js.map +1 -0
  147. package/dist/swap/common.d.ts +68 -0
  148. package/dist/swap/common.d.ts.map +1 -0
  149. package/dist/swap/common.js +65 -0
  150. package/dist/swap/common.js.map +1 -0
  151. package/dist/swap/cpmm.d.ts +28 -0
  152. package/dist/swap/cpmm.d.ts.map +1 -0
  153. package/dist/swap/cpmm.js +113 -0
  154. package/dist/swap/cpmm.js.map +1 -0
  155. package/dist/swap/index.d.ts +145 -0
  156. package/dist/swap/index.d.ts.map +1 -0
  157. package/dist/swap/index.js +349 -0
  158. package/dist/swap/index.js.map +1 -0
  159. package/dist/swap/orca.d.ts +50 -0
  160. package/dist/swap/orca.d.ts.map +1 -0
  161. package/dist/swap/orca.js +382 -0
  162. package/dist/swap/orca.js.map +1 -0
  163. package/dist/swap/raydiumClmm.d.ts +62 -0
  164. package/dist/swap/raydiumClmm.d.ts.map +1 -0
  165. package/dist/swap/raydiumClmm.js +447 -0
  166. package/dist/swap/raydiumClmm.js.map +1 -0
  167. package/dist/tradeCheck.d.ts +45 -0
  168. package/dist/tradeCheck.d.ts.map +1 -0
  169. package/dist/tradeCheck.js +131 -0
  170. package/dist/tradeCheck.js.map +1 -0
  171. package/dist/write/instructions.d.ts +9 -0
  172. package/dist/write/instructions.d.ts.map +1 -1
  173. package/dist/write/instructions.js +40 -1
  174. package/dist/write/instructions.js.map +1 -1
  175. package/dist/write/transaction.d.ts +23 -0
  176. package/dist/write/transaction.d.ts.map +1 -1
  177. package/dist/write/transaction.js +50 -0
  178. package/dist/write/transaction.js.map +1 -1
  179. package/package.json +66 -14
  180. package/src/approvals.ts +358 -0
  181. package/src/batchPlan.ts +137 -0
  182. package/src/claim.ts +323 -0
  183. package/src/decode.ts +202 -0
  184. package/src/describe.ts +77 -0
  185. package/src/fees.ts +259 -0
  186. package/src/history.ts +336 -0
  187. package/src/historyHelius.ts +136 -0
  188. package/src/layout.ts +2 -2
  189. package/src/liquidity/orca.ts +15 -5
  190. package/src/liquidity/raydiumClmm.ts +13 -5
  191. package/src/lp.ts +148 -59
  192. package/src/lpMath.ts +38 -0
  193. package/src/names.ts +329 -0
  194. package/src/pools.ts +43 -0
  195. package/src/portfolio.ts +124 -0
  196. package/src/price.ts +366 -0
  197. package/src/programs.ts +216 -0
  198. package/src/reclaim.ts +547 -0
  199. package/src/risk.ts +243 -0
  200. package/src/rpc.ts +39 -10
  201. package/src/simulate.ts +535 -0
  202. package/src/subpaths/approvals.ts +47 -0
  203. package/src/subpaths/claim.ts +53 -0
  204. package/src/subpaths/fees.ts +41 -0
  205. package/src/subpaths/history.ts +38 -0
  206. package/src/subpaths/lp.ts +5 -1
  207. package/src/subpaths/names.ts +45 -0
  208. package/src/subpaths/price.ts +62 -0
  209. package/src/subpaths/reclaim.ts +57 -0
  210. package/src/subpaths/risk.ts +36 -0
  211. package/src/subpaths/simulate.ts +37 -0
  212. package/src/subpaths/swap.ts +41 -0
  213. package/src/subpaths/write.ts +2 -0
  214. package/src/swap/amm.ts +88 -0
  215. package/src/swap/clmmMath.ts +96 -0
  216. package/src/swap/common.ts +113 -0
  217. package/src/swap/cpmm.ts +132 -0
  218. package/src/swap/index.ts +467 -0
  219. package/src/swap/orca.ts +397 -0
  220. package/src/swap/raydiumClmm.ts +464 -0
  221. package/src/tradeCheck.ts +166 -0
  222. package/src/write/instructions.ts +43 -1
  223. package/src/write/transaction.ts +62 -0
@@ -0,0 +1,399 @@
1
+ /**
2
+ * 账户回收(子路径 `@w3lib/solana-batch-call/reclaim`):扫描钱包里关闭后能退回租金(SOL)的账户,给出每项和合计能拿回多少 lamports,批量关闭。
3
+ *
4
+ * - 空的代币账户(SPL Token / Token-2022,有暂存转账手续费的先收到 mint 上);冻结的、关闭权限是别人的关不掉,单独列出
5
+ * - 垃圾币:有余额但没有价格 / 价值很小 / 垃圾特征(可疑名字、不可转让等)的代币,先销毁再关闭账户(一个账户的指令原子执行)。
6
+ * 默认只自动勾选有把握的(见 `selected`):有价格且价值超过 `maxJunkUsd` 的、NFT、仓位 NFT 一律不当垃圾币
7
+ * - Wrapped SOL 账户:关闭 = 解包,余额和租金一起退回
8
+ * - 已清空的集中流动性仓位(Orca Whirlpool、Raydium CLMM:流动性、手续费、奖励都是 0):关闭仓位账户并销毁 NFT。还有没领的手续费 / 奖励时列在 blocked,先用 /claim 领取
9
+ */
10
+ import { decodeAddress, findProgramAddress, isAddress } from './address.js';
11
+ import { TOKEN_2022_PROGRAM_ID } from './constants.js';
12
+ import { approvals, parseTokenAccountState } from './approvals.js';
13
+ import { ORCA_WHIRLPOOL_PROGRAM_ID, RAYDIUM_CLMM_PROGRAM_ID, parseClmmPosition, utf8 } from './lp.js';
14
+ import { orcaClosePosition } from './liquidity/orca.js';
15
+ import { raydiumClosePosition } from './liquidity/raydiumClmm.js';
16
+ import { defillamaPrices } from './price.js';
17
+ import { tokenRisks } from './risk.js';
18
+ import { simulatePlan, sendCalls } from './batchPlan.js';
19
+ import { burnChecked, closeAccount, harvestWithheldTokensToMint } from './write/instructions.js';
20
+ /** 垃圾特征里足以自动勾选的风险标记(只有这些:legit 的 RWA / 稳定币常有 permanent-delegate、transfer-hook,不能据此判断) */
21
+ const JUNK_RISK_FLAGS = ['non-transferable', 'high-transfer-fee', 'paused'];
22
+ /** 垃圾币常见的名字:链接 / 域名、领奖广告。只作提示(reasons 里的 spam-name),不会让代币被自动勾选 */
23
+ const SPAM_SYMBOL = /https?:|www\.|\.(com|io|xyz|net|org|app|cc|vip|top|site|fun|live|me)\b|t\.me|claim|airdrop|visit|voucher|\$\d/i;
24
+ const NFT_DECIMALS = 0;
25
+ const ownedBy = (a, owner) => a.owner === owner;
26
+ /** 能关闭的限制:冻结、关闭权限是别人、机密余额。没有时返回 undefined */
27
+ function closeBlock(a) {
28
+ if (a.frozen)
29
+ return 'frozen';
30
+ if (a.closeBlocker === 'close-authority')
31
+ return 'close-authority';
32
+ if (a.closeBlocker === 'confidential-balance')
33
+ return 'confidential-balance';
34
+ return undefined;
35
+ }
36
+ const positionPda = (program, mint) => findProgramAddress([utf8('position'), decodeAddress(mint)], program);
37
+ function tokenItem(a, kind, extra) {
38
+ const lamports = BigInt(a.lamports);
39
+ return {
40
+ kind,
41
+ account: a.account,
42
+ owner: a.owner,
43
+ mint: a.mint,
44
+ tokenProgram: a.tokenProgram,
45
+ symbol: a.symbol,
46
+ decimals: a.decimals,
47
+ amount: a.amount,
48
+ formatted: a.formatted,
49
+ usd: extra.usd,
50
+ withheldAmount: a.withheldAmount,
51
+ lamports: lamports.toString(),
52
+ rentLamports: (a.native ? lamports - BigInt(a.amount) : lamports).toString(),
53
+ selected: extra.selected,
54
+ reasons: extra.reasons,
55
+ ...(extra.blocker ? { blocker: extra.blocker } : {}),
56
+ };
57
+ }
58
+ /**
59
+ * 扫描钱包里能回收租金的账户(只读取)。需要列出全部代币账户(getTokenAccountsByOwner),免费公共节点不支持时传 `mints` 只看指定代币的 ATA。
60
+ *
61
+ * ```ts
62
+ * const r = await reclaimable(client, owner)
63
+ * r.totalLamports // 全部能拿回的 lamports
64
+ * r.items.filter((i) => i.selected) // 建议勾选的
65
+ * ```
66
+ */
67
+ export async function reclaimable(client, owner, query = {}) {
68
+ if (!isAddress(owner)) {
69
+ throw new Error(`Invalid owner address: ${owner}`);
70
+ }
71
+ const { signal } = query;
72
+ const maxJunkUsd = query.maxJunkUsd ?? 0.01;
73
+ if (!(maxJunkUsd >= 0)) {
74
+ throw new RangeError(`maxJunkUsd must be >= 0: ${maxJunkUsd}`);
75
+ }
76
+ const accounts = (await approvals(client, owner, { mints: query.mints, all: true, signal })).filter((a) => ownedBy(a, owner));
77
+ const items = [];
78
+ const blocked = [];
79
+ const warnings = [];
80
+ const push = (item, blocker) => (blocker ? blocked.push({ ...item, blocker }) : items.push(item));
81
+ const nft = (a) => a.decimals === NFT_DECIMALS && a.amount === '1' && !a.native;
82
+ const rest = [];
83
+ for (const a of accounts) {
84
+ const blocker = closeBlock(a);
85
+ if (a.native) {
86
+ // Wrapped SOL:空的算空账户,有余额的关闭即解包
87
+ const empty = BigInt(a.amount) === 0n;
88
+ push(tokenItem(a, empty ? 'empty-token' : 'wrapped-sol', { selected: true, reasons: [empty ? 'empty' : 'unwrap'], usd: null }), blocker);
89
+ }
90
+ else if (BigInt(a.amount) === 0n) {
91
+ push(tokenItem(a, 'empty-token', { selected: true, reasons: ['empty'], usd: null }), blocker);
92
+ }
93
+ else if (!nft(a)) {
94
+ rest.push(a);
95
+ }
96
+ }
97
+ if (query.positions ?? true) {
98
+ await scanPositions(client, accounts.filter(nft), push, signal);
99
+ }
100
+ if ((query.junk ?? true) && rest.length) {
101
+ await scanJunk(client, rest, query, maxJunkUsd, push, warnings);
102
+ }
103
+ const byKind = {};
104
+ let total = 0n;
105
+ let selected = 0n;
106
+ for (const item of items) {
107
+ const entry = byKind[item.kind] ?? { count: 0, lamports: '0' };
108
+ byKind[item.kind] = { count: entry.count + 1, lamports: (BigInt(entry.lamports) + BigInt(item.lamports)).toString() };
109
+ total += BigInt(item.lamports);
110
+ if (item.selected)
111
+ selected += BigInt(item.lamports);
112
+ }
113
+ return { owner, items, blocked, totalLamports: total.toString(), selectedLamports: selected.toString(), byKind, warnings };
114
+ }
115
+ /** 仓位 NFT(精度 0、余额 1):Orca / Raydium CLMM 的仓位账户一次读出,清空了的列出来 */
116
+ async function scanPositions(client, nfts, push, signal) {
117
+ if (!nfts.length)
118
+ return;
119
+ const protocols = [
120
+ { protocol: 'orca-whirlpool', program: ORCA_WHIRLPOOL_PROGRAM_ID, kind: 'orca-position' },
121
+ { protocol: 'raydium-clmm', program: RAYDIUM_CLMM_PROGRAM_ID, kind: 'raydium-position' },
122
+ ];
123
+ const addresses = nfts.flatMap((a) => [...protocols.map((p) => positionPda(p.program, a.mint)), a.mint]);
124
+ const read = await client.accounts(addresses, { signal });
125
+ nfts.forEach((a, i) => {
126
+ const base = i * (protocols.length + 1);
127
+ const mintAccount = read[base + protocols.length];
128
+ protocols.forEach((p, j) => {
129
+ const address = addresses[base + j];
130
+ const account = read[base + j];
131
+ const state = account ? parseClmmPosition(p.protocol, address, account) : null;
132
+ if (!state || !account || state.mint !== a.mint || state.liquidity > 0n)
133
+ return;
134
+ // 仓位 NFT 是 Token-2022(带元数据扩展)时两个程序都连 mint 一起关闭;SPL Token 的 NFT mint 留着(主网模拟核对过)
135
+ const closesMint = a.tokenProgram === TOKEN_2022_PROGRAM_ID;
136
+ const rent = account.lamports + BigInt(a.lamports) + (closesMint && mintAccount ? mintAccount.lamports : 0n);
137
+ const owed = state.owed0 > 0n || state.owed1 > 0n || state.rewards.some((r) => r.owed > 0n);
138
+ const item = {
139
+ ...tokenItem(a, p.kind, { selected: true, reasons: [owed ? 'owed' : 'empty-position'], usd: null }),
140
+ lamports: rent.toString(),
141
+ rentLamports: rent.toString(),
142
+ position: { protocol: p.protocol, positionMint: a.mint, position: address, pool: state.pool },
143
+ };
144
+ push(item, closeBlock(a) ?? (owed ? 'owed' : undefined));
145
+ });
146
+ });
147
+ }
148
+ /** 有余额的代币:查价格和风险,按保守的规则判断哪些是垃圾币 */
149
+ async function scanJunk(client, list, query, maxJunkUsd, push, warnings) {
150
+ const { signal } = query;
151
+ const mints = [...new Set(list.map((a) => a.mint))];
152
+ const source = query.prices === false ? null : query.prices && query.prices !== true ? query.prices : defillamaPrices();
153
+ // 价格没查到(关闭 / 服务出错)时不知道哪些值钱:不自动勾选任何垃圾币
154
+ let pricesOk = source !== null;
155
+ let priceMap = new Map();
156
+ if (source) {
157
+ try {
158
+ const fetchFn = query.fetch ?? ((...args) => fetch(...args));
159
+ priceMap = await source.prices({ mints, fetch: fetchFn, signal, client });
160
+ }
161
+ catch (err) {
162
+ if (signal?.aborted)
163
+ throw err;
164
+ pricesOk = false;
165
+ warnings.push(`Price lookup failed (${err instanceof Error ? err.message : String(err)}): junk tokens are not auto-selected`);
166
+ }
167
+ }
168
+ else {
169
+ warnings.push('Prices are off: junk tokens are not auto-selected');
170
+ }
171
+ const risks = new Map();
172
+ if (query.risk ?? true) {
173
+ try {
174
+ const found = await tokenRisks(client, mints, { signal });
175
+ found.forEach((r, i) => risks.set(mints[i], r));
176
+ }
177
+ catch (err) {
178
+ if (signal?.aborted)
179
+ throw err;
180
+ warnings.push(`Risk check failed (${err instanceof Error ? err.message : String(err)})`);
181
+ }
182
+ }
183
+ for (const a of list) {
184
+ const price = priceMap.get(a.mint) ?? null;
185
+ const usd = price !== null && a.formatted !== null ? Number(a.formatted) * price : null;
186
+ const risk = risks.get(a.mint) ?? null;
187
+ const custom = query.isJunk?.({ account: a, price, usd, risk });
188
+ const valuable = usd !== null && usd > maxJunkUsd;
189
+ if (custom === false || (valuable && custom !== true))
190
+ continue;
191
+ const reasons = [];
192
+ let sure = false;
193
+ if (custom === true) {
194
+ reasons.push('custom');
195
+ sure = true;
196
+ }
197
+ else {
198
+ if (usd !== null) {
199
+ reasons.push('dust');
200
+ sure = true;
201
+ }
202
+ else {
203
+ reasons.push('no-price');
204
+ }
205
+ if (a.symbol && (SPAM_SYMBOL.test(a.symbol) || a.symbol.length > 24)) {
206
+ reasons.push('spam-name'); // 只是提示:名字不能单独作为销毁的依据
207
+ }
208
+ for (const flag of risk?.flags ?? []) {
209
+ if (JUNK_RISK_FLAGS.includes(flag)) {
210
+ reasons.push(`risk:${flag}`);
211
+ sure = true;
212
+ }
213
+ }
214
+ sure &&= pricesOk;
215
+ }
216
+ // 销毁不了的:暂停了、只有指定地址能销毁
217
+ const blocker = closeBlock(a) ?? (risk?.pausable?.paused ? 'paused' : risk?.burnAuthority ? 'permissioned-burn' : undefined);
218
+ if (blocker && !sure)
219
+ continue; // 不确定是垃圾币又关不掉的不列
220
+ push(tokenItem(a, 'junk-token', { selected: sure, reasons, usd }), blocker);
221
+ }
222
+ }
223
+ /**
224
+ * 构建回收的指令(只读取、不签名):发送前重新读取每个账户的当前状态再核对(owner、mint、余额、冻结、关闭权限、仓位是否清空),
225
+ * 状态变了的不构建、列在 skipped。每个账户一个调用(垃圾币:销毁 → 收暂存手续费 → 关闭,原子执行)。
226
+ * 绝不关闭有余额的账户:空账户余额不为 0 时跳过;垃圾币只销毁和列表里一致的余额(有人又转入了就跳过);只有 Wrapped SOL 带余额关闭(解包)
227
+ *
228
+ * ```ts
229
+ * const r = await reclaimable(client, owner)
230
+ * const plan = await buildReclaim(client, owner, r.items.filter((i) => i.selected))
231
+ * ```
232
+ */
233
+ export async function buildReclaim(client, owner, items, options = {}) {
234
+ if (!isAddress(owner)) {
235
+ throw new Error(`Invalid owner address: ${owner}`);
236
+ }
237
+ const destination = options.destination ?? owner;
238
+ if (!isAddress(destination)) {
239
+ throw new Error(`Invalid destination: ${destination}`);
240
+ }
241
+ const seen = new Set();
242
+ const list = [];
243
+ for (const item of items) {
244
+ if (item.owner !== owner) {
245
+ throw new Error(`Account ${item.account} belongs to ${item.owner}, not ${owner}`);
246
+ }
247
+ if (item.blocker) {
248
+ throw new Error(`Account ${item.account} cannot be reclaimed yet (${item.blocker})`);
249
+ }
250
+ if (!seen.has(item.account)) {
251
+ seen.add(item.account);
252
+ list.push(item);
253
+ }
254
+ }
255
+ const addresses = list.flatMap((i) => (i.position ? [i.account, i.position.position] : [i.account]));
256
+ const read = addresses.length ? await client.accounts(addresses, { signal: options.signal }) : [];
257
+ const at = new Map(addresses.map((a, i) => [a, read[i] ?? null]));
258
+ const calls = [];
259
+ const skipped = [];
260
+ const warnings = [];
261
+ let lamports = 0n;
262
+ for (const item of list) {
263
+ const skip = (reason) => skipped.push({ item, reason });
264
+ const account = at.get(item.account);
265
+ const state = account && account.owner === item.tokenProgram ? parseTokenAccountState(account.data) : null;
266
+ if (!account || !state) {
267
+ skip('account not found (already closed?)');
268
+ continue;
269
+ }
270
+ if (state.owner !== owner || state.mint !== item.mint) {
271
+ skip('account owner or mint changed');
272
+ continue;
273
+ }
274
+ if (state.frozen) {
275
+ skip('account is frozen');
276
+ continue;
277
+ }
278
+ if (state.closeAuthority !== null && state.closeAuthority !== owner) {
279
+ skip('another address holds the close authority');
280
+ continue;
281
+ }
282
+ if (state.confidentialBalance) {
283
+ skip('confidential balance is not zero');
284
+ continue;
285
+ }
286
+ const instructions = [];
287
+ let expected = account.lamports;
288
+ if (item.kind === 'orca-position' || item.kind === 'raydium-position') {
289
+ const position = item.position;
290
+ const raw = position ? at.get(position.position) : null;
291
+ const parsed = position && raw ? parseClmmPosition(position.protocol, position.position, raw) : null;
292
+ if (!position || !parsed || parsed.mint !== item.mint) {
293
+ skip('position account not found');
294
+ continue;
295
+ }
296
+ if (state.amount !== 1n) {
297
+ skip('the position NFT is not in this account');
298
+ continue;
299
+ }
300
+ if (parsed.liquidity > 0n || parsed.owed0 > 0n || parsed.owed1 > 0n || parsed.rewards.some((r) => r.owed > 0n)) {
301
+ skip('position is not empty (has liquidity or unclaimed fees / rewards)');
302
+ continue;
303
+ }
304
+ if (item.kind === 'orca-position') {
305
+ instructions.push(orcaClosePosition(owner, destination, item.mint, item.tokenProgram, item.account));
306
+ }
307
+ else {
308
+ instructions.push(raydiumClosePosition(owner, item.mint, item.tokenProgram, position.pool, item.account));
309
+ if (destination !== owner && !warnings.some((w) => w.startsWith('Raydium CLMM'))) {
310
+ warnings.push('Raydium CLMM position rent is always returned to the owner, not to the destination');
311
+ }
312
+ }
313
+ expected = BigInt(item.lamports);
314
+ }
315
+ else {
316
+ if (item.kind === 'junk-token') {
317
+ if (state.native || state.amount === 0n || state.amount.toString() !== item.amount) {
318
+ skip('balance changed since the scan');
319
+ continue;
320
+ }
321
+ if (item.decimals === null || (item.decimals === NFT_DECIMALS && state.amount === 1n)) {
322
+ skip('NFTs and tokens with unknown decimals are never burned');
323
+ continue;
324
+ }
325
+ instructions.push(burnChecked(item.account, item.mint, owner, state.amount, item.decimals, item.tokenProgram));
326
+ }
327
+ else if (item.kind === 'empty-token') {
328
+ if (state.amount !== 0n) {
329
+ skip('account is not empty anymore');
330
+ continue;
331
+ }
332
+ }
333
+ else if (item.kind === 'wrapped-sol') {
334
+ if (!state.native) {
335
+ skip('not a Wrapped SOL account anymore');
336
+ continue;
337
+ }
338
+ }
339
+ if (item.tokenProgram === TOKEN_2022_PROGRAM_ID && state.withheldAmount > 0n) {
340
+ instructions.push(harvestWithheldTokensToMint(item.mint, [item.account]));
341
+ }
342
+ instructions.push(closeAccount(item.account, destination, owner, item.tokenProgram));
343
+ }
344
+ lamports += expected;
345
+ calls.push({ kind: item.kind, account: item.account, owner, instructions, item });
346
+ }
347
+ return { owner, destination, calls, skipped, lamports: lamports.toString(), warnings };
348
+ }
349
+ /**
350
+ * 用 /simulate 模拟构建好的回收(不签名、不发送):逐笔交易的结果、哪些调用会失败、手续费、预计退回的 SOL
351
+ *
352
+ * ```ts
353
+ * const sim = await simulateReclaim(client, plan)
354
+ * if (!sim.success) console.log(sim.failed) // [{ index, error }]
355
+ * sim.lamports // 预计拿回的 lamports
356
+ * ```
357
+ */
358
+ export async function simulateReclaim(client, plan, options = {}) {
359
+ const sim = await simulatePlan(client, plan.calls, { ...options, watch: [plan.destination] });
360
+ const payer = options.feePayer ?? plan.owner;
361
+ const exact = payer === plan.destination && sim.success;
362
+ return { ...sim, lamports: exact ? sim.payerNativeDelta : plan.lamports, lamportsSource: exact ? 'simulation' : 'estimate' };
363
+ }
364
+ /**
365
+ * 回收:构建(重新读取账户并核对)→ 模拟 → 用 from 签名发送(钱包同 /write 的 batchCall,多个账户打包进同一笔交易,feePayer 可以替 owner 付手续费)。
366
+ * 一个账户失败不影响其他的。dryRun: true 只构建和模拟(不签名,from 只用来取地址)
367
+ *
368
+ * ```ts
369
+ * const r = await reclaimable(client, owner)
370
+ * const { simulation, results } = await reclaim(client, key, r.items.filter((i) => i.selected), { destination: cold })
371
+ * ```
372
+ */
373
+ export async function reclaim(client, from, items, options = {}) {
374
+ const { resolveSigner } = await import('./write/signer.js');
375
+ const owner = (await resolveSigner(from)).address;
376
+ const plan = await buildReclaim(client, owner, items, options);
377
+ const feePayer = options.feePayer === undefined ? undefined : (await resolveSigner(options.feePayer)).address;
378
+ const simulation = options.simulate === false && !options.dryRun ? null : await simulateReclaim(client, plan, { feePayer, signal: options.signal, batchSize: (options.mode ?? 'pack') === 'tx' ? 1 : options.batchSize });
379
+ const failed = new Map(simulation?.failed.map((f) => [f.index, f.error]));
380
+ const results = [];
381
+ const toSend = plan.calls.filter((_, i) => !failed.has(i));
382
+ const sent = options.dryRun ? [] : await sendCalls(client, from, toSend, options);
383
+ let next = 0;
384
+ plan.calls.forEach((call, index) => {
385
+ const base = { kind: call.kind, account: call.account, item: call.item };
386
+ const error = failed.get(index);
387
+ if (error !== undefined) {
388
+ results.push({ index, from: owner, status: 'failed', signature: null, slot: null, fee: null, computeUnits: null, error, ...base });
389
+ }
390
+ else if (options.dryRun) {
391
+ results.push({ index, from: owner, status: 'simulated', signature: null, slot: null, fee: null, computeUnits: null, error: null, ...base });
392
+ }
393
+ else {
394
+ results.push({ ...sent[next++], index, ...base });
395
+ }
396
+ });
397
+ return { plan, simulation, results };
398
+ }
399
+ //# sourceMappingURL=reclaim.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reclaim.js","sourceRoot":"","sources":["../src/reclaim.ts"],"names":[],"mappings":"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"}
package/dist/risk.d.ts ADDED
@@ -0,0 +1,84 @@
1
+ import type { RequestOptions, SolanaClient } from './client.js';
2
+ import { type AccountInfo } from './layout.js';
3
+ export interface SolanaTokenRisk {
4
+ mint: string;
5
+ /** mint 账户存在且是 SPL Token / Token-2022 的 mint */
6
+ exists: boolean;
7
+ program: 'spl-token' | 'token-2022' | null;
8
+ decimals: number | null;
9
+ /** 总量(最小单位) */
10
+ supply: string | null;
11
+ /** 增发权限:不为 null 时还能继续增发 */
12
+ mintAuthority: string | null;
13
+ /** 冻结权限:不为 null 时可以冻结任何持有人的代币账户 */
14
+ freezeAuthority: string | null;
15
+ /** Token-2022 转账手续费(当前 epoch 生效的);authority 不为 null 时费率还能改(新费率两个 epoch 后生效) */
16
+ transferFee: {
17
+ basisPoints: number;
18
+ maximumFee: string;
19
+ authority: string | null;
20
+ next: {
21
+ basisPoints: number;
22
+ maximumFee: string;
23
+ epoch: string;
24
+ } | null;
25
+ } | null;
26
+ /** 永久授权:这个地址可以转走 / 销毁任何持有人的代币 */
27
+ permanentDelegate: string | null;
28
+ /** 转账 hook:每次转账都会调用这个程序(可以拒绝转账);authority 不为 null 时程序还能换 */
29
+ transferHook: {
30
+ program: string | null;
31
+ authority: string | null;
32
+ } | null;
33
+ /** 不可转让(灵魂绑定) */
34
+ nonTransferable: boolean;
35
+ /** 新建的代币账户默认是冻结的(要冻结权限解冻后才能用) */
36
+ defaultFrozen: boolean;
37
+ /** 可暂停:authority 可以暂停全部转账、增发、销毁;paused 为当前状态 */
38
+ pausable: {
39
+ paused: boolean;
40
+ authority: string | null;
41
+ } | null;
42
+ /** 保密转账(余额和转账数量加密) */
43
+ confidentialTransfer: {
44
+ authority: string | null;
45
+ autoApprove: boolean;
46
+ } | null;
47
+ /** mint 关闭权限(总量为 0 时可以关闭 mint) */
48
+ mintCloseAuthority: string | null;
49
+ /** 显示数量会随时间 / 系数变化(InterestBearingConfig、ScaledUiAmount),authority 可以改利率 / 系数 */
50
+ uiAmountAuthority: string | null;
51
+ /** 只有这个地址能批准销毁(PermissionedBurn) */
52
+ burnAuthority: string | null;
53
+ /** 持币集中度(concentration: true 时):最大的 20 个代币账户里前 10 个占总量的比例;节点不支持或总量为 0 时为 null */
54
+ topHolders: {
55
+ top10Share: number;
56
+ accounts: Array<{
57
+ address: string;
58
+ amount: string;
59
+ share: number;
60
+ }>;
61
+ } | null;
62
+ /**
63
+ * 汇总的风险标记:not-found、mintable、freezable、transfer-fee(> 0)、high-transfer-fee(> 10%)、fee-changeable、permanent-delegate、
64
+ * transfer-hook、non-transferable、default-frozen、pausable、paused、confidential-transfer、closable、ui-amount-changes、permissioned-burn、
65
+ * concentrated(前 10 个账户 > 50%,含池子金库、交易所地址)
66
+ */
67
+ flags: string[];
68
+ }
69
+ export interface TokenRisksOptions extends RequestOptions {
70
+ /** 查持币集中度(getTokenLargestAccounts,每个 mint 一次请求;免费公共节点大多不支持,不支持时 topHolders 为 null),默认 false */
71
+ concentration?: boolean;
72
+ }
73
+ /**
74
+ * 检查代币的风险(mint 和 Clock 一次 getMultipleAccounts 读完)。原生 SOL(客户端的 nativeMints)按 Wrapped SOL 的 mint 查。
75
+ *
76
+ * ```ts
77
+ * const [risk] = await tokenRisks(client, [PYUSD])
78
+ * // { program: 'token-2022', mintAuthority: '22mK…', freezeAuthority: '2apB…', permanentDelegate: '2apB…', flags: ['mintable', 'freezable', 'permanent-delegate', …] }
79
+ * ```
80
+ */
81
+ export declare function tokenRisks(client: SolanaClient, mints: readonly string[], options?: TokenRisksOptions): Promise<SolanaTokenRisk[]>;
82
+ /** 解析一个 mint 账户的风险项(包内使用,测试也用);epoch 用来选转账手续费的新旧配置(null 时按新配置) */
83
+ export declare function parseRisk(mint: string, account: AccountInfo | null, epoch: bigint | null): SolanaTokenRisk;
84
+ //# sourceMappingURL=risk.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"risk.d.ts","sourceRoot":"","sources":["../src/risk.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/D,OAAO,EAAoD,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAyBhG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,WAAW,GAAG,YAAY,GAAG,IAAI,CAAA;IAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,eAAe;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,2BAA2B;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,mCAAmC;IACnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,+EAA+E;IAC/E,WAAW,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IAClK,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,4DAA4D;IAC5D,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IACzE,iBAAiB;IACjB,eAAe,EAAE,OAAO,CAAA;IACxB,iCAAiC;IACjC,aAAa,EAAE,OAAO,CAAA;IACtB,gDAAgD;IAChD,QAAQ,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IAC9D,sBAAsB;IACtB,oBAAoB,EAAE;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;IAC/E,kCAAkC;IAClC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,iFAAiF;IACjF,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,oCAAoC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,iFAAiF;IACjF,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAA;IAC9G;;;;OAIG;IACH,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,+FAA+F;IAC/F,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA2B5I;AA6CD,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,CA0D1G"}