@oobe-protocol-labs/synapse-client-sdk 1.0.0-beta

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 (460) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +1393 -0
  3. package/dist/cjs/advanced/circuit-breaker.d.ts +111 -0
  4. package/dist/cjs/advanced/circuit-breaker.d.ts.map +1 -0
  5. package/dist/cjs/advanced/circuit-breaker.js +278 -0
  6. package/dist/cjs/advanced/circuit-breaker.js.map +1 -0
  7. package/dist/cjs/advanced/index.d.ts +8 -0
  8. package/dist/cjs/advanced/index.d.ts.map +1 -0
  9. package/dist/cjs/advanced/index.js +13 -0
  10. package/dist/cjs/advanced/index.js.map +1 -0
  11. package/dist/cjs/advanced/load-balancer.d.ts +114 -0
  12. package/dist/cjs/advanced/load-balancer.d.ts.map +1 -0
  13. package/dist/cjs/advanced/load-balancer.js +354 -0
  14. package/dist/cjs/advanced/load-balancer.js.map +1 -0
  15. package/dist/cjs/advanced/smart-caching.d.ts +113 -0
  16. package/dist/cjs/advanced/smart-caching.d.ts.map +1 -0
  17. package/dist/cjs/advanced/smart-caching.js +461 -0
  18. package/dist/cjs/advanced/smart-caching.js.map +1 -0
  19. package/dist/cjs/advanced/types.d.ts +228 -0
  20. package/dist/cjs/advanced/types.d.ts.map +1 -0
  21. package/dist/cjs/advanced/types.js +7 -0
  22. package/dist/cjs/advanced/types.js.map +1 -0
  23. package/dist/cjs/ai/index.d.ts +15 -0
  24. package/dist/cjs/ai/index.d.ts.map +1 -0
  25. package/dist/cjs/ai/index.js +20 -0
  26. package/dist/cjs/ai/index.js.map +1 -0
  27. package/dist/cjs/ai/merkle-operation.d.ts +245 -0
  28. package/dist/cjs/ai/merkle-operation.d.ts.map +1 -0
  29. package/dist/cjs/ai/merkle-operation.js +522 -0
  30. package/dist/cjs/ai/merkle-operation.js.map +1 -0
  31. package/dist/cjs/ai/pda-manager.d.ts +134 -0
  32. package/dist/cjs/ai/pda-manager.d.ts.map +1 -0
  33. package/dist/cjs/ai/pda-manager.js +250 -0
  34. package/dist/cjs/ai/pda-manager.js.map +1 -0
  35. package/dist/cjs/ai/types.ai.d.ts +172 -0
  36. package/dist/cjs/ai/types.ai.d.ts.map +1 -0
  37. package/dist/cjs/ai/types.ai.js +14 -0
  38. package/dist/cjs/ai/types.ai.js.map +1 -0
  39. package/dist/cjs/ai/zero-combine-fetcher.d.ts +171 -0
  40. package/dist/cjs/ai/zero-combine-fetcher.d.ts.map +1 -0
  41. package/dist/cjs/ai/zero-combine-fetcher.js +412 -0
  42. package/dist/cjs/ai/zero-combine-fetcher.js.map +1 -0
  43. package/dist/cjs/client.d.ts +83 -0
  44. package/dist/cjs/client.d.ts.map +1 -0
  45. package/dist/cjs/client.js +287 -0
  46. package/dist/cjs/client.js.map +1 -0
  47. package/dist/cjs/defi/advanced-features.d.ts +207 -0
  48. package/dist/cjs/defi/advanced-features.d.ts.map +1 -0
  49. package/dist/cjs/defi/advanced-features.js +382 -0
  50. package/dist/cjs/defi/advanced-features.js.map +1 -0
  51. package/dist/cjs/defi/index.d.ts +29 -0
  52. package/dist/cjs/defi/index.d.ts.map +1 -0
  53. package/dist/cjs/defi/index.js +50 -0
  54. package/dist/cjs/defi/index.js.map +1 -0
  55. package/dist/cjs/defi/jito.d.ts +118 -0
  56. package/dist/cjs/defi/jito.d.ts.map +1 -0
  57. package/dist/cjs/defi/jito.js +291 -0
  58. package/dist/cjs/defi/jito.js.map +1 -0
  59. package/dist/cjs/defi/jupiter.d.ts +143 -0
  60. package/dist/cjs/defi/jupiter.d.ts.map +1 -0
  61. package/dist/cjs/defi/jupiter.js +219 -0
  62. package/dist/cjs/defi/jupiter.js.map +1 -0
  63. package/dist/cjs/defi/price-feed.d.ts +63 -0
  64. package/dist/cjs/defi/price-feed.d.ts.map +1 -0
  65. package/dist/cjs/defi/price-feed.js +153 -0
  66. package/dist/cjs/defi/price-feed.js.map +1 -0
  67. package/dist/cjs/defi/token-data.d.ts +83 -0
  68. package/dist/cjs/defi/token-data.d.ts.map +1 -0
  69. package/dist/cjs/defi/token-data.js +205 -0
  70. package/dist/cjs/defi/token-data.js.map +1 -0
  71. package/dist/cjs/defi/unstable-features.d.ts +207 -0
  72. package/dist/cjs/defi/unstable-features.d.ts.map +1 -0
  73. package/dist/cjs/defi/unstable-features.js +382 -0
  74. package/dist/cjs/defi/unstable-features.js.map +1 -0
  75. package/dist/cjs/defi/utils.d.ts +265 -0
  76. package/dist/cjs/defi/utils.d.ts.map +1 -0
  77. package/dist/cjs/defi/utils.js +619 -0
  78. package/dist/cjs/defi/utils.js.map +1 -0
  79. package/dist/cjs/index.d.ts +31 -0
  80. package/dist/cjs/index.d.ts.map +1 -0
  81. package/dist/cjs/index.js +71 -0
  82. package/dist/cjs/index.js.map +1 -0
  83. package/dist/cjs/methods/solana-rpc.d.ts +362 -0
  84. package/dist/cjs/methods/solana-rpc.d.ts.map +1 -0
  85. package/dist/cjs/methods/solana-rpc.js +584 -0
  86. package/dist/cjs/methods/solana-rpc.js.map +1 -0
  87. package/dist/cjs/nft/advanced-features.d.ts +205 -0
  88. package/dist/cjs/nft/advanced-features.d.ts.map +1 -0
  89. package/dist/cjs/nft/advanced-features.js +529 -0
  90. package/dist/cjs/nft/advanced-features.js.map +1 -0
  91. package/dist/cjs/nft/clients/index.d.ts +8 -0
  92. package/dist/cjs/nft/clients/index.d.ts.map +1 -0
  93. package/dist/cjs/nft/clients/index.js +14 -0
  94. package/dist/cjs/nft/clients/index.js.map +1 -0
  95. package/dist/cjs/nft/clients/magic-eden-client.d.ts +101 -0
  96. package/dist/cjs/nft/clients/magic-eden-client.d.ts.map +1 -0
  97. package/dist/cjs/nft/clients/magic-eden-client.js +263 -0
  98. package/dist/cjs/nft/clients/magic-eden-client.js.map +1 -0
  99. package/dist/cjs/nft/clients/metaplex-onchain-client.d.ts +154 -0
  100. package/dist/cjs/nft/clients/metaplex-onchain-client.d.ts.map +1 -0
  101. package/dist/cjs/nft/clients/metaplex-onchain-client.js +408 -0
  102. package/dist/cjs/nft/clients/metaplex-onchain-client.js.map +1 -0
  103. package/dist/cjs/nft/clients/tensor-client.d.ts +79 -0
  104. package/dist/cjs/nft/clients/tensor-client.d.ts.map +1 -0
  105. package/dist/cjs/nft/clients/tensor-client.js +222 -0
  106. package/dist/cjs/nft/clients/tensor-client.js.map +1 -0
  107. package/dist/cjs/nft/index.d.ts +13 -0
  108. package/dist/cjs/nft/index.d.ts.map +1 -0
  109. package/dist/cjs/nft/index.js +37 -0
  110. package/dist/cjs/nft/index.js.map +1 -0
  111. package/dist/cjs/nft/types.nft.d.ts +342 -0
  112. package/dist/cjs/nft/types.nft.d.ts.map +1 -0
  113. package/dist/cjs/nft/types.nft.js +3 -0
  114. package/dist/cjs/nft/types.nft.js.map +1 -0
  115. package/dist/cjs/nft/utils.d.ts +46 -0
  116. package/dist/cjs/nft/utils.d.ts.map +1 -0
  117. package/dist/cjs/nft/utils.js +281 -0
  118. package/dist/cjs/nft/utils.js.map +1 -0
  119. package/dist/cjs/types.d.ts +525 -0
  120. package/dist/cjs/types.d.ts.map +1 -0
  121. package/dist/cjs/types.js +192 -0
  122. package/dist/cjs/types.js.map +1 -0
  123. package/dist/cjs/utils/constant.d.ts +8 -0
  124. package/dist/cjs/utils/constant.d.ts.map +1 -0
  125. package/dist/cjs/utils/constant.js +12 -0
  126. package/dist/cjs/utils/constant.js.map +1 -0
  127. package/dist/cjs/utils/helpers.d.ts +92 -0
  128. package/dist/cjs/utils/helpers.d.ts.map +1 -0
  129. package/dist/cjs/utils/helpers.js +248 -0
  130. package/dist/cjs/utils/helpers.js.map +1 -0
  131. package/dist/cjs/websocket/client.d.ts +182 -0
  132. package/dist/cjs/websocket/client.d.ts.map +1 -0
  133. package/dist/cjs/websocket/client.js +465 -0
  134. package/dist/cjs/websocket/client.js.map +1 -0
  135. package/dist/cjs/websocket/index.d.ts +6 -0
  136. package/dist/cjs/websocket/index.d.ts.map +1 -0
  137. package/dist/cjs/websocket/index.js +9 -0
  138. package/dist/cjs/websocket/index.js.map +1 -0
  139. package/dist/docs/.nojekyll +1 -0
  140. package/dist/docs/assets/highlight.css +113 -0
  141. package/dist/docs/assets/icons.js +18 -0
  142. package/dist/docs/assets/icons.svg +1 -0
  143. package/dist/docs/assets/main.js +60 -0
  144. package/dist/docs/assets/navigation.js +1 -0
  145. package/dist/docs/assets/search.js +1 -0
  146. package/dist/docs/assets/style.css +1493 -0
  147. package/dist/docs/classes/AIError.html +40 -0
  148. package/dist/docs/classes/AIInvestmentAdvisor.html +26 -0
  149. package/dist/docs/classes/AIRarityCalculator.html +28 -0
  150. package/dist/docs/classes/ArbitrageDetector.html +30 -0
  151. package/dist/docs/classes/BatchingError.html +40 -0
  152. package/dist/docs/classes/CacheError.html +40 -0
  153. package/dist/docs/classes/CircuitBreaker.html +38 -0
  154. package/dist/docs/classes/CircuitBreakerError.html +40 -0
  155. package/dist/docs/classes/CollectionAnalytics.html +30 -0
  156. package/dist/docs/classes/DeFiError.html +40 -0
  157. package/dist/docs/classes/FlashLoanSimulator.html +26 -0
  158. package/dist/docs/classes/JitoIntegration.html +53 -0
  159. package/dist/docs/classes/JupiterIntegration.html +43 -0
  160. package/dist/docs/classes/Keypair.html +28 -0
  161. package/dist/docs/classes/LoadBalancer.html +34 -0
  162. package/dist/docs/classes/MEVProtection.html +28 -0
  163. package/dist/docs/classes/MarketplaceAggregator.html +28 -0
  164. package/dist/docs/classes/MerkleOperation.html +74 -0
  165. package/dist/docs/classes/NFTEngine.html +29 -0
  166. package/dist/docs/classes/NFTError.html +40 -0
  167. package/dist/docs/classes/NetworkError.html +40 -0
  168. package/dist/docs/classes/PDAManager.html +46 -0
  169. package/dist/docs/classes/PortfolioAnalytics.html +26 -0
  170. package/dist/docs/classes/PriceFeedIntegration.html +37 -0
  171. package/dist/docs/classes/PublicKey.html +46 -0
  172. package/dist/docs/classes/RateLimitError.html +39 -0
  173. package/dist/docs/classes/SmartCaching.html +42 -0
  174. package/dist/docs/classes/Synapse.html +6 -0
  175. package/dist/docs/classes/SynapseClient.html +55 -0
  176. package/dist/docs/classes/SynapseError.html +37 -0
  177. package/dist/docs/classes/SynapseSolanaEngine.html +49 -0
  178. package/dist/docs/classes/SynapseUtils.html +25 -0
  179. package/dist/docs/classes/TokenDataIntegration.html +41 -0
  180. package/dist/docs/classes/Transaction.html +87 -0
  181. package/dist/docs/classes/TransactionInstruction.html +10 -0
  182. package/dist/docs/classes/UpstreamError.html +39 -0
  183. package/dist/docs/classes/WebSocketClient.html +47 -0
  184. package/dist/docs/classes/WebSocketError.html +40 -0
  185. package/dist/docs/classes/YieldFarmingFinder.html +26 -0
  186. package/dist/docs/classes/ZeroCombineFetcher.html +25 -0
  187. package/dist/docs/functions/createSynapseClient.html +2 -0
  188. package/dist/docs/hierarchy.html +1 -0
  189. package/dist/docs/index.html +776 -0
  190. package/dist/docs/interfaces/AIAgentConfig.html +11 -0
  191. package/dist/docs/interfaces/AIAgentContext.html +7 -0
  192. package/dist/docs/interfaces/AIContext.html +6 -0
  193. package/dist/docs/interfaces/AIMethodResult.html +6 -0
  194. package/dist/docs/interfaces/AIRarityAnalysis.html +3 -0
  195. package/dist/docs/interfaces/AIResponse.html +5 -0
  196. package/dist/docs/interfaces/AccountInfo.html +8 -0
  197. package/dist/docs/interfaces/AdvancedClientConfig.html +7 -0
  198. package/dist/docs/interfaces/AdvancedEvents.html +9 -0
  199. package/dist/docs/interfaces/AdvancedMetricsData.html +5 -0
  200. package/dist/docs/interfaces/AdvancedPerformanceMetrics.html +6 -0
  201. package/dist/docs/interfaces/AgentAdapter.html +6 -0
  202. package/dist/docs/interfaces/AgentRiskReport.html +6 -0
  203. package/dist/docs/interfaces/AgentTradeSuggestion.html +10 -0
  204. package/dist/docs/interfaces/AggregatedCollectionStats.html +36 -0
  205. package/dist/docs/interfaces/ArbitrageOpportunity.html +8 -0
  206. package/dist/docs/interfaces/AutoTradingStrategy.html +13 -0
  207. package/dist/docs/interfaces/BatchResponse.html +4 -0
  208. package/dist/docs/interfaces/BatchResult.html +6 -0
  209. package/dist/docs/interfaces/BatcherConfig.html +5 -0
  210. package/dist/docs/interfaces/BirdeyeTokenPrice.html +4 -0
  211. package/dist/docs/interfaces/BlockhashInfo.html +5 -0
  212. package/dist/docs/interfaces/BuildSwapTxResult.html +7 -0
  213. package/dist/docs/interfaces/CacheStats.html +9 -0
  214. package/dist/docs/interfaces/ChunkInfo.html +10 -0
  215. package/dist/docs/interfaces/CircuitBreakerConfig.html +6 -0
  216. package/dist/docs/interfaces/ClientStats.html +14 -0
  217. package/dist/docs/interfaces/CollectionStats.html +17 -0
  218. package/dist/docs/interfaces/CollectionTrends.html +7 -0
  219. package/dist/docs/interfaces/CompressedNFTInfo.html +13 -0
  220. package/dist/docs/interfaces/ConfirmedTransaction.html +6 -0
  221. package/dist/docs/interfaces/ConnectionEvents.html +11 -0
  222. package/dist/docs/interfaces/DeFiConfig.html +16 -0
  223. package/dist/docs/interfaces/DiagnosticsResult.html +6 -0
  224. package/dist/docs/interfaces/EpochInfo.html +9 -0
  225. package/dist/docs/interfaces/ExecuteSwapParams.html +10 -0
  226. package/dist/docs/interfaces/FetchConfig.html +7 -0
  227. package/dist/docs/interfaces/FlashLoanAction.html +6 -0
  228. package/dist/docs/interfaces/FlashLoanSimulation.html +9 -0
  229. package/dist/docs/interfaces/GatewayStats.html +7 -0
  230. package/dist/docs/interfaces/InscriptionResult.html +18 -0
  231. package/dist/docs/interfaces/InvestmentRecommendation.html +10 -0
  232. package/dist/docs/interfaces/JitoBundleParams.html +4 -0
  233. package/dist/docs/interfaces/JitoBundleResult.html +6 -0
  234. package/dist/docs/interfaces/JitoBundleStatus.html +6 -0
  235. package/dist/docs/interfaces/JitoTipAccount.html +3 -0
  236. package/dist/docs/interfaces/JupiterQuoteParams.html +10 -0
  237. package/dist/docs/interfaces/JupiterQuoteRequest.html +17 -0
  238. package/dist/docs/interfaces/JupiterQuoteResponse.html +13 -0
  239. package/dist/docs/interfaces/JupiterSwapOptions.html +8 -0
  240. package/dist/docs/interfaces/JupiterSwapResponse.html +4 -0
  241. package/dist/docs/interfaces/JupiterTokenPrice.html +5 -0
  242. package/dist/docs/interfaces/LoadBalancerConfig.html +5 -0
  243. package/dist/docs/interfaces/MEVProtectionConfig.html +11 -0
  244. package/dist/docs/interfaces/MEVProtectionResult.html +6 -0
  245. package/dist/docs/interfaces/MagicEdenActivity.html +22 -0
  246. package/dist/docs/interfaces/MagicEdenCollection.html +22 -0
  247. package/dist/docs/interfaces/MagicEdenCollectionStats.html +17 -0
  248. package/dist/docs/interfaces/MagicEdenErrorResponse.html +4 -0
  249. package/dist/docs/interfaces/MagicEdenListing.html +24 -0
  250. package/dist/docs/interfaces/MarketplaceClientConfig.html +14 -0
  251. package/dist/docs/interfaces/MarketplaceFloorPrices.html +7 -0
  252. package/dist/docs/interfaces/MarketplaceListing.html +9 -0
  253. package/dist/docs/interfaces/MerkleLeaf.html +6 -0
  254. package/dist/docs/interfaces/MerkleProof.html +8 -0
  255. package/dist/docs/interfaces/MerkleValidationResult.html +10 -0
  256. package/dist/docs/interfaces/MultiChainSignal.html +8 -0
  257. package/dist/docs/interfaces/NFTAttribute.html +4 -0
  258. package/dist/docs/interfaces/NFTConfig.html +6 -0
  259. package/dist/docs/interfaces/NFTInfo.html +10 -0
  260. package/dist/docs/interfaces/NFTMetadata.html +9 -0
  261. package/dist/docs/interfaces/NormalizedMarketplaceListing.html +18 -0
  262. package/dist/docs/interfaces/OOBECompatibleAgent.html +8 -0
  263. package/dist/docs/interfaces/PDAConfig.html +10 -0
  264. package/dist/docs/interfaces/ParsedAccountInfo.html +8 -0
  265. package/dist/docs/interfaces/PerformanceMetrics.html +9 -0
  266. package/dist/docs/interfaces/PortfolioMetrics.html +10 -0
  267. package/dist/docs/interfaces/PriceData.html +8 -0
  268. package/dist/docs/interfaces/ProofRecord.html +12 -0
  269. package/dist/docs/interfaces/QuoteRequestCommon.html +11 -0
  270. package/dist/docs/interfaces/QuoteResponse.html +6 -0
  271. package/dist/docs/interfaces/RarityAlgorithmConfig.html +3 -0
  272. package/dist/docs/interfaces/RarityScore.html +8 -0
  273. package/dist/docs/interfaces/RaydiumBuildSwapParams.html +14 -0
  274. package/dist/docs/interfaces/RaydiumQuoteRequest.html +14 -0
  275. package/dist/docs/interfaces/RequestOptions.html +12 -0
  276. package/dist/docs/interfaces/RetryAttempt.html +5 -0
  277. package/dist/docs/interfaces/RpcError.html +5 -0
  278. package/dist/docs/interfaces/RpcRequest.html +6 -0
  279. package/dist/docs/interfaces/RpcResponse.html +6 -0
  280. package/dist/docs/interfaces/SecurityThreat.html +6 -0
  281. package/dist/docs/interfaces/SignatureInfo.html +8 -0
  282. package/dist/docs/interfaces/Signer.html +4 -0
  283. package/dist/docs/interfaces/SmartCacheConfig.html +7 -0
  284. package/dist/docs/interfaces/SmartQueryOptions.html +10 -0
  285. package/dist/docs/interfaces/StressTestOptions.html +8 -0
  286. package/dist/docs/interfaces/StressTestResult.html +9 -0
  287. package/dist/docs/interfaces/SubscriptionConfig.html +9 -0
  288. package/dist/docs/interfaces/SubscriptionOptions.html +7 -0
  289. package/dist/docs/interfaces/SubscriptionResult.html +7 -0
  290. package/dist/docs/interfaces/SynapseConfig.html +13 -0
  291. package/dist/docs/interfaces/SynapseLikeClient.html +4 -0
  292. package/dist/docs/interfaces/TensorCollectionStats.html +33 -0
  293. package/dist/docs/interfaces/TensorErrorResponse.html +5 -0
  294. package/dist/docs/interfaces/TensorListing.html +16 -0
  295. package/dist/docs/interfaces/TensorSale.html +16 -0
  296. package/dist/docs/interfaces/TokenAccount.html +7 -0
  297. package/dist/docs/interfaces/TokenAccountInfo.html +12 -0
  298. package/dist/docs/interfaces/TokenHolding.html +8 -0
  299. package/dist/docs/interfaces/TokenInfo.html +7 -0
  300. package/dist/docs/interfaces/TokenLargestAccount.html +5 -0
  301. package/dist/docs/interfaces/TokenSupply.html +5 -0
  302. package/dist/docs/interfaces/TradeExecution.html +14 -0
  303. package/dist/docs/interfaces/TransactionSignature.html +8 -0
  304. package/dist/docs/interfaces/UpstreamHealth.html +8 -0
  305. package/dist/docs/interfaces/UserPDAs.html +10 -0
  306. package/dist/docs/interfaces/WebSocketConfig.html +12 -0
  307. package/dist/docs/interfaces/WebSocketMessage.html +6 -0
  308. package/dist/docs/interfaces/YieldOpportunity.html +8 -0
  309. package/dist/docs/interfaces/ZeroChunk.html +8 -0
  310. package/dist/docs/interfaces/ZeroCombineResult.html +3 -0
  311. package/dist/docs/media/LICENSE +21 -0
  312. package/dist/docs/media/README-1.md +778 -0
  313. package/dist/docs/media/README-2.md +1050 -0
  314. package/dist/docs/media/README-3.md +1522 -0
  315. package/dist/docs/media/README-4.md +869 -0
  316. package/dist/docs/media/README-5.md +857 -0
  317. package/dist/docs/media/README-6.md +727 -0
  318. package/dist/docs/media/README.md +766 -0
  319. package/dist/docs/modules.html +168 -0
  320. package/dist/docs/types/BlockhashWithExpiryBlockHeight.html +1 -0
  321. package/dist/docs/types/Commitment.html +3 -0
  322. package/dist/docs/types/RiskTolerance.html +1 -0
  323. package/dist/docs/types/SimulatedTransactionResponse.html +1 -0
  324. package/dist/esm/advanced/circuit-breaker.d.ts +111 -0
  325. package/dist/esm/advanced/circuit-breaker.d.ts.map +1 -0
  326. package/dist/esm/advanced/circuit-breaker.js +274 -0
  327. package/dist/esm/advanced/circuit-breaker.js.map +1 -0
  328. package/dist/esm/advanced/index.d.ts +8 -0
  329. package/dist/esm/advanced/index.d.ts.map +1 -0
  330. package/dist/esm/advanced/index.js +7 -0
  331. package/dist/esm/advanced/index.js.map +1 -0
  332. package/dist/esm/advanced/load-balancer.d.ts +114 -0
  333. package/dist/esm/advanced/load-balancer.d.ts.map +1 -0
  334. package/dist/esm/advanced/load-balancer.js +350 -0
  335. package/dist/esm/advanced/load-balancer.js.map +1 -0
  336. package/dist/esm/advanced/smart-caching.d.ts +113 -0
  337. package/dist/esm/advanced/smart-caching.d.ts.map +1 -0
  338. package/dist/esm/advanced/smart-caching.js +457 -0
  339. package/dist/esm/advanced/smart-caching.js.map +1 -0
  340. package/dist/esm/advanced/types.d.ts +228 -0
  341. package/dist/esm/advanced/types.d.ts.map +1 -0
  342. package/dist/esm/advanced/types.js +6 -0
  343. package/dist/esm/advanced/types.js.map +1 -0
  344. package/dist/esm/ai/index.d.ts +15 -0
  345. package/dist/esm/ai/index.d.ts.map +1 -0
  346. package/dist/esm/ai/index.js +14 -0
  347. package/dist/esm/ai/index.js.map +1 -0
  348. package/dist/esm/ai/merkle-operation.d.ts +245 -0
  349. package/dist/esm/ai/merkle-operation.d.ts.map +1 -0
  350. package/dist/esm/ai/merkle-operation.js +485 -0
  351. package/dist/esm/ai/merkle-operation.js.map +1 -0
  352. package/dist/esm/ai/pda-manager.d.ts +134 -0
  353. package/dist/esm/ai/pda-manager.d.ts.map +1 -0
  354. package/dist/esm/ai/pda-manager.js +213 -0
  355. package/dist/esm/ai/pda-manager.js.map +1 -0
  356. package/dist/esm/ai/types.ai.d.ts +172 -0
  357. package/dist/esm/ai/types.ai.d.ts.map +1 -0
  358. package/dist/esm/ai/types.ai.js +13 -0
  359. package/dist/esm/ai/types.ai.js.map +1 -0
  360. package/dist/esm/ai/zero-combine-fetcher.d.ts +171 -0
  361. package/dist/esm/ai/zero-combine-fetcher.d.ts.map +1 -0
  362. package/dist/esm/ai/zero-combine-fetcher.js +408 -0
  363. package/dist/esm/ai/zero-combine-fetcher.js.map +1 -0
  364. package/dist/esm/client.d.ts +83 -0
  365. package/dist/esm/client.d.ts.map +1 -0
  366. package/dist/esm/client.js +283 -0
  367. package/dist/esm/client.js.map +1 -0
  368. package/dist/esm/defi/advanced-features.d.ts +207 -0
  369. package/dist/esm/defi/advanced-features.d.ts.map +1 -0
  370. package/dist/esm/defi/advanced-features.js +374 -0
  371. package/dist/esm/defi/advanced-features.js.map +1 -0
  372. package/dist/esm/defi/index.d.ts +29 -0
  373. package/dist/esm/defi/index.d.ts.map +1 -0
  374. package/dist/esm/defi/index.js +37 -0
  375. package/dist/esm/defi/index.js.map +1 -0
  376. package/dist/esm/defi/jito.d.ts +118 -0
  377. package/dist/esm/defi/jito.d.ts.map +1 -0
  378. package/dist/esm/defi/jito.js +287 -0
  379. package/dist/esm/defi/jito.js.map +1 -0
  380. package/dist/esm/defi/jupiter.d.ts +143 -0
  381. package/dist/esm/defi/jupiter.d.ts.map +1 -0
  382. package/dist/esm/defi/jupiter.js +215 -0
  383. package/dist/esm/defi/jupiter.js.map +1 -0
  384. package/dist/esm/defi/price-feed.d.ts +63 -0
  385. package/dist/esm/defi/price-feed.d.ts.map +1 -0
  386. package/dist/esm/defi/price-feed.js +149 -0
  387. package/dist/esm/defi/price-feed.js.map +1 -0
  388. package/dist/esm/defi/token-data.d.ts +83 -0
  389. package/dist/esm/defi/token-data.d.ts.map +1 -0
  390. package/dist/esm/defi/token-data.js +201 -0
  391. package/dist/esm/defi/token-data.js.map +1 -0
  392. package/dist/esm/defi/unstable-features.d.ts +207 -0
  393. package/dist/esm/defi/unstable-features.d.ts.map +1 -0
  394. package/dist/esm/defi/unstable-features.js +374 -0
  395. package/dist/esm/defi/unstable-features.js.map +1 -0
  396. package/dist/esm/defi/utils.d.ts +265 -0
  397. package/dist/esm/defi/utils.d.ts.map +1 -0
  398. package/dist/esm/defi/utils.js +582 -0
  399. package/dist/esm/defi/utils.js.map +1 -0
  400. package/dist/esm/index.d.ts +31 -0
  401. package/dist/esm/index.d.ts.map +1 -0
  402. package/dist/esm/index.js +47 -0
  403. package/dist/esm/index.js.map +1 -0
  404. package/dist/esm/methods/solana-rpc.d.ts +362 -0
  405. package/dist/esm/methods/solana-rpc.d.ts.map +1 -0
  406. package/dist/esm/methods/solana-rpc.js +532 -0
  407. package/dist/esm/methods/solana-rpc.js.map +1 -0
  408. package/dist/esm/nft/advanced-features.d.ts +205 -0
  409. package/dist/esm/nft/advanced-features.d.ts.map +1 -0
  410. package/dist/esm/nft/advanced-features.js +489 -0
  411. package/dist/esm/nft/advanced-features.js.map +1 -0
  412. package/dist/esm/nft/clients/index.d.ts +8 -0
  413. package/dist/esm/nft/clients/index.d.ts.map +1 -0
  414. package/dist/esm/nft/clients/index.js +8 -0
  415. package/dist/esm/nft/clients/index.js.map +1 -0
  416. package/dist/esm/nft/clients/magic-eden-client.d.ts +101 -0
  417. package/dist/esm/nft/clients/magic-eden-client.d.ts.map +1 -0
  418. package/dist/esm/nft/clients/magic-eden-client.js +259 -0
  419. package/dist/esm/nft/clients/magic-eden-client.js.map +1 -0
  420. package/dist/esm/nft/clients/metaplex-onchain-client.d.ts +154 -0
  421. package/dist/esm/nft/clients/metaplex-onchain-client.d.ts.map +1 -0
  422. package/dist/esm/nft/clients/metaplex-onchain-client.js +404 -0
  423. package/dist/esm/nft/clients/metaplex-onchain-client.js.map +1 -0
  424. package/dist/esm/nft/clients/tensor-client.d.ts +79 -0
  425. package/dist/esm/nft/clients/tensor-client.d.ts.map +1 -0
  426. package/dist/esm/nft/clients/tensor-client.js +218 -0
  427. package/dist/esm/nft/clients/tensor-client.js.map +1 -0
  428. package/dist/esm/nft/index.d.ts +13 -0
  429. package/dist/esm/nft/index.d.ts.map +1 -0
  430. package/dist/esm/nft/index.js +15 -0
  431. package/dist/esm/nft/index.js.map +1 -0
  432. package/dist/esm/nft/types.nft.d.ts +342 -0
  433. package/dist/esm/nft/types.nft.d.ts.map +1 -0
  434. package/dist/esm/nft/types.nft.js +2 -0
  435. package/dist/esm/nft/types.nft.js.map +1 -0
  436. package/dist/esm/nft/utils.d.ts +46 -0
  437. package/dist/esm/nft/utils.d.ts.map +1 -0
  438. package/dist/esm/nft/utils.js +276 -0
  439. package/dist/esm/nft/utils.js.map +1 -0
  440. package/dist/esm/types.d.ts +525 -0
  441. package/dist/esm/types.d.ts.map +1 -0
  442. package/dist/esm/types.js +178 -0
  443. package/dist/esm/types.js.map +1 -0
  444. package/dist/esm/utils/constant.d.ts +8 -0
  445. package/dist/esm/utils/constant.d.ts.map +1 -0
  446. package/dist/esm/utils/constant.js +8 -0
  447. package/dist/esm/utils/constant.js.map +1 -0
  448. package/dist/esm/utils/helpers.d.ts +92 -0
  449. package/dist/esm/utils/helpers.d.ts.map +1 -0
  450. package/dist/esm/utils/helpers.js +243 -0
  451. package/dist/esm/utils/helpers.js.map +1 -0
  452. package/dist/esm/websocket/client.d.ts +182 -0
  453. package/dist/esm/websocket/client.d.ts.map +1 -0
  454. package/dist/esm/websocket/client.js +458 -0
  455. package/dist/esm/websocket/client.js.map +1 -0
  456. package/dist/esm/websocket/index.d.ts +6 -0
  457. package/dist/esm/websocket/index.d.ts.map +1 -0
  458. package/dist/esm/websocket/index.js +5 -0
  459. package/dist/esm/websocket/index.js.map +1 -0
  460. package/package.json +160 -0
@@ -0,0 +1,287 @@
1
+ /**
2
+ * @file defi/jito.ts
3
+ * @module SolanaDeFi/Jito
4
+ * @author Keepeeto
5
+ * @license MIT
6
+ * @description Real Jito Block Engine API integration for MEV-protected transactions.
7
+ * Complete implementation with bundle submission, status tracking, and tip management.
8
+ */
9
+ import { EventEmitter } from 'eventemitter3';
10
+ import { PublicKey, SystemProgram } from '@solana/web3.js';
11
+ import { DeFiError } from '../types.js';
12
+ // ============================================================================
13
+ // Jito Integration
14
+ // ============================================================================
15
+ /**
16
+ * Jito Block Engine Integration
17
+ * Real Jito API for MEV-protected transaction bundles
18
+ *
19
+ * @example
20
+ * ```typescript
21
+ * const jito = new JitoIntegration(client);
22
+ *
23
+ * // Get tip account
24
+ * const tipAccount = jito.getTipAccount('mainnet');
25
+ *
26
+ * // Submit bundle
27
+ * const bundle = await jito.submitBundle({
28
+ * transactions: [serializedTx1, serializedTx2],
29
+ * tipLamports: 1_000_000,
30
+ * });
31
+ *
32
+ * // Check status
33
+ * const status = await jito.getBundleStatus(bundle.bundleId);
34
+ * ```
35
+ */
36
+ export class JitoIntegration extends EventEmitter {
37
+ client;
38
+ blockEngineUrl;
39
+ // Official Jito tip accounts
40
+ tipAccounts = [
41
+ { address: '96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5', region: 'mainnet' },
42
+ { address: 'HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe', region: 'ny' },
43
+ { address: 'Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY', region: 'amsterdam' },
44
+ { address: 'ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49', region: 'frankfurt' },
45
+ { address: 'DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh', region: 'tokyo' },
46
+ { address: 'ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt', region: 'mainnet' },
47
+ { address: '3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT', region: 'mainnet' },
48
+ { address: 'DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL', region: 'mainnet' },
49
+ ];
50
+ constructor(client, customUrl) {
51
+ super();
52
+ this.client = client;
53
+ this.blockEngineUrl = customUrl || 'https://mainnet.block-engine.jito.wtf';
54
+ }
55
+ /**
56
+ * Get recommended tip account based on region
57
+ */
58
+ getTipAccount(region = 'mainnet') {
59
+ const accounts = this.tipAccounts.filter((acc) => acc.region === region);
60
+ if (accounts.length === 0) {
61
+ return this.tipAccounts[0].address;
62
+ }
63
+ // Return random account from region for load balancing
64
+ return accounts[Math.floor(Math.random() * accounts.length)].address;
65
+ }
66
+ /**
67
+ * Get all tip accounts for a specific region
68
+ */
69
+ getTipAccountsByRegion(region) {
70
+ return this.tipAccounts
71
+ .filter((acc) => acc.region === region)
72
+ .map((acc) => acc.address);
73
+ }
74
+ /**
75
+ * Create tip instruction
76
+ */
77
+ createTipInstruction(from, tipLamports, tipAccount) {
78
+ const tipAccountPubkey = new PublicKey(tipAccount || this.getTipAccount('mainnet'));
79
+ return SystemProgram.transfer({
80
+ fromPubkey: from,
81
+ toPubkey: tipAccountPubkey,
82
+ lamports: tipLamports,
83
+ });
84
+ }
85
+ /**
86
+ * Submit bundle to Jito
87
+ */
88
+ async submitBundle(params) {
89
+ try {
90
+ this.emit('jito-bundle-submit', { txCount: params.transactions.length });
91
+ const response = await fetch(`${this.blockEngineUrl}/api/v1/bundles`, {
92
+ method: 'POST',
93
+ headers: { 'Content-Type': 'application/json' },
94
+ body: JSON.stringify({
95
+ jsonrpc: '2.0',
96
+ id: 1,
97
+ method: 'sendBundle',
98
+ params: [params.transactions],
99
+ }),
100
+ });
101
+ if (!response.ok) {
102
+ throw new Error(`Jito bundle submission failed: ${response.status}`);
103
+ }
104
+ const data = await response.json();
105
+ if (data.error) {
106
+ throw new Error(data.error.message || 'Bundle submission failed');
107
+ }
108
+ const bundleId = data.result;
109
+ this.emit('jito-bundle-submitted', { bundleId });
110
+ return {
111
+ bundleId,
112
+ status: 'accepted',
113
+ };
114
+ }
115
+ catch (error) {
116
+ this.emit('jito-bundle-error', error);
117
+ throw new DeFiError(`Jito bundle submission failed: ${error.message}`, 'mev-protection', undefined, error);
118
+ }
119
+ }
120
+ /**
121
+ * Get bundle status
122
+ */
123
+ async getBundleStatus(bundleId) {
124
+ try {
125
+ const response = await fetch(`${this.blockEngineUrl}/api/v1/bundles`, {
126
+ method: 'POST',
127
+ headers: { 'Content-Type': 'application/json' },
128
+ body: JSON.stringify({
129
+ jsonrpc: '2.0',
130
+ id: 1,
131
+ method: 'getBundleStatuses',
132
+ params: [[bundleId]],
133
+ }),
134
+ });
135
+ if (!response.ok) {
136
+ throw new Error(`Failed to get bundle status: ${response.status}`);
137
+ }
138
+ const data = await response.json();
139
+ const bundleStatus = data.result?.value?.[0];
140
+ if (!bundleStatus) {
141
+ return {
142
+ bundleId,
143
+ status: 'pending',
144
+ };
145
+ }
146
+ return {
147
+ bundleId,
148
+ status: bundleStatus.confirmation_status || 'pending',
149
+ slot: bundleStatus.slot,
150
+ confirmations: bundleStatus.confirmations,
151
+ landedTipLamports: bundleStatus.landed_tips_lamports,
152
+ };
153
+ }
154
+ catch (error) {
155
+ throw new DeFiError(`Failed to get bundle status: ${error.message}`, 'mev-protection', undefined, error);
156
+ }
157
+ }
158
+ /**
159
+ * Get bundle statuses (batch)
160
+ */
161
+ async getBundleStatuses(bundleIds) {
162
+ try {
163
+ const response = await fetch(`${this.blockEngineUrl}/api/v1/bundles`, {
164
+ method: 'POST',
165
+ headers: { 'Content-Type': 'application/json' },
166
+ body: JSON.stringify({
167
+ jsonrpc: '2.0',
168
+ id: 1,
169
+ method: 'getBundleStatuses',
170
+ params: [bundleIds],
171
+ }),
172
+ });
173
+ if (!response.ok) {
174
+ throw new Error(`Failed to get bundle statuses: ${response.status}`);
175
+ }
176
+ const data = await response.json();
177
+ const statuses = data.result?.value || [];
178
+ return bundleIds.map((bundleId, index) => {
179
+ const status = statuses[index];
180
+ if (!status) {
181
+ return { bundleId, status: 'pending' };
182
+ }
183
+ return {
184
+ bundleId,
185
+ status: status.confirmation_status || 'pending',
186
+ slot: status.slot,
187
+ confirmations: status.confirmations,
188
+ landedTipLamports: status.landed_tips_lamports,
189
+ };
190
+ });
191
+ }
192
+ catch (error) {
193
+ throw new DeFiError(`Failed to get bundle statuses: ${error.message}`, 'mev-protection', undefined, error);
194
+ }
195
+ }
196
+ /**
197
+ * Get inflight bundle statuses
198
+ */
199
+ async getInflightBundleStatuses(bundleIds) {
200
+ try {
201
+ const response = await fetch(`${this.blockEngineUrl}/api/v1/bundles`, {
202
+ method: 'POST',
203
+ headers: { 'Content-Type': 'application/json' },
204
+ body: JSON.stringify({
205
+ jsonrpc: '2.0',
206
+ id: 1,
207
+ method: 'getInflightBundleStatuses',
208
+ params: [bundleIds],
209
+ }),
210
+ });
211
+ if (!response.ok) {
212
+ throw new Error(`Failed to get inflight statuses: ${response.status}`);
213
+ }
214
+ const data = await response.json();
215
+ const statuses = data.result?.value || [];
216
+ return statuses.map((status) => ({
217
+ bundleId: status.bundle_id,
218
+ status: status.status || 'pending',
219
+ slot: status.slot,
220
+ confirmations: status.confirmations,
221
+ }));
222
+ }
223
+ catch (error) {
224
+ throw new DeFiError(`Failed to get inflight statuses: ${error.message}`, 'mev-protection', undefined, error);
225
+ }
226
+ }
227
+ /**
228
+ * Get tip accounts
229
+ */
230
+ getTipAccounts() {
231
+ return [...this.tipAccounts];
232
+ }
233
+ /**
234
+ * Get tip accounts by region (convenience method)
235
+ */
236
+ getAllTipAccountsByRegion() {
237
+ const byRegion = new Map();
238
+ for (const account of this.tipAccounts) {
239
+ const existing = byRegion.get(account.region) || [];
240
+ existing.push(account.address);
241
+ byRegion.set(account.region, existing);
242
+ }
243
+ return byRegion;
244
+ }
245
+ /**
246
+ * Wait for bundle confirmation
247
+ */
248
+ async waitForBundleConfirmation(bundleId, options) {
249
+ const timeout = options?.timeout || 60000; // 60s default
250
+ const pollingInterval = options?.pollingInterval || 2000; // 2s default
251
+ const targetStatus = options?.confirmationStatus || 'confirmed';
252
+ const startTime = Date.now();
253
+ while (Date.now() - startTime < timeout) {
254
+ const status = await this.getBundleStatus(bundleId);
255
+ if (status.status === 'landed' || status.status === 'failed') {
256
+ return status;
257
+ }
258
+ await new Promise(resolve => setTimeout(resolve, pollingInterval));
259
+ }
260
+ throw new DeFiError(`Bundle confirmation timeout after ${timeout}ms`, 'mev-protection', undefined);
261
+ }
262
+ /**
263
+ * Update block engine URL
264
+ */
265
+ setBlockEngineUrl(url) {
266
+ this.blockEngineUrl = url;
267
+ }
268
+ /**
269
+ * Get current block engine URL
270
+ */
271
+ getBlockEngineUrl() {
272
+ return this.blockEngineUrl;
273
+ }
274
+ /**
275
+ * Get recommended tip amount based on priority
276
+ */
277
+ getRecommendedTip(priority) {
278
+ const tips = {
279
+ low: 10_000, // 0.00001 SOL
280
+ medium: 100_000, // 0.0001 SOL
281
+ high: 1_000_000, // 0.001 SOL
282
+ turbo: 10_000_000, // 0.01 SOL
283
+ };
284
+ return tips[priority];
285
+ }
286
+ }
287
+ //# sourceMappingURL=jito.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jito.js","sourceRoot":"","sources":["../../../src/defi/jito.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,143 @@
1
+ /**
2
+ * @file defi/jupiter.ts
3
+ * @module SolanaDeFi/Jupiter
4
+ * @author Keepeeto
5
+ * @license MIT
6
+ * @description Real Jupiter V6 API integration for best swap routes on Solana.
7
+ * Complete implementation with quote, swap, and price endpoints.
8
+ */
9
+ import { EventEmitter } from 'eventemitter3';
10
+ import { VersionedTransaction } from '@solana/web3.js';
11
+ import type { SynapseClient } from '../client';
12
+ export interface JupiterQuoteParams {
13
+ inputMint: string;
14
+ outputMint: string;
15
+ amount: number;
16
+ slippageBps?: number;
17
+ swapMode?: 'ExactIn' | 'ExactOut';
18
+ onlyDirectRoutes?: boolean;
19
+ asLegacyTransaction?: boolean;
20
+ platformFeeBps?: number;
21
+ maxAccounts?: number;
22
+ }
23
+ export interface JupiterQuoteResponse {
24
+ inputMint: string;
25
+ inAmount: string;
26
+ outputMint: string;
27
+ outAmount: string;
28
+ otherAmountThreshold: string;
29
+ swapMode: string;
30
+ slippageBps: number;
31
+ platformFee: {
32
+ amount: string;
33
+ feeBps: number;
34
+ } | null;
35
+ priceImpactPct: string;
36
+ routePlan: Array<{
37
+ swapInfo: {
38
+ ammKey: string;
39
+ label: string;
40
+ inputMint: string;
41
+ outputMint: string;
42
+ inAmount: string;
43
+ outAmount: string;
44
+ feeAmount: string;
45
+ feeMint: string;
46
+ };
47
+ percent: number;
48
+ }>;
49
+ contextSlot?: number;
50
+ timeTaken?: number;
51
+ }
52
+ export interface JupiterSwapResponse {
53
+ swapTransaction: string;
54
+ lastValidBlockHeight: number;
55
+ prioritizationFeeLamports: number;
56
+ }
57
+ export interface JupiterSwapOptions {
58
+ wrapUnwrapSOL?: boolean;
59
+ feeAccount?: string;
60
+ computeUnitPriceMicroLamports?: number;
61
+ prioritizationFeeLamports?: number;
62
+ asLegacyTransaction?: boolean;
63
+ useSharedAccounts?: boolean;
64
+ dynamicComputeUnitLimit?: boolean;
65
+ }
66
+ export interface JupiterTokenPrice {
67
+ id: string;
68
+ mintSymbol: string;
69
+ vsToken: string;
70
+ price: number;
71
+ }
72
+ /**
73
+ * Jupiter Aggregator V6 Integration
74
+ * Real Jupiter API integration for best swap routes across Solana DEXes
75
+ *
76
+ * @example
77
+ * ```typescript
78
+ * const jupiter = new JupiterIntegration(client);
79
+ *
80
+ * const quote = await jupiter.getQuote({
81
+ * inputMint: 'So11111111111111111111111111111111111111112',
82
+ * outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
83
+ * amount: 1_000_000_000,
84
+ * slippageBps: 50,
85
+ * });
86
+ * ```
87
+ */
88
+ export declare class JupiterIntegration extends EventEmitter {
89
+ private client;
90
+ private baseUrl;
91
+ constructor(client: SynapseClient, customUrl?: string);
92
+ /**
93
+ * Get quote from Jupiter aggregator
94
+ */
95
+ getQuote(params: JupiterQuoteParams): Promise<JupiterQuoteResponse>;
96
+ /**
97
+ * Get swap transaction from Jupiter
98
+ */
99
+ getSwapTransaction(quoteResponse: JupiterQuoteResponse, userPublicKey: string, options?: JupiterSwapOptions): Promise<JupiterSwapResponse>;
100
+ /**
101
+ * Execute complete swap (quote + swap + send)
102
+ */
103
+ executeSwap(params: JupiterQuoteParams, userPublicKey: string, options?: {
104
+ signTransaction?: (tx: VersionedTransaction) => Promise<VersionedTransaction>;
105
+ sendOptions?: {
106
+ skipPreflight?: boolean;
107
+ maxRetries?: number;
108
+ };
109
+ swapOptions?: JupiterSwapOptions;
110
+ }): Promise<{
111
+ signature: string;
112
+ quote: JupiterQuoteResponse;
113
+ success: boolean;
114
+ }>;
115
+ /**
116
+ * Get token price from Jupiter
117
+ */
118
+ getTokenPrice(mintAddress: string, vsToken?: string): Promise<JupiterTokenPrice>;
119
+ /**
120
+ * Get token prices (batch)
121
+ */
122
+ getTokenPrices(mintAddresses: string[], vsToken?: string): Promise<Map<string, JupiterTokenPrice>>;
123
+ /**
124
+ * Get supported tokens list
125
+ */
126
+ getTokenList(): Promise<Array<{
127
+ address: string;
128
+ symbol: string;
129
+ name: string;
130
+ decimals: number;
131
+ logoURI?: string;
132
+ tags?: string[];
133
+ }>>;
134
+ /**
135
+ * Update base URL for custom Jupiter instance
136
+ */
137
+ setBaseUrl(url: string): void;
138
+ /**
139
+ * Get current base URL
140
+ */
141
+ getBaseUrl(): string;
142
+ }
143
+ //# sourceMappingURL=jupiter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jupiter.d.ts","sourceRoot":"","sources":["../../../src/defi/jupiter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,215 @@
1
+ /**
2
+ * @file defi/jupiter.ts
3
+ * @module SolanaDeFi/Jupiter
4
+ * @author Keepeeto
5
+ * @license MIT
6
+ * @description Real Jupiter V6 API integration for best swap routes on Solana.
7
+ * Complete implementation with quote, swap, and price endpoints.
8
+ */
9
+ import { EventEmitter } from 'eventemitter3';
10
+ import { VersionedTransaction } from '@solana/web3.js';
11
+ import { DeFiError } from '../types.js';
12
+ // ============================================================================
13
+ // Jupiter Integration
14
+ // ============================================================================
15
+ /**
16
+ * Jupiter Aggregator V6 Integration
17
+ * Real Jupiter API integration for best swap routes across Solana DEXes
18
+ *
19
+ * @example
20
+ * ```typescript
21
+ * const jupiter = new JupiterIntegration(client);
22
+ *
23
+ * const quote = await jupiter.getQuote({
24
+ * inputMint: 'So11111111111111111111111111111111111111112',
25
+ * outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
26
+ * amount: 1_000_000_000,
27
+ * slippageBps: 50,
28
+ * });
29
+ * ```
30
+ */
31
+ export class JupiterIntegration extends EventEmitter {
32
+ client;
33
+ baseUrl;
34
+ constructor(client, customUrl) {
35
+ super();
36
+ this.client = client;
37
+ this.baseUrl = customUrl || 'https://quote-api.jup.ag/v6';
38
+ }
39
+ /**
40
+ * Get quote from Jupiter aggregator
41
+ */
42
+ async getQuote(params) {
43
+ try {
44
+ this.emit('jupiter-quote-start', params);
45
+ const queryParams = new URLSearchParams({
46
+ inputMint: params.inputMint,
47
+ outputMint: params.outputMint,
48
+ amount: params.amount.toString(),
49
+ slippageBps: (params.slippageBps || 50).toString(),
50
+ swapMode: params.swapMode || 'ExactIn',
51
+ onlyDirectRoutes: params.onlyDirectRoutes ? 'true' : 'false',
52
+ asLegacyTransaction: params.asLegacyTransaction ? 'true' : 'false',
53
+ ...(params.maxAccounts && { maxAccounts: params.maxAccounts.toString() }),
54
+ ...(params.platformFeeBps && { platformFeeBps: params.platformFeeBps.toString() }),
55
+ });
56
+ const response = await fetch(`${this.baseUrl}/quote?${queryParams.toString()}`);
57
+ if (!response.ok) {
58
+ const error = await response.text();
59
+ throw new DeFiError(`Jupiter quote failed: ${response.status} ${error}`, 'quote', 'jupiter');
60
+ }
61
+ const quote = await response.json();
62
+ this.emit('jupiter-quote-complete', {
63
+ inAmount: quote.inAmount,
64
+ outAmount: quote.outAmount,
65
+ priceImpact: quote.priceImpactPct,
66
+ });
67
+ return quote;
68
+ }
69
+ catch (error) {
70
+ this.emit('jupiter-quote-error', error);
71
+ throw new DeFiError(`Jupiter quote failed: ${error.message}`, 'quote', 'jupiter', error);
72
+ }
73
+ }
74
+ /**
75
+ * Get swap transaction from Jupiter
76
+ */
77
+ async getSwapTransaction(quoteResponse, userPublicKey, options) {
78
+ try {
79
+ this.emit('jupiter-swap-tx-start', { user: userPublicKey });
80
+ const response = await fetch(`${this.baseUrl}/swap`, {
81
+ method: 'POST',
82
+ headers: { 'Content-Type': 'application/json' },
83
+ body: JSON.stringify({
84
+ quoteResponse,
85
+ userPublicKey,
86
+ wrapAndUnwrapSol: options?.wrapUnwrapSOL ?? true,
87
+ useSharedAccounts: options?.useSharedAccounts ?? true,
88
+ feeAccount: options?.feeAccount,
89
+ computeUnitPriceMicroLamports: options?.computeUnitPriceMicroLamports,
90
+ prioritizationFeeLamports: options?.prioritizationFeeLamports,
91
+ asLegacyTransaction: options?.asLegacyTransaction ?? false,
92
+ dynamicComputeUnitLimit: options?.dynamicComputeUnitLimit ?? true,
93
+ }),
94
+ });
95
+ if (!response.ok) {
96
+ const error = await response.text();
97
+ throw new DeFiError(`Jupiter swap transaction failed: ${response.status} ${error}`, 'swap', 'jupiter');
98
+ }
99
+ const swapData = await response.json();
100
+ this.emit('jupiter-swap-tx-complete', {
101
+ txSize: swapData.swapTransaction.length,
102
+ priorityFee: swapData.prioritizationFeeLamports,
103
+ });
104
+ return swapData;
105
+ }
106
+ catch (error) {
107
+ this.emit('jupiter-swap-tx-error', error);
108
+ throw new DeFiError(`Jupiter swap transaction failed: ${error.message}`, 'swap', 'jupiter', error);
109
+ }
110
+ }
111
+ /**
112
+ * Execute complete swap (quote + swap + send)
113
+ */
114
+ async executeSwap(params, userPublicKey, options) {
115
+ try {
116
+ // Step 1: Get quote
117
+ const quote = await this.getQuote(params);
118
+ // Step 2: Get swap transaction
119
+ const swapData = await this.getSwapTransaction(quote, userPublicKey, options?.swapOptions);
120
+ // Step 3: Deserialize and sign transaction
121
+ const txBuffer = Buffer.from(swapData.swapTransaction, 'base64');
122
+ let transaction = VersionedTransaction.deserialize(txBuffer);
123
+ if (options?.signTransaction) {
124
+ transaction = await options.signTransaction(transaction);
125
+ }
126
+ else {
127
+ throw new DeFiError('signTransaction callback required for executeSwap', 'swap', 'jupiter');
128
+ }
129
+ // Step 4: Send transaction via Synapse RPC
130
+ const signature = await this.client.call('sendTransaction', [
131
+ Buffer.from(transaction.serialize()).toString('base64'),
132
+ {
133
+ skipPreflight: options?.sendOptions?.skipPreflight ?? false,
134
+ maxRetries: options?.sendOptions?.maxRetries ?? 3,
135
+ encoding: 'base64',
136
+ },
137
+ ]);
138
+ this.emit('jupiter-swap-complete', { signature });
139
+ return {
140
+ signature,
141
+ quote,
142
+ success: true,
143
+ };
144
+ }
145
+ catch (error) {
146
+ this.emit('jupiter-swap-error', error);
147
+ throw new DeFiError(`Jupiter swap execution failed: ${error.message}`, 'swap', 'jupiter', error);
148
+ }
149
+ }
150
+ /**
151
+ * Get token price from Jupiter
152
+ */
153
+ async getTokenPrice(mintAddress, vsToken = 'USDC') {
154
+ try {
155
+ const response = await fetch(`https://price.jup.ag/v4/price?ids=${mintAddress}&vsToken=${vsToken}`);
156
+ if (!response.ok) {
157
+ throw new Error(`Price API failed: ${response.status}`);
158
+ }
159
+ const data = await response.json();
160
+ return data.data[mintAddress];
161
+ }
162
+ catch (error) {
163
+ throw new DeFiError(`Failed to get token price: ${error.message}`, 'quote', 'jupiter', error);
164
+ }
165
+ }
166
+ /**
167
+ * Get token prices (batch)
168
+ */
169
+ async getTokenPrices(mintAddresses, vsToken = 'USDC') {
170
+ try {
171
+ const ids = mintAddresses.join(',');
172
+ const response = await fetch(`https://price.jup.ag/v4/price?ids=${ids}&vsToken=${vsToken}`);
173
+ if (!response.ok) {
174
+ throw new Error(`Price API failed: ${response.status}`);
175
+ }
176
+ const data = await response.json();
177
+ const priceMap = new Map();
178
+ for (const [mint, priceInfo] of Object.entries(data.data)) {
179
+ priceMap.set(mint, priceInfo);
180
+ }
181
+ return priceMap;
182
+ }
183
+ catch (error) {
184
+ throw new DeFiError(`Failed to get token prices: ${error.message}`, 'quote', 'jupiter', error);
185
+ }
186
+ }
187
+ /**
188
+ * Get supported tokens list
189
+ */
190
+ async getTokenList() {
191
+ try {
192
+ const response = await fetch('https://token.jup.ag/all');
193
+ if (!response.ok) {
194
+ throw new Error(`Token list API failed: ${response.status}`);
195
+ }
196
+ return await response.json();
197
+ }
198
+ catch (error) {
199
+ throw new DeFiError(`Failed to get token list: ${error.message}`, 'quote', 'jupiter', error);
200
+ }
201
+ }
202
+ /**
203
+ * Update base URL for custom Jupiter instance
204
+ */
205
+ setBaseUrl(url) {
206
+ this.baseUrl = url;
207
+ }
208
+ /**
209
+ * Get current base URL
210
+ */
211
+ getBaseUrl() {
212
+ return this.baseUrl;
213
+ }
214
+ }
215
+ //# sourceMappingURL=jupiter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jupiter.js","sourceRoot":"","sources":["../../../src/defi/jupiter.ts"],"names":[],"mappings":"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"}