four-flap-meme-sdk 3.0.1 → 4.0.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 (442) hide show
  1. package/dist/bundle/four-meme/approve-tokenmanager.d.ts +2 -2
  2. package/dist/bundle/four-meme/approve-tokenmanager.js +3 -3
  3. package/dist/bundle/four-meme/core/buy-flow.d.ts +5 -0
  4. package/dist/bundle/four-meme/core/buy-flow.js +147 -0
  5. package/dist/bundle/four-meme/core/constants.d.ts +6 -0
  6. package/dist/bundle/four-meme/core/constants.js +15 -0
  7. package/dist/bundle/four-meme/core/create-token.d.ts +5 -0
  8. package/dist/bundle/four-meme/core/create-token.js +137 -0
  9. package/dist/bundle/four-meme/core/index.d.ts +14 -0
  10. package/dist/bundle/four-meme/core/index.js +14 -0
  11. package/dist/bundle/four-meme/core/sell-flow.d.ts +5 -0
  12. package/dist/bundle/four-meme/core/sell-flow.js +240 -0
  13. package/dist/bundle/four-meme/core-helpers.js +1 -1
  14. package/dist/bundle/four-meme/core.d.ts +7 -4
  15. package/dist/bundle/four-meme/core.js +5 -513
  16. package/dist/bundle/four-meme/pancake-proxy/approve.d.ts +15 -0
  17. package/dist/bundle/four-meme/pancake-proxy/approve.js +113 -0
  18. package/dist/bundle/four-meme/pancake-proxy/buy.d.ts +8 -0
  19. package/dist/bundle/four-meme/pancake-proxy/buy.js +143 -0
  20. package/dist/bundle/four-meme/pancake-proxy/constants.d.ts +25 -0
  21. package/dist/bundle/four-meme/pancake-proxy/constants.js +14 -0
  22. package/dist/bundle/four-meme/pancake-proxy/helpers.d.ts +45 -0
  23. package/dist/bundle/four-meme/pancake-proxy/helpers.js +232 -0
  24. package/dist/bundle/four-meme/pancake-proxy/index.d.ts +15 -0
  25. package/dist/bundle/four-meme/pancake-proxy/index.js +15 -0
  26. package/dist/bundle/four-meme/pancake-proxy/sell.d.ts +8 -0
  27. package/dist/bundle/four-meme/pancake-proxy/sell.js +194 -0
  28. package/dist/bundle/four-meme/pancake-proxy.d.ts +4 -20
  29. package/dist/bundle/four-meme/pancake-proxy.js +3 -670
  30. package/dist/bundle/four-meme/private/buy.d.ts +16 -0
  31. package/dist/bundle/four-meme/private/buy.js +225 -0
  32. package/dist/bundle/four-meme/private/index.d.ts +11 -0
  33. package/dist/bundle/four-meme/private/index.js +11 -0
  34. package/dist/bundle/four-meme/private/sell.d.ts +18 -0
  35. package/dist/bundle/four-meme/private/sell.js +245 -0
  36. package/dist/bundle/four-meme/private.d.ts +5 -25
  37. package/dist/bundle/four-meme/private.js +5 -463
  38. package/dist/bundle/four-meme/swap/batch.d.ts +8 -0
  39. package/dist/bundle/four-meme/swap/batch.js +170 -0
  40. package/dist/bundle/four-meme/swap/bundle.d.ts +8 -0
  41. package/dist/bundle/four-meme/swap/bundle.js +147 -0
  42. package/dist/bundle/four-meme/swap/index.d.ts +14 -0
  43. package/dist/bundle/four-meme/swap/index.js +13 -0
  44. package/dist/bundle/four-meme/swap/quick-batch.d.ts +8 -0
  45. package/dist/bundle/four-meme/swap/quick-batch.js +206 -0
  46. package/dist/bundle/four-meme/swap-buy-first/helpers.d.ts +20 -0
  47. package/dist/bundle/four-meme/swap-buy-first/helpers.js +39 -0
  48. package/dist/bundle/four-meme/swap-buy-first/index.d.ts +12 -0
  49. package/dist/bundle/four-meme/swap-buy-first/index.js +11 -0
  50. package/dist/bundle/four-meme/swap-buy-first/multi-wallet.d.ts +20 -0
  51. package/dist/bundle/four-meme/swap-buy-first/multi-wallet.js +198 -0
  52. package/dist/bundle/four-meme/swap-buy-first/single.d.ts +7 -0
  53. package/dist/bundle/four-meme/swap-buy-first/single.js +232 -0
  54. package/dist/bundle/four-meme/swap-buy-first.d.ts +4 -3
  55. package/dist/bundle/four-meme/swap-buy-first.js +4 -451
  56. package/dist/bundle/four-meme/swap-hop-helpers.d.ts +2 -2
  57. package/dist/bundle/four-meme/swap-sign-helpers.d.ts +2 -2
  58. package/dist/bundle/four-meme/swap-sign-helpers.js +1 -1
  59. package/dist/bundle/four-meme/swap.d.ts +4 -14
  60. package/dist/bundle/four-meme/swap.js +4 -502
  61. package/dist/bundle/four-meme/types/index.d.ts +1 -1
  62. package/dist/bundle/four-meme/utils-disperse.d.ts +1 -1
  63. package/dist/bundle/four-meme/utils-disperse.js +1 -1
  64. package/dist/bundle/four-meme/utils-pairwise.d.ts +1 -1
  65. package/dist/bundle/four-meme/utils-pairwise.js +1 -1
  66. package/dist/bundle/four-meme/utils-sweep/context.d.ts +39 -0
  67. package/dist/bundle/four-meme/utils-sweep/context.js +7 -0
  68. package/dist/bundle/four-meme/utils-sweep/erc20-no-hop.d.ts +5 -0
  69. package/dist/bundle/four-meme/utils-sweep/erc20-no-hop.js +162 -0
  70. package/dist/bundle/four-meme/utils-sweep/index.d.ts +13 -0
  71. package/dist/bundle/four-meme/utils-sweep/index.js +13 -0
  72. package/dist/bundle/four-meme/utils-sweep/main.d.ts +8 -0
  73. package/dist/bundle/four-meme/utils-sweep/main.js +114 -0
  74. package/dist/bundle/four-meme/utils-sweep/native-no-hop.d.ts +5 -0
  75. package/dist/bundle/four-meme/utils-sweep/native-no-hop.js +156 -0
  76. package/dist/bundle/four-meme/utils-sweep/with-hops.d.ts +6 -0
  77. package/dist/bundle/four-meme/utils-sweep/with-hops.js +382 -0
  78. package/dist/bundle/four-meme/utils-sweep.d.ts +3 -4
  79. package/dist/bundle/four-meme/utils-sweep.js +3 -740
  80. package/dist/bundle/internal.d.ts +2 -2
  81. package/dist/bundle/sign-context-helpers.d.ts +1 -26
  82. package/dist/bundle/sign-context-helpers.js +1 -63
  83. package/dist/bundle/submit/blockrazor.d.ts +94 -0
  84. package/dist/bundle/submit/blockrazor.js +122 -0
  85. package/dist/bundle/submit/direct.d.ts +118 -0
  86. package/dist/bundle/submit/direct.js +484 -0
  87. package/dist/bundle/submit/helpers.d.ts +7 -0
  88. package/dist/bundle/submit/helpers.js +15 -0
  89. package/dist/bundle/submit/index.d.ts +14 -0
  90. package/dist/bundle/submit/index.js +14 -0
  91. package/dist/bundle/submit/merkle.d.ts +84 -0
  92. package/dist/bundle/submit/merkle.js +121 -0
  93. package/dist/bundle/submit.d.ts +3 -286
  94. package/dist/bundle/submit.js +3 -724
  95. package/dist/chains/bsc/four/types.d.ts +1 -1
  96. package/dist/chains/bsc/pancake/bundle-buy-first-build.d.ts +25 -0
  97. package/dist/chains/bsc/pancake/bundle-buy-first-build.js +177 -0
  98. package/dist/chains/bsc/pancake/bundle-buy-first-constants.d.ts +30 -0
  99. package/dist/chains/bsc/pancake/bundle-buy-first-constants.js +24 -0
  100. package/dist/chains/bsc/pancake/bundle-buy-first-helpers.d.ts +11 -149
  101. package/dist/chains/bsc/pancake/bundle-buy-first-helpers.js +12 -74
  102. package/dist/chains/bsc/pancake/bundle-buy-first-multi-wallet.d.ts +9 -0
  103. package/dist/chains/bsc/pancake/bundle-buy-first-multi-wallet.js +225 -0
  104. package/dist/chains/bsc/pancake/bundle-buy-first-plan.d.ts +14 -0
  105. package/dist/chains/bsc/pancake/bundle-buy-first-plan.js +64 -0
  106. package/dist/chains/bsc/pancake/bundle-buy-first-profit.d.ts +12 -0
  107. package/dist/chains/bsc/pancake/bundle-buy-first-profit.js +22 -0
  108. package/dist/chains/bsc/pancake/bundle-buy-first-quote.d.ts +15 -0
  109. package/dist/chains/bsc/pancake/bundle-buy-first-quote.js +122 -0
  110. package/dist/chains/bsc/pancake/bundle-buy-first-types.d.ts +179 -0
  111. package/dist/chains/bsc/pancake/bundle-buy-first-types.js +1 -0
  112. package/dist/chains/bsc/pancake/bundle-buy-first-validate.d.ts +2 -0
  113. package/dist/chains/bsc/pancake/bundle-buy-first-validate.js +41 -0
  114. package/dist/chains/bsc/pancake/bundle-buy-first.d.ts +1 -1
  115. package/dist/chains/bsc/pancake/bundle-buy-first.js +8 -578
  116. package/dist/chains/bsc/pancake/bundle-swap-helpers.d.ts +11 -239
  117. package/dist/chains/bsc/pancake/bundle-swap-helpers.js +12 -564
  118. package/dist/chains/bsc/pancake/bundle-swap-types.d.ts +183 -0
  119. package/dist/chains/bsc/pancake/bundle-swap-types.js +17 -0
  120. package/dist/chains/bsc/pancake/bundle-swap.d.ts +10 -132
  121. package/dist/chains/bsc/pancake/bundle-swap.js +12 -1003
  122. package/dist/chains/bsc/pancake/hop-chain.d.ts +18 -0
  123. package/dist/chains/bsc/pancake/hop-chain.js +227 -0
  124. package/dist/chains/bsc/pancake/quote.d.ts +14 -0
  125. package/dist/chains/bsc/pancake/quote.js +84 -0
  126. package/dist/chains/bsc/pancake/swap-batch.d.ts +42 -0
  127. package/dist/chains/bsc/pancake/swap-batch.js +283 -0
  128. package/dist/chains/bsc/pancake/swap-build.d.ts +19 -0
  129. package/dist/chains/bsc/pancake/swap-build.js +226 -0
  130. package/dist/chains/bsc/pancake/swap-cross.d.ts +42 -0
  131. package/dist/chains/bsc/pancake/swap-cross.js +140 -0
  132. package/dist/chains/bsc/pancake/swap-quick.d.ts +54 -0
  133. package/dist/chains/bsc/pancake/swap-quick.js +424 -0
  134. package/dist/chains/bsc/pancake/swap-single.d.ts +2 -0
  135. package/dist/chains/bsc/pancake/swap-single.js +182 -0
  136. package/dist/chains/bsc/platforms/four/index.d.ts +21 -3
  137. package/dist/chains/bsc/platforms/four/index.js +28 -3
  138. package/dist/chains/eni/batch-router/transfer-disperse.d.ts +37 -0
  139. package/dist/chains/eni/batch-router/transfer-disperse.js +302 -0
  140. package/dist/chains/eni/batch-router/transfer-shared.d.ts +9 -0
  141. package/dist/chains/eni/batch-router/transfer-shared.js +10 -0
  142. package/dist/chains/eni/batch-router/transfer-sweep.d.ts +51 -0
  143. package/dist/chains/eni/batch-router/transfer-sweep.js +364 -0
  144. package/dist/chains/eni/batch-router/transfer.d.ts +4 -74
  145. package/dist/chains/eni/batch-router/transfer.js +2 -647
  146. package/dist/chains/eni/platforms/daoaas/portal-direct-profit.d.ts +17 -0
  147. package/dist/chains/eni/platforms/daoaas/portal-direct-profit.js +30 -0
  148. package/dist/chains/eni/platforms/daoaas/portal-direct-submit.d.ts +12 -0
  149. package/dist/chains/eni/platforms/daoaas/portal-direct-submit.js +396 -0
  150. package/dist/chains/eni/platforms/daoaas/portal-direct-tx.d.ts +20 -0
  151. package/dist/chains/eni/platforms/daoaas/portal-direct-tx.js +165 -0
  152. package/dist/chains/eni/platforms/daoaas/portal-direct.d.ts +3 -32
  153. package/dist/chains/eni/platforms/daoaas/portal-direct.js +3 -571
  154. package/dist/chains/eni/submit.js +1 -1
  155. package/dist/chains/xlayer/constants.d.ts +0 -2
  156. package/dist/chains/xlayer/constants.js +0 -2
  157. package/dist/chains/xlayer/eip7702/auth.d.ts +16 -0
  158. package/dist/chains/xlayer/eip7702/auth.js +81 -0
  159. package/dist/chains/xlayer/eip7702/bundle-create-buy.d.ts +22 -0
  160. package/dist/chains/xlayer/eip7702/bundle-create-buy.js +201 -0
  161. package/dist/chains/xlayer/eip7702/bundle-create-helpers.d.ts +114 -0
  162. package/dist/chains/xlayer/eip7702/bundle-create-helpers.js +139 -0
  163. package/dist/chains/xlayer/eip7702/bundle-create-to-dex.d.ts +24 -0
  164. package/dist/chains/xlayer/eip7702/bundle-create-to-dex.js +233 -0
  165. package/dist/chains/xlayer/eip7702/bundle-create.d.ts +3 -35
  166. package/dist/chains/xlayer/eip7702/bundle-create.js +3 -746
  167. package/dist/chains/xlayer/eip7702/bundle-graduate-buy.d.ts +22 -0
  168. package/dist/chains/xlayer/eip7702/bundle-graduate-buy.js +214 -0
  169. package/dist/chains/xlayer/eip7702/bundle-sell.js +1 -1
  170. package/dist/chains/xlayer/eip7702/bundle-swap-batch.d.ts +31 -0
  171. package/dist/chains/xlayer/eip7702/bundle-swap-batch.js +216 -0
  172. package/dist/chains/xlayer/eip7702/bundle-swap-helpers.d.ts +21 -0
  173. package/dist/chains/xlayer/eip7702/bundle-swap-helpers.js +206 -0
  174. package/dist/chains/xlayer/eip7702/bundle-swap-multi.d.ts +33 -0
  175. package/dist/chains/xlayer/eip7702/bundle-swap-multi.js +146 -0
  176. package/dist/chains/xlayer/eip7702/bundle-swap-single.d.ts +31 -0
  177. package/dist/chains/xlayer/eip7702/bundle-swap-single.js +177 -0
  178. package/dist/chains/xlayer/eip7702/bundle-swap.d.ts +6 -61
  179. package/dist/chains/xlayer/eip7702/bundle-swap.js +3 -712
  180. package/dist/chains/xlayer/eip7702/bytes.d.ts +4 -0
  181. package/dist/chains/xlayer/eip7702/bytes.js +31 -0
  182. package/dist/chains/xlayer/eip7702/gas.d.ts +19 -0
  183. package/dist/chains/xlayer/eip7702/gas.js +152 -0
  184. package/dist/chains/xlayer/eip7702/multi-hop-transfer-disperse.d.ts +5 -0
  185. package/dist/chains/xlayer/eip7702/multi-hop-transfer-disperse.js +196 -0
  186. package/dist/chains/xlayer/eip7702/multi-hop-transfer-pairwise.d.ts +5 -0
  187. package/dist/chains/xlayer/eip7702/multi-hop-transfer-pairwise.js +188 -0
  188. package/dist/chains/xlayer/eip7702/multi-hop-transfer-sweep.d.ts +5 -0
  189. package/dist/chains/xlayer/eip7702/multi-hop-transfer-sweep.js +220 -0
  190. package/dist/chains/xlayer/eip7702/multi-hop-transfer.d.ts +8 -4
  191. package/dist/chains/xlayer/eip7702/multi-hop-transfer.js +5 -591
  192. package/dist/chains/xlayer/eip7702/profit.d.ts +32 -0
  193. package/dist/chains/xlayer/eip7702/profit.js +59 -0
  194. package/dist/chains/xlayer/eip7702/provider.d.ts +3 -0
  195. package/dist/chains/xlayer/eip7702/provider.js +17 -0
  196. package/dist/chains/xlayer/eip7702/time.d.ts +2 -0
  197. package/dist/chains/xlayer/eip7702/time.js +10 -0
  198. package/dist/chains/xlayer/eip7702/tx-build.d.ts +10 -0
  199. package/dist/chains/xlayer/eip7702/tx-build.js +128 -0
  200. package/dist/chains/xlayer/eip7702/utils.d.ts +19 -85
  201. package/dist/chains/xlayer/eip7702/utils.js +19 -484
  202. package/dist/chains/xlayer/eip7702/volume-bundle.d.ts +13 -0
  203. package/dist/chains/xlayer/eip7702/volume-bundle.js +250 -0
  204. package/dist/chains/xlayer/eip7702/volume-internal.d.ts +13 -0
  205. package/dist/chains/xlayer/eip7702/volume-internal.js +169 -0
  206. package/dist/chains/xlayer/eip7702/volume-make.d.ts +8 -0
  207. package/dist/chains/xlayer/eip7702/volume-make.js +38 -0
  208. package/dist/chains/xlayer/eip7702/volume-single-round.d.ts +17 -0
  209. package/dist/chains/xlayer/eip7702/volume-single-round.js +44 -0
  210. package/dist/chains/xlayer/eip7702/volume-swap.d.ts +18 -0
  211. package/dist/chains/xlayer/eip7702/volume-swap.js +30 -0
  212. package/dist/chains/xlayer/eip7702/volume-wash.d.ts +8 -0
  213. package/dist/chains/xlayer/eip7702/volume-wash.js +191 -0
  214. package/dist/chains/xlayer/eip7702/volume.d.ts +7 -35
  215. package/dist/chains/xlayer/eip7702/volume.js +5 -697
  216. package/dist/chains/xlayer/eip7702/wallet.d.ts +6 -0
  217. package/dist/chains/xlayer/eip7702/wallet.js +17 -0
  218. package/dist/chains/xlayer/eoa/aa-types.d.ts +176 -0
  219. package/dist/chains/xlayer/eoa/aa-types.js +6 -0
  220. package/dist/chains/xlayer/eoa/constants.d.ts +0 -2
  221. package/dist/chains/xlayer/eoa/constants.js +0 -2
  222. package/dist/chains/xlayer/eoa/context.d.ts +8 -0
  223. package/dist/chains/xlayer/eoa/context.js +23 -0
  224. package/dist/chains/xlayer/eoa/encoders.d.ts +147 -0
  225. package/dist/chains/xlayer/eoa/encoders.js +147 -0
  226. package/dist/chains/xlayer/eoa/eoa-bundle-swap-cross.d.ts +5 -0
  227. package/dist/chains/xlayer/eoa/eoa-bundle-swap-cross.js +113 -0
  228. package/dist/chains/xlayer/eoa/eoa-bundle-swap-helpers.d.ts +10 -123
  229. package/dist/chains/xlayer/eoa/eoa-bundle-swap-helpers.js +10 -225
  230. package/dist/chains/xlayer/eoa/eoa-bundle-swap-pure.d.ts +50 -0
  231. package/dist/chains/xlayer/eoa/eoa-bundle-swap-pure.js +170 -0
  232. package/dist/chains/xlayer/eoa/eoa-bundle-swap-quick.d.ts +5 -0
  233. package/dist/chains/xlayer/eoa/eoa-bundle-swap-quick.js +257 -0
  234. package/dist/chains/xlayer/eoa/eoa-bundle-swap-types.d.ts +99 -0
  235. package/dist/chains/xlayer/eoa/eoa-bundle-swap-types.js +11 -0
  236. package/dist/chains/xlayer/eoa/eoa-bundle-swap.d.ts +5 -47
  237. package/dist/chains/xlayer/eoa/eoa-bundle-swap.js +3 -522
  238. package/dist/chains/xlayer/eoa/eoa-types.d.ts +776 -0
  239. package/dist/chains/xlayer/eoa/eoa-types.js +6 -0
  240. package/dist/chains/xlayer/eoa/eoa-wash-volume.d.ts +8 -0
  241. package/dist/chains/xlayer/eoa/eoa-wash-volume.js +8 -0
  242. package/dist/chains/xlayer/eoa/format.d.ts +34 -0
  243. package/dist/chains/xlayer/eoa/format.js +56 -0
  244. package/dist/chains/xlayer/eoa/hop-chain.d.ts +4 -0
  245. package/dist/chains/xlayer/eoa/hop-chain.js +87 -0
  246. package/dist/chains/xlayer/eoa/nonce-map.d.ts +20 -0
  247. package/dist/chains/xlayer/eoa/nonce-map.js +51 -0
  248. package/dist/chains/xlayer/eoa/portal-ops.d.ts +9 -292
  249. package/dist/chains/xlayer/eoa/portal-ops.js +9 -486
  250. package/dist/chains/xlayer/eoa/query.d.ts +117 -0
  251. package/dist/chains/xlayer/eoa/query.js +285 -0
  252. package/dist/chains/xlayer/eoa/quote.d.ts +6 -0
  253. package/dist/chains/xlayer/eoa/quote.js +90 -0
  254. package/dist/chains/xlayer/eoa/types.d.ts +9 -959
  255. package/dist/chains/xlayer/eoa/types.js +9 -49
  256. package/dist/core/clients/blockrazor.js +1 -1
  257. package/dist/core/clients/merkle.js +1 -1
  258. package/dist/core/erc20/allowances.d.ts +104 -0
  259. package/dist/core/erc20/allowances.js +205 -0
  260. package/dist/core/erc20/approve.d.ts +141 -0
  261. package/dist/core/erc20/approve.js +325 -0
  262. package/dist/core/erc20/helpers.d.ts +20 -0
  263. package/dist/core/erc20/helpers.js +109 -0
  264. package/dist/core/erc20/index.d.ts +13 -0
  265. package/dist/core/erc20/index.js +12 -0
  266. package/dist/core/gas/bundle-gas.d.ts +6 -1
  267. package/dist/core/index.d.ts +1 -1
  268. package/dist/core/index.js +1 -1
  269. package/dist/core/quote/index.d.ts +1 -0
  270. package/dist/core/quote/index.js +1 -0
  271. package/dist/core/quote/quote-helpers.d.ts +78 -0
  272. package/dist/core/quote/quote-helpers.js +289 -0
  273. package/dist/core/quote/types.d.ts +1 -0
  274. package/dist/core/quote/types.js +1 -0
  275. package/dist/core/sign-context-helpers.d.ts +29 -0
  276. package/dist/core/sign-context-helpers.js +63 -0
  277. package/dist/domains/dex/direct-router-helpers.d.ts +16 -268
  278. package/dist/domains/dex/direct-router-helpers.js +16 -535
  279. package/dist/domains/dex/direct-router-types.d.ts +104 -0
  280. package/dist/domains/dex/direct-router-types.js +81 -0
  281. package/dist/domains/dex/direct-router-v2-buy.d.ts +2 -0
  282. package/dist/domains/dex/direct-router-v2-buy.js +249 -0
  283. package/dist/domains/dex/direct-router-v2-sell.d.ts +5 -0
  284. package/dist/domains/dex/direct-router-v2-sell.js +270 -0
  285. package/dist/domains/dex/direct-router-v2.d.ts +9 -0
  286. package/dist/domains/dex/direct-router-v2.js +9 -0
  287. package/dist/domains/dex/direct-router-v3.d.ts +17 -0
  288. package/dist/domains/dex/direct-router-v3.js +432 -0
  289. package/dist/domains/dex/direct-router.d.ts +11 -26
  290. package/dist/domains/dex/direct-router.js +10 -977
  291. package/dist/domains/dex/dyo-encode.d.ts +62 -0
  292. package/dist/domains/dex/dyo-encode.js +124 -0
  293. package/dist/domains/dex/profit.d.ts +24 -0
  294. package/dist/domains/dex/profit.js +86 -0
  295. package/dist/domains/dex/provider.d.ts +10 -0
  296. package/dist/domains/dex/provider.js +27 -0
  297. package/dist/domains/dex/quote.d.ts +7 -0
  298. package/dist/domains/dex/quote.js +52 -0
  299. package/dist/domains/dex/router.d.ts +56 -0
  300. package/dist/domains/dex/router.js +193 -0
  301. package/dist/domains/flap/portal-bundle/batch.d.ts +9 -0
  302. package/dist/domains/flap/portal-bundle/batch.js +193 -0
  303. package/dist/domains/flap/portal-bundle/create.d.ts +5 -0
  304. package/dist/domains/flap/portal-bundle/create.js +153 -0
  305. package/dist/domains/flap/portal-bundle/helpers.d.ts +32 -0
  306. package/dist/domains/flap/portal-bundle/helpers.js +50 -0
  307. package/dist/domains/flap/portal-bundle/index.d.ts +16 -0
  308. package/dist/domains/flap/portal-bundle/index.js +15 -0
  309. package/dist/domains/flap/portal-bundle/private.d.ts +5 -0
  310. package/dist/domains/flap/portal-bundle/private.js +198 -0
  311. package/dist/domains/flap/portal-bundle/types.d.ts +102 -0
  312. package/dist/domains/flap/portal-bundle/types.js +1 -0
  313. package/dist/domains/flap/portal-bundle-merkle/core-batch.d.ts +13 -0
  314. package/dist/domains/flap/portal-bundle-merkle/core-batch.js +376 -0
  315. package/dist/domains/flap/portal-bundle-merkle/core-helpers.d.ts +75 -7
  316. package/dist/domains/flap/portal-bundle-merkle/core-helpers.js +259 -20
  317. package/dist/domains/flap/portal-bundle-merkle/core.d.ts +2 -13
  318. package/dist/domains/flap/portal-bundle-merkle/core.js +12 -629
  319. package/dist/domains/flap/portal-bundle-merkle/create-to-dex/constants.d.ts +70 -0
  320. package/dist/domains/flap/portal-bundle-merkle/create-to-dex/constants.js +90 -0
  321. package/dist/domains/flap/portal-bundle-merkle/create-to-dex/index.d.ts +12 -0
  322. package/dist/domains/flap/portal-bundle-merkle/create-to-dex/index.js +11 -0
  323. package/dist/domains/flap/portal-bundle-merkle/create-to-dex/main.d.ts +15 -0
  324. package/dist/domains/flap/portal-bundle-merkle/create-to-dex/main.js +432 -0
  325. package/dist/domains/flap/portal-bundle-merkle/create-to-dex/types.d.ts +113 -0
  326. package/dist/domains/flap/portal-bundle-merkle/create-to-dex/types.js +4 -0
  327. package/dist/domains/flap/portal-bundle-merkle/create-to-dex.d.ts +4 -127
  328. package/dist/domains/flap/portal-bundle-merkle/create-to-dex.js +4 -527
  329. package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/constants.d.ts +42 -0
  330. package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/constants.js +81 -0
  331. package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/index.d.ts +12 -0
  332. package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/index.js +11 -0
  333. package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/main.d.ts +15 -0
  334. package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/main.js +339 -0
  335. package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/types.d.ts +72 -0
  336. package/dist/domains/flap/portal-bundle-merkle/curve-to-dex/types.js +4 -0
  337. package/dist/domains/flap/portal-bundle-merkle/curve-to-dex.d.ts +4 -85
  338. package/dist/domains/flap/portal-bundle-merkle/curve-to-dex.js +4 -425
  339. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/approve.d.ts +12 -0
  340. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/approve.js +102 -0
  341. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/buy.d.ts +5 -0
  342. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/buy.js +135 -0
  343. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/helpers.d.ts +52 -0
  344. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/helpers.js +267 -0
  345. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/index.d.ts +14 -0
  346. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/index.js +14 -0
  347. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/sell.d.ts +5 -0
  348. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/sell.js +195 -0
  349. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy.d.ts +3 -24
  350. package/dist/domains/flap/portal-bundle-merkle/pancake-proxy.js +3 -700
  351. package/dist/domains/flap/portal-bundle-merkle/private/buy.d.ts +9 -0
  352. package/dist/domains/flap/portal-bundle-merkle/private/buy.js +188 -0
  353. package/dist/domains/flap/portal-bundle-merkle/private/helpers.d.ts +36 -0
  354. package/dist/domains/flap/portal-bundle-merkle/private/helpers.js +127 -0
  355. package/dist/domains/flap/portal-bundle-merkle/private/index.d.ts +12 -0
  356. package/dist/domains/flap/portal-bundle-merkle/private/index.js +12 -0
  357. package/dist/domains/flap/portal-bundle-merkle/private/sell.d.ts +9 -0
  358. package/dist/domains/flap/portal-bundle-merkle/private/sell.js +191 -0
  359. package/dist/domains/flap/portal-bundle-merkle/private.d.ts +5 -15
  360. package/dist/domains/flap/portal-bundle-merkle/private.js +5 -494
  361. package/dist/domains/flap/portal-bundle-merkle/swap-batch.js +3 -2
  362. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-chain.d.ts +4 -0
  363. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-chain.js +43 -0
  364. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-constants.d.ts +13 -0
  365. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-constants.js +21 -0
  366. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-helpers.d.ts +11 -121
  367. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-helpers.js +11 -109
  368. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-multi-wallet.d.ts +20 -0
  369. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-multi-wallet.js +223 -0
  370. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-plan.d.ts +32 -0
  371. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-plan.js +66 -0
  372. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-profit.d.ts +22 -0
  373. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-profit.js +22 -0
  374. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-quote.d.ts +51 -0
  375. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-quote.js +149 -0
  376. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-types.d.ts +87 -0
  377. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first-types.js +1 -0
  378. package/dist/domains/flap/portal-bundle-merkle/swap-buy-first.js +5 -404
  379. package/dist/domains/flap/portal-bundle-merkle/swap-helpers.d.ts +0 -1
  380. package/dist/domains/flap/portal-bundle-merkle/swap-helpers.js +0 -7
  381. package/dist/domains/flap/portal-bundle-merkle/swap-planning.js +1 -1
  382. package/dist/domains/flap/portal-bundle-merkle/swap-quick-batch.js +3 -2
  383. package/dist/domains/flap/portal-bundle-merkle/swap-single.js +3 -2
  384. package/dist/domains/flap/portal-bundle-merkle/utils/disperse.d.ts +2 -0
  385. package/dist/domains/flap/portal-bundle-merkle/utils/disperse.js +275 -0
  386. package/dist/domains/flap/portal-bundle-merkle/utils/index.d.ts +11 -0
  387. package/dist/domains/flap/portal-bundle-merkle/utils/index.js +11 -0
  388. package/dist/domains/flap/portal-bundle-merkle/utils/sweep.d.ts +9 -0
  389. package/dist/domains/flap/portal-bundle-merkle/utils/sweep.js +570 -0
  390. package/dist/domains/flap/portal-bundle-merkle/utils.d.ts +5 -8
  391. package/dist/domains/flap/portal-bundle-merkle/utils.js +5 -841
  392. package/dist/domains/flap/portal-bundle.d.ts +5 -117
  393. package/dist/domains/flap/portal-bundle.js +5 -587
  394. package/dist/domains/flap/portal.d.ts +13 -404
  395. package/dist/domains/flap/portal.js +12 -619
  396. package/dist/domains/flap/reader.d.ts +51 -0
  397. package/dist/domains/flap/reader.js +275 -0
  398. package/dist/domains/flap/types.d.ts +246 -0
  399. package/dist/domains/flap/types.js +104 -0
  400. package/dist/domains/flap/vault/constants.d.ts +220 -0
  401. package/dist/domains/flap/vault/constants.js +173 -0
  402. package/dist/domains/flap/vault/encode.d.ts +39 -0
  403. package/dist/domains/flap/vault/encode.js +135 -0
  404. package/dist/domains/flap/vault/index.d.ts +15 -0
  405. package/dist/domains/flap/vault/index.js +14 -0
  406. package/dist/domains/flap/vault/query.d.ts +40 -0
  407. package/dist/domains/flap/vault/query.js +104 -0
  408. package/dist/domains/flap/vault/types.d.ts +147 -0
  409. package/dist/domains/flap/vault/types.js +29 -0
  410. package/dist/domains/flap/vault.d.ts +3 -413
  411. package/dist/domains/flap/vault.js +3 -467
  412. package/dist/domains/flap/writer.d.ts +124 -0
  413. package/dist/domains/flap/writer.js +255 -0
  414. package/dist/domains/four/contracts/tm-bundle-batch.d.ts +35 -0
  415. package/dist/domains/four/contracts/tm-bundle-batch.js +286 -0
  416. package/dist/domains/four/contracts/tm-bundle-create.d.ts +2 -0
  417. package/dist/domains/four/contracts/tm-bundle-create.js +304 -0
  418. package/dist/domains/four/contracts/tm-bundle-helpers.d.ts +2 -1
  419. package/dist/domains/four/contracts/tm-bundle-helpers.js +3 -0
  420. package/dist/domains/four/contracts/tm-bundle-private.d.ts +36 -0
  421. package/dist/domains/four/contracts/tm-bundle-private.js +164 -0
  422. package/dist/domains/four/contracts/tm-bundle.d.ts +10 -71
  423. package/dist/domains/four/contracts/tm-bundle.js +9 -738
  424. package/dist/domains/lp-inspect/inspect-helpers.d.ts +25 -0
  425. package/dist/domains/lp-inspect/inspect-helpers.js +343 -0
  426. package/dist/domains/lp-inspect/inspect.d.ts +8 -0
  427. package/dist/domains/lp-inspect/inspect.js +332 -0
  428. package/dist/domains/lp-inspect/lp-inspect.d.ts +9 -37
  429. package/dist/domains/lp-inspect/lp-inspect.js +9 -775
  430. package/dist/domains/lp-inspect/registry.d.ts +43 -0
  431. package/dist/domains/lp-inspect/registry.js +127 -0
  432. package/dist/domains/merkle/index.d.ts +1 -1
  433. package/dist/exports/root-bundle-and-tooling.d.ts +9 -1
  434. package/dist/exports/root-bundle-and-tooling.js +8 -1
  435. package/dist/exports/root-foundations.d.ts +1 -1
  436. package/dist/exports/root-foundations.js +1 -1
  437. package/dist/exports/root-swap-dex-and-xlayer.d.ts +4 -4
  438. package/dist/exports/root-swap-dex-and-xlayer.js +4 -4
  439. package/dist/index.d.ts +1 -1
  440. package/dist/index.js +1 -1
  441. package/dist/utils/swap-helpers.js +1 -1
  442. package/package.json +1 -85
@@ -0,0 +1,325 @@
1
+ /**
2
+ * ERC20 授权(approve 侧)
3
+ *
4
+ * 发送授权交易、批量授权(直接发送或仅签名)、智能路由授权等。
5
+ */
6
+ import { Contract, Wallet, JsonRpcProvider, Interface, parseUnits } from 'ethers';
7
+ import { ADDRESSES, CHAINS } from '../constants/index.js';
8
+ import { NonceManager } from '../nonce/nonce-manager.js';
9
+ import { ERC20_ABI } from '../../abis/common.js';
10
+ import { getErrorMessageFromUnknown } from '../foundation.js';
11
+ import { validateContractAddress, resolveSpenderAddress, MAX_UINT256, MAX_APPROVAL_THRESHOLD, FOUR_MEME_V1_PROXY, FOUR_MEME_V2_PROXY, } from './helpers.js';
12
+ import { batchCheckAllowances } from './allowances.js';
13
+ /**
14
+ * 通用 ERC20 授权方法(内部辅助函数)
15
+ * 自动检查当前授权额度,只在不足时才发送交易
16
+ */
17
+ async function ensureAllowance(rpcUrl, privateKey, token, owner, spender, required) {
18
+ const provider = new JsonRpcProvider(rpcUrl);
19
+ const signer = new Wallet(privateKey, provider);
20
+ // ✅ 验证 token 和 spender 地址
21
+ await validateContractAddress(provider, token, 'Token');
22
+ await validateContractAddress(provider, spender, 'Spender');
23
+ const erc20 = new Contract(token, ERC20_ABI, signer);
24
+ // ✅ 自动检查当前授权额度,只在不足时才发送交易
25
+ let current;
26
+ try {
27
+ current = await erc20.allowance(owner, spender);
28
+ }
29
+ catch (error) {
30
+ throw new Error(`❌ 调用 allowance 失败(Token 可能不是 ERC20): ${getErrorMessageFromUnknown(error)}`, { cause: error });
31
+ }
32
+ if (current >= required) {
33
+ return {
34
+ alreadyApproved: true,
35
+ currentAllowance: current,
36
+ requiredAllowance: required,
37
+ };
38
+ }
39
+ const tx = await erc20.approve(spender, required);
40
+ const receipt = await tx.wait();
41
+ return {
42
+ alreadyApproved: false,
43
+ currentAllowance: current,
44
+ requiredAllowance: required,
45
+ txReceipt: receipt,
46
+ };
47
+ }
48
+ /**
49
+ * 确保代币已授权给 Four.meme V1 代理合约
50
+ */
51
+ export async function ensureSellApprovalV1(chain, rpcUrl, privateKey, token, owner, amount) {
52
+ return ensureAllowance(rpcUrl, privateKey, token, owner, FOUR_MEME_V1_PROXY[chain], amount);
53
+ }
54
+ /**
55
+ * 确保代币已授权给 Four.meme V2 代理合约
56
+ */
57
+ export async function ensureSellApprovalV2(chain, rpcUrl, privateKey, token, owner, amount) {
58
+ return ensureAllowance(rpcUrl, privateKey, token, owner, FOUR_MEME_V2_PROXY[chain], amount);
59
+ }
60
+ /**
61
+ * 确保代币已授权给 Four.meme 代理合约(通用,默认使用 V2)
62
+ * @deprecated 建议使用明确版本的方法:ensureSellApprovalV1 或 ensureSellApprovalV2
63
+ */
64
+ export async function ensureSellApproval(chain, rpcUrl, privateKey, token, owner, amount) {
65
+ return ensureSellApprovalV2(chain, rpcUrl, privateKey, token, owner, amount);
66
+ }
67
+ /**
68
+ * 确保代币已授权给 Flap Protocol 代理合约
69
+ * 用于 Flap Protocol 代币的卖出操作
70
+ * @returns 授权结果,包含是否已授权、当前额度、交易回执等信息
71
+ */
72
+ export async function ensureFlapSellApproval(chain, rpcUrl, privateKey, token, owner, amount) {
73
+ // ✅ 授权给 Flap Portal 代理合约(收费版)
74
+ const proxyAddresses = {
75
+ BSC: ADDRESSES.BSC.FlapPortal, // Flap Portal 代理合约 (BSC)
76
+ BASE: ADDRESSES.BASE.FlapPortal, // Flap Portal 代理合约 (BASE)
77
+ XLAYER: ADDRESSES.XLAYER.FlapPortal, // Flap Portal 代理合约 (XLAYER)
78
+ MORPH: ADDRESSES.MORPH.FlapPortal, // Flap Portal 代理合约 (MORPH)
79
+ MONAD: ADDRESSES.MONAD.FlapPortal, // Flap Portal 代理合约 (MONAD)
80
+ };
81
+ return await ensureAllowance(rpcUrl, privateKey, token, owner, proxyAddresses[chain], amount);
82
+ }
83
+ /**
84
+ * 批量确保代币已授权给 Flap Protocol 代理合约(默认授权上限 2^256-1)
85
+ * @param privateKeys 拥有者私钥数组(每个地址需自行签名)
86
+ * @returns 每个地址的授权结果(包含 owner 与交易回执等信息)
87
+ */
88
+ export async function ensureFlapSellApprovalBatch(chain, rpcUrl, privateKeys, token, required = BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff')) {
89
+ if (!privateKeys || privateKeys.length === 0)
90
+ return [];
91
+ // ✅ 并行处理所有授权
92
+ const results = await Promise.all(privateKeys.map(async (pk) => {
93
+ const owner = new Wallet(pk).address;
94
+ const r = await ensureFlapSellApproval(chain, rpcUrl, pk, token, owner, required);
95
+ return { owner, ...r };
96
+ }));
97
+ return results;
98
+ }
99
+ /**
100
+ * ✅ 智能路由:授权 ERC20 代币(自动选择 spender,自动检查,只在不足时才发送交易)
101
+ *
102
+ * @param chain - 链名称 ('BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD')
103
+ * @param platform - 平台名称 ('flap' | 'four' | 'pancake-v2' | 'pancake-v3')
104
+ * @param rpcUrl - RPC 节点地址
105
+ * @param privateKey - 私钥
106
+ * @param tokenAddress - 代币合约地址
107
+ * @param amount - 授权数量(bigint),传 'max' 表示最大授权
108
+ * @returns 授权结果
109
+ */
110
+ export async function approveToken(chain, platform, rpcUrl, privateKey, tokenAddress, amount) {
111
+ const spenderAddress = resolveSpenderAddress(chain, platform);
112
+ return approveTokenRaw(rpcUrl, privateKey, tokenAddress, spenderAddress, amount);
113
+ }
114
+ /**
115
+ * ✅ 底层方法:授权 ERC20 代币给指定合约(手动指定 spender)
116
+ * 适用于任意 spender 地址(Flap、Four、PancakeSwap V2/V3 等)
117
+ *
118
+ * @param rpcUrl - RPC 节点地址
119
+ * @param privateKey - 私钥
120
+ * @param tokenAddress - 代币合约地址
121
+ * @param spenderAddress - 被授权的合约地址(如 Router、Portal、TokenManager 等)
122
+ * @param amount - 授权数量(bigint),传 'max' 或 ethers.MaxUint256 表示最大授权
123
+ * @returns 授权结果
124
+ */
125
+ export async function approveTokenRaw(rpcUrl, privateKey, tokenAddress, spenderAddress, amount) {
126
+ const provider = new JsonRpcProvider(rpcUrl);
127
+ const signer = new Wallet(privateKey, provider);
128
+ const ownerAddress = signer.address;
129
+ // ✅ 规范化地址(转为小写,避免 checksum 错误)
130
+ const normalizedToken = tokenAddress.toLowerCase();
131
+ const normalizedSpender = spenderAddress.toLowerCase();
132
+ // 验证地址
133
+ await validateContractAddress(provider, normalizedToken, 'Token');
134
+ await validateContractAddress(provider, normalizedSpender, 'Spender');
135
+ const erc20 = new Contract(normalizedToken, ERC20_ABI, signer);
136
+ const isMax = amount === 'max';
137
+ const requiredAmount = isMax ? MAX_UINT256 : amount;
138
+ // 检查当前授权额度
139
+ let currentAllowance;
140
+ try {
141
+ currentAllowance = await erc20.allowance(ownerAddress, normalizedSpender);
142
+ }
143
+ catch (error) {
144
+ throw new Error(`❌ 查询授权额度失败: ${getErrorMessageFromUnknown(error)}`, { cause: error });
145
+ }
146
+ // 如果已经授权足够,直接返回
147
+ // ✅ max 授权:使用阈值判断,避免每次消耗一点 allowance 都重新授权
148
+ if (isMax ? currentAllowance >= MAX_APPROVAL_THRESHOLD : currentAllowance >= requiredAmount) {
149
+ return {
150
+ alreadyApproved: true,
151
+ currentAllowance,
152
+ requiredAllowance: requiredAmount,
153
+ };
154
+ }
155
+ // 发送授权交易
156
+ try {
157
+ const tx = await erc20.approve(normalizedSpender, requiredAmount);
158
+ const receipt = await tx.wait();
159
+ return {
160
+ alreadyApproved: false,
161
+ currentAllowance,
162
+ requiredAllowance: requiredAmount,
163
+ txReceipt: receipt,
164
+ };
165
+ }
166
+ catch (error) {
167
+ throw new Error(`❌ 授权交易失败: ${getErrorMessageFromUnknown(error)}`, { cause: error });
168
+ }
169
+ }
170
+ export async function approveTokenBatch(params) {
171
+ const { chain, platform, rpcUrl, privateKeys, tokenAddress, amounts, signOnly, gasPriceGwei, gasLimit, chainId, skipValidation, } = params;
172
+ const spenderAddress = resolveSpenderAddress(chain, platform);
173
+ const rawParams = {
174
+ rpcUrl,
175
+ privateKeys,
176
+ tokenAddress,
177
+ spenderAddress,
178
+ amounts,
179
+ gasPriceGwei,
180
+ gasLimit,
181
+ chainId,
182
+ skipValidation,
183
+ };
184
+ if (signOnly === true) {
185
+ return approveTokenBatchRaw({ ...rawParams, signOnly: true });
186
+ }
187
+ return approveTokenBatchRaw({ ...rawParams, signOnly: false });
188
+ }
189
+ export async function approveTokenBatchRaw(params) {
190
+ const { rpcUrl, privateKeys, tokenAddress, spenderAddress, amounts, signOnly, gasPriceGwei, gasLimit, chainId = CHAINS.BSC.chainId, nonceManager: externalNonceManager, skipValidation, } = params;
191
+ if (privateKeys.length === 0 || amounts.length !== privateKeys.length) {
192
+ throw new Error('❌ 私钥数量和授权数量必须匹配');
193
+ }
194
+ const provider = new JsonRpcProvider(rpcUrl);
195
+ // ✅ 规范化地址(转为小写,避免 checksum 错误)
196
+ const normalizedToken = tokenAddress.toLowerCase();
197
+ const normalizedSpender = spenderAddress.toLowerCase();
198
+ // 验证地址(如果 skipValidation=true 则跳过)
199
+ if (!skipValidation) {
200
+ await validateContractAddress(provider, normalizedToken, 'Token');
201
+ await validateContractAddress(provider, normalizedSpender, 'Spender');
202
+ }
203
+ // ✅ 优化:批量创建钱包和合约实例
204
+ const wallets = privateKeys.map((key) => new Wallet(key, provider));
205
+ const ownerAddresses = wallets.map((w) => w.address);
206
+ const isMaxApprovals = amounts.map((a) => a === 'max');
207
+ const requiredAmounts = amounts.map((amount) => (amount === 'max' ? MAX_UINT256 : amount));
208
+ // ==================== signOnly=true:只签名不提交 ====================
209
+ if (signOnly) {
210
+ // ✅ 使用 NonceManager 管理 nonce(和买卖交易一样)
211
+ const nonceManager = externalNonceManager || new NonceManager(provider);
212
+ // ✅ 并行获取:当前授权额度 + nonces + gasPrice
213
+ const [currentAllowances, nonces, fetchedGasPrice] = await Promise.all([
214
+ batchCheckAllowances(provider, normalizedToken, ownerAddresses, normalizedSpender),
215
+ nonceManager.getNextNoncesForWallets(wallets), // ✅ 使用 NonceManager 批量获取 nonce
216
+ gasPriceGwei
217
+ ? Promise.resolve(parseUnits(gasPriceGwei.toString(), 'gwei'))
218
+ : provider.getFeeData().then((fee) => fee.gasPrice || parseUnits('3', 'gwei')),
219
+ ]);
220
+ const finalGasPrice = fetchedGasPrice;
221
+ const finalGasLimit = BigInt(gasLimit || 100000);
222
+ // ✅ ERC20 approve 函数的 ABI 编码
223
+ const erc20Interface = new Interface(ERC20_ABI);
224
+ // ✅ 并行签名所有需要授权的交易
225
+ const signPromises = wallets.map(async (wallet, i) => {
226
+ const ownerAddress = ownerAddresses[i];
227
+ const currentAllowance = currentAllowances[i];
228
+ const requiredAmount = requiredAmounts[i];
229
+ const isMax = isMaxApprovals[i];
230
+ // 如果已经授权足够,跳过
231
+ // ✅ max 授权:使用阈值判断(与 BSC 一致)
232
+ if (isMax ? currentAllowance >= MAX_APPROVAL_THRESHOLD : currentAllowance >= requiredAmount) {
233
+ return {
234
+ owner: ownerAddress,
235
+ alreadyApproved: true,
236
+ currentAllowance,
237
+ requiredAllowance: requiredAmount,
238
+ signedTx: undefined,
239
+ };
240
+ }
241
+ // 构建并签名交易
242
+ const txData = erc20Interface.encodeFunctionData('approve', [normalizedSpender, requiredAmount]);
243
+ const signedTx = await wallet.signTransaction({
244
+ to: normalizedToken,
245
+ data: txData,
246
+ nonce: nonces[i], // ✅ NonceManager 已经处理好递增
247
+ gasLimit: finalGasLimit,
248
+ gasPrice: finalGasPrice,
249
+ chainId,
250
+ type: 0, // Legacy 交易
251
+ });
252
+ return {
253
+ owner: ownerAddress,
254
+ alreadyApproved: false,
255
+ currentAllowance,
256
+ requiredAllowance: requiredAmount,
257
+ signedTx,
258
+ };
259
+ });
260
+ const results = await Promise.all(signPromises);
261
+ // ✅ 提取所有签名交易(过滤掉已授权的)
262
+ const signedTransactions = results.filter((r) => !r.alreadyApproved && r.signedTx).map((r) => r.signedTx);
263
+ const alreadyApprovedCount = results.filter((r) => r.alreadyApproved).length;
264
+ const needApproveCount = results.filter((r) => !r.alreadyApproved).length;
265
+ return {
266
+ signedTransactions,
267
+ results,
268
+ needApproveCount,
269
+ alreadyApprovedCount,
270
+ };
271
+ }
272
+ // ==================== signOnly=false(默认):直接发送交易 ====================
273
+ // ✅ 优化:并行检查所有钱包的授权额度
274
+ const currentAllowances = await batchCheckAllowances(provider, normalizedToken, ownerAddresses, normalizedSpender);
275
+ // ✅ 优化:并行发送所有需要授权的交易
276
+ const approvalPromises = wallets.map(async (wallet, i) => {
277
+ const ownerAddress = ownerAddresses[i];
278
+ const currentAllowance = currentAllowances[i];
279
+ const requiredAmount = requiredAmounts[i];
280
+ const isMax = isMaxApprovals[i];
281
+ try {
282
+ // 如果已经授权足够,跳过
283
+ // ✅ max 授权:使用阈值判断(与 BSC 一致)
284
+ if (isMax ? currentAllowance >= MAX_APPROVAL_THRESHOLD : currentAllowance >= requiredAmount) {
285
+ return {
286
+ owner: ownerAddress,
287
+ alreadyApproved: true,
288
+ currentAllowance,
289
+ requiredAllowance: requiredAmount,
290
+ };
291
+ }
292
+ // 发送授权交易
293
+ const erc20 = new Contract(normalizedToken, ERC20_ABI, wallet);
294
+ const tx = await erc20.approve(normalizedSpender, requiredAmount);
295
+ const receipt = await tx.wait();
296
+ return {
297
+ owner: ownerAddress,
298
+ alreadyApproved: false,
299
+ currentAllowance,
300
+ requiredAllowance: requiredAmount,
301
+ txHash: receipt.hash,
302
+ };
303
+ }
304
+ catch (error) {
305
+ return {
306
+ owner: ownerAddress,
307
+ alreadyApproved: false,
308
+ currentAllowance,
309
+ requiredAllowance: requiredAmount,
310
+ error: getErrorMessageFromUnknown(error),
311
+ };
312
+ }
313
+ });
314
+ // ✅ 优化:并行等待所有授权交易完成
315
+ const results = await Promise.all(approvalPromises);
316
+ // 统计结果
317
+ const approvedCount = results.filter((r) => !r.alreadyApproved && !r.error).length;
318
+ const errorCount = results.filter((r) => r.error).length;
319
+ // ✅ 只要没有错误,就算成功(包括所有钱包都已授权的情况)
320
+ return {
321
+ success: errorCount === 0,
322
+ approvedCount,
323
+ results,
324
+ };
325
+ }
@@ -0,0 +1,20 @@
1
+ /**
2
+ * ERC20 授权内部共享工具(非公开 API)
3
+ *
4
+ * 包含地址校验、最大授权常量、Sell 代理地址解析、spender 智能路由解析等内部辅助。
5
+ * 此文件不会被 barrel 对外导出。
6
+ */
7
+ import { JsonRpcProvider } from 'ethers';
8
+ export declare const MAX_UINT256: bigint;
9
+ export declare const MAX_APPROVAL_THRESHOLD: bigint;
10
+ /**
11
+ * 验证合约地址是否有效(是否部署了代码)
12
+ */
13
+ export declare function validateContractAddress(provider: JsonRpcProvider, address: string, label: string): Promise<void>;
14
+ export type SellApprovalChain = 'BSC' | 'BASE' | 'ARBITRUM_ONE';
15
+ export declare const FOUR_MEME_V1_PROXY: Record<SellApprovalChain, string>;
16
+ export declare const FOUR_MEME_V2_PROXY: Record<SellApprovalChain, string>;
17
+ /**
18
+ * 🔧 内部辅助函数:根据链和平台自动解析 spender 地址
19
+ */
20
+ export declare function resolveSpenderAddress(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD' | 'ENI', platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3' | 'daoaas' | 'dswap-v2'): string;
@@ -0,0 +1,109 @@
1
+ /**
2
+ * ERC20 授权内部共享工具(非公开 API)
3
+ *
4
+ * 包含地址校验、最大授权常量、Sell 代理地址解析、spender 智能路由解析等内部辅助。
5
+ * 此文件不会被 barrel 对外导出。
6
+ */
7
+ import { ADDRESSES, ZERO_ADDRESS } from '../constants/index.js';
8
+ import { getErrorMessageFromUnknown } from '../foundation.js';
9
+ // ============================================================================
10
+ // ✅ Max approval(与 BSC 策略一致:阈值判断,避免频繁重复授权)
11
+ // ============================================================================
12
+ export const MAX_UINT256 = BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff');
13
+ export const MAX_APPROVAL_THRESHOLD = MAX_UINT256 / 2n;
14
+ /**
15
+ * 验证合约地址是否有效(是否部署了代码)
16
+ */
17
+ export async function validateContractAddress(provider, address, label) {
18
+ try {
19
+ // ✅ 先规范化地址(转为 checksum 格式),避免 ethers v6 的严格校验报错
20
+ const normalizedAddress = address.toLowerCase().startsWith('0x')
21
+ ? address.toLowerCase()
22
+ : `0x${address.toLowerCase()}`;
23
+ const code = await provider.getCode(normalizedAddress);
24
+ if (code === '0x' || code.length <= 2) {
25
+ throw new Error(`❌ ${label} 地址无效或未部署合约: ${address}`);
26
+ }
27
+ }
28
+ catch (error) {
29
+ const msg = getErrorMessageFromUnknown(error);
30
+ if (msg.includes('无效或未部署')) {
31
+ throw error instanceof Error ? error : new Error(msg);
32
+ }
33
+ const code = error !== null && typeof error === 'object' && 'code' in error ? error.code : undefined;
34
+ if (msg.includes('bad address checksum') || code === 'INVALID_ARGUMENT') {
35
+ throw new Error(`❌ ${label} 地址格式错误,请使用正确的 checksum 格式: ${address}`, { cause: error });
36
+ }
37
+ throw new Error(`❌ 无法验证 ${label} 地址 ${address}: ${msg}`, { cause: error });
38
+ }
39
+ }
40
+ export const FOUR_MEME_V1_PROXY = {
41
+ BSC: ADDRESSES.BSC.TokenManagerV1,
42
+ BASE: ADDRESSES.BASE.TokenManagerHelper3,
43
+ ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
44
+ };
45
+ export const FOUR_MEME_V2_PROXY = {
46
+ BSC: ADDRESSES.BSC.TokenManagerV2,
47
+ BASE: ADDRESSES.BASE.TokenManagerHelper3,
48
+ ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
49
+ };
50
+ /**
51
+ * 🔧 内部辅助函数:根据链和平台自动解析 spender 地址
52
+ */
53
+ export function resolveSpenderAddress(chain, platform) {
54
+ const spenderMap = {
55
+ flap: {
56
+ BSC: ADDRESSES.BSC.FlapPortal,
57
+ BASE: ADDRESSES.BASE.FlapPortal,
58
+ XLAYER: ADDRESSES.XLAYER.FlapPortal,
59
+ MORPH: ADDRESSES.MORPH.FlapPortal,
60
+ MONAD: ADDRESSES.MONAD.FlapPortal,
61
+ ENI: ZERO_ADDRESS,
62
+ },
63
+ four: {
64
+ BSC: ADDRESSES.BSC.TokenManagerOriginal,
65
+ BASE: ADDRESSES.BASE.TokenManagerHelper3,
66
+ XLAYER: ZERO_ADDRESS,
67
+ MORPH: ZERO_ADDRESS,
68
+ MONAD: ZERO_ADDRESS,
69
+ ENI: ZERO_ADDRESS,
70
+ },
71
+ 'pancake-v2': {
72
+ BSC: ADDRESSES.BSC.PancakeV2Router,
73
+ BASE: ADDRESSES.BASE.PancakeV2Router,
74
+ XLAYER: ZERO_ADDRESS,
75
+ MORPH: ZERO_ADDRESS,
76
+ MONAD: ADDRESSES.MONAD.PancakeV2Router,
77
+ ENI: ZERO_ADDRESS,
78
+ },
79
+ 'pancake-v3': {
80
+ BSC: ADDRESSES.BSC.PancakeV3Router,
81
+ BASE: ADDRESSES.BASE.PancakeV3Router,
82
+ XLAYER: ZERO_ADDRESS,
83
+ MORPH: ZERO_ADDRESS,
84
+ MONAD: ADDRESSES.MONAD.PancakeV3Router,
85
+ ENI: ZERO_ADDRESS,
86
+ },
87
+ daoaas: {
88
+ BSC: ZERO_ADDRESS,
89
+ BASE: ZERO_ADDRESS,
90
+ XLAYER: ZERO_ADDRESS,
91
+ MORPH: ZERO_ADDRESS,
92
+ MONAD: ZERO_ADDRESS,
93
+ ENI: ADDRESSES.ENI.DaoaasPortal,
94
+ },
95
+ 'dswap-v2': {
96
+ BSC: ZERO_ADDRESS,
97
+ BASE: ZERO_ADDRESS,
98
+ XLAYER: ZERO_ADDRESS,
99
+ MORPH: ZERO_ADDRESS,
100
+ MONAD: ZERO_ADDRESS,
101
+ ENI: ADDRESSES.ENI.DswapV2Router,
102
+ },
103
+ };
104
+ const spender = spenderMap[platform]?.[chain];
105
+ if (!spender || spender === ZERO_ADDRESS) {
106
+ throw new Error(`❌ 不支持的链或平台: ${chain} / ${platform}`);
107
+ }
108
+ return spender;
109
+ }
@@ -0,0 +1,13 @@
1
+ /**
2
+ * ERC20 授权模块 barrel
3
+ *
4
+ * 原超长文件按职责拆分为:
5
+ * - allowances.ts:授权额度检查(check 侧)
6
+ * - approve.ts:授权交易(approve 侧)
7
+ * - helpers.ts:内部共享工具(不对外导出)
8
+ *
9
+ * 对外 export 符号与路径保持不变。
10
+ */
11
+ export * from './allowances.js';
12
+ export * from './approve.js';
13
+ export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from '../types-erc20.js';
@@ -0,0 +1,12 @@
1
+ /**
2
+ * ERC20 授权模块 barrel
3
+ *
4
+ * 原超长文件按职责拆分为:
5
+ * - allowances.ts:授权额度检查(check 侧)
6
+ * - approve.ts:授权交易(approve 侧)
7
+ * - helpers.ts:内部共享工具(不对外导出)
8
+ *
9
+ * 对外 export 符号与路径保持不变。
10
+ */
11
+ export * from './allowances.js';
12
+ export * from './approve.js';
@@ -25,6 +25,11 @@ export interface BuildTransactionOptions {
25
25
  type?: 0 | 2;
26
26
  }
27
27
  export declare function buildTransaction(options: BuildTransactionOptions): TransactionRequest;
28
+ /** getGasLimit 的最小 config 接口(所有链/DEX 的 config 都满足) */
29
+ export interface GasLimitConfig {
30
+ gasLimit?: number | bigint;
31
+ gasLimitMultiplier?: number;
32
+ }
28
33
  export interface CommonBundleConfig {
29
34
  gasLimit?: number;
30
35
  gasLimitMultiplier?: number;
@@ -33,7 +38,7 @@ export interface CommonBundleConfig {
33
38
  txType?: 0 | 2;
34
39
  chainId?: number;
35
40
  }
36
- export declare function getGasLimit(config: CommonBundleConfig, defaultGas?: number): bigint;
41
+ export declare function getGasLimit(config: GasLimitConfig, defaultGas?: number): bigint;
37
42
  export declare function getGasPriceConfig(config: CommonBundleConfig): GasPriceConfig;
38
43
  export declare function getTxType(config: CommonBundleConfig): 0 | 2;
39
44
  export type LegacyGasFields = {
@@ -2,4 +2,4 @@
2
2
  export * from './foundation.js';
3
3
  export * from './constants/index.js';
4
4
  export * from './clients/index.js';
5
- export * from './erc20.js';
5
+ export * from './erc20/index.js';
@@ -2,4 +2,4 @@
2
2
  export * from './foundation.js';
3
3
  export * from './constants/index.js';
4
4
  export * from './clients/index.js';
5
- export * from './erc20.js';
5
+ export * from './erc20/index.js';
@@ -0,0 +1 @@
1
+ export * from './quote-helpers.js';
@@ -0,0 +1 @@
1
+ export * from './quote-helpers.js';
@@ -0,0 +1,78 @@
1
+ /**
2
+ * V2/V3 报价工具函数
3
+ *
4
+ * 提供统一的代币报价功能,支持:
5
+ * - V2 Router 报价(直接路径 + 多跳路径)
6
+ * - V3 Quoter 报价(多费率尝试 + 多跳路径)
7
+ * - ERC20 → 原生代币转换报价
8
+ */
9
+ import { JsonRpcProvider } from 'ethers';
10
+ import { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS } from '../constants/quote.js';
11
+ import type { QuoteParams, QuoteResult } from './types.js';
12
+ export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS };
13
+ /**
14
+ * V2 报价(直接路径 + 多跳路径)
15
+ * ✅ 优化:并行尝试直接路径和多跳路径
16
+ *
17
+ * @param provider - Provider 实例
18
+ * @param tokenIn - 输入代币地址
19
+ * @param tokenOut - 输出代币地址
20
+ * @param amountIn - 输入数量(wei)
21
+ * @param chain - 链名称
22
+ * @returns 报价结果
23
+ */
24
+ export declare function quoteV2(provider: JsonRpcProvider, tokenIn: string, tokenOut: string, amountIn: bigint, chain: string, routerOverride?: string): Promise<QuoteResult>;
25
+ /**
26
+ * V3 报价(多费率尝试 + 多跳路径)
27
+ * ✅ 优化:并行尝试多个费率
28
+ *
29
+ * @param provider - Provider 实例
30
+ * @param tokenIn - 输入代币地址
31
+ * @param tokenOut - 输出代币地址
32
+ * @param amountIn - 输入数量(wei)
33
+ * @param chain - 链名称
34
+ * @param preferredFee - 优先尝试的费率(可选)
35
+ * @returns 报价结果
36
+ */
37
+ export declare function quoteV3(provider: JsonRpcProvider, tokenIn: string, tokenOut: string, amountIn: bigint, chain: string, preferredFee?: number): Promise<QuoteResult>;
38
+ /**
39
+ * 统一报价接口(根据版本自动选择 V2 或 V3)
40
+ *
41
+ * @param params - 报价参数
42
+ * @returns 报价结果
43
+ */
44
+ export declare function quote(params: QuoteParams): Promise<QuoteResult>;
45
+ /**
46
+ * 获取 ERC20 代币 → 原生代币(WBNB/WMON 等)的报价
47
+ *
48
+ * @param provider - Provider 实例
49
+ * @param tokenAddress - ERC20 代币地址
50
+ * @param tokenAmount - 代币数量(wei)
51
+ * @param chain - 链名称
52
+ * @param version - 'v2' | 'v3'
53
+ * @param fee - V3 费率档位(仅 V3 时使用)
54
+ * @param routerOverride - V2 时使用指定 Router(如 IROSwap,用于利润报价)
55
+ * @returns 等值的原生代币数量(wei),失败返回 0n
56
+ */
57
+ export declare function getTokenToNativeQuote(provider: JsonRpcProvider, tokenAddress: string, tokenAmount: bigint, chain: string, version?: 'v2' | 'v3', fee?: number, routerOverride?: string): Promise<bigint>;
58
+ /**
59
+ * 获取原生代币 → ERC20 代币的报价
60
+ *
61
+ * @param provider - Provider 实例
62
+ * @param tokenAddress - ERC20 代币地址
63
+ * @param nativeAmount - 原生代币数量(wei)
64
+ * @param chain - 链名称
65
+ * @param version - 'v2' | 'v3'
66
+ * @param fee - V3 费率档位(仅 V3 时使用)
67
+ * @returns 等值的 ERC20 代币数量(wei),失败返回 0n
68
+ */
69
+ export declare function getNativeToTokenQuote(provider: JsonRpcProvider, tokenAddress: string, nativeAmount: bigint, chain: string, version?: 'v2' | 'v3', fee?: number): Promise<bigint>;
70
+ /**
71
+ * 获取链的包装原生代币地址
72
+ */
73
+ export declare function getWrappedNativeAddress(chain: string): string;
74
+ /**
75
+ * 获取链的稳定币列表
76
+ */
77
+ export declare function getStableCoins(chain: string): string[];
78
+ export type { SupportedChain, QuoteParams, QuoteResult } from './types.js';