@xochi/widget 0.0.0-stage → 0.1.1

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 (585) hide show
  1. package/CHANGELOG.md +79 -0
  2. package/LICENSE +21 -0
  3. package/README.md +420 -2
  4. package/THIRD_PARTY_NOTICES.txt +44 -0
  5. package/dist/ConfiguratorApp.js +19 -0
  6. package/dist/EmbedApp.js +57 -0
  7. package/dist/assets/MonaspaceArgon-Bold-D9kWRRK5.woff2 +0 -0
  8. package/dist/assets/MonaspaceArgon-Light-Dt_6qXbW.woff2 +0 -0
  9. package/dist/assets/MonaspaceArgon-Medium-B1gMZwrU.woff2 +0 -0
  10. package/dist/assets/MonaspaceArgon-Regular-RS-2TGNg.woff2 +0 -0
  11. package/dist/assets/MonaspaceArgon-SemiBold-PYusZXE_.woff2 +0 -0
  12. package/dist/assets/MonaspaceNeon-Italic-C9u9eioB.woff2 +0 -0
  13. package/dist/assets/MonaspaceNeon-Light-CJkxpyfT.woff2 +0 -0
  14. package/dist/assets/MonaspaceNeon-Medium-DCChELAx.woff2 +0 -0
  15. package/dist/assets/MonaspaceNeon-Regular-BZtV1wRa.woff2 +0 -0
  16. package/dist/assets/MonaspaceXenon-Bold-KacFhGOf.woff2 +0 -0
  17. package/dist/assets/MonaspaceXenon-Medium-Dqqg-cnL.woff2 +0 -0
  18. package/dist/assets/MonaspaceXenon-Regular-BRsdKART.woff2 +0 -0
  19. package/dist/assets/MonaspaceXenon-SemiBold-DNjPl3uE.woff2 +0 -0
  20. package/dist/assets/alipay-3tx9-HPp.svg +1 -0
  21. package/dist/assets/arb-CCfLcB_X.svg +7 -0
  22. package/dist/assets/arc-Dy98eSCd.svg +10 -0
  23. package/dist/assets/aztec-DiLp9qTG.svg +4 -0
  24. package/dist/assets/base-Ch0ino36.svg +4 -0
  25. package/dist/assets/cashapp-lOg0DIt8.svg +1 -0
  26. package/dist/assets/chains/arbitrum.svg.js +4 -0
  27. package/dist/assets/chains/arc.svg.js +4 -0
  28. package/dist/assets/chains/aztec.svg.js +4 -0
  29. package/dist/assets/chains/base.svg.js +4 -0
  30. package/dist/assets/chains/ethereum.svg.js +4 -0
  31. package/dist/assets/chains/gnosis.png.js +4 -0
  32. package/dist/assets/chains/index.js +31 -0
  33. package/dist/assets/chains/optimism.svg.js +4 -0
  34. package/dist/assets/chains/polygon.svg.js +4 -0
  35. package/dist/assets/chains/robinhood.svg.js +4 -0
  36. package/dist/assets/chains/tron.svg.js +4 -0
  37. package/dist/assets/chains/xochi.svg.js +4 -0
  38. package/dist/assets/dai-XuyZLceZ.png +0 -0
  39. package/dist/assets/defillama-BU037Unq.svg +1 -0
  40. package/dist/assets/defillama.svg.js +4 -0
  41. package/dist/assets/eth-Dvbng9UB.svg +8 -0
  42. package/dist/assets/eurc-NI9zNgOQ.png +0 -0
  43. package/dist/assets/eure-BH9vpwcv.png +0 -0
  44. package/dist/assets/gnosis-fRzAZQFj.png +0 -0
  45. package/dist/assets/mercadopago-gjsFb6F7.svg +1 -0
  46. package/dist/assets/monzo-B9XD4bL5.png +0 -0
  47. package/dist/assets/monzo-SZnIdUKN.svg +1 -0
  48. package/dist/assets/monzo-dark-Bwzg90UC.png +0 -0
  49. package/dist/assets/n26-cANcjY2T.svg +1 -0
  50. package/dist/assets/op-DF67SbB6.png +0 -0
  51. package/dist/assets/optimism-B3cTNxEQ.svg +4 -0
  52. package/dist/assets/paypal-D8xqXEtN.svg +1 -0
  53. package/dist/assets/pol-uLmSo2O8.svg +3 -0
  54. package/dist/assets/rails/SOURCES.md +50 -0
  55. package/dist/assets/rails/alipay.svg.js +4 -0
  56. package/dist/assets/rails/cashapp.svg.js +4 -0
  57. package/dist/assets/rails/index.js +59 -0
  58. package/dist/assets/rails/mercadopago.svg.js +4 -0
  59. package/dist/assets/rails/monzo-dark.png.js +4 -0
  60. package/dist/assets/rails/monzo.png.js +4 -0
  61. package/dist/assets/rails/monzo.svg.js +4 -0
  62. package/dist/assets/rails/n26.svg.js +4 -0
  63. package/dist/assets/rails/paypal.svg.js +4 -0
  64. package/dist/assets/rails/revolut-dark.png.js +4 -0
  65. package/dist/assets/rails/revolut.png.js +4 -0
  66. package/dist/assets/rails/revolut.svg.js +4 -0
  67. package/dist/assets/rails/venmo.svg.js +4 -0
  68. package/dist/assets/rails/wise-dark.png.js +4 -0
  69. package/dist/assets/rails/wise.png.js +4 -0
  70. package/dist/assets/rails/wise.svg.js +4 -0
  71. package/dist/assets/rails/xmoney.svg.js +4 -0
  72. package/dist/assets/rails/zelle.svg.js +4 -0
  73. package/dist/assets/raxol-86FmC34h.png +0 -0
  74. package/dist/assets/revolut-CiBtyALA.png +0 -0
  75. package/dist/assets/revolut-D7qr5Vzs.svg +1 -0
  76. package/dist/assets/revolut-dark-RQdWGM_p.png +0 -0
  77. package/dist/assets/robinhood-DgdGTQ1I.svg +8 -0
  78. package/dist/assets/tokens/arb.svg.js +4 -0
  79. package/dist/assets/tokens/dai.png.js +4 -0
  80. package/dist/assets/tokens/eth.svg.js +4 -0
  81. package/dist/assets/tokens/eurc.png.js +4 -0
  82. package/dist/assets/tokens/eure.png.js +4 -0
  83. package/dist/assets/tokens/index.js +36 -0
  84. package/dist/assets/tokens/op.png.js +4 -0
  85. package/dist/assets/tokens/pol.svg.js +4 -0
  86. package/dist/assets/tokens/raxol.png.js +4 -0
  87. package/dist/assets/tokens/usdc.png.js +4 -0
  88. package/dist/assets/tokens/usdg.png.js +4 -0
  89. package/dist/assets/tokens/usdt.png.js +4 -0
  90. package/dist/assets/tokens/wbtc.png.js +4 -0
  91. package/dist/assets/tokens/wsteth.png.js +4 -0
  92. package/dist/assets/tokens/zchf.png.js +4 -0
  93. package/dist/assets/tron-Dtumyzha.svg +4 -0
  94. package/dist/assets/usdc-UHSd0FoM.png +0 -0
  95. package/dist/assets/usdg-Cd5nCzbC.png +0 -0
  96. package/dist/assets/usdt-3G3YdPq8.png +0 -0
  97. package/dist/assets/venmo-CMHeCn-D.svg +1 -0
  98. package/dist/assets/wbtc-CV8uE44Q.png +0 -0
  99. package/dist/assets/wise-BUOflsWL.svg +1 -0
  100. package/dist/assets/wise-JLpDvCdq.png +0 -0
  101. package/dist/assets/wise-dark-_Q8pbCom.png +0 -0
  102. package/dist/assets/wsteth-BamwtTCR.png +0 -0
  103. package/dist/assets/xmoney-CwY9KVlD.svg +1 -0
  104. package/dist/assets/xochi-DL2f8G4R.svg +4 -0
  105. package/dist/assets/zchf-BLBNdTGJ.png +0 -0
  106. package/dist/assets/zelle-t15cG4SB.svg +1 -0
  107. package/dist/browser.js +4 -0
  108. package/dist/components/AccountChip.js +29 -0
  109. package/dist/components/ActivityFeed.js +710 -0
  110. package/dist/components/AssetsStrip.js +133 -0
  111. package/dist/components/AuthorizedAgents.js +197 -0
  112. package/dist/components/Chevron.js +22 -0
  113. package/dist/components/ErrorDisplay.js +68 -0
  114. package/dist/components/InfoButton.js +27 -0
  115. package/dist/components/IntentTimeline.js +202 -0
  116. package/dist/components/LinksSignIn.js +26 -0
  117. package/dist/components/MobileSigningBanner.js +44 -0
  118. package/dist/components/PrivacyBars.js +44 -0
  119. package/dist/components/PrivacyPanel.js +99 -0
  120. package/dist/components/QuoteDetails.js +327 -0
  121. package/dist/components/ReceiptCommand.js +46 -0
  122. package/dist/components/SessionReloadBanner.js +19 -0
  123. package/dist/components/SolverRace.js +62 -0
  124. package/dist/components/StealthClaims.js +179 -0
  125. package/dist/components/SwapFlowModal.js +408 -0
  126. package/dist/components/Toast.js +40 -0
  127. package/dist/components/TokenIcon.js +21 -0
  128. package/dist/components/TokenSearchModal.js +331 -0
  129. package/dist/components/TransactionPreview.js +230 -0
  130. package/dist/components/WalletProvider.js +41 -0
  131. package/dist/components/WrapModal.js +192 -0
  132. package/dist/components/swap-flow/CantonEscrowPanel.js +28 -0
  133. package/dist/components/swap-flow/CantonEscrowStatus.js +160 -0
  134. package/dist/components/swap-flow/DepositInstructions.js +156 -0
  135. package/dist/components/swap-flow/QrCode.js +22 -0
  136. package/dist/components/swap-flow/SwapResult.js +325 -0
  137. package/dist/components/swap-flow/depositScreen.js +36 -0
  138. package/dist/components/widgetTabsContext.js +17 -0
  139. package/dist/config.js +132 -0
  140. package/dist/configurator-model.js +71 -0
  141. package/dist/configurator.js +11 -0
  142. package/dist/constants.js +53 -0
  143. package/dist/hooks/applyTheme.js +10 -0
  144. package/dist/hooks/useAgentRegistry.js +28 -0
  145. package/dist/hooks/useAgentStream.js +89 -0
  146. package/dist/hooks/useCantonEscrow.js +89 -0
  147. package/dist/hooks/useCapabilities.js +86 -0
  148. package/dist/hooks/useEmbedLook.js +23 -0
  149. package/dist/hooks/useFocusTrap.js +44 -0
  150. package/dist/hooks/useIntent.js +485 -0
  151. package/dist/hooks/useIntentStatusPoll.js +71 -0
  152. package/dist/hooks/useIntentStream.js +95 -0
  153. package/dist/hooks/useLocalActivity.js +114 -0
  154. package/dist/hooks/useLocalSends.js +15 -0
  155. package/dist/hooks/useLocalStorage.js +26 -0
  156. package/dist/hooks/useOrderHistory.js +307 -0
  157. package/dist/hooks/usePermit.js +203 -0
  158. package/dist/hooks/usePrices.js +49 -0
  159. package/dist/hooks/usePublicBalances.js +186 -0
  160. package/dist/hooks/useRampSummaries.js +19 -0
  161. package/dist/hooks/useRecipientBalance.js +98 -0
  162. package/dist/hooks/useSettlements.js +33 -0
  163. package/dist/hooks/useStealth.js +324 -0
  164. package/dist/hooks/useStealthClaim.js +183 -0
  165. package/dist/hooks/useStealthScanner.js +259 -0
  166. package/dist/hooks/useTheme.js +48 -0
  167. package/dist/hooks/useTierInfo.js +20 -0
  168. package/dist/hooks/useTrustScore.js +16 -0
  169. package/dist/hooks/useWalletSession.js +70 -0
  170. package/dist/hooks/useWrapEth.js +60 -0
  171. package/dist/index.js +41 -0
  172. package/dist/integration.js +19 -0
  173. package/dist/lib/activityValue.js +20 -0
  174. package/dist/lib/agentConnect.js +11 -0
  175. package/dist/lib/agentRegistry.js +83 -0
  176. package/dist/lib/agentStreamVerify.js +47 -0
  177. package/dist/lib/api.js +67 -0
  178. package/dist/lib/auth.js +8 -0
  179. package/dist/lib/authFetch.js +33 -0
  180. package/dist/lib/aztecTokens.js +13 -0
  181. package/dist/lib/balances.js +77 -0
  182. package/dist/lib/capabilities.js +40 -0
  183. package/dist/lib/claimSubmitPoll.js +63 -0
  184. package/dist/lib/debug.js +7 -0
  185. package/dist/lib/declineGuidance.js +31 -0
  186. package/dist/lib/displayFallbacks.js +25 -0
  187. package/dist/lib/eip712.js +38 -0
  188. package/dist/lib/errorCategory.js +202 -0
  189. package/dist/lib/errorReport.js +19 -0
  190. package/dist/lib/explorerLinks.js +30 -0
  191. package/dist/lib/feesLabel.js +19 -0
  192. package/dist/lib/glyphs.js +58 -0
  193. package/dist/lib/hostBridge.js +41 -0
  194. package/dist/lib/hostOrigin.js +52 -0
  195. package/dist/lib/intentAPI.js +39 -0
  196. package/dist/lib/linksSignIn.js +9 -0
  197. package/dist/lib/localActivity.js +247 -0
  198. package/dist/lib/localSends.js +129 -0
  199. package/dist/lib/mobileWallet.js +17 -0
  200. package/dist/lib/pairAvailability.js +29 -0
  201. package/dist/lib/paymentSummary.js +23 -0
  202. package/dist/lib/permits.js +27 -0
  203. package/dist/lib/priceImpact.js +101 -0
  204. package/dist/lib/providers.js +124 -0
  205. package/dist/lib/qr.js +20 -0
  206. package/dist/lib/quoteCost.js +34 -0
  207. package/dist/lib/quoteCountdown.js +24 -0
  208. package/dist/lib/rampHostGate.js +24 -0
  209. package/dist/lib/rampLifecycle.js +63 -0
  210. package/dist/lib/receiptCost.js +64 -0
  211. package/dist/lib/recipient/index.js +302 -0
  212. package/dist/lib/recipient/recent.js +47 -0
  213. package/dist/lib/recipientReceipt.js +16 -0
  214. package/dist/lib/reportClient.js +32 -0
  215. package/dist/lib/sessionExpiry.js +11 -0
  216. package/dist/lib/settlementAvailability.js +34 -0
  217. package/dist/lib/stealth.js +110 -0
  218. package/dist/lib/swapFlowPhase.js +52 -0
  219. package/dist/lib/swapStatusCopy.js +59 -0
  220. package/dist/lib/tradeLifecycle.js +40 -0
  221. package/dist/lib/tronlink.js +71 -0
  222. package/dist/lib/walletSession.js +87 -0
  223. package/dist/pages/Configurator.js +390 -0
  224. package/dist/pages/Trade.js +635 -0
  225. package/dist/pages/configurator/AllowedAssetsSection.js +98 -0
  226. package/dist/pages/configurator/AppearanceSection.js +44 -0
  227. package/dist/pages/configurator/CodeDock.js +140 -0
  228. package/dist/pages/configurator/DeveloperSection.js +40 -0
  229. package/dist/pages/configurator/IntegrationSection.js +105 -0
  230. package/dist/pages/configurator/LayoutSection.js +83 -0
  231. package/dist/pages/configurator/PolicyNote.js +7 -0
  232. package/dist/pages/configurator/PreviewStage.js +165 -0
  233. package/dist/pages/configurator/PrivacySection.js +54 -0
  234. package/dist/pages/configurator/RouteSection.js +211 -0
  235. package/dist/pages/configurator/Settings.js +35 -0
  236. package/dist/pages/configurator/SharedLinkBanner.js +25 -0
  237. package/dist/pages/configurator/SurfaceSection.js +124 -0
  238. package/dist/pages/configurator/WhatUsersSee.js +268 -0
  239. package/dist/pages/configurator/codeShown.js +8 -0
  240. package/dist/pages/configurator/configuratorUrl.js +33 -0
  241. package/dist/pages/configurator/paramsDraft.js +82 -0
  242. package/dist/pages/configurator/previewModel.js +10 -0
  243. package/dist/pages/configurator/previewQuote.js +109 -0
  244. package/dist/pages/configurator/routePicks.js +131 -0
  245. package/dist/pages/configurator/snippets.js +98 -0
  246. package/dist/pages/configurator/surfaceParams.js +51 -0
  247. package/dist/pages/configurator/useCodeCheck.js +79 -0
  248. package/dist/pages/configurator/useConfiguratorUrl.js +24 -0
  249. package/dist/pages/configurator/useMediaQuery.js +20 -0
  250. package/dist/pages/configurator/useParamsDraft.js +33 -0
  251. package/dist/pages/configurator/usePreviewFee.js +100 -0
  252. package/dist/pages/send/MetaAddressValue.js +28 -0
  253. package/dist/pages/send/Receive.js +168 -0
  254. package/dist/pages/send/RecentRecipients.js +23 -0
  255. package/dist/pages/send/RecipientChip.js +26 -0
  256. package/dist/pages/send/ScanRecipient.js +85 -0
  257. package/dist/pages/send/SendForm.js +516 -0
  258. package/dist/pages/send/SendPanel.js +30 -0
  259. package/dist/pages/send/ShieldedDisclosure.js +12 -0
  260. package/dist/pages/send/StealthInvite.js +27 -0
  261. package/dist/pages/send/addressSend.js +92 -0
  262. package/dist/pages/send/sendCopy.js +10 -0
  263. package/dist/pages/send/sendRetry.js +24 -0
  264. package/dist/pages/send/stealthRecipient.js +65 -0
  265. package/dist/pages/send/stealthSend.js +15 -0
  266. package/dist/pages/send/useAddressSend.js +257 -0
  267. package/dist/pages/send/useSendRecipient.js +61 -0
  268. package/dist/pages/trade/BuyPanel.js +70 -0
  269. package/dist/pages/trade/RampRecovery.js +41 -0
  270. package/dist/pages/trade/RecipientSheet.js +182 -0
  271. package/dist/pages/trade/Selectors.js +152 -0
  272. package/dist/pages/trade/SwapPanel.js +972 -0
  273. package/dist/pages/trade/WidgetTabs.js +109 -0
  274. package/dist/pages/trade/canton.js +122 -0
  275. package/dist/pages/trade/config.js +70 -0
  276. package/dist/pages/trade/embedNarrowing.js +25 -0
  277. package/dist/pages/trade/embedParams.js +532 -0
  278. package/dist/pages/trade/embedTheme.js +9 -0
  279. package/dist/pages/trade/orderMinimum.js +8 -0
  280. package/dist/pages/trade/resumeSwap.js +55 -0
  281. package/dist/pages/trade/settlementCopy.js +32 -0
  282. package/dist/pages/trade/useAmountFit.js +31 -0
  283. package/dist/pages/trade/useEmbedDefaults.js +18 -0
  284. package/dist/pages/trade/useSettlementGating.js +289 -0
  285. package/dist/pages/trade/useSwapAmount.js +191 -0
  286. package/dist/pages/trade/useSwapFlow.js +511 -0
  287. package/dist/pages/trade/useSwapPanel.js +475 -0
  288. package/dist/pages/trade/useSwapRoute.js +634 -0
  289. package/dist/pages/trade/useTronLinkFill.js +34 -0
  290. package/dist/pages/trade/zkMoney.js +46 -0
  291. package/dist/promiseWithResolvers.js +20 -0
  292. package/dist/ramp/availability/RailTiles.js +156 -0
  293. package/dist/ramp/availability/RampDisclosure.js +38 -0
  294. package/dist/ramp/availability/RampRails.js +170 -0
  295. package/dist/ramp/availability/model.js +207 -0
  296. package/dist/ramp/availability/useRampDiscovery.js +83 -0
  297. package/dist/ramp/offramp/CompletedPrerequisite.js +23 -0
  298. package/dist/ramp/offramp/OfframpActivityList.js +16 -0
  299. package/dist/ramp/offramp/OfframpRoute.js +222 -0
  300. package/dist/ramp/offramp/OfframpRouteReview.js +94 -0
  301. package/dist/ramp/offramp/PaymentAppSend.js +765 -0
  302. package/dist/ramp/offramp/localOfframps.js +101 -0
  303. package/dist/ramp/offramp/model.js +154 -0
  304. package/dist/ramp/offramp/port.js +134 -0
  305. package/dist/ramp/offramp/prerequisite.js +143 -0
  306. package/dist/ramp/offramp/useOfframp.js +505 -0
  307. package/dist/ramp/offramp/useOfframpRails.js +73 -0
  308. package/dist/ramp/peer/BuyOnramp.js +292 -0
  309. package/dist/ramp/peer/OnrampSteps.js +148 -0
  310. package/dist/ramp/peer/buyerDriver.js +461 -0
  311. package/dist/ramp/peer/discovery.js +231 -0
  312. package/dist/ramp/peer/environment.js +7 -0
  313. package/dist/ramp/peer/liveProvider.js +87 -0
  314. package/dist/ramp/peer/liveReads.js +488 -0
  315. package/dist/ramp/peer/maker.js +92 -0
  316. package/dist/ramp/peer/normalization.js +184 -0
  317. package/dist/ramp/peer/offramp.js +648 -0
  318. package/dist/ramp/peer/onramp.js +353 -0
  319. package/dist/ramp/peer/preview.js +52 -0
  320. package/dist/ramp/peer/protectedMapping.js +67 -0
  321. package/dist/ramp/peer/runtime.js +55 -0
  322. package/dist/ramp/peer/sdkMaker.js +107 -0
  323. package/dist/ramp/recovery/ResumeOnramp.js +153 -0
  324. package/dist/ramp/recovery/summaries.js +173 -0
  325. package/dist/ramp/route/OnrampRoute.js +255 -0
  326. package/dist/ramp/route/RampRouteSteps.js +148 -0
  327. package/dist/ramp/route/routeActivity.js +12 -0
  328. package/dist/ramp/route/useXochiRampDriver.js +203 -0
  329. package/dist/styles.css +17473 -0
  330. package/dist/styles.js +2 -0
  331. package/dist/types/ConfiguratorApp.d.ts +6 -0
  332. package/dist/types/EmbedApp.d.ts +2 -0
  333. package/dist/types/activity.js +50 -0
  334. package/dist/types/asset.d.ts +2 -0
  335. package/dist/types/assets/chains/index.d.ts +3 -0
  336. package/dist/types/assets/rails/index.d.ts +12 -0
  337. package/dist/types/assets/tokens/index.d.ts +1 -0
  338. package/dist/types/browser.d.ts +1 -0
  339. package/dist/types/components/AccountChip.d.ts +10 -0
  340. package/dist/types/components/ActivityFeed.d.ts +46 -0
  341. package/dist/types/components/AssetsStrip.d.ts +14 -0
  342. package/dist/types/components/AuthorizedAgents.d.ts +15 -0
  343. package/dist/types/components/Chevron.d.ts +16 -0
  344. package/dist/types/components/ErrorDisplay.d.ts +46 -0
  345. package/dist/types/components/InfoButton.d.ts +6 -0
  346. package/dist/types/components/IntentTimeline.d.ts +41 -0
  347. package/dist/types/components/LinksSignIn.d.ts +13 -0
  348. package/dist/types/components/MobileSigningBanner.d.ts +16 -0
  349. package/dist/types/components/PermitBadge.d.ts +17 -0
  350. package/dist/types/components/PrivacyBars.d.ts +12 -0
  351. package/dist/types/components/PrivacyPanel.d.ts +33 -0
  352. package/dist/types/components/QuoteDetails.d.ts +56 -0
  353. package/dist/types/components/RampActivityList.d.ts +14 -0
  354. package/dist/types/components/ReceiptCommand.d.ts +12 -0
  355. package/dist/types/components/SessionReloadBanner.d.ts +8 -0
  356. package/dist/types/components/SolverRace.d.ts +35 -0
  357. package/dist/types/components/StealthClaims.d.ts +51 -0
  358. package/dist/types/components/SwapFlowModal.d.ts +142 -0
  359. package/dist/types/components/Toast.d.ts +10 -0
  360. package/dist/types/components/TokenIcon.d.ts +17 -0
  361. package/dist/types/components/TokenSearchModal.d.ts +28 -0
  362. package/dist/types/components/TransactionPreview.d.ts +37 -0
  363. package/dist/types/components/WalletProvider.d.ts +12 -0
  364. package/dist/types/components/WrapModal.d.ts +19 -0
  365. package/dist/types/components/swap-flow/CantonEscrowPanel.d.ts +14 -0
  366. package/dist/types/components/swap-flow/CantonEscrowStatus.d.ts +30 -0
  367. package/dist/types/components/swap-flow/DepositInstructions.d.ts +75 -0
  368. package/dist/types/components/swap-flow/QrCode.d.ts +18 -0
  369. package/dist/types/components/swap-flow/SwapResult.d.ts +68 -0
  370. package/dist/types/components/swap-flow/depositScreen.d.ts +67 -0
  371. package/dist/types/components/widgetTabsContext.d.ts +21 -0
  372. package/dist/types/config.d.ts +104 -0
  373. package/dist/types/configurator-model.d.ts +9 -0
  374. package/dist/types/configurator.d.ts +3 -0
  375. package/dist/types/constants.d.ts +52 -0
  376. package/dist/types/hooks/applyTheme.d.ts +7 -0
  377. package/dist/types/hooks/useAgentRegistry.d.ts +13 -0
  378. package/dist/types/hooks/useAgentStream.d.ts +15 -0
  379. package/dist/types/hooks/useCantonEscrow.d.ts +40 -0
  380. package/dist/types/hooks/useCapabilities.d.ts +83 -0
  381. package/dist/types/hooks/useEmbedLook.d.ts +4 -0
  382. package/dist/types/hooks/useFocusTrap.d.ts +7 -0
  383. package/dist/types/hooks/useIntent.d.ts +161 -0
  384. package/dist/types/hooks/useIntentStatusPoll.d.ts +107 -0
  385. package/dist/types/hooks/useIntentStream.d.ts +34 -0
  386. package/dist/types/hooks/useLocalActivity.d.ts +22 -0
  387. package/dist/types/hooks/useLocalSends.d.ts +8 -0
  388. package/dist/types/hooks/useLocalStorage.d.ts +8 -0
  389. package/dist/types/hooks/useOrderHistory.d.ts +52 -0
  390. package/dist/types/hooks/usePermit.d.ts +90 -0
  391. package/dist/types/hooks/usePrices.d.ts +72 -0
  392. package/dist/types/hooks/usePublicBalances.d.ts +19 -0
  393. package/dist/types/hooks/useRampSummaries.d.ts +9 -0
  394. package/dist/types/hooks/useRecipientBalance.d.ts +58 -0
  395. package/dist/types/hooks/useSettlements.d.ts +14 -0
  396. package/dist/types/hooks/useStealth.d.ts +72 -0
  397. package/dist/types/hooks/useStealthClaim.d.ts +96 -0
  398. package/dist/types/hooks/useStealthScanner.d.ts +44 -0
  399. package/dist/types/hooks/useTheme.d.ts +29 -0
  400. package/dist/types/hooks/useTierInfo.d.ts +23 -0
  401. package/dist/types/hooks/useTrustScore.d.ts +16 -0
  402. package/dist/types/hooks/useWalletSession.d.ts +21 -0
  403. package/dist/types/hooks/useWrapEth.d.ts +21 -0
  404. package/dist/types/index.d.ts +6 -0
  405. package/dist/types/index.js +8 -0
  406. package/dist/types/integration.d.ts +9 -0
  407. package/dist/types/intent.js +85 -0
  408. package/dist/types/lib/activityValue.d.ts +16 -0
  409. package/dist/types/lib/agentConnect.d.ts +23 -0
  410. package/dist/types/lib/agentRegistry.d.ts +47 -0
  411. package/dist/types/lib/agentStreamVerify.d.ts +29 -0
  412. package/dist/types/lib/api.d.ts +41 -0
  413. package/dist/types/lib/auth.d.ts +6 -0
  414. package/dist/types/lib/authFetch.d.ts +14 -0
  415. package/dist/types/lib/aztecTokens.d.ts +15 -0
  416. package/dist/types/lib/balances.d.ts +88 -0
  417. package/dist/types/lib/capabilities.d.ts +3 -0
  418. package/dist/types/lib/claimSubmitPoll.d.ts +114 -0
  419. package/dist/types/lib/debug.d.ts +13 -0
  420. package/dist/types/lib/declineGuidance.d.ts +55 -0
  421. package/dist/types/lib/displayFallbacks.d.ts +7 -0
  422. package/dist/types/lib/eip712.d.ts +61 -0
  423. package/dist/types/lib/errorCategory.d.ts +50 -0
  424. package/dist/types/lib/errorReport.d.ts +15 -0
  425. package/dist/types/lib/explorerLinks.d.ts +67 -0
  426. package/dist/types/lib/feesLabel.d.ts +20 -0
  427. package/dist/types/lib/glyphs.d.ts +52 -0
  428. package/dist/types/lib/hostBridge.d.ts +11 -0
  429. package/dist/types/lib/hostOrigin.d.ts +30 -0
  430. package/dist/types/lib/intentAPI.d.ts +15 -0
  431. package/dist/types/lib/linksSignIn.d.ts +13 -0
  432. package/dist/types/lib/localActivity.d.ts +135 -0
  433. package/dist/types/lib/localSends.d.ts +55 -0
  434. package/dist/types/lib/mobileWallet.d.ts +27 -0
  435. package/dist/types/lib/pairAvailability.d.ts +106 -0
  436. package/dist/types/lib/paymentSummary.d.ts +18 -0
  437. package/dist/types/lib/permits.d.ts +25 -0
  438. package/dist/types/lib/priceImpact.d.ts +165 -0
  439. package/dist/types/lib/providers.d.ts +14 -0
  440. package/dist/types/lib/qr.d.ts +19 -0
  441. package/dist/types/lib/quoteCost.d.ts +45 -0
  442. package/dist/types/lib/quoteCountdown.d.ts +34 -0
  443. package/dist/types/lib/rampHostGate.d.ts +15 -0
  444. package/dist/types/lib/rampLifecycle.d.ts +20 -0
  445. package/dist/types/lib/receiptCost.d.ts +64 -0
  446. package/dist/types/lib/recipient/index.d.ts +33 -0
  447. package/dist/types/lib/recipient/recent.d.ts +5 -0
  448. package/dist/types/lib/recipientReceipt.d.ts +25 -0
  449. package/dist/types/lib/reportClient.d.ts +9 -0
  450. package/dist/types/lib/sessionExpiry.d.ts +11 -0
  451. package/dist/types/lib/settlementAvailability.d.ts +61 -0
  452. package/dist/types/lib/stealth.d.ts +75 -0
  453. package/dist/types/lib/swapFlowPhase.d.ts +76 -0
  454. package/dist/types/lib/swapStatusCopy.d.ts +57 -0
  455. package/dist/types/lib/tierProgressDisplay.d.ts +35 -0
  456. package/dist/types/lib/tierUnlock.d.ts +25 -0
  457. package/dist/types/lib/tradeLifecycle.d.ts +32 -0
  458. package/dist/types/lib/tronlink.d.ts +62 -0
  459. package/dist/types/lib/walletSession.d.ts +38 -0
  460. package/dist/types/pages/Configurator.d.ts +25 -0
  461. package/dist/types/pages/Trade.d.ts +36 -0
  462. package/dist/types/pages/configurator/AllowedAssetsSection.d.ts +17 -0
  463. package/dist/types/pages/configurator/AppearanceSection.d.ts +22 -0
  464. package/dist/types/pages/configurator/CodeDock.d.ts +19 -0
  465. package/dist/types/pages/configurator/DeveloperSection.d.ts +12 -0
  466. package/dist/types/pages/configurator/IntegrationSection.d.ts +20 -0
  467. package/dist/types/pages/configurator/LayoutSection.d.ts +20 -0
  468. package/dist/types/pages/configurator/PolicyNote.d.ts +6 -0
  469. package/dist/types/pages/configurator/PreviewStage.d.ts +22 -0
  470. package/dist/types/pages/configurator/PrivacySection.d.ts +16 -0
  471. package/dist/types/pages/configurator/RouteSection.d.ts +30 -0
  472. package/dist/types/pages/configurator/Settings.d.ts +25 -0
  473. package/dist/types/pages/configurator/SharedLinkBanner.d.ts +16 -0
  474. package/dist/types/pages/configurator/SurfaceSection.d.ts +5 -0
  475. package/dist/types/pages/configurator/WhatUsersSee.d.ts +30 -0
  476. package/dist/types/pages/configurator/codeShown.d.ts +15 -0
  477. package/dist/types/pages/configurator/configuratorUrl.d.ts +38 -0
  478. package/dist/types/pages/configurator/paramsDraft.d.ts +32 -0
  479. package/dist/types/pages/configurator/previewModel.d.ts +20 -0
  480. package/dist/types/pages/configurator/previewQuote.d.ts +96 -0
  481. package/dist/types/pages/configurator/routePicks.d.ts +75 -0
  482. package/dist/types/pages/configurator/snippets.d.ts +23 -0
  483. package/dist/types/pages/configurator/surfaceParams.d.ts +9 -0
  484. package/dist/types/pages/configurator/useCodeCheck.d.ts +56 -0
  485. package/dist/types/pages/configurator/useConfiguratorUrl.d.ts +21 -0
  486. package/dist/types/pages/configurator/useMediaQuery.d.ts +5 -0
  487. package/dist/types/pages/configurator/useParamsDraft.d.ts +29 -0
  488. package/dist/types/pages/configurator/usePreviewFee.d.ts +74 -0
  489. package/dist/types/pages/send/MetaAddressValue.d.ts +9 -0
  490. package/dist/types/pages/send/Receive.d.ts +3 -0
  491. package/dist/types/pages/send/RecentRecipients.d.ts +3 -0
  492. package/dist/types/pages/send/RecipientChip.d.ts +4 -0
  493. package/dist/types/pages/send/ScanRecipient.d.ts +3 -0
  494. package/dist/types/pages/send/SendForm.d.ts +17 -0
  495. package/dist/types/pages/send/SendPanel.d.ts +19 -0
  496. package/dist/types/pages/send/ShieldedDisclosure.d.ts +1 -0
  497. package/dist/types/pages/send/StealthInvite.d.ts +1 -0
  498. package/dist/types/pages/send/addressSend.d.ts +62 -0
  499. package/dist/types/pages/send/sendCopy.d.ts +9 -0
  500. package/dist/types/pages/send/sendRetry.d.ts +10 -0
  501. package/dist/types/pages/send/stealthRecipient.d.ts +37 -0
  502. package/dist/types/pages/send/stealthSend.d.ts +18 -0
  503. package/dist/types/pages/send/useAddressSend.d.ts +61 -0
  504. package/dist/types/pages/send/useSendRecipient.d.ts +13 -0
  505. package/dist/types/pages/trade/BuyPanel.d.ts +22 -0
  506. package/dist/types/pages/trade/RampRecovery.d.ts +22 -0
  507. package/dist/types/pages/trade/RecipientSheet.d.ts +11 -0
  508. package/dist/types/pages/trade/Selectors.d.ts +24 -0
  509. package/dist/types/pages/trade/SwapPanel.d.ts +34 -0
  510. package/dist/types/pages/trade/WidgetTabs.d.ts +46 -0
  511. package/dist/types/pages/trade/canton.d.ts +94 -0
  512. package/dist/types/pages/trade/config.d.ts +185 -0
  513. package/dist/types/pages/trade/embedNarrowing.d.ts +28 -0
  514. package/dist/types/pages/trade/embedParams.d.ts +299 -0
  515. package/dist/types/pages/trade/embedTheme.d.ts +14 -0
  516. package/dist/types/pages/trade/harness.d.ts +120 -0
  517. package/dist/types/pages/trade/orderMinimum.d.ts +5 -0
  518. package/dist/types/pages/trade/resumeSwap.d.ts +139 -0
  519. package/dist/types/pages/trade/settlementCopy.d.ts +42 -0
  520. package/dist/types/pages/trade/useAmountFit.d.ts +25 -0
  521. package/dist/types/pages/trade/useEmbedDefaults.d.ts +28 -0
  522. package/dist/types/pages/trade/useSettlementGating.d.ts +152 -0
  523. package/dist/types/pages/trade/useSwapAmount.d.ts +93 -0
  524. package/dist/types/pages/trade/useSwapFlow.d.ts +152 -0
  525. package/dist/types/pages/trade/useSwapPanel.d.ts +170 -0
  526. package/dist/types/pages/trade/useSwapRoute.d.ts +215 -0
  527. package/dist/types/pages/trade/useTronLinkFill.d.ts +13 -0
  528. package/dist/types/pages/trade/zkMoney.d.ts +28 -0
  529. package/dist/types/promiseWithResolvers.d.ts +12 -0
  530. package/dist/types/ramp/availability/RailTiles.d.ts +26 -0
  531. package/dist/types/ramp/availability/RampDisclosure.d.ts +9 -0
  532. package/dist/types/ramp/availability/RampRails.d.ts +27 -0
  533. package/dist/types/ramp/availability/model.d.ts +51 -0
  534. package/dist/types/ramp/availability/useRampDiscovery.d.ts +60 -0
  535. package/dist/types/ramp/offramp/CompletedPrerequisite.d.ts +5 -0
  536. package/dist/types/ramp/offramp/OfframpActivityList.d.ts +12 -0
  537. package/dist/types/ramp/offramp/OfframpRoute.d.ts +8 -0
  538. package/dist/types/ramp/offramp/OfframpRouteReview.d.ts +12 -0
  539. package/dist/types/ramp/offramp/PaymentAppSend.d.ts +27 -0
  540. package/dist/types/ramp/offramp/localOfframps.d.ts +58 -0
  541. package/dist/types/ramp/offramp/model.d.ts +46 -0
  542. package/dist/types/ramp/offramp/port.d.ts +55 -0
  543. package/dist/types/ramp/offramp/prerequisite.d.ts +271 -0
  544. package/dist/types/ramp/offramp/useOfframp.d.ts +87 -0
  545. package/dist/types/ramp/offramp/useOfframpRails.d.ts +36 -0
  546. package/dist/types/ramp/peer/BuyOnramp.d.ts +21 -0
  547. package/dist/types/ramp/peer/OnrampSteps.d.ts +32 -0
  548. package/dist/types/ramp/peer/buyerDriver.d.ts +48 -0
  549. package/dist/types/ramp/peer/discovery.d.ts +17 -0
  550. package/dist/types/ramp/peer/environment.d.ts +2 -0
  551. package/dist/types/ramp/peer/index.d.ts +14 -0
  552. package/dist/types/ramp/peer/liveProvider.d.ts +15 -0
  553. package/dist/types/ramp/peer/liveReads.d.ts +102 -0
  554. package/dist/types/ramp/peer/maker.d.ts +4 -0
  555. package/dist/types/ramp/peer/normalization.d.ts +33 -0
  556. package/dist/types/ramp/peer/offramp.d.ts +130 -0
  557. package/dist/types/ramp/peer/onramp.d.ts +134 -0
  558. package/dist/types/ramp/peer/preview.d.ts +14 -0
  559. package/dist/types/ramp/peer/protectedMapping.d.ts +22 -0
  560. package/dist/types/ramp/peer/runtime.d.ts +15 -0
  561. package/dist/types/ramp/peer/sdkMaker.d.ts +67 -0
  562. package/dist/types/ramp/peer/types.d.ts +64 -0
  563. package/dist/types/ramp/recovery/ResumeOnramp.d.ts +37 -0
  564. package/dist/types/ramp/recovery/summaries.d.ts +71 -0
  565. package/dist/types/ramp/route/OnrampRoute.d.ts +12 -0
  566. package/dist/types/ramp/route/RampRouteSteps.d.ts +16 -0
  567. package/dist/types/ramp/route/routeActivity.d.ts +4 -0
  568. package/dist/types/ramp/route/useXochiRampDriver.d.ts +22 -0
  569. package/dist/types/result.js +14 -0
  570. package/dist/types/styles.d.ts +1 -0
  571. package/dist/types/types/activity.d.ts +184 -0
  572. package/dist/types/types/index.d.ts +20 -0
  573. package/dist/types/types/intent.d.ts +85 -0
  574. package/dist/types/types/result.d.ts +53 -0
  575. package/dist/types/utils/format.d.ts +88 -0
  576. package/dist/types/wagmi.d.ts +143 -0
  577. package/dist/types/widgetLibModule.d.ts +8 -0
  578. package/dist/utils/format.js +109 -0
  579. package/dist/wagmi.js +210 -0
  580. package/dist/widgetLibModule.js +4 -0
  581. package/licenses/Monaspace-OFL-1.1.txt +93 -0
  582. package/licenses/assets.json +132 -0
  583. package/licenses/rainbowkit-MIT.txt +9 -0
  584. package/licenses/xochi-shared-MIT.txt +21 -0
  585. package/package.json +115 -4
@@ -0,0 +1,22 @@
1
+ /**
2
+ * useLocalActivity Hook
3
+ *
4
+ * Surfaces the connected wallet's local-first swap log (see lib/localActivity)
5
+ * and keeps non-terminal records fresh by polling the public per-intent status
6
+ * endpoint -- no Member token required. This is what makes the activity feed
7
+ * populate for wallet-only users right after they trade.
8
+ *
9
+ * While any record is in flight it polls on an interval, so a swap keeps
10
+ * advancing in the feed even after the user closes the flow modal on the
11
+ * "safe to close" screen. A record crossing into `completed` fires onComplete.
12
+ */
13
+ import type { SwapActivityItem } from "../types/activity.js";
14
+ export interface UseLocalActivityOptions {
15
+ /** Called once when a record crosses from in-flight into `completed`. */
16
+ onComplete?: (item: SwapActivityItem) => void;
17
+ }
18
+ export interface UseLocalActivityReturn {
19
+ swaps: SwapActivityItem[];
20
+ refresh: () => Promise<void>;
21
+ }
22
+ export declare function useLocalActivity(options?: UseLocalActivityOptions): UseLocalActivityReturn;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * useLocalSends
3
+ *
4
+ * The connected wallet's local log of public sends (lib/localSends), kept live
5
+ * by its pub/sub, so a send made in the Send tab shows in Activity at once.
6
+ */
7
+ import { type SendActivityItem } from "../lib/localSends.js";
8
+ export declare function useLocalSends(): SendActivityItem[];
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Hook for reading a value from localStorage without persisting changes.
3
+ * Useful when one component writes and another only reads.
4
+ *
5
+ * @param key - The localStorage key
6
+ * @param typeGuard - Optional type guard for validating stored data
7
+ */
8
+ export declare function useLocalStorageRead<T>(key: string, typeGuard?: (value: unknown) => value is T): T | null;
@@ -0,0 +1,52 @@
1
+ /**
2
+ * useOrderHistory Hook
3
+ *
4
+ * Fetches and manages order (intent) history with functional patterns.
5
+ * Uses Result types and pure transformations.
6
+ */
7
+ import type { IntentStatus, ChainId, SettlementType } from "../types/intent.js";
8
+ export interface OrderHistoryItem {
9
+ id: string;
10
+ status: IntentStatus;
11
+ fromChainId: ChainId;
12
+ toChainId: ChainId;
13
+ fromToken: string;
14
+ toToken: string;
15
+ fromAmount: string;
16
+ toAmount: string | null;
17
+ tier: string;
18
+ feeRate: number;
19
+ txHash: string | null;
20
+ /** Destination-leg fill hash on to_chain (cross-chain completions only). */
21
+ receivingTxHash: string | null;
22
+ /** Public fill receipt (Riddler #632) + its chain; drives the receipt CTA. */
23
+ settlementTxHash: string | null;
24
+ settlementChainId: ChainId | null;
25
+ /** As the history read serves it; a `failed` row's retry needs `not_executed`. */
26
+ substatus: string | null;
27
+ /** The owner's history serves it; null when absent or not a mode this build models. */
28
+ settlementType: SettlementType | null;
29
+ recipientTag?: string;
30
+ createdAt: string;
31
+ timestamp: number;
32
+ explorerUrl: string | null;
33
+ fromChainName: string;
34
+ toChainName: string;
35
+ isCrossChain: boolean;
36
+ }
37
+ export interface UseOrderHistoryReturn {
38
+ orders: OrderHistoryItem[];
39
+ isLoading: boolean;
40
+ error: string | null;
41
+ refresh: () => Promise<void>;
42
+ hasMore: boolean;
43
+ loadMore: () => void;
44
+ /**
45
+ * True when a wallet is connected but there is no wallet-bound session yet, so
46
+ * server history can't be loaded. The UI shows a "Sign in to view" affordance
47
+ * rather than prompting a signature automatically.
48
+ */
49
+ needsSignIn: boolean;
50
+ }
51
+ export declare const toOrderHistoryItem: (record: Record<string, unknown>) => OrderHistoryItem;
52
+ export declare function useOrderHistory(): UseOrderHistoryReturn;
@@ -0,0 +1,90 @@
1
+ /**
2
+ * usePermit Hook
3
+ *
4
+ * Origin-pull approval helper. Under the origin-pull contract the user signs
5
+ * the solver-served `pull_authorization` (handled in useIntent), so this hook
6
+ * no longer builds permit typed data itself. Its job now:
7
+ *
8
+ * - Report the pull method. When a served `pull_authorization` is available it
9
+ * is authoritative (the solver decides how it pulls); before a quote lands the
10
+ * hook falls back to a per-token guess (erc3009 for USDC, permit2 otherwise)
11
+ * for display only.
12
+ * - For permit2, ensure an on-chain ERC-20 allowance to the canonical
13
+ * Permit2 contract that PermitWitnessTransferFrom requires. erc3009 (USDC)
14
+ * pulls via ReceiveWithAuthorization and needs no approval transaction.
15
+ * - Report whether that approval is still outstanding (`approval`), read off
16
+ * the wallet's real on-chain allowance. The payment copy claims "no gas" only
17
+ * from this, and `ensureApproval` decides from a refetch of the same read, so
18
+ * the copy and the approval prompt cannot disagree.
19
+ */
20
+ import type { PermitType, PaymentMethod, ChainId, Eip712TypedData, OriginApproval } from "../types/intent.js";
21
+ export interface UsePermitParams {
22
+ token: string;
23
+ chainId: ChainId;
24
+ /**
25
+ * The solver-served origin-pull authorization for the current quote, when one
26
+ * exists. Its `primaryType` is the authoritative pull method: the approval
27
+ * gate keys on it so an ERC-3009 pull (ReceiveWithAuthorization) never prompts
28
+ * an approval and a Permit2 pull always approves the canonical Permit2
29
+ * contract. Undefined before a quote lands (falls back to the token guess).
30
+ */
31
+ pullAuthorization?: Eip712TypedData;
32
+ /**
33
+ * The quote's served `payment_method`. When it names a pull method it beats
34
+ * the token guess on a quote that carries no pull (an anonymous preview), so
35
+ * a preview the solver labels Permit2 is never read as an allowance-free
36
+ * ERC-3009 pull just because the token is USDC. The pull itself still wins.
37
+ */
38
+ servedMethod?: PaymentMethod;
39
+ /**
40
+ * The base-units amount the approval must cover, the figure the machine later
41
+ * passes to `ensureApproval`. Null before anything is quoted, which leaves a
42
+ * Permit2 approval `unknown`.
43
+ */
44
+ amount: string | null;
45
+ /** Quote/trade identity. Changing it invalidates any unlimited consent. */
46
+ approvalContext?: string | null;
47
+ /**
48
+ * Whether the origin leg uses an EVM gasless pull. False for a non-EVM (Tron)
49
+ * deposit-route origin, which has no permit/approval at all -- the hook goes
50
+ * inert (`permitType:"none"`, no reads, `ensureApproval` no-ops) so a Tron
51
+ * origin never touches wagmi. `chainId` is then a harmless EVM placeholder.
52
+ */
53
+ enabled?: boolean;
54
+ }
55
+ export interface UsePermitReturn {
56
+ permitType: PermitType;
57
+ /** Whether the pull needs an approval transaction first, from the on-chain allowance. */
58
+ approval: OriginApproval;
59
+ /** A zero-first token may need a separate gasful allowance reset. */
60
+ approvalMayNeedReset: boolean;
61
+ /** An approval transaction is in flight. */
62
+ isApproving: boolean;
63
+ unlimitedApproval: boolean;
64
+ setUnlimitedApproval: (enabled: boolean) => void;
65
+ /**
66
+ * Ensure the origin token has a sufficient Permit2 allowance. No-op (returns
67
+ * true) for erc3009 tokens. For permit2, refetches the allowance read that
68
+ * `approval` comes from and sends the exact amount if it is short (unlimited
69
+ * only with explicit, single-use consent), waiting for the receipt and
70
+ * re-reading allowance after it. Returns false on rejection, revert,
71
+ * a non-canonical Permit2 domain or failure so the caller aborts before signing.
72
+ */
73
+ ensureApproval: (amount: bigint) => Promise<boolean>;
74
+ /** Clear the in-flight flag and re-read the allowance (a swap may have spent it). */
75
+ reset: () => void;
76
+ }
77
+ /**
78
+ * Guess the pre-quote pull method for a token. USDC pulls via ERC-3009
79
+ * (ReceiveWithAuthorization); everything else via Permit2.
80
+ *
81
+ * `isSmartAccount` steers a Base Account / Coinbase Smart Wallet (ERC-4337)
82
+ * signer away from ERC-3009: USDC's `receiveWithAuthorization` validates the
83
+ * signature with `ecrecover` and has no ERC-1271 fallback, so a smart account
84
+ * physically cannot produce a valid ERC-3009 signature. Permit2 does support
85
+ * ERC-1271 on-chain, so it is the only viable guess for a smart account
86
+ * (xochi#291). This only steers the pre-quote guess; the solver-served
87
+ * `pull_authorization` remains authoritative once a quote lands.
88
+ */
89
+ export declare function detectPermitType(token: string, chainId: ChainId, isSmartAccount?: boolean): PermitType;
90
+ export declare function usePermit({ token, chainId, pullAuthorization, servedMethod, amount, approvalContext, enabled, }: UsePermitParams): UsePermitReturn;
@@ -0,0 +1,72 @@
1
+ /**
2
+ * usePrices Hook
3
+ *
4
+ * Fetches live token prices from the worker API (DeFi Llama backed).
5
+ * Falls back to FALLBACK_PRICES on error or while loading.
6
+ */
7
+ /** Where one `/api/prices` entry came from (xochi#568). */
8
+ type PriceSource = "defillama" | "fallback";
9
+ /**
10
+ * The `/api/prices` body. `sources` and `updated_at` are optional so a body from
11
+ * a worker that predates them reads as carrying no market rate (fail closed).
12
+ */
13
+ export interface PriceResponse {
14
+ prices: Record<string, number>;
15
+ live: boolean;
16
+ sources?: Record<string, PriceSource>;
17
+ updated_at?: Record<string, number>;
18
+ }
19
+ /**
20
+ * Oldest DeFi Llama print still treated as a market rate, in seconds. Llama's
21
+ * `prices/current` answers with the latest print inside a 6-hour window, so a
22
+ * served price is not necessarily a recent one. CoinGecko-keyed coins update
23
+ * about every minute and contract-priced ones (RAXOL, EURe, ZCHF) were sampled
24
+ * about 12 minutes old (2026-10-31); 30 minutes clears both with room for the
25
+ * worker's 60s edge cache and this hook's 60s refetch.
26
+ */
27
+ export declare const PRICE_MAX_AGE_SECONDS: number;
28
+ /** A market rate: a DeFi Llama print and its timestamp (unix seconds). */
29
+ export interface LivePrice {
30
+ price: number;
31
+ updatedAt: number;
32
+ }
33
+ /**
34
+ * The prices in `feed` that are a live market rate: served by DeFi Llama (not a
35
+ * FALLBACK_PRICES entry, pegs included) with a print no older than
36
+ * PRICE_MAX_AGE_SECONDS at `nowSeconds`. Anything graded against "the market"
37
+ * (the spot-price row, the excessiveSlippage guard) reads this map; a missing
38
+ * symbol means unpriced, never a static fallback passed off as a market rate.
39
+ */
40
+ export declare function livePriceMap(feed: PriceResponse, nowSeconds: number): Record<string, LivePrice>;
41
+ /**
42
+ * Parse a token amount that may be a number or a display string with thousands
43
+ * separators into a Number. parseFloat stops at the first comma
44
+ * (parseFloat("5,000") === 5), so separators are stripped first; otherwise
45
+ * amounts >= 1000 are truncated by orders of magnitude on the signing screen and
46
+ * the order-bounds guard.
47
+ */
48
+ export declare function parseAmountToNumber(amount: number | string): number;
49
+ export interface UsePricesReturn {
50
+ /** Token prices keyed by symbol (e.g. { ETH: 3200, USDC: 1 }) */
51
+ prices: Record<string, number>;
52
+ /** Whether prices are live from DeFi Llama (false = fallback) */
53
+ isLive: boolean;
54
+ /**
55
+ * Only the prices that are a live market rate (see `livePriceMap`), with
56
+ * their print time. Anything graded against the market reads this, never
57
+ * `prices`, which carries static fallbacks (xochi#568).
58
+ */
59
+ livePrices: Record<string, LivePrice>;
60
+ /** Whether the initial fetch is still loading */
61
+ isLoading: boolean;
62
+ /**
63
+ * Estimate USD value for a token amount; null when the symbol is unpriced.
64
+ * Never defaults to a $1 par: an unpriced volatile token (RAXOL is absent
65
+ * from FALLBACK_PRICES by design) would be overvalued by orders of magnitude.
66
+ */
67
+ estimateUsd: (amount: number | string, symbol: string) => number | null;
68
+ }
69
+ /** USD value of `amount` at `prices[symbol]`, or null when the symbol has no price. */
70
+ export declare function estimateUsdFrom(prices: Record<string, number>, amount: number | string, symbol: string): number | null;
71
+ export declare function usePrices(): UsePricesReturn;
72
+ export {};
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Read wallet holdings independently of trade-route availability. Each browser
3
+ * chain has its own query, so a failed or unconfigured chain cannot discard
4
+ * successful reads elsewhere. Every Arc ERC-20 (USDC, EURC, any advertised
5
+ * token) is read through the first-party balance endpoint, which takes any
6
+ * token address; Arc's native and ERC-20 USDC views are the same funds and are
7
+ * counted only once.
8
+ */
9
+ import { type PublicBalance } from "../lib/balances.js";
10
+ export declare function usePublicBalances(): {
11
+ balances: PublicBalance[];
12
+ holdings: import("../lib/balances.js").AggregatedHolding[];
13
+ readBalanceOf: (chainId: number, tokenAddress: string) => bigint | null;
14
+ hasUnread: boolean;
15
+ isLoading: boolean;
16
+ isError: boolean;
17
+ error: Error | null;
18
+ refetch: () => void;
19
+ };
@@ -0,0 +1,9 @@
1
+ /**
2
+ * useRampSummaries
3
+ *
4
+ * The sanitized local Peer onramp summaries (ramp/recovery/summaries), kept
5
+ * live by their pub/sub and by `storage` events from other tabs, so a purchase
6
+ * started in Buy shows in Activity at once and a reload resumes it.
7
+ */
8
+ import { type RampOperationSummary } from "../ramp/recovery/summaries.js";
9
+ export declare function useRampSummaries(): RampOperationSummary[];
@@ -0,0 +1,58 @@
1
+ /**
2
+ * useRecipientBalance Hook
3
+ *
4
+ * What the destination address already holds of the token it is about to
5
+ * receive. Shown so a payer can sanity-check an address before signing, which
6
+ * matters most on a route where the address is typed by hand rather than taken
7
+ * from the connected wallet.
8
+ *
9
+ * Read through the worker (`GET /api/balance`) rather than straight from an RPC
10
+ * or TronGrid. A browser-side read would hand a third party the pair (user IP,
11
+ * recipient address) moments before a payment, which is exactly the correlation
12
+ * this protocol exists to avoid.
13
+ *
14
+ * A zero balance is normal and is NOT a warning: fresh addresses and first
15
+ * payments are the common case. The only state worth distinguishing is
16
+ * "unavailable", which means nobody checked, not that the address is empty.
17
+ */
18
+ interface BalanceResponse {
19
+ success: boolean;
20
+ available: boolean;
21
+ balance?: string;
22
+ }
23
+ export interface UseRecipientBalanceReturn {
24
+ /** Raw smallest-unit balance, or null when unknown. */
25
+ balance: bigint | null;
26
+ /** True once a real answer arrived (including a genuine zero). */
27
+ available: boolean;
28
+ isLoading: boolean;
29
+ /** True when an enabled lookup failed or the worker could not produce an answer. */
30
+ isError: boolean;
31
+ error: Error | null;
32
+ refetch: () => void;
33
+ }
34
+ /**
35
+ * The `/api/balance` query for `address` in `token` on `chainId`. Shared by the
36
+ * recipient hint and the wallet's Arc reads, so one chain/token/address pair is
37
+ * one cache entry. Disabled until all three are present, so a half-typed
38
+ * recipient never fires a request.
39
+ */
40
+ export declare function recipientBalanceQuery(chainId: number | undefined, token: string | undefined, address: string | undefined): {
41
+ queryKey: readonly ["recipient-balance", number | undefined, string | undefined, string | undefined];
42
+ queryFn: () => Promise<BalanceResponse>;
43
+ enabled: boolean;
44
+ staleTime: 30000;
45
+ retry: number;
46
+ refetchOnWindowFocus: boolean;
47
+ };
48
+ /** Read a `recipientBalanceQuery` result as a balance, or unknown. */
49
+ export declare function recipientBalanceResult(query: {
50
+ data: BalanceResponse | undefined;
51
+ isLoading: boolean;
52
+ isError: boolean;
53
+ error: unknown;
54
+ refetch: () => Promise<unknown>;
55
+ }, enabled: boolean): UseRecipientBalanceReturn;
56
+ /** Balance of `address` in `token` on `chainId` (see `recipientBalanceQuery`). */
57
+ export declare function useRecipientBalance(chainId: number | undefined, token: string | undefined, address: string | undefined): UseRecipientBalanceReturn;
58
+ export {};
@@ -0,0 +1,14 @@
1
+ /**
2
+ * useSettlements Hook
3
+ *
4
+ * Fetches the connected wallet's settlements (GET /api/settlement) and surfaces
5
+ * a claimable summary for the compact assets strip. Settlements are amounts a
6
+ * completed swap or stealth payment is holding for you, awaiting claim.
7
+ */
8
+ export interface UseSettlementsReturn {
9
+ /** Count of settlements ready to claim */
10
+ claimableCount: number;
11
+ isLoading: boolean;
12
+ refresh: () => void;
13
+ }
14
+ export declare function useSettlements(): UseSettlementsReturn;
@@ -0,0 +1,72 @@
1
+ /**
2
+ * useStealth Hook
3
+ *
4
+ * React hook for stealth address key management.
5
+ * Derives stealth keys from wallet signature and manages meta-address registration.
6
+ *
7
+ * SHARED, NOT PER-CALLER. The state lives in one `StealthProvider` and every
8
+ * `useStealth()` reads that same instance. This is load-bearing, not tidiness:
9
+ * the send side (`useSwapPanel`) and the receive side (`useStealthClaim`) both
10
+ * consume it, and when they each owned private `useState` the derived secret
11
+ * keys were invisible across the split. Only the PUBLIC meta-address is cached
12
+ * to localStorage, and the reader effect is keyed on `[address, chainId]`, so
13
+ * nothing re-read it mid-session either.
14
+ *
15
+ * The cost was the whole of xochi#352: selecting Stealth derived keys on the
16
+ * swap-panel instance, so on the receive instance `keysReady` stayed false (the
17
+ * post-settle auto-scan silently no-opped) and `isInitialized` stayed false (the
18
+ * Stealth Payments panel was not rendered at all). A user finished a stealth
19
+ * swap, got scrolled to a panel offering to "Setup" the stealth they had just
20
+ * set up, and was never shown the payment waiting for them. Every claim-clarity
21
+ * fix in #357 was gated behind one of those two flags, so none of them could run.
22
+ *
23
+ * `useStealth` therefore throws outside a provider rather than falling back to a
24
+ * local instance: a silent fallback would restore exactly that failure, and it
25
+ * fails invisibly.
26
+ */
27
+ import type { ReactNode } from "react";
28
+ import { type StealthKeys } from "@xochi/signer";
29
+ import type { StealthMetaAddress } from "@xochi/client";
30
+ export interface UseStealthReturn {
31
+ /** Stealth meta-address (public keys for receiving) */
32
+ metaAddress: StealthMetaAddress | null;
33
+ /** Encoded meta-address string (st:eth:0x...) */
34
+ encodedMetaAddress: string | null;
35
+ /** Whether stealth keys have been derived (meta-address cached) */
36
+ isInitialized: boolean;
37
+ /**
38
+ * Whether stealth keys are currently held in memory (getKeys() !== null).
39
+ * Distinct from isInitialized: after a reload the meta-address is cached but
40
+ * the secret keys are not, so scanning needs a re-sign. This is the honest
41
+ * scan-readiness signal.
42
+ */
43
+ keysReady: boolean;
44
+ /** Whether meta-address is registered on-chain */
45
+ isRegistered: boolean;
46
+ /** Loading state */
47
+ isLoading: boolean;
48
+ /** Error message if any */
49
+ error: string | null;
50
+ /** Initialize stealth keys from wallet signature */
51
+ initializeKeys: () => Promise<boolean>;
52
+ /** Register meta-address on ERC-6538 */
53
+ registerMetaAddress: () => Promise<string | null>;
54
+ /** Get stealth keys (call initializeKeys first) */
55
+ getKeys: () => StealthKeys | null;
56
+ /** Reset all state */
57
+ reset: () => void;
58
+ }
59
+ /**
60
+ * Owns the single stealth key state for the app. Mount above anything that
61
+ * derives, registers, scans, or claims -- in practice the app root, so the send
62
+ * and receive sides cannot drift apart again.
63
+ */
64
+ export declare function StealthProvider({ children }: {
65
+ children: ReactNode;
66
+ }): import("react").JSX.Element;
67
+ /**
68
+ * Read the shared stealth state. Throws outside a `StealthProvider`: the
69
+ * alternative (a private instance per caller) is the exact bug this replaced,
70
+ * and it fails silently rather than loudly.
71
+ */
72
+ export declare function useStealth(): UseStealthReturn;
@@ -0,0 +1,96 @@
1
+ /**
2
+ * useStealthClaim Hook
3
+ *
4
+ * Orchestrates the keyless stealth claim flow:
5
+ * 1. Scan ERC-5564 announcements for the user's viewing key
6
+ * 2. Verify matched payments locally (ECDH + view tag check)
7
+ * 3. Derive the per-payment stealth spending key for each payment
8
+ * 4. Prepare: POST /api/stealth/claim/prepare -> unsigned UserOp hash
9
+ * 5. Sign the raw userOpHash locally with the stealth key (never leaves the client)
10
+ * 6. Submit: POST /api/stealth/claim/submit with the signature. A 503
11
+ * `claim_pending` means the op was accepted and not mined yet; the same
12
+ * signed op is resubmitted (which polls it) until it lands or its pending
13
+ * window, measured from the first pending answer, closes -- never
14
+ * re-prepared or re-signed. See claimSubmitPoll.
15
+ */
16
+ import { type ChainStealthPayment } from "./useStealthScanner.js";
17
+ export interface ClaimResult {
18
+ success: boolean;
19
+ txHash?: string;
20
+ opHash?: string;
21
+ error?: string;
22
+ /**
23
+ * The server's `error_category` when it named one (#469). `no_claimable_settlement`
24
+ * means the record has to be restored and retrying will never work;
25
+ * `claim_rate_limited` and `claim_service_unavailable` are the retryable pair.
26
+ * `claim_pending` is set with `pending` and is not a failure (see below).
27
+ *
28
+ * One value is client-originated rather than served: `claim_op_unverified`,
29
+ * when this hook refused to sign because the prepared operation did not check
30
+ * out (#472). It is listed here because a caller branching on the reason wants
31
+ * to tell "we refused" from "the server refused".
32
+ */
33
+ errorCategory?: string;
34
+ /**
35
+ * What the operation would actually have moved, on a claim that got as far as
36
+ * being verified. Surfaced so the payout the user is signing for is readable
37
+ * rather than implied: the amount is the one field `verifyClaimUserOp`
38
+ * deliberately does not enforce, so a person has to be able to see it.
39
+ */
40
+ payout?: {
41
+ token: string;
42
+ amount: bigint;
43
+ announcedAmount: bigint;
44
+ };
45
+ /**
46
+ * The op was accepted and was still unconfirmed when polling ended -- its
47
+ * pending window closed, or the server stopped answering for it. Not a
48
+ * failure: it may yet land, so the UI shows it as pending rather than as an
49
+ * error. `error` is unset; `opHash` names it.
50
+ */
51
+ pending?: boolean;
52
+ }
53
+ export interface UseStealthClaimReturn {
54
+ /** Matched stealth payments from scanning, each with its settlement chain */
55
+ payments: ChainStealthPayment[];
56
+ /** Whether scanner is actively scanning */
57
+ isScanning: boolean;
58
+ /** Whether a claim is in progress */
59
+ isClaiming: boolean;
60
+ /**
61
+ * The in-progress claim was sent and is waiting to be mined; the hook is
62
+ * resubmitting the same signed op to poll it. A subset of `isClaiming`.
63
+ */
64
+ isConfirming: boolean;
65
+ /** Error from scanning or claiming */
66
+ error: string | null;
67
+ /** Last scanned block number */
68
+ lastScannedBlock: bigint | null;
69
+ /** A scan has completed at least once this session (see useStealthScanner) */
70
+ hasScanned: boolean;
71
+ /** Whether stealth keys have been set up (meta-address cached) */
72
+ isInitialized: boolean;
73
+ /** Whether secret keys are in memory (scan-ready); false after a reload */
74
+ keysReady: boolean;
75
+ /** Whether the meta-address is registered on-chain */
76
+ isRegistered: boolean;
77
+ /** Whether a key derivation or registration is in progress */
78
+ isLoading: boolean;
79
+ /** Derive stealth keys from a wallet signature (Setup or re-sign) */
80
+ initializeKeys: () => Promise<boolean>;
81
+ /** Register the meta-address on ERC-6538 */
82
+ registerMetaAddress: () => Promise<string | null>;
83
+ /** Scan for incoming stealth payments */
84
+ scan: () => Promise<void>;
85
+ /** Claim a specific stealth payment on the chain it settled on */
86
+ claim: (payment: ChainStealthPayment, recipientAddress: string) => Promise<ClaimResult>;
87
+ /** Claim all matched payments */
88
+ claimAll: (recipientAddress: string) => Promise<{
89
+ claimed: number;
90
+ failed: number;
91
+ pending: number;
92
+ }>;
93
+ /** Clear found payments */
94
+ clearPayments: () => void;
95
+ }
96
+ export declare function useStealthClaim(): UseStealthClaimReturn;
@@ -0,0 +1,44 @@
1
+ /**
2
+ * useStealthScanner Hook
3
+ *
4
+ * Finds incoming ERC-5564 stealth payments by reading the worker's per-chain
5
+ * announcement index, then matching view tags and counterfactual SimpleAccount
6
+ * addresses locally. Every locally trusted settlement chain is scanned: solver
7
+ * narrowing stops new quotes, but cannot make an existing payout disappear.
8
+ */
9
+ import { type StealthPayment, type StealthKeys } from "@xochi/signer";
10
+ /** A matched payment and the chain whose claim operation must sweep it. */
11
+ export interface ChainStealthPayment extends StealthPayment {
12
+ chainId: number;
13
+ }
14
+ export interface UseStealthScannerParams {
15
+ /** Stealth keys for scanning (from useStealth) */
16
+ keys: StealthKeys | null;
17
+ /** Live key getter: lets a key lock revoke work before the next render. */
18
+ getKeys?: () => StealthKeys | null;
19
+ /** Whether to auto-scan on mount */
20
+ autoScan?: boolean;
21
+ /** Max announcements to request per chain (default 500). */
22
+ limit?: number;
23
+ }
24
+ export interface UseStealthScannerReturn {
25
+ /** Discovered stealth payments, tagged with their settlement chain */
26
+ payments: ChainStealthPayment[];
27
+ /** Whether currently scanning */
28
+ isScanning: boolean;
29
+ /** Highest announcement block seen in the last scan (for display) */
30
+ lastScannedBlock: bigint | null;
31
+ /** A scan reached at least one announcement index this session. */
32
+ hasScanned: boolean;
33
+ /** Error message if any */
34
+ error: string | null;
35
+ /** Scan every trusted settlement chain. */
36
+ scan: (fromBlock?: bigint) => Promise<void>;
37
+ /** Clear discovered payments */
38
+ clearPayments: () => void;
39
+ /** Opaque, in-memory scope; never persisted or supplied by the backend. */
40
+ authority: object;
41
+ /** Rejects payments not discovered by this scanner's current unlocked scope. */
42
+ isPaymentAuthorized: (payment: ChainStealthPayment) => boolean;
43
+ }
44
+ export declare function useStealthScanner({ keys, getKeys, autoScan, limit, }: UseStealthScannerParams): UseStealthScannerReturn;
@@ -0,0 +1,29 @@
1
+ /**
2
+ * useTheme Hook
3
+ *
4
+ * Resolves the theme and applies it as the data-theme attribute on <html>.
5
+ * The app has three (themes.css): `dim`, the default dark look (`:root`);
6
+ * `dark`, the high-contrast theme (true black, pure white text), which the
7
+ * frame's `theme` parameter calls `contrast`; and `light`.
8
+ *
9
+ * The widget has no theme control: a host picks the frame's initial theme with
10
+ * the `theme` URL parameter and can update it over the host bridge. The frame
11
+ * passes either choice in as `fixed`. Without one, resolution is:
12
+ * - a choice saved under STORAGE_KEYS.theme on this origin, if any
13
+ * - otherwise the system preference (light when the OS asks for light, else
14
+ * dim), followed live
15
+ */
16
+ declare const THEMES: readonly ["dim", "dark", "light"];
17
+ export type AppTheme = (typeof THEMES)[number];
18
+ /** Share live resolution between the frame and wallet dialogs, including auto. */
19
+ export declare function useResolvedTheme(fixed?: AppTheme | null): AppTheme;
20
+ /**
21
+ * Apply the resolved theme to <html> and keep it in step with the system.
22
+ *
23
+ * @param fixed A theme to apply as it is, ignoring the stored choice and the
24
+ * system; null resolves it as described above.
25
+ */
26
+ export declare function useTheme(fixed?: AppTheme | null): void;
27
+ /** The theme `useTheme(fixed)` applies at first, without React (for WalletProvider). */
28
+ export declare function getTheme(fixed?: AppTheme | null): AppTheme;
29
+ export {};
@@ -0,0 +1,23 @@
1
+ /**
2
+ * useTierInfo Hook
3
+ *
4
+ * Provides tier information based on trust score:
5
+ * - Fee rate calculation
6
+ * - Tier name lookup
7
+ * - Memoized for performance
8
+ */
9
+ export interface UseTierInfoReturn {
10
+ /** Numeric fee rate (e.g., 0.25 for 0.25%) */
11
+ feeRate: number;
12
+ /** Formatted fee rate string (e.g., "0.25%") */
13
+ feeRateFormatted: string;
14
+ /** Tier name (e.g., "Trusted") */
15
+ tierName: string;
16
+ /** Current trust score */
17
+ trustScore: number;
18
+ /** Points needed for next tier (null if at max) */
19
+ pointsToNextTier: number | null;
20
+ /** Next tier name (null if at max) */
21
+ nextTierName: string | null;
22
+ }
23
+ export declare function useTierInfo(trustScore?: number): UseTierInfoReturn;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * useTrustScore Hook
3
+ *
4
+ * The one place the widget turns the local verify state into a trust score.
5
+ * Returns the EFFECTIVE score (`effectiveTrustScore`): 0 unless the server says
6
+ * trust economics is live, so no consumer can show or send a tier the server
7
+ * does not honour. `verifyState` is passed through for the non-score fields.
8
+ */
9
+ import { type VerifyState } from "../types/index.js";
10
+ export interface UseTrustScoreReturn {
11
+ /** Effective trust score: 0 while trust economics is off. */
12
+ trustScore: number;
13
+ /** Raw local verify state (connected providers etc.); never read its score. */
14
+ verifyState: VerifyState | null;
15
+ }
16
+ export declare function useTrustScore(): UseTrustScoreReturn;