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
@@ -1,53 +1,13 @@
1
1
  /**
2
- * XLayer SDK 类型定义
2
+ * XLayer SDK 类型定义 barrel
3
3
  *
4
- * 包含 ERC-4337 UserOperation、AA 账户、交易参数等核心类型
5
- */
6
- // ==================== AA Nonce(EntryPoint nonce)本地分配器 ====================
7
- /**
8
- * ✅ 仅用于 ERC-4337 AA(EntryPoint.getNonce(sender, 0))
9
- *
10
- * 目标:不要在业务代码里手写 `+1/+2` 推导,而是像 BSC bundle 一样用本地 Map
11
- * 对“同一 sender 多步流程”连续分配 nonce。
4
+ * 原超长文件按职责拆分为:
5
+ * - aa-types.ts:ERC-4337 AA 核心类型(UserOperation、AA 账户、Gas 策略、handleOps 结果等)
6
+ * - eoa-types.ts:EOA/交易参数与结果类型(买入/卖出/换手/刷量/DEX/预授权/买到毕业)
7
+ * - nonce-map.ts:AANonceMap 类逻辑
12
8
  *
13
- * 注意:
14
- * - 这是**同一次 SDK 调用/同一条流程**内的 nonce 分配;不解决多进程/多并发任务同时使用同一 sender 的问题。
15
- * - 对“可能不生成 op”的分支(例如 withdraw 返回 null),使用 peek + commit,避免提前消耗 nonce。
9
+ * 对外 export 符号与路径保持不变。
16
10
  */
17
- export class AANonceMap {
18
- nextBySenderLower = new Map();
19
- init(sender, startNonce) {
20
- const k = sender.toLowerCase();
21
- const cur = this.nextBySenderLower.get(k);
22
- if (cur === undefined || startNonce > cur) {
23
- this.nextBySenderLower.set(k, startNonce);
24
- }
25
- }
26
- peek(sender) {
27
- const k = sender.toLowerCase();
28
- const cur = this.nextBySenderLower.get(k);
29
- if (cur === undefined) {
30
- throw new Error(`AANonceMap: sender not initialized: ${sender}`);
31
- }
32
- return cur;
33
- }
34
- commit(sender, usedNonce) {
35
- const k = sender.toLowerCase();
36
- const cur = this.nextBySenderLower.get(k);
37
- if (cur === undefined) {
38
- throw new Error(`AANonceMap: sender not initialized: ${sender}`);
39
- }
40
- // 只允许“使用当前 nonce”或“重复 commit”(幂等)
41
- if (usedNonce !== cur && usedNonce !== cur - 1n) {
42
- throw new Error(`AANonceMap: nonce mismatch for ${sender}: used=${usedNonce.toString()} cur=${cur.toString()}`);
43
- }
44
- if (usedNonce === cur) {
45
- this.nextBySenderLower.set(k, cur + 1n);
46
- }
47
- }
48
- next(sender) {
49
- const n = this.peek(sender);
50
- this.commit(sender, n);
51
- return n;
52
- }
53
- }
11
+ export * from './aa-types.js';
12
+ export * from './eoa-types.js';
13
+ export * from './nonce-map.js';
@@ -234,7 +234,7 @@ export class BlockRazorClient {
234
234
  catch (error) {
235
235
  const errorMsg = getErrorMessageFromUnknown(error);
236
236
  console.error(`❌ [BlockRazor] Bundle 发送失败: ${errorMsg}`);
237
- throw new Error(`BlockRazor send bundle failed: ${errorMsg}`);
237
+ throw new Error(`BlockRazor send bundle failed: ${errorMsg}`, { cause: error });
238
238
  }
239
239
  }
240
240
  /**
@@ -139,7 +139,7 @@ export class MerkleClient {
139
139
  throw new Error('Invalid bundle result format');
140
140
  }
141
141
  catch (error) {
142
- throw new Error(`Send bundle failed: ${getErrorMessageFromUnknown(error)}`);
142
+ throw new Error(`Send bundle failed: ${getErrorMessageFromUnknown(error)}`, { cause: error });
143
143
  }
144
144
  }
145
145
  /**
@@ -0,0 +1,104 @@
1
+ /**
2
+ * ERC20 授权额度检查(check 侧)
3
+ *
4
+ * 只读查询授权额度、批量查询(Multicall3)、智能路由检查等。
5
+ */
6
+ import { JsonRpcProvider } from 'ethers';
7
+ import { type SellApprovalChain } from './helpers.js';
8
+ /**
9
+ * 检查代币授权状态 - Four.meme V1(只读,不发送交易)
10
+ */
11
+ export declare function checkSellApprovalV1(chain: SellApprovalChain, rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
12
+ isApproved: boolean;
13
+ currentAllowance: bigint;
14
+ requiredAllowance: bigint;
15
+ }>;
16
+ /**
17
+ * 检查代币授权状态 - Four.meme V2(只读,不发送交易)
18
+ */
19
+ export declare function checkSellApprovalV2(chain: SellApprovalChain, rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
20
+ isApproved: boolean;
21
+ currentAllowance: bigint;
22
+ requiredAllowance: bigint;
23
+ }>;
24
+ /**
25
+ * 检查代币授权状态 - Four.meme(通用,默认使用 V2)
26
+ * @deprecated 建议使用明确版本的方法:checkSellApprovalV1 或 checkSellApprovalV2
27
+ */
28
+ export declare function checkSellApproval(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
29
+ isApproved: boolean;
30
+ currentAllowance: bigint;
31
+ requiredAllowance: bigint;
32
+ }>;
33
+ /**
34
+ * 检查代币授权状态 - Flap Protocol(只读,不发送交易)
35
+ * @returns 是否已授权足够的额度
36
+ */
37
+ export declare function checkFlapSellApproval(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
38
+ isApproved: boolean;
39
+ currentAllowance: bigint;
40
+ requiredAllowance: bigint;
41
+ }>;
42
+ /**
43
+ * 批量检查 Flap Protocol 授权状态(默认按上限 2^256-1 判断)
44
+ * ✅ 使用 Multicall3 批量查询,减少 RPC 调用次数
45
+ */
46
+ export declare function checkFlapSellApprovalBatch(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', rpcUrl: string, token: string, owners: string[], required?: bigint): Promise<Array<{
47
+ owner: string;
48
+ isApproved: boolean;
49
+ currentAllowance: bigint;
50
+ requiredAllowance: bigint;
51
+ }>>;
52
+ /**
53
+ * 使用 Multicall3 批量查询 ERC20 授权额度
54
+ * @param provider - Provider 实例
55
+ * @param tokenAddress - ERC20 代币地址
56
+ * @param owners - 所有者地址数组
57
+ * @param spender - 被授权的 spender 地址
58
+ * @returns 每个地址的授权额度数组
59
+ */
60
+ export declare function batchCheckAllowances(provider: JsonRpcProvider, tokenAddress: string, owners: string[], spender: string): Promise<bigint[]>;
61
+ /**
62
+ * ✅ 智能路由:检查单个 ERC20 授权额度(自动选择 spender)
63
+ *
64
+ * @param chain - 链名称 ('BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD')
65
+ * @param platform - 平台名称 ('flap' | 'four' | 'pancake-v2' | 'pancake-v3')
66
+ * @param rpcUrl - RPC 节点地址
67
+ * @param tokenAddress - 代币合约地址
68
+ * @param ownerAddress - 代币持有者地址
69
+ * @returns 当前授权额度(bigint)
70
+ */
71
+ export declare function checkAllowance(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3', rpcUrl: string, tokenAddress: string, ownerAddress: string): Promise<bigint>;
72
+ /**
73
+ * ✅ 底层方法:检查 ERC20 代币授权额度(手动指定 spender)
74
+ * 适用于任意 spender 地址(Flap、Four、PancakeSwap V2/V3 等)
75
+ *
76
+ * @param rpcUrl - RPC 节点地址
77
+ * @param tokenAddress - 代币合约地址
78
+ * @param ownerAddress - 代币持有者地址
79
+ * @param spenderAddress - 被授权的合约地址(如 Router、Portal、TokenManager 等)
80
+ * @returns 当前授权额度(bigint)
81
+ */
82
+ export declare function checkAllowanceRaw(rpcUrl: string, tokenAddress: string, ownerAddress: string, spenderAddress: string): Promise<bigint>;
83
+ /**
84
+ * ✅ 智能路由:批量检查多个钱包的授权额度(自动选择 spender)
85
+ *
86
+ * @param chain - 链名称 ('BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD')
87
+ * @param platform - 平台名称 ('flap' | 'four' | 'pancake-v2' | 'pancake-v3')
88
+ * @param rpcUrl - RPC 节点地址
89
+ * @param tokenAddress - 代币合约地址
90
+ * @param ownerAddresses - 代币持有者地址数组
91
+ * @returns 每个地址的授权额度数组
92
+ */
93
+ export declare function checkAllowanceBatch(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3', rpcUrl: string, tokenAddress: string, ownerAddresses: string[]): Promise<bigint[]>;
94
+ /**
95
+ * ✅ 底层方法:批量检查多个钱包的授权额度(手动指定 spender)
96
+ * 适用于任意 spender 地址(Flap、Four、PancakeSwap V2/V3 等)
97
+ *
98
+ * @param rpcUrl - RPC 节点地址
99
+ * @param tokenAddress - 代币合约地址
100
+ * @param ownerAddresses - 代币持有者地址数组
101
+ * @param spenderAddress - 被授权的合约地址
102
+ * @returns 每个地址的授权额度数组
103
+ */
104
+ export declare function checkAllowanceBatchRaw(rpcUrl: string, tokenAddress: string, ownerAddresses: string[], spenderAddress: string): Promise<bigint[]>;
@@ -0,0 +1,205 @@
1
+ /**
2
+ * ERC20 授权额度检查(check 侧)
3
+ *
4
+ * 只读查询授权额度、批量查询(Multicall3)、智能路由检查等。
5
+ */
6
+ import { Contract, JsonRpcProvider } from 'ethers';
7
+ import { ADDRESSES, getMulticall3Address } from '../constants/index.js';
8
+ import { ERC20_ABI, MULTICALL3_ABI } from '../../abis/common.js';
9
+ import { getErrorMessageFromUnknown } from '../foundation.js';
10
+ import { validateContractAddress, resolveSpenderAddress, FOUR_MEME_V1_PROXY, FOUR_MEME_V2_PROXY, } from './helpers.js';
11
+ async function checkAllowanceForSpender(rpcUrl, token, owner, amount, spender, spenderLabel) {
12
+ const provider = new JsonRpcProvider(rpcUrl);
13
+ await validateContractAddress(provider, token, 'Token');
14
+ await validateContractAddress(provider, spender, spenderLabel);
15
+ const erc20 = new Contract(token, ERC20_ABI, provider);
16
+ let current;
17
+ try {
18
+ current = await erc20.allowance(owner, spender);
19
+ }
20
+ catch (error) {
21
+ throw new Error(`❌ 调用 allowance 失败(Token 可能不是 ERC20): ${getErrorMessageFromUnknown(error)}`, { cause: error });
22
+ }
23
+ return {
24
+ isApproved: current >= amount,
25
+ currentAllowance: current,
26
+ requiredAllowance: amount,
27
+ };
28
+ }
29
+ async function checkSellApprovalForProxy(_chain, rpcUrl, token, owner, amount, proxyAddress, proxyLabel) {
30
+ return checkAllowanceForSpender(rpcUrl, token, owner, amount, proxyAddress, proxyLabel);
31
+ }
32
+ /**
33
+ * 检查代币授权状态 - Four.meme V1(只读,不发送交易)
34
+ */
35
+ export async function checkSellApprovalV1(chain, rpcUrl, token, owner, amount) {
36
+ return checkSellApprovalForProxy(chain, rpcUrl, token, owner, amount, FOUR_MEME_V1_PROXY[chain], `Four.meme V1 Proxy (${chain})`);
37
+ }
38
+ /**
39
+ * 检查代币授权状态 - Four.meme V2(只读,不发送交易)
40
+ */
41
+ export async function checkSellApprovalV2(chain, rpcUrl, token, owner, amount) {
42
+ return checkSellApprovalForProxy(chain, rpcUrl, token, owner, amount, FOUR_MEME_V2_PROXY[chain], `Four.meme V2 Proxy (${chain})`);
43
+ }
44
+ /**
45
+ * 检查代币授权状态 - Four.meme(通用,默认使用 V2)
46
+ * @deprecated 建议使用明确版本的方法:checkSellApprovalV1 或 checkSellApprovalV2
47
+ */
48
+ export async function checkSellApproval(chain, rpcUrl, token, owner, amount) {
49
+ return checkSellApprovalV2(chain, rpcUrl, token, owner, amount);
50
+ }
51
+ /**
52
+ * 检查代币授权状态 - Flap Protocol(只读,不发送交易)
53
+ * @returns 是否已授权足够的额度
54
+ */
55
+ export async function checkFlapSellApproval(chain, rpcUrl, token, owner, amount) {
56
+ const proxyAddresses = {
57
+ BSC: ADDRESSES.BSC.FlapPortal,
58
+ BASE: ADDRESSES.BASE.FlapPortal,
59
+ XLAYER: ADDRESSES.XLAYER.FlapPortal,
60
+ MORPH: ADDRESSES.MORPH.FlapPortal,
61
+ MONAD: ADDRESSES.MONAD.FlapPortal,
62
+ };
63
+ return checkAllowanceForSpender(rpcUrl, token, owner, amount, proxyAddresses[chain], `Flap Portal (${chain})`);
64
+ }
65
+ /**
66
+ * 批量检查 Flap Protocol 授权状态(默认按上限 2^256-1 判断)
67
+ * ✅ 使用 Multicall3 批量查询,减少 RPC 调用次数
68
+ */
69
+ export async function checkFlapSellApprovalBatch(chain, rpcUrl, token, owners, required = BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff')) {
70
+ if (!owners || owners.length === 0)
71
+ return [];
72
+ const proxyAddresses = {
73
+ BSC: ADDRESSES.BSC.FlapPortal,
74
+ BASE: ADDRESSES.BASE.FlapPortal,
75
+ XLAYER: ADDRESSES.XLAYER.FlapPortal,
76
+ MORPH: ADDRESSES.MORPH.FlapPortal,
77
+ MONAD: ADDRESSES.MONAD.FlapPortal,
78
+ };
79
+ const provider = new JsonRpcProvider(rpcUrl);
80
+ // ✅ 并行验证 token 和代理合约地址
81
+ await Promise.all([
82
+ validateContractAddress(provider, token, 'Token'),
83
+ validateContractAddress(provider, proxyAddresses[chain], `Flap Portal (${chain})`),
84
+ ]);
85
+ // ✅ 使用 batchCheckAllowances 批量查询(Multicall3)
86
+ const allowances = await batchCheckAllowances(provider, token, owners, proxyAddresses[chain]);
87
+ return owners.map((owner, i) => ({
88
+ owner,
89
+ isApproved: allowances[i] >= required,
90
+ currentAllowance: allowances[i],
91
+ requiredAllowance: required,
92
+ }));
93
+ }
94
+ /**
95
+ * 使用 Multicall3 批量查询 ERC20 授权额度
96
+ * @param provider - Provider 实例
97
+ * @param tokenAddress - ERC20 代币地址
98
+ * @param owners - 所有者地址数组
99
+ * @param spender - 被授权的 spender 地址
100
+ * @returns 每个地址的授权额度数组
101
+ */
102
+ export async function batchCheckAllowances(provider, tokenAddress, owners, spender) {
103
+ const network = await provider.getNetwork();
104
+ const multicall3Address = getMulticall3Address(Number(network.chainId));
105
+ const multicall3 = new Contract(multicall3Address, MULTICALL3_ABI, provider);
106
+ // 编码 allowance(owner, spender) 调用数据
107
+ const erc20Interface = new Contract(tokenAddress, ERC20_ABI, provider).interface;
108
+ const calls = owners.map((owner) => ({
109
+ target: tokenAddress,
110
+ allowFailure: true,
111
+ callData: erc20Interface.encodeFunctionData('allowance', [owner, spender]),
112
+ }));
113
+ // 批量调用
114
+ const results = await multicall3.aggregate3(calls);
115
+ // 解析结果
116
+ return results.map((result) => {
117
+ if (!result.success) {
118
+ return 0n;
119
+ }
120
+ try {
121
+ const decoded = erc20Interface.decodeFunctionResult('allowance', result.returnData);
122
+ return decoded[0];
123
+ }
124
+ catch {
125
+ return 0n;
126
+ }
127
+ });
128
+ }
129
+ /**
130
+ * ✅ 智能路由:检查单个 ERC20 授权额度(自动选择 spender)
131
+ *
132
+ * @param chain - 链名称 ('BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD')
133
+ * @param platform - 平台名称 ('flap' | 'four' | 'pancake-v2' | 'pancake-v3')
134
+ * @param rpcUrl - RPC 节点地址
135
+ * @param tokenAddress - 代币合约地址
136
+ * @param ownerAddress - 代币持有者地址
137
+ * @returns 当前授权额度(bigint)
138
+ */
139
+ export async function checkAllowance(chain, platform, rpcUrl, tokenAddress, ownerAddress) {
140
+ const spenderAddress = resolveSpenderAddress(chain, platform);
141
+ return checkAllowanceRaw(rpcUrl, tokenAddress, ownerAddress, spenderAddress);
142
+ }
143
+ /**
144
+ * ✅ 底层方法:检查 ERC20 代币授权额度(手动指定 spender)
145
+ * 适用于任意 spender 地址(Flap、Four、PancakeSwap V2/V3 等)
146
+ *
147
+ * @param rpcUrl - RPC 节点地址
148
+ * @param tokenAddress - 代币合约地址
149
+ * @param ownerAddress - 代币持有者地址
150
+ * @param spenderAddress - 被授权的合约地址(如 Router、Portal、TokenManager 等)
151
+ * @returns 当前授权额度(bigint)
152
+ */
153
+ export async function checkAllowanceRaw(rpcUrl, tokenAddress, ownerAddress, spenderAddress) {
154
+ const provider = new JsonRpcProvider(rpcUrl);
155
+ // ✅ 规范化地址(转为小写,避免 checksum 错误)
156
+ const normalizedToken = tokenAddress.toLowerCase();
157
+ const normalizedOwner = ownerAddress.toLowerCase();
158
+ const normalizedSpender = spenderAddress.toLowerCase();
159
+ // 验证地址
160
+ await validateContractAddress(provider, normalizedToken, 'Token');
161
+ await validateContractAddress(provider, normalizedSpender, 'Spender');
162
+ const erc20 = new Contract(normalizedToken, ERC20_ABI, provider);
163
+ try {
164
+ const allowance = await erc20.allowance(normalizedOwner, normalizedSpender);
165
+ return allowance;
166
+ }
167
+ catch (error) {
168
+ throw new Error(`❌ 查询授权额度失败: ${getErrorMessageFromUnknown(error)}`, { cause: error });
169
+ }
170
+ }
171
+ /**
172
+ * ✅ 智能路由:批量检查多个钱包的授权额度(自动选择 spender)
173
+ *
174
+ * @param chain - 链名称 ('BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD')
175
+ * @param platform - 平台名称 ('flap' | 'four' | 'pancake-v2' | 'pancake-v3')
176
+ * @param rpcUrl - RPC 节点地址
177
+ * @param tokenAddress - 代币合约地址
178
+ * @param ownerAddresses - 代币持有者地址数组
179
+ * @returns 每个地址的授权额度数组
180
+ */
181
+ export async function checkAllowanceBatch(chain, platform, rpcUrl, tokenAddress, ownerAddresses) {
182
+ const spenderAddress = resolveSpenderAddress(chain, platform);
183
+ return checkAllowanceBatchRaw(rpcUrl, tokenAddress, ownerAddresses, spenderAddress);
184
+ }
185
+ /**
186
+ * ✅ 底层方法:批量检查多个钱包的授权额度(手动指定 spender)
187
+ * 适用于任意 spender 地址(Flap、Four、PancakeSwap V2/V3 等)
188
+ *
189
+ * @param rpcUrl - RPC 节点地址
190
+ * @param tokenAddress - 代币合约地址
191
+ * @param ownerAddresses - 代币持有者地址数组
192
+ * @param spenderAddress - 被授权的合约地址
193
+ * @returns 每个地址的授权额度数组
194
+ */
195
+ export async function checkAllowanceBatchRaw(rpcUrl, tokenAddress, ownerAddresses, spenderAddress) {
196
+ const provider = new JsonRpcProvider(rpcUrl);
197
+ // ✅ 规范化地址(转为小写,避免 checksum 错误)
198
+ const normalizedToken = tokenAddress.toLowerCase();
199
+ const normalizedOwners = ownerAddresses.map((addr) => addr.toLowerCase());
200
+ const normalizedSpender = spenderAddress.toLowerCase();
201
+ // 验证地址
202
+ await validateContractAddress(provider, normalizedToken, 'Token');
203
+ await validateContractAddress(provider, normalizedSpender, 'Spender');
204
+ return batchCheckAllowances(provider, normalizedToken, normalizedOwners, normalizedSpender);
205
+ }
@@ -0,0 +1,141 @@
1
+ /**
2
+ * ERC20 授权(approve 侧)
3
+ *
4
+ * 发送授权交易、批量授权(直接发送或仅签名)、智能路由授权等。
5
+ */
6
+ import { type SellApprovalChain } from './helpers.js';
7
+ import type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult } from '../types-erc20.js';
8
+ /**
9
+ * 确保代币已授权给 Four.meme V1 代理合约
10
+ */
11
+ export declare function ensureSellApprovalV1(chain: SellApprovalChain, rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
12
+ /**
13
+ * 确保代币已授权给 Four.meme V2 代理合约
14
+ */
15
+ export declare function ensureSellApprovalV2(chain: SellApprovalChain, rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
16
+ /**
17
+ * 确保代币已授权给 Four.meme 代理合约(通用,默认使用 V2)
18
+ * @deprecated 建议使用明确版本的方法:ensureSellApprovalV1 或 ensureSellApprovalV2
19
+ */
20
+ export declare function ensureSellApproval(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
21
+ /**
22
+ * 确保代币已授权给 Flap Protocol 代理合约
23
+ * 用于 Flap Protocol 代币的卖出操作
24
+ * @returns 授权结果,包含是否已授权、当前额度、交易回执等信息
25
+ */
26
+ export declare function ensureFlapSellApproval(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
27
+ /**
28
+ * 批量确保代币已授权给 Flap Protocol 代理合约(默认授权上限 2^256-1)
29
+ * @param privateKeys 拥有者私钥数组(每个地址需自行签名)
30
+ * @returns 每个地址的授权结果(包含 owner 与交易回执等信息)
31
+ */
32
+ export declare function ensureFlapSellApprovalBatch(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', rpcUrl: string, privateKeys: string[], token: string, required?: bigint): Promise<EnsureAllowanceBatchItemResult[]>;
33
+ /**
34
+ * ✅ 智能路由:授权 ERC20 代币(自动选择 spender,自动检查,只在不足时才发送交易)
35
+ *
36
+ * @param chain - 链名称 ('BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD')
37
+ * @param platform - 平台名称 ('flap' | 'four' | 'pancake-v2' | 'pancake-v3')
38
+ * @param rpcUrl - RPC 节点地址
39
+ * @param privateKey - 私钥
40
+ * @param tokenAddress - 代币合约地址
41
+ * @param amount - 授权数量(bigint),传 'max' 表示最大授权
42
+ * @returns 授权结果
43
+ */
44
+ export declare function approveToken(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3', rpcUrl: string, privateKey: string, tokenAddress: string, amount: bigint | 'max'): Promise<EnsureAllowanceResult>;
45
+ /**
46
+ * ✅ 底层方法:授权 ERC20 代币给指定合约(手动指定 spender)
47
+ * 适用于任意 spender 地址(Flap、Four、PancakeSwap V2/V3 等)
48
+ *
49
+ * @param rpcUrl - RPC 节点地址
50
+ * @param privateKey - 私钥
51
+ * @param tokenAddress - 代币合约地址
52
+ * @param spenderAddress - 被授权的合约地址(如 Router、Portal、TokenManager 等)
53
+ * @param amount - 授权数量(bigint),传 'max' 或 ethers.MaxUint256 表示最大授权
54
+ * @returns 授权结果
55
+ */
56
+ export declare function approveTokenRaw(rpcUrl: string, privateKey: string, tokenAddress: string, spenderAddress: string, amount: bigint | 'max'): Promise<EnsureAllowanceResult>;
57
+ /**
58
+ * ✅ 智能路由:批量授权 ERC20 代币(自动选择 spender,自动检查,只在不足时才发送交易)
59
+ *
60
+ * @param params - 批量授权参数
61
+ * @param params.signOnly - 是否只签名不提交(默认 false)
62
+ * - false: 直接发送交易并等待确认,返回 ApproveTokenBatchResult
63
+ * - true: 只签名不提交,返回 ApproveTokenBatchSignResult,前端可通过 submitBundleToBlockRazor 提交
64
+ * @returns 批量授权结果
65
+ *
66
+ * @example
67
+ * ```typescript
68
+ * // 模式1:直接发送交易(默认)
69
+ * const result = await approveTokenBatch({
70
+ * chain: 'BSC',
71
+ * platform: 'four',
72
+ * rpcUrl: 'https://bsc-dataseed.binance.org',
73
+ * privateKeys: [key1, key2],
74
+ * tokenAddress: '0x...',
75
+ * amounts: ['max', 'max']
76
+ * });
77
+ *
78
+ * // 模式2:只签名,前端提交
79
+ * const signResult = await approveTokenBatch({
80
+ * chain: 'BSC',
81
+ * platform: 'four',
82
+ * rpcUrl: 'https://bsc-dataseed.binance.org',
83
+ * privateKeys: [key1, key2],
84
+ * tokenAddress: '0x...',
85
+ * amounts: ['max', 'max'],
86
+ * signOnly: true
87
+ * });
88
+ * // 提交到 BlockRazor
89
+ * if (signResult.signedTransactions.length > 0) {
90
+ * await submitBundleToBlockRazor(signResult.signedTransactions, { blockOffset: 10 });
91
+ * }
92
+ * ```
93
+ */
94
+ export declare function approveTokenBatch(params: ApproveTokenBatchParams & {
95
+ signOnly: true;
96
+ }): Promise<ApproveTokenBatchSignResult>;
97
+ export declare function approveTokenBatch(params: ApproveTokenBatchParams & {
98
+ signOnly?: false;
99
+ }): Promise<ApproveTokenBatchResult>;
100
+ /**
101
+ * ✅ 底层方法:批量授权 ERC20 代币(手动指定 spender)
102
+ * 适用于任意 spender 地址(Flap、Four、PancakeSwap V2/V3 等)
103
+ *
104
+ * @param params - 批量授权参数
105
+ * @param params.signOnly - 是否只签名不提交(默认 false)
106
+ * - false: 直接发送交易并等待确认,返回 ApproveTokenBatchResult
107
+ * - true: 只签名不提交,返回 ApproveTokenBatchSignResult,前端可通过 submitBundleToBlockRazor 提交
108
+ * @returns 批量授权结果
109
+ *
110
+ * @example
111
+ * ```typescript
112
+ * // 模式1:直接发送交易(默认)
113
+ * const result = await approveTokenBatchRaw({
114
+ * rpcUrl: 'https://bsc-dataseed.binance.org',
115
+ * privateKeys: [key1, key2],
116
+ * tokenAddress: '0x...',
117
+ * spenderAddress: '0x...',
118
+ * amounts: ['max', 'max']
119
+ * });
120
+ *
121
+ * // 模式2:只签名,前端提交
122
+ * const signResult = await approveTokenBatchRaw({
123
+ * rpcUrl: 'https://bsc-dataseed.binance.org',
124
+ * privateKeys: [key1, key2],
125
+ * tokenAddress: '0x...',
126
+ * spenderAddress: '0x...',
127
+ * amounts: ['max', 'max'],
128
+ * signOnly: true
129
+ * });
130
+ * // 提交到 BlockRazor
131
+ * if (signResult.signedTransactions.length > 0) {
132
+ * await submitBundleToBlockRazor(signResult.signedTransactions, { blockOffset: 10 });
133
+ * }
134
+ * ```
135
+ */
136
+ export declare function approveTokenBatchRaw(params: ApproveTokenBatchRawParams & {
137
+ signOnly: true;
138
+ }): Promise<ApproveTokenBatchSignResult>;
139
+ export declare function approveTokenBatchRaw(params: ApproveTokenBatchRawParams & {
140
+ signOnly?: false;
141
+ }): Promise<ApproveTokenBatchResult>;