@xochi/widget 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (585) hide show
  1. package/CHANGELOG.md +76 -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 +66 -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 +398 -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 +207 -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 +323 -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 +435 -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 +131 -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 +200 -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 +971 -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 +17448 -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 +44 -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 +138 -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 +34 -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 +66 -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 +156 -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 +84 -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 +48 -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 +142 -0
  577. package/dist/types/widgetLibModule.d.ts +8 -0
  578. package/dist/utils/format.js +109 -0
  579. package/dist/wagmi.js +188 -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,64 @@
1
+ import type { RampAvailability, RampErrorCode, RampIntent, RampOffer, RampMoney, RampSettlement } from "@xochi/client";
2
+ /** Widget-owned request sent to the Peer V3 best-by-platform read. */
3
+ export interface PeerBestQuoteRequest {
4
+ fiatCurrency: string;
5
+ user: string;
6
+ recipient: string;
7
+ destinationChainId: number;
8
+ destinationToken: string;
9
+ escrowAddresses: string[];
10
+ amount: string;
11
+ isExactFiat: boolean;
12
+ mode: "eligible";
13
+ quotePreference: "EXCLUSIVE_BUYER_TEE";
14
+ }
15
+ /** Widget-owned request for a quote on a selected payment rail. */
16
+ export interface PeerQuoteRequest extends PeerBestQuoteRequest {
17
+ paymentPlatforms: string[];
18
+ quotesToReturn: number;
19
+ includeNearbyQuotes: boolean;
20
+ }
21
+ /** Read-only ports in the trusted widget runtime. Never bridge these callbacks or their input/output. */
22
+ export interface PeerDiscoveryReads {
23
+ bestByPlatform(request: PeerBestQuoteRequest, signal?: AbortSignal): Promise<unknown>;
24
+ quote(request: PeerQuoteRequest, signal?: AbortSignal): Promise<unknown>;
25
+ /** S5 supplies authoritative live protocol bounds/rate and seller status; no static defaults. */
26
+ makerEvidence?(intent: RampIntent, rail: string, user?: string, signal?: AbortSignal): Promise<unknown>;
27
+ }
28
+ export interface PeerDiscoveryOptions {
29
+ signal?: AbortSignal;
30
+ environment?: "production" | "preproduction" | "staging";
31
+ /** Public connected wallet, never a signer or credential. Defaults to the intent recipient. */
32
+ user?: string;
33
+ reads?: PeerDiscoveryReads;
34
+ now?: () => number;
35
+ /** Host narrowing only; false never overrides actual mobile browser detection. */
36
+ mobileWeb?: boolean;
37
+ }
38
+ /** Allowlisted economics from the same fresh live observation as the offer. */
39
+ export interface PeerOfferEstimate {
40
+ offerId: string;
41
+ pay: RampMoney;
42
+ receive: RampMoney;
43
+ fees: readonly {
44
+ code: string;
45
+ money: RampMoney;
46
+ }[];
47
+ observedAt: string;
48
+ validUntil: string;
49
+ }
50
+ export interface PeerDiscoveryResult {
51
+ estimates: PeerOfferEstimate[];
52
+ offers: RampOffer[];
53
+ availability: RampAvailability;
54
+ code?: RampErrorCode;
55
+ }
56
+ export interface PeerConfiguration {
57
+ settlement: RampSettlement;
58
+ orchestrator: string;
59
+ escrow: string;
60
+ currencyHash: string;
61
+ rails: Readonly<Record<string, {
62
+ paymentMethodHash: string;
63
+ }>>;
64
+ }
@@ -0,0 +1,37 @@
1
+ /**
2
+ * ResumeOnramp
3
+ *
4
+ * Shown by Trade/Buy when a sanitized local summary names a Peer onramp that no
5
+ * live runtime owns: after a reload, or after the purchase view unmounted. It
6
+ * resumes that operation by its widget-minted `operation_id` and never creates
7
+ * another intent or payment action:
8
+ *
9
+ * - unsubmitted: the reviewed quote is gone, so it says no transfer was
10
+ * submitted and offers only explicit abandonment;
11
+ * - bound to another wallet: it names the original wallet; only an unsubmitted
12
+ * flow may be abandoned from here;
13
+ * - submitted: it rebinds the provider runtime with read-only lookups, runs one
14
+ * status reconciliation, and continues in the shared OnrampSteps view.
15
+ *
16
+ * Host events continue under the summary's stored `ramp_ref`, never a second
17
+ * `ramp:started`; a summary without one emits nothing (lib/rampLifecycle).
18
+ */
19
+ import type { RampOperationStore } from "@xochi/client";
20
+ import type { PublicClient, WalletClient } from "viem";
21
+ import type { PeerOnrampRuntime } from "../peer/onramp.js";
22
+ import { type RampOperationSummary } from "./summaries.js";
23
+ export interface ResumeOnrampProps {
24
+ summary: RampOperationSummary;
25
+ /** Connected wallet; undefined while disconnected. */
26
+ connected?: string;
27
+ wallet?: WalletClient;
28
+ publicClient?: PublicClient;
29
+ /** Trusted runtime injection for deterministic tests; never an embed parameter. */
30
+ runtime?: PeerOnrampRuntime;
31
+ /** S4 store injection for deterministic tests; defaults to browser-local storage. */
32
+ store?: RampOperationStore;
33
+ now?: () => number;
34
+ /** Leave a settled resumed purchase and return to choosing a rail. */
35
+ onDone?: () => void;
36
+ }
37
+ export declare function ResumeOnramp({ summary, connected, wallet, publicClient, runtime: supplied, store, now, onDone, }: ResumeOnrampProps): import("react").JSX.Element;
@@ -0,0 +1,71 @@
1
+ /**
2
+ * Browser-local, sanitized summaries of Peer onramp operations (W3).
3
+ *
4
+ * The S4 `RampOperationStore` (`xochi:ramp/1:<operation_id>`) keeps each
5
+ * operation's snapshot and command receipts. It has no index, so this list is
6
+ * the index: one row per operation, holding only what the review screen showed
7
+ * plus the public wallet the operation is bound to. The `operation_id` is a
8
+ * widget-minted UUID; it cannot retrieve anything from Peer.
9
+ *
10
+ * Never stored here: provider session or order ids, intent hashes, payment
11
+ * recipients or handles, proof material, bearer URLs, raw provider data. Every
12
+ * write and every read is an explicit projection through a strict schema, so a
13
+ * field outside the allowlist is dropped on the way in and a row carrying one
14
+ * is refused on the way out.
15
+ */
16
+ import { type RampErrorCode, type RampLegState, type RampMoney, type RampSnapshot } from "@xochi/client";
17
+ /** Peer may hold a Venmo/PayPal payout this long; an estimate, never a guarantee. */
18
+ export declare const PEER_HOLD_MS: number;
19
+ export interface RampOperationSummary {
20
+ readonly operation_id: string;
21
+ readonly direction: "onramp";
22
+ /** Lowercase public wallet the operation is bound to (its signer and recipient). */
23
+ readonly wallet: string;
24
+ readonly rail: {
25
+ readonly id: string;
26
+ readonly label: string;
27
+ };
28
+ readonly pay: RampMoney;
29
+ readonly receive: RampMoney;
30
+ readonly quote_expires_at: string;
31
+ /** True once the wallet boundary was crossed; an unsubmitted flow may be abandoned. */
32
+ readonly submitted: boolean;
33
+ /** When the wallet approval started; bounds the read-only intent lookup on resume. */
34
+ readonly approved_at?: string;
35
+ /**
36
+ * The frame-minted reference its `ramp:started` carried (opaque,
37
+ * non-authorizing), so a resumed view continues that lifecycle instead of
38
+ * announcing another operation.
39
+ */
40
+ readonly ramp_ref?: string;
41
+ readonly state: RampLegState;
42
+ /** The S4 snapshot's derived `terminal`; nothing further can happen. */
43
+ readonly terminal: boolean;
44
+ readonly payout_state?: "held" | "released";
45
+ readonly held_since?: string;
46
+ readonly failure_code?: RampErrorCode;
47
+ readonly abandoned?: boolean;
48
+ readonly created_at: string;
49
+ readonly updated_at: string;
50
+ }
51
+ /** Field-by-field projection: nothing outside the allowlist survives. */
52
+ export declare function parseRampSummary(value: unknown): RampOperationSummary | null;
53
+ /** Settled: nothing left to resume. */
54
+ export declare function summaryResolved(summary: RampOperationSummary): boolean;
55
+ /** A submitted operation whose outcome is not final: another transfer must not start. */
56
+ export declare function summaryBlocksNewPurchase(summary: RampOperationSummary): boolean;
57
+ type Listener = () => void;
58
+ export declare function subscribeRampSummaries(listener: Listener): () => void;
59
+ export declare function markRampOperationLive(operationId: string, value?: boolean): void;
60
+ export declare function rampOperationLive(operationId: string): boolean;
61
+ /** All summaries, newest first. */
62
+ export declare function listRampSummaries(): RampOperationSummary[];
63
+ export declare function getRampSummary(operationId: string): RampOperationSummary | undefined;
64
+ /** Insert or replace by operation id; malformed input is refused, not stored. */
65
+ export declare function upsertRampSummary(summary: RampOperationSummary): void;
66
+ /** Project a sanitized S4 snapshot onto its summary. `submitted` never reverts. */
67
+ export declare function summaryFromSnapshot(summary: RampOperationSummary, snapshot: RampSnapshot, now?: number): RampOperationSummary;
68
+ export declare function abandonRampSummary(operationId: string, now?: number): boolean;
69
+ /** The earliest the held payout may release: an estimate, never a guarantee. */
70
+ export declare function heldReleaseEstimate(summary: RampOperationSummary): Date | undefined;
71
+ export {};
@@ -0,0 +1,12 @@
1
+ import { type RampMoney, type RampOperationStore, type RampProvider, type RampSnapshot } from "@xochi/client";
2
+ /** Mounted only for confirmed, released Peer USDC; it never sends Peer facts to the solver. */
3
+ interface OnrampRouteProps {
4
+ snapshot: RampSnapshot;
5
+ onSnapshot(snapshot: RampSnapshot): void;
6
+ store: RampOperationStore;
7
+ peer: RampProvider;
8
+ received: RampMoney;
9
+ wallet: string;
10
+ }
11
+ export declare function OnrampRoute(props: OnrampRouteProps): import("react").JSX.Element;
12
+ export {};
@@ -0,0 +1,16 @@
1
+ import { type ReactNode } from "react";
2
+ import { type RampAction, type RampMoney, type RampSnapshot, type XochiRampPreview } from "@xochi/client";
3
+ export declare const routeMoney: (money: RampMoney) => string;
4
+ /** Public presentation only: provider and wallet signing material never enters this view. */
5
+ export declare function RampRouteSteps({ snapshot, preview, wallet, received, busy, disabled, quoteDisabled, completedNote, onAction, children, }: {
6
+ snapshot: RampSnapshot;
7
+ preview?: XochiRampPreview;
8
+ wallet: string;
9
+ received: RampMoney;
10
+ busy?: boolean;
11
+ disabled?: boolean;
12
+ quoteDisabled?: boolean;
13
+ completedNote?: string;
14
+ onAction(action: RampAction): void;
15
+ children?: ReactNode;
16
+ }): import("react").JSX.Element | null;
@@ -0,0 +1,4 @@
1
+ import { type RampMoney } from "@xochi/client";
2
+ import type { SwapActivityItem } from "../../types/activity.js";
3
+ /** Existing Xochi activity holds its public intent reference; only a widget reference is added. */
4
+ export declare function findOnrampRoute(wallet: string, operationId: string, delivered: RampMoney): SwapActivityItem | undefined;
@@ -0,0 +1,22 @@
1
+ import { type RampLegSnapshot, type RampMoney, type XochiRampDriver } from "@xochi/client";
2
+ import type { UseIntentReturn } from "../../hooks/useIntent.js";
3
+ /** The validated interpreter boundary; signing data stays inside the existing Swap machine. */
4
+ export type RampSwapInterpreter = Pick<UseIntentReturn, "status" | "quote" | "error" | "canSign" | "intentId" | "tierName" | "legsWithheld" | "txHash" | "receivingTxHash" | "settlementTxHash" | "settlementChainId" | "substatus" | "requestQuote" | "refreshQuote" | "reset" | "sign" | "resume"> & {
5
+ receipt: Pick<UseIntentReturn["receipt"], "phase">;
6
+ };
7
+ /** The existing Swap machine remains the sole quote validation and signing authority. */
8
+ export declare function routeMachineStatus(intent: Pick<RampSwapInterpreter, "receipt" | "settlementTxHash" | "receivingTxHash">): RampLegSnapshot;
9
+ /** Promise port over useIntent's quote/execute/poll interpreter, with no second signing flow. */
10
+ export declare function useXochiRampDriver(options: {
11
+ intent: RampSwapInterpreter;
12
+ pay: RampMoney;
13
+ receiveAsset: RampMoney["asset"];
14
+ recipient: string;
15
+ settlement: "public" | "stealth";
16
+ authorized: boolean;
17
+ operationId: string;
18
+ wallet: string;
19
+ payee: "own" | "other";
20
+ routeState?: RampLegSnapshot["state"];
21
+ requireDurableCorrelation?: boolean;
22
+ }): XochiRampDriver;
@@ -0,0 +1,14 @@
1
+ function ok(data) {
2
+ return { success: true, data };
3
+ }
4
+ function err(error, meta) {
5
+ return { success: false, error, ...meta };
6
+ }
7
+ function isOk(result) {
8
+ return result.success;
9
+ }
10
+ export {
11
+ err,
12
+ isOk,
13
+ ok
14
+ };
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,184 @@
1
+ /**
2
+ * Activity Types
3
+ *
4
+ * Unified activity feed types for swaps, x402 payments, and permits.
5
+ */
6
+ import type { SendRecipientDisplay } from "../pages/send/sendCopy.js";
7
+ import type { IntentStatus, SelectableChainId, SettlementType } from "./intent.js";
8
+ import { type StoredDepositAttestation } from "@xochi/client";
9
+ export type ActivityType = "swap" | "x402_payment" | "permit";
10
+ /**
11
+ * Deposit-route facts, for a swap the user funds by hand.
12
+ *
13
+ * Persisted because this is the one flow whose completion REQUIRES leaving the
14
+ * browser: a non-EVM origin has no gasless pull, so the user reads an address
15
+ * here and sends from a Tron wallet, and a mobile OS evicts the backgrounded tab
16
+ * routinely. Without it the resumed flow modal reopens with no address to send
17
+ * to and no window to send within, which is a worse view than not reopening.
18
+ *
19
+ * These are already-displayed, solver-issued facts, so persisting them
20
+ * fabricates nothing. That is why they can be restored while a QUOTE cannot: a
21
+ * quote asserts a live price, and a stale one shown as current would be a lie.
22
+ * A deposit address does not go stale, it expires, and the deadline says so.
23
+ *
24
+ * STORED AS THE SIGNED BINDING, NOT AS LOOSE DISPLAY FIELDS, and that shape is
25
+ * the point. localStorage is not a trust boundary: it is same-origin mutable
26
+ * state that survives reloads and outlives whatever wrote it. An address read
27
+ * from there and rendered with a QR and a Copy button, unchecked, gives away the
28
+ * invariant this whole module exists for (`verifyDepositAttestation`: the
29
+ * signature must recover to the pinned signer BEFORE the address is ever shown).
30
+ *
31
+ * So the record carries the exact 18 fields the solver signed plus the
32
+ * signature, and `verifyStoredDeposit` re-proves them on the way out. Every
33
+ * value the deposit screen displays is read from `attested`, so what is shown
34
+ * and what was verified are the same object rather than two derivations that
35
+ * could drift.
36
+ *
37
+ * A record written before the cutover to `@xochi/client` carries the old
38
+ * camelCase field set, so the stored value is typed here as what is WRITTEN,
39
+ * not what is read: `verifyStoredDeposit` takes the record as `unknown`,
40
+ * renames a pre-cutover one to this shape, proves it like any other, and hands
41
+ * back the proven binding. Anything else it refuses.
42
+ */
43
+ export type DepositActivity = StoredDepositAttestation;
44
+ export interface SwapActivity {
45
+ /**
46
+ * Both legs are `SelectableChainId`, which includes Tron.
47
+ *
48
+ * These were `ChainId` (EVM only), and `useSwapPanel`'s capture write was
49
+ * gated on `isChainId` for both, so ANY swap with a Tron leg was silently
50
+ * never persisted. That write feeds the activity row, the background status
51
+ * poll in `useLocalActivity` and `findResumableSwap`, so those swaps had no
52
+ * row, no poll and no resume: they existed only in the memory of one tab.
53
+ * Tron DESTINATION is live, so this was dropping production swaps, not only
54
+ * the gated origin corridor.
55
+ */
56
+ fromChainId: SelectableChainId;
57
+ toChainId: SelectableChainId;
58
+ fromToken: string;
59
+ toToken: string;
60
+ fromAmount: string;
61
+ toAmount: string | null;
62
+ tier: string;
63
+ feeRate: number;
64
+ txHash: string | null;
65
+ /** Destination-leg fill hash on toChainId (cross-chain completions only). */
66
+ receivingTxHash?: string | null;
67
+ /** Public fill receipt (Riddler #632) + its chain; the receipt CTA keys off these. */
68
+ settlementTxHash?: string | null;
69
+ /**
70
+ * Riddler's granular fill substatus, verbatim. Persisted so the feed shares one
71
+ * delivery predicate with the flow modal: without it the feed still escalated
72
+ * to "email us" while the modal said the funds had landed (xochi#376). On a
73
+ * `failed` row it holds the Worker's `not_executed` marker, the only failure
74
+ * the feed offers a retry on; on a `settling` shielded row, the Worker's
75
+ * `awaiting_recipient` marker.
76
+ */
77
+ substatus?: string | null;
78
+ /**
79
+ * The status-only view's `settlement_confirmed` (SPEC §5.1): the fill receipt
80
+ * exists but its hash was withheld from this read. The feed reads it as
81
+ * delivery, like `substatus: filled` (which that view omits); it never makes
82
+ * the row terminal. Replaced by every withheld read, so a refund clears it.
83
+ */
84
+ settlementConfirmed?: boolean;
85
+ /**
86
+ * Selectable rather than EVM-only for the same reason as the legs: a Tron
87
+ * destination fill settles on Tron, and `swapExplorerLinks` already accepts it
88
+ * (it narrows with `isSelectableChainId`). The type was the only thing saying
89
+ * otherwise.
90
+ */
91
+ settlementChainId?: SelectableChainId | null;
92
+ /**
93
+ * A Canton destination's delivery: the update id Riddler's attester verified
94
+ * it against (`escrow.cantonUpdateId` on status), verbatim. Canton has no
95
+ * transaction hash, so the feed links this on ccview instead.
96
+ */
97
+ cantonUpdateId?: string | null;
98
+ isCrossChain: boolean;
99
+ /** Destination type. USDX is archived; "stealth" is reserved (no emitter yet). */
100
+ destinationType?: "chain" | "aztec" | "stealth";
101
+ /**
102
+ * Settlement mode the order was DISPATCHED with (bound at confirm, not the
103
+ * live toggle). Written at capture so Retry restores it (Phase 6: retry
104
+ * preserves route, token, amount, AND settlement) and so a completed
105
+ * stealth row can point at the claims surface.
106
+ *
107
+ * Absent on records written before the field existed; readers treat that
108
+ * as public. Deliberate: legacy captures recorded no settlement marker at
109
+ * all, so a stealth history row from before this field cannot be told from
110
+ * a public one, and guessing "stealth" would put a claims action on public
111
+ * rows. Funds at legacy stealth addresses are still surfaced by the
112
+ * claims nudge / receive panel, which read the server-side settlements
113
+ * index and do not depend on history rows.
114
+ */
115
+ settlementType?: SettlementType;
116
+ /**
117
+ * `"other"` on a stealth order that paid someone else's meta-address (Send >
118
+ * Stealth). The marker only: their keys are never stored and the row offers
119
+ * no claim. Send retries require the recipient to be supplied again from the
120
+ * session or resolved from their original name. Absent means the wallet's own keys.
121
+ */
122
+ stealthPayee?: "other";
123
+ /** Immutable zk.money recipient captured from the dispatched public tag order. */
124
+ recipientTag?: string;
125
+ /** Send identity and a retry input only when it is a name or an alias. */
126
+ sendRecipientDisplay?: SendRecipientDisplay;
127
+ swapRecipientLabel?: string;
128
+ /** The original name or zk.money alias, when the recipient was entered that way. */
129
+ swapRecipientRetryInput?: string;
130
+ /**
131
+ * Deposit-route facts, present only on a swap the user funds by hand. See
132
+ * `DepositActivity`.
133
+ */
134
+ deposit?: DepositActivity | null;
135
+ }
136
+ export type ActivityStatus = "pending" | "completed" | "failed" | "active" | "expired";
137
+ interface ActivityBase {
138
+ id: string;
139
+ timestamp: number;
140
+ status: ActivityStatus;
141
+ }
142
+ export interface SwapActivityItem extends ActivityBase {
143
+ type: "swap";
144
+ /** Widget-minted ramp reference linking an independent post-route; never a Peer handle. */
145
+ rampOperationId?: string;
146
+ data: SwapActivity;
147
+ intentStatus: IntentStatus;
148
+ /** Who initiated: "you" (this device) or "agent" (a delegated agent stream). */
149
+ initiator?: "you" | "agent";
150
+ /** Friendly agent label when initiator is "agent". */
151
+ agentLabel?: string;
152
+ /**
153
+ * Wallet whose local activity bucket supplied this row. Derived from the
154
+ * bucket key when read and never persisted inside the record.
155
+ */
156
+ ownerWallet?: string;
157
+ /**
158
+ * The latest status read returned a status-only private-intent view.
159
+ * Replaced by every read and used to select the owner recovery action.
160
+ */
161
+ legsWithheld?: boolean;
162
+ }
163
+ export declare function getActivityIcon(type: ActivityType): string;
164
+ export declare function getActivityLabel(type: ActivityType): string;
165
+ /**
166
+ * Honest badge for a swap row, driven by the granular `IntentStatus` instead of
167
+ * the collapsed `ActivityStatus`. Keeps refunded/expired/awaiting_deposit/
168
+ * bridging/settling distinct in the feed rather than flattening them to
169
+ * pending/failed. Returns a plain label plus the CSS status class to apply.
170
+ */
171
+ export declare function getSwapStatusBadge(status: IntentStatus): {
172
+ label: string;
173
+ className: string;
174
+ };
175
+ /** Terminal-negative swap states that offer a Report action in the feed. */
176
+ export declare function isReportableSwapStatus(status: IntentStatus): boolean;
177
+ /**
178
+ * Swap rows a user can re-attempt with a fresh quote from the feed. Every row is
179
+ * an order that was sent (the local log captures nothing earlier, and server
180
+ * history omits `quoted`), so a `failed` row is retryable only with the Worker's
181
+ * `not_executed` marker: any other failure may have moved funds.
182
+ */
183
+ export declare function isRetryableSwapStatus(status: IntentStatus, substatus: string | null | undefined): boolean;
184
+ export {};
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Xochi Shared Types
3
+ *
4
+ * Centralized type definitions used across the application.
5
+ */
6
+ export type { ProviderCategory } from "@xochi/client";
7
+ export interface Provider {
8
+ id: string;
9
+ name: string;
10
+ category: import("@xochi/client").ProviderCategory;
11
+ points: number;
12
+ description: string;
13
+ icon: string;
14
+ }
15
+ export interface VerifyState {
16
+ score: number;
17
+ connectedProviders: string[];
18
+ }
19
+ export declare function isVerifyState(value: unknown): value is VerifyState;
20
+ export type { SettlementType } from "./intent.js";
@@ -0,0 +1,85 @@
1
+ /**
2
+ * Intent Types
3
+ *
4
+ * Type definitions for the cross-chain intent system.
5
+ * Supports Riddler integration and Aztec privacy layer.
6
+ */
7
+ export type { ChainId, ExtendedChainId, SelectableChainId, IntentStatus, SettlementType, Eip712TypedData, SettlementOption, } from "@xochi/client";
8
+ export type { IntentDestination, QuoteResponse, IntentWebSocketMessage, PaymentMethod, RaceWebSocketMessage, } from "@xochi/client";
9
+ export { isRaceWebSocketMessage } from "@xochi/client";
10
+ import type { IntentDestination, PaymentMethod } from "@xochi/client";
11
+ export { isChainId, isSelectableChainId, canTransitionTo, getStatusLabel } from "@xochi/client";
12
+ import type { ExtendedChainId } from "@xochi/client";
13
+ /** Default destination: public L1 settlement */
14
+ export declare const DEFAULT_DESTINATION: IntentDestination;
15
+ /** Stealth destination: L1 stealth address */
16
+ export declare const STEALTH_DESTINATION: IntentDestination;
17
+ export interface Token {
18
+ address: string;
19
+ symbol: string;
20
+ name: string;
21
+ decimals: number;
22
+ chainId: ExtendedChainId;
23
+ logoUri?: string;
24
+ }
25
+ export type { FeeBreakdown } from "@xochi/client";
26
+ export interface PaymentMethodInfo {
27
+ method: PaymentMethod;
28
+ label: string;
29
+ description: string;
30
+ gasless: boolean;
31
+ }
32
+ export declare const PAYMENT_METHODS: Record<PaymentMethod, PaymentMethodInfo>;
33
+ /** True when `value` is a known payment method (a key of PAYMENT_METHODS). */
34
+ export declare function isPaymentMethod(value: unknown): value is PaymentMethod;
35
+ /**
36
+ * Resolve the payment method to display for a quote.
37
+ *
38
+ * Prefers the server-supplied method (Riddler's `payment_method`, mapped to
39
+ * `quote.paymentMethod`) because only the solver knows the true settlement path:
40
+ * `x402` (paid, NOT gasless), `mpp` (agent relay), and `approval` (on-chain, NOT
41
+ * gasless) carry no `pull_authorization`, so the permit-type guess below cannot
42
+ * reach them and would mislabel the method AND its gasless promise. The permit +
43
+ * gasless inference is the fallback for older/edge quotes that omit the field.
44
+ * The returned method keys into PAYMENT_METHODS for the label + honest gasless
45
+ * flag, so both are always taken from the resolved method (never `quote.gasless`
46
+ * directly). Shared by QuoteDetails and TransactionPreview so they cannot drift.
47
+ *
48
+ * A DEPOSIT ROUTE OVERRIDES THE SERVER VALUE, which is the one case where the
49
+ * solver's own field is wrong rather than merely unknowable locally. A live
50
+ * Tron-origin quote returns `payment_method: "permit2"` alongside
51
+ * `gasless: false` and a `deposit_address`. Preferring that answer rendered
52
+ * "Permit2 (gasless)" on a route that has no permit, no pull, and no wallet
53
+ * signature of any kind: the user reads a promise to sign something and is then
54
+ * handed an address to send TRC-20 to, at their own network cost. The label also
55
+ * contradicted the same response's `gasless: false`, because PAYMENT_METHODS
56
+ * carries the honest flag per method and `permit2` is gasless.
57
+ *
58
+ * `depositAddress` is the signal, and it is required rather than optional so a
59
+ * new call site cannot silently inherit the mislabel. Its presence alone is
60
+ * sound HERE even though `config.ts` defines a deposit route as the origin
61
+ * chain's VM and this field AGREEING: useIntent enforces that agreement at
62
+ * quote-ingest and discards the quote when they disagree, so a quote that
63
+ * reaches a display component has already passed it.
64
+ */
65
+ export declare function resolvePaymentMethod(serverMethod: PaymentMethod | undefined, permitType: PermitType | undefined, gasless: boolean, depositAddress: string | undefined): PaymentMethod;
66
+ /**
67
+ * Whether the origin pull needs an on-chain approval transaction first, read
68
+ * off the wallet's real ERC-20 allowance to the canonical Permit2 (usePermit).
69
+ *
70
+ * - `none`: the pull needs no allowance (ERC-3009, or no EVM pull at all).
71
+ * - `covered`: a Permit2 pull whose allowance already covers the amount.
72
+ * - `required`: a Permit2 pull whose allowance is short, so the first swap
73
+ * sends a gasful `approve(Permit2)`.
74
+ * - `unknown`: a Permit2 pull whose allowance is not known (loading, failed,
75
+ * no wallet, or a served domain naming a non-canonical Permit2, which
76
+ * `ensureApproval` refuses). Never read as either answer.
77
+ */
78
+ export type OriginApproval = "none" | "covered" | "required" | "unknown";
79
+ /**
80
+ * Whether the payment costs the wallet no gas at all: a gasless method whose
81
+ * pull needs no approval transaction first. Drives the "no gas" claim and its
82
+ * colour, so the two cannot disagree.
83
+ */
84
+ export declare function paysNoGas(method: PaymentMethod, approval: OriginApproval): boolean;
85
+ export type PermitType = "eip2612" | "erc3009" | "permit2" | "none";
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Result Types
3
+ *
4
+ * Standardized result types for operations that can fail.
5
+ * Provides type-safe error handling without exceptions.
6
+ */
7
+ /** Successful result with data */
8
+ export interface Ok<T> {
9
+ success: true;
10
+ data: T;
11
+ error?: never;
12
+ }
13
+ /** Failed result with error */
14
+ export interface Err {
15
+ success: false;
16
+ data?: never;
17
+ error: string;
18
+ /**
19
+ * HTTP status, when the failure came from a server response rather than a
20
+ * transport error or timeout. Lets a caller distinguish retryable (429/503)
21
+ * from terminal (404/409) without parsing prose.
22
+ */
23
+ status?: number;
24
+ /**
25
+ * The server's `error_category`, when it sent one. Typed as `string` because
26
+ * it is untrusted wire data and the server may add categories ahead of this
27
+ * client; compare against the vocabularies in `@xochi/client` rather than
28
+ * against a literal.
29
+ */
30
+ errorCategory?: string;
31
+ /**
32
+ * The parsed JSON error body, when there was one. Untrusted wire data: parse
33
+ * it with the matching `@xochi/client` schema before reading a field. Needed
34
+ * where a body carries more than `error` + `error_category` -- a pending
35
+ * stealth claim's `retryAfter`, preserved for callers that consume a Result
36
+ * rather than the raw response and its CORS-exposed Retry-After header.
37
+ */
38
+ body?: unknown;
39
+ }
40
+ /** Server-response detail attached to an `Err`. */
41
+ export interface ErrMeta {
42
+ status?: number;
43
+ errorCategory?: string;
44
+ body?: unknown;
45
+ }
46
+ /** Result type - either Ok with data or Err with error message */
47
+ export type Result<T> = Ok<T> | Err;
48
+ /** Create a successful result */
49
+ export declare function ok<T>(data: T): Ok<T>;
50
+ /** Create a failed result */
51
+ export declare function err(error: string, meta?: ErrMeta): Err;
52
+ /** Check if result is successful */
53
+ export declare function isOk<T>(result: Result<T>): result is Ok<T>;