@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,74 @@
1
+ /**
2
+ * The live preview quote behind the "What users see" panel
3
+ * (xochi-fi/xochi-widget#40). See previewQuote.ts for what is asked for.
4
+ *
5
+ * Asked through the frame's transport with no credential (`anonymousIntentAPI`:
6
+ * the same quote cache and in-flight deduplication, but never a bearer token,
7
+ * so a wallet or passkey session the integrator has stored does not ride
8
+ * along on a visitor's preview), and only after the request has been unchanged for
9
+ * the frame's own quote debounce, so typing an amount never sends a request
10
+ * per keystroke. Everything is keyed on the request itself (`plan.key`): an
11
+ * option that does not change the request (the settlement mode, a theme) asks
12
+ * nothing, and a reply for a request the panel has since left is dropped.
13
+ *
14
+ * While shown, the price is asked for again every PREVIEW_REFRESH_MS, in
15
+ * place (no loading flash), so "live" stays true on an open page.
16
+ */
17
+ import { type StructuredError } from "@xochi/client";
18
+ import type { QuoteResponse } from "../../types/intent.js";
19
+ import type { EmbedDefaults } from "../trade/embedParams.js";
20
+ import type { CapabilityState, RoutePrivacyMode } from "@xochi/client";
21
+ import { type PricedAmount } from "./previewQuote.js";
22
+ /** How often an open panel refreshes its price. */
23
+ export declare const PREVIEW_REFRESH_MS = 60000;
24
+ export type PreviewFee = {
25
+ kind: "no_amount";
26
+ } | {
27
+ kind: "needs_recipient";
28
+ chainName: string;
29
+ } | {
30
+ kind: "unconfirmed";
31
+ reason: "stale" | "fallback" | "failed" | "route" | "private";
32
+ } | {
33
+ kind: "out_of_bounds";
34
+ amount: PricedAmount;
35
+ notice: string;
36
+ } | {
37
+ kind: "loading";
38
+ amount: PricedAmount;
39
+ }
40
+ /** Solvable: the price the frame shows a visitor. */
41
+ | {
42
+ kind: "ready";
43
+ amount: PricedAmount;
44
+ quote: QuoteResponse;
45
+ }
46
+ /** The solver declined the route at this amount; `quote` carries its reason. */
47
+ | {
48
+ kind: "declined";
49
+ amount: PricedAmount;
50
+ quote: QuoteResponse;
51
+ }
52
+ /** No answer: the request failed (with the API's code and retry time) or could not be built. */
53
+ | {
54
+ kind: "failed";
55
+ amount: PricedAmount;
56
+ error: StructuredError;
57
+ };
58
+ export interface UsePreviewFeeResult {
59
+ fee: PreviewFee;
60
+ prices: Record<string, number>;
61
+ /** Privacy modes authorized by the exact selected live route. */
62
+ routePrivacyModes: readonly RoutePrivacyMode[];
63
+ capabilityState: CapabilityState;
64
+ /** A capability retry is currently in flight. */
65
+ retryingRoutes: boolean;
66
+ trustEconomicsLive: boolean;
67
+ /** Ask again after a failure. */
68
+ retry: () => void;
69
+ }
70
+ /**
71
+ * The preview fee for `config`. Nothing is requested while `enabled` is false
72
+ * (the panel is collapsed behind its disclosure).
73
+ */
74
+ export declare function usePreviewFee(config: EmbedDefaults, enabled: boolean): UsePreviewFeeResult;
@@ -0,0 +1,9 @@
1
+ /**
2
+ * A stealth meta-address on screen: abbreviated, with a Copy that puts the full
3
+ * `st:eth:0x...` on the clipboard so the sender can check it against what the
4
+ * recipient sent. A refused clipboard shows the full value selected instead, as
5
+ * ReceiptCommand does. Both outcomes are announced.
6
+ */
7
+ export declare function MetaAddressValue({ encoded }: {
8
+ encoded: string;
9
+ }): import("react").JSX.Element;
@@ -0,0 +1,3 @@
1
+ export declare function Receive({ onConnect }: {
2
+ onConnect?: () => void;
3
+ }): import("react").JSX.Element;
@@ -0,0 +1,3 @@
1
+ export declare function RecentRecipients({ onSelect }: {
2
+ onSelect: (input: string) => void;
3
+ }): import("react").JSX.Element | null;
@@ -0,0 +1,4 @@
1
+ import type { ResolvedRecipient } from "../../lib/recipient/index.js";
2
+ export declare function RecipientChip({ recipient }: {
3
+ recipient: ResolvedRecipient;
4
+ }): import("react").JSX.Element;
@@ -0,0 +1,3 @@
1
+ export declare function ScanRecipient({ onScan }: {
2
+ onScan: (value: string) => void;
3
+ }): import("react").JSX.Element | null;
@@ -0,0 +1,17 @@
1
+ import type { SwapPrefill } from "../trade/SwapPanel.js";
2
+ import type { SendDestinationKind } from "../trade/WidgetTabs.js";
3
+ import type { SendRetryDraft } from "./sendRetry.js";
4
+ import type { ResolvedRecipient } from "../../lib/recipient/index.js";
5
+ type SettlementOrder = Omit<SwapPrefill, "nonce">;
6
+ interface SendFormProps {
7
+ initialChain?: number;
8
+ retry?: SendRetryDraft;
9
+ onEditRetry?: () => void;
10
+ active?: boolean;
11
+ /** Hosted wallet UI delegates the connect prompt to the embedding page. */
12
+ onConnectRequest?: () => void;
13
+ destinations: readonly SendDestinationKind[];
14
+ onQuote: (order: SettlementOrder, recipient: ResolvedRecipient) => void;
15
+ }
16
+ export declare function SendForm(props: SendFormProps): import("react").JSX.Element;
17
+ export {};
@@ -0,0 +1,19 @@
1
+ import type { ResolvedRecipient } from "../../lib/recipient/index.js";
2
+ import type { Ref } from "react";
3
+ import type { SwapPrefill } from "../trade/SwapPanel.js";
4
+ import { type SendDestinationKind } from "../trade/WidgetTabs.js";
5
+ import type { SendRetryDraft } from "./sendRetry.js";
6
+ interface SendPanelProps {
7
+ initialChain?: number;
8
+ retry?: SendRetryDraft;
9
+ onEditRetry?: () => void;
10
+ active: boolean;
11
+ destinations?: readonly SendDestinationKind[];
12
+ showQuote: boolean;
13
+ quoteMount: Ref<HTMLDivElement>;
14
+ onCloseQuote: () => void;
15
+ onQuote: (order: Omit<SwapPrefill, "nonce">, recipient: ResolvedRecipient) => void;
16
+ onConnectRequest?: () => void;
17
+ }
18
+ export declare function SendPanel({ destinations, active, showQuote, quoteMount, onCloseQuote, ...props }: SendPanelProps): import("react").JSX.Element;
19
+ export {};
@@ -0,0 +1 @@
1
+ export declare function ShieldedDisclosure(): import("react").JSX.Element;
@@ -0,0 +1 @@
1
+ export declare function StealthInvite(): import("react").JSX.Element;
@@ -0,0 +1,62 @@
1
+ /**
2
+ * The Send tab's `address` destination: a public ERC-20 transfer from the
3
+ * connected wallet to a wallet address on the same chain.
4
+ *
5
+ * Pure checks, so the panel and its tests share one definition of "this send
6
+ * may go to review". Every amount is atomic-unit `bigint`; the typed string is
7
+ * parsed once, with the token's own decimals, and never through a float.
8
+ *
9
+ * The chains offered are the wallet's EVM chains that this build has token
10
+ * metadata for, so the recipient is always validated as an EVM address for the
11
+ * chain the transfer executes on (checksum included, zero address refused).
12
+ */
13
+ import { type Address } from "viem";
14
+ import type { Token } from "../../types/intent.js";
15
+ /** The ERC-20s a send on `chainId` can move. */
16
+ export declare function sendTokens(chainId: number): readonly Token[];
17
+ /** The asset a new send starts on: USDC where the chain has it, else its first token. */
18
+ export declare function defaultSendToken(chainId: number): Token | undefined;
19
+ /** Of the wallet's configured chains, those a send can execute on, in that order. */
20
+ export declare function sendChainIds(configured: readonly number[]): number[];
21
+ export declare function chainName(chainId: number): string;
22
+ export interface AddressSendDraft {
23
+ chainId: number;
24
+ tokenAddress: string;
25
+ /** As typed. */
26
+ amount: string;
27
+ recipient: string;
28
+ }
29
+ /** What review shows and what the wallet is asked to sign: nothing else. */
30
+ export interface AddressSendOrder {
31
+ chainId: number;
32
+ token: Token;
33
+ amount: bigint;
34
+ recipient: Address;
35
+ }
36
+ export interface AddressSendErrors {
37
+ asset?: string;
38
+ amount?: string;
39
+ recipient?: string;
40
+ }
41
+ export type AddressSendCheck = {
42
+ ok: true;
43
+ order: AddressSendOrder;
44
+ } | {
45
+ ok: false;
46
+ errors: AddressSendErrors;
47
+ };
48
+ export interface AddressSendContext {
49
+ /** The chains offered (`sendChainIds`). */
50
+ chainIds: readonly number[];
51
+ /** The token's balance in atomic units, or null while unknown. */
52
+ balance: bigint | null;
53
+ }
54
+ /** The typed amount in atomic units, or why it cannot be sent. */
55
+ export declare function checkSendAmount(typed: string, token: Token, balance: bigint | null): {
56
+ amount: bigint;
57
+ } | {
58
+ error: string;
59
+ };
60
+ /** Whether the draft may go to review, with one message per field that may not. */
61
+ export declare function checkAddressSend(draft: AddressSendDraft, context: AddressSendContext): AddressSendCheck;
62
+ export declare function defaultSendChain(chainIds: readonly number[], preferred?: number): number;
@@ -0,0 +1,9 @@
1
+ export { SHIELDED_DESCRIPTION } from "../trade/settlementCopy.js";
2
+ export interface SendRecipientDisplay {
3
+ mode: "Stealth" | "Shielded";
4
+ label: string;
5
+ /** Only a resolved name or an explicit zk.money alias may be persisted for retry. */
6
+ retryInput?: string;
7
+ }
8
+ export declare function sentToRecipient({ mode, label }: SendRecipientDisplay): string;
9
+ export declare function confirmSend({ mode }: SendRecipientDisplay): string;
@@ -0,0 +1,10 @@
1
+ import type { ResolvedRecipient } from "../../lib/recipient/index.js";
2
+ import type { SwapPrefill } from "../trade/SwapPanel.js";
3
+ import type { SendRecipientDisplay } from "./sendCopy.js";
4
+ export interface SendRetryDraft extends SwapPrefill {
5
+ mode: SendRecipientDisplay["mode"];
6
+ input?: string;
7
+ }
8
+ export declare function rememberSendRecipient(display: SendRecipientDisplay, recipient: ResolvedRecipient): void;
9
+ export declare function rememberSendIntent(intentId: string, display: SendRecipientDisplay): void;
10
+ export declare function recallSendRecipient(intentId: string): ResolvedRecipient | undefined;
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Another person's Stealth meta-address, as the Send tab accepts it.
3
+ *
4
+ * ERC-5564 scheme 1 encodes a recipient as `st:eth:0x` followed by two
5
+ * compressed secp256k1 public keys, spending then viewing (33 bytes each), the
6
+ * form `encodeMetaAddress` in `@xochi/signer` writes. Parsing is strict: the
7
+ * prefix, the exact length, hex only, and both keys must be points on the
8
+ * curve. Anything else is refused with a reason; nothing is repaired.
9
+ *
10
+ * Only public keys are held. The one-time address is derived from them by the
11
+ * existing Stealth settlement (the quote request carries the meta-address, as
12
+ * it does for the wallet's own keys), and the recipient finds the payment with
13
+ * their own keys through the scanner in `lib/stealth.ts`.
14
+ */
15
+ /** A parsed meta-address: public keys only, lowercase `0x` hex. */
16
+ export interface StealthRecipient {
17
+ /** The canonical `st:eth:0x...` form. */
18
+ encoded: string;
19
+ /** Compressed spending public key (33 bytes). */
20
+ spendingPubKey: string;
21
+ /** Compressed viewing public key (33 bytes). */
22
+ viewingPubKey: string;
23
+ }
24
+ export type StealthRecipientCheck = {
25
+ ok: true;
26
+ recipient: StealthRecipient;
27
+ } | {
28
+ ok: false;
29
+ error: string;
30
+ };
31
+ /**
32
+ * Parse a pasted meta-address. Surrounding whitespace from a paste is ignored;
33
+ * everything between the ends must be exact.
34
+ */
35
+ export declare function parseStealthMetaAddress(input: string): StealthRecipientCheck;
36
+ /** `st:eth:0x` and the first and last six hex characters. */
37
+ export declare function abbreviateMetaAddress(encoded: string): string;
@@ -0,0 +1,18 @@
1
+ /**
2
+ * The Send tab's `stealth` destination, as data.
3
+ *
4
+ * A Stealth send is the existing Stealth settlement, not a new transfer type:
5
+ * the value leaves the connected wallet as a Xochi order whose payout lands at
6
+ * a one-time address derived from the wallet's own stealth keys (ERC-5564),
7
+ * claimed later from Claims. The quote, the signature, the confirm modal and
8
+ * every refusal are the Swap card's, reached through its prefill, so nothing
9
+ * here derives keys or addresses and nothing can settle Public in its place.
10
+ *
11
+ * Which networks the payout may land on is the producer's exact route list,
12
+ * and only while it is `live`: the same asset, routed with `stealth` among its
13
+ * privacy modes. Anything else offers nothing.
14
+ */
15
+ import type { SolverCapabilities } from "@xochi/signer";
16
+ import type { CapabilityState } from "@xochi/client";
17
+ /** Destination chains a Stealth send of `symbol` from `chainId` can settle on. */
18
+ export declare function stealthSendDestinations(caps: Pick<SolverCapabilities, "routes">, state: CapabilityState, chainId: number, symbol: string): number[];
@@ -0,0 +1,61 @@
1
+ /**
2
+ * useAddressSend
3
+ *
4
+ * The `address` send's lifecycle: edit -> review -> wallet approval -> sent.
5
+ *
6
+ * Nothing reaches the wallet before the user presses the review screen's
7
+ * approval button, and what the wallet is asked for is exactly the reviewed
8
+ * order (`AddressSendOrder`), bound to the wallet and chain that reviewed it.
9
+ * A wallet, account or chain change while reviewing drops back to editing, so
10
+ * an approval can never sign for a sender the review did not show.
11
+ *
12
+ * The transfer goes through wagmi's connector, so the widget's own wallets and
13
+ * the host page's wallet (lent over `@xochi/widget-lib`'s bridge, which carries
14
+ * `eth_sendTransaction` and `wallet_switchEthereumChain`) take the same path.
15
+ * A network switch, when needed, is its own explicit step.
16
+ */
17
+ import { type Hex } from "viem";
18
+ import { type SendAttempt } from "../../lib/localSends.js";
19
+ import { type AddressSendOrder } from "./addressSend.js";
20
+ export type AddressSendPhase = {
21
+ step: "edit";
22
+ } | {
23
+ step: "in_doubt";
24
+ order: AddressSendOrder;
25
+ attempt: SendAttempt;
26
+ notice?: string;
27
+ } | {
28
+ step: "blocked";
29
+ } | {
30
+ step: "review";
31
+ order: AddressSendOrder;
32
+ notice?: string;
33
+ } | {
34
+ step: "switching";
35
+ order: AddressSendOrder;
36
+ } | {
37
+ step: "approving";
38
+ order: AddressSendOrder;
39
+ } | {
40
+ step: "sent";
41
+ order: AddressSendOrder;
42
+ hash: Hex;
43
+ outcome: "pending" | "confirmed" | "reverted";
44
+ };
45
+ export interface UseAddressSendReturn {
46
+ phase: AddressSendPhase;
47
+ /** Hold a checked order for review. Never contacts the wallet. */
48
+ review: (order: AddressSendOrder) => void;
49
+ /** Back to the form, keeping what was typed. */
50
+ edit: () => void;
51
+ /** Ask the wallet to move to the order's chain (an explicit step). */
52
+ switchNetwork: () => Promise<void>;
53
+ /** Ask the wallet to approve exactly the reviewed transfer. */
54
+ approve: () => Promise<void>;
55
+ /** Start a new send once one has been sent. */
56
+ reset: () => void;
57
+ /** The wallet is on another chain than the reviewed order's. */
58
+ needsSwitch: boolean;
59
+ reconcile: (hash: string) => Promise<void>;
60
+ }
61
+ export declare function useAddressSend(): UseAddressSendReturn;
@@ -0,0 +1,13 @@
1
+ import { type RecipientDeps, type ResolveResult } from "../../lib/recipient/index.js";
2
+ declare const LOOKING: {
3
+ readonly status: "looking";
4
+ };
5
+ declare const EMPTY: {
6
+ readonly status: "empty";
7
+ };
8
+ type Lookup = (ResolveResult & {
9
+ networkMismatch?: boolean;
10
+ }) | typeof LOOKING | typeof EMPTY;
11
+ export declare function useRecipientDeps(): RecipientDeps | undefined;
12
+ export declare function useSendRecipient(input: string, chainId: number, attempt?: number): Lookup;
13
+ export {};
@@ -0,0 +1,22 @@
1
+ /**
2
+ * BuyPanel
3
+ *
4
+ * Trade's Buy mode (API `onramp`): buying Base USDC with fiat through Peer.
5
+ * Shows live Peer rail availability (ramp/availability); only a fresh
6
+ * `available` offer can be chosen, and choosing one starts nothing yet.
7
+ *
8
+ * A purchase that no live runtime owns (after a reload, or a return from Peer
9
+ * into a fresh view) is resumed first, from its sanitized local summary. While
10
+ * this wallet has a submitted purchase that has not settled, no rail can be
11
+ * chosen: another transfer must not start beside it. Inside an iframe, no rail
12
+ * is offered until a current host has pinned the origin (lib/rampHostGate);
13
+ * the resume view above stays regardless.
14
+ */
15
+ interface BuyPanelProps {
16
+ /** Whether Buy is the visible mode; a hidden panel reads nothing from Peer. */
17
+ active: boolean;
18
+ fiatCurrency?: string;
19
+ onConnectRequest?: () => void;
20
+ }
21
+ export declare function BuyPanel({ active, fiatCurrency, onConnectRequest }: BuyPanelProps): import("react").JSX.Element;
22
+ export {};
@@ -0,0 +1,22 @@
1
+ /**
2
+ * RampRecovery
3
+ *
4
+ * Recovery for a Peer operation already submitted from this browser, shown in
5
+ * Activity when the host's narrowing (`rampProviders` without `peer`, or a
6
+ * `modes` list without Buy or Cash out) has removed
7
+ * the surface that would otherwise resume it. Narrowing removes ways to START
8
+ * an operation; it must never strand one that moved money (a rollback that
9
+ * drops Peer mid-purchase is the case this covers).
10
+ *
11
+ * Recovery only: no rails are read and nothing new can start here. A purchase
12
+ * resumes through ResumeOnramp; a cash-out through PaymentAppSend, mounted
13
+ * only while its sanitized summary is open or in doubt, so the view leaves
14
+ * Activity once the order resolves.
15
+ */
16
+ import { type OfframpActivityItem } from "../../ramp/offramp/localOfframps.js";
17
+ export declare function PurchaseRecovery(): import("react").JSX.Element | null;
18
+ export declare function CashOutRecovery({ items, fiatCurrency, active, }: {
19
+ items: readonly OfframpActivityItem[];
20
+ fiatCurrency?: string;
21
+ active: boolean;
22
+ }): import("react").JSX.Element | null;
@@ -0,0 +1,11 @@
1
+ import { type ResolvedRecipient } from "../../lib/recipient/index.js";
2
+ import type { SettlementType } from "../../types/index.js";
3
+ export declare function recipientLabel(input: string): string;
4
+ export declare function recipientIssue(recipient: ResolvedRecipient, mode: SettlementType): string | null;
5
+ export declare function RecipientSheet({ selected, mode, onSelect, onClose, portalTarget, }: {
6
+ selected: ResolvedRecipient | null;
7
+ mode: SettlementType;
8
+ onSelect: (recipient: ResolvedRecipient | null, mode?: SettlementType) => void;
9
+ onClose: () => void;
10
+ portalTarget?: HTMLElement | null;
11
+ }): import("react").ReactPortal;
@@ -0,0 +1,24 @@
1
+ import type { PairAvailability } from "../../lib/pairAvailability.js";
2
+ import type { ExtendedChainId, Token } from "../../types/intent.js";
3
+ import { type SelectableChainId } from "@xochi/client";
4
+ import { type EmbedPolicy } from "./embedParams.js";
5
+ export type { ExtendedChainId } from "../../types/intent.js";
6
+ export interface TokenSelectorProps {
7
+ chainId: ExtendedChainId;
8
+ value: Token;
9
+ chainIds: readonly SelectableChainId[];
10
+ tokensByChain: ReadonlyMap<SelectableChainId, readonly Token[]>;
11
+ classify: (token: Token) => PairAvailability;
12
+ onChange: (token: Token) => void;
13
+ onChainChange?: (chainId: ExtendedChainId) => void;
14
+ showChain?: boolean;
15
+ isSource?: boolean;
16
+ policy?: EmbedPolicy;
17
+ chainBlockedReason?: (chainId: SelectableChainId) => string | null;
18
+ zkMoney?: {
19
+ selected: boolean;
20
+ onSelect: () => void;
21
+ };
22
+ liveStealthDestination?: boolean;
23
+ }
24
+ export declare function TokenSelector({ chainId, value, chainIds, tokensByChain, classify, onChange, onChainChange, showChain, isSource, policy, chainBlockedReason, zkMoney, liveStealthDestination, }: TokenSelectorProps): import("react").JSX.Element;
@@ -0,0 +1,34 @@
1
+ /**
2
+ * SwapPanel
3
+ *
4
+ * Lean market-swap surface for the unified launch screen. Cross-chain token
5
+ * in/out across the 6 supported chains. Public and stealth settlement are live;
6
+ * stealth destinations are narrowed by solver capabilities and local factory
7
+ * trust. Market orders only -- limit orders and direct Aztec settlement
8
+ * remain unavailable (#142). zk.money uses a public Ethereum deposit.
9
+ *
10
+ * Thin view over useSwapPanel: the hook owns all state/effects/handlers, this
11
+ * component only renders JSX. Composed by Trade.tsx alongside AssetsStrip and
12
+ * the transaction log.
13
+ */
14
+ import type { ResolvedRecipient } from "../../lib/recipient/index.js";
15
+ export type { SwapPrefill } from "./useSwapPanel.js";
16
+ import type { SwapPrefill } from "./useSwapPanel.js";
17
+ interface SwapPanelProps {
18
+ /** Values to seed the panel with when the user retries a past swap. */
19
+ prefill?: SwapPrefill | null;
20
+ sendRecipient?: ResolvedRecipient;
21
+ /** Fired once when a stealth swap settles, so the receive panel can auto-scan. */
22
+ onStealthSettled?: () => void;
23
+ /**
24
+ * The stealth receipt's Claim payment, when the host widget handles it itself
25
+ * (a frame without tabs opens the full widget). Absent, it closes the flow and
26
+ * hands off through `onStealthSettled`.
27
+ */
28
+ onGoToClaims?: () => void;
29
+ /** Whether the How it works disclosure shows (the frame's `howItWorks`). */
30
+ howItWorks?: boolean;
31
+ /** Hosted wallet UI delegates every connect prompt to the embedding page. */
32
+ onConnectRequest?: () => void;
33
+ }
34
+ export declare function SwapPanel({ prefill, sendRecipient, onStealthSettled, onGoToClaims, howItWorks, onConnectRequest, }?: SwapPanelProps): import("react").JSX.Element;
@@ -0,0 +1,46 @@
1
+ /**
2
+ * WidgetTabs
3
+ *
4
+ * The widget's in-frame tablist (Trade / Send / Activity / Claims), following
5
+ * the WAI-ARIA tabs pattern with automatic activation: one tab stop (roving
6
+ * tabindex), Left/Right arrows move and select with wrap-around, Home/End jump
7
+ * to the ends. Trade owns the selection and renders the matching tabpanels
8
+ * under the ids from `widgetTabIds`.
9
+ *
10
+ * The same component renders the nested choices inside a tab (Trade’s Swap |
11
+ * Buy | Cash out modes, Send's destination kind), so every level of the widget's
12
+ * navigation moves by the same keys.
13
+ *
14
+ * The id vocabularies are the embed contract's (peer-send-tab addendum), so
15
+ * the frame URL's `initialTab` / `tabs` / `initialMode` / `sendDestinations`
16
+ * can drive this state directly once they are parsed.
17
+ */
18
+ /** Top-level tabs, in display order. */
19
+ export declare const WIDGET_TAB_IDS: readonly ["trade", "send", "activity", "claims"];
20
+ export type WidgetTabId = (typeof WIDGET_TAB_IDS)[number];
21
+ export { TRADE_MODES, SEND_DESTINATIONS as SEND_DESTINATION_KINDS } from "@xochi/widget-lib";
22
+ export type { TradeMode, SendDestinationKind } from "@xochi/widget-lib";
23
+ export interface WidgetTab<Id extends string = WidgetTabId> {
24
+ id: Id;
25
+ label: string;
26
+ /** Count shown beside the label (e.g. claimable payments); hidden at 0. */
27
+ count?: number;
28
+ /** Spoken after the count, e.g. "ready to claim". */
29
+ countLabel?: string;
30
+ }
31
+ /** Element ids tying a tab to its panel (aria-controls / aria-labelledby). */
32
+ export declare function widgetTabIds(baseId: string, tab: string): {
33
+ tab: string;
34
+ panel: string;
35
+ };
36
+ interface WidgetTabsProps<Id extends string> {
37
+ baseId: string;
38
+ tabs: readonly WidgetTab<Id>[];
39
+ active: Id;
40
+ onSelect: (tab: Id) => void;
41
+ /** The tablist's accessible name. */
42
+ label?: string;
43
+ /** Extra classes for a nested tablist (e.g. a mode switch inside a tab). */
44
+ className?: string;
45
+ }
46
+ export declare function WidgetTabs<Id extends string = WidgetTabId>({ baseId, tabs, active, onSelect, label, className, }: WidgetTabsProps<Id>): import("react").JSX.Element;
@@ -0,0 +1,94 @@
1
+ /**
2
+ * Canton Coin as a destination (xochi-sdk#116; SPEC.md §3.3, §5.2.4).
3
+ *
4
+ * Base USDC -> Canton Coin, delivered to a Canton party the user types. Canton
5
+ * is destination-only and public only, and the order settles through the Base
6
+ * `RiddlerEscrow`: the taker's USDC is locked, a Riddler-run solver delivers
7
+ * Canton Coin, Riddler's attester verifies the delivery on Canton
8
+ * (`cantonUpdateId`), and the solver claims the lock. With no attested
9
+ * delivery, the taker refunds the lock from `refundableAt` on.
10
+ *
11
+ * Two rules shape this module:
12
+ *
13
+ * - A party id is case-sensitive and sent byte for byte as typed. The field is
14
+ * never trimmed or case-folded; a padded paste is refused, not repaired.
15
+ * - Delivery is Riddler's attestation and nothing else. A transfer the Canton
16
+ * gateway reports completed is not a delivery (a recipient without a
17
+ * preapproval only receives a pending offer), so `cantonEscrowView` reads the
18
+ * escrow status and the lock, never the intent's top-level status, a fill
19
+ * substatus or a balance.
20
+ */
21
+ import { type EscrowLock, type EscrowProgress, type EscrowStatusData, type SelectableChainId } from "@xochi/client";
22
+ /**
23
+ * Whether the widget offers `value` as a chain anywhere (resume, local
24
+ * activity): every selectable chain, Canton only while the corridor is live.
25
+ */
26
+ export declare function isOfferedChainId(value: unknown, cantonLive?: boolean): value is SelectableChainId;
27
+ /** The one line the Stealth and Shielded controls show with Canton as the destination. */
28
+ export declare const CANTON_PUBLIC_ONLY_LINE = "Canton is public only";
29
+ /** The recipient field's hint: what to paste, and that it settles in public. */
30
+ export declare const CANTON_RECIPIENT_HINT = "Paste the Canton party id exactly as the wallet shows it (name::1220...). It is sent as typed, and case matters. Public settlement only: Stealth and Shielded are not available to Canton.";
31
+ /**
32
+ * Recipient readiness (SPEC.md §5.2.4). Shown before quoting, because the
33
+ * venue refuses an unready party before anything locks.
34
+ */
35
+ export declare const CANTON_READINESS_NOTE = "The party must hold a Canton Coin transfer preapproval valid past this order's deadline. Without one the quote is refused and nothing is locked.";
36
+ /**
37
+ * The verdict on the recipient exactly as typed: the client's party parser
38
+ * (`validateAddressForVm(_, "cvm")`), plus a precise refusal for a party id
39
+ * padded with whitespace, which is never trimmed into a valid one.
40
+ */
41
+ export declare function cantonRecipientCheck(typed: string): {
42
+ valid: boolean;
43
+ error?: string;
44
+ };
45
+ /** A refused Canton quote, worded for the panel. Nothing locks on any of these. */
46
+ export interface CantonDecline {
47
+ title: string;
48
+ detail: string;
49
+ /** A fresh quote can succeed once the user acts on `detail`. */
50
+ requote: boolean;
51
+ }
52
+ /**
53
+ * The Worker's `error_category` for a refused Canton escrow quote (Riddler's
54
+ * `422 escrow_refused` `details.reason`, verbatim), worded for the panel; null
55
+ * for any other category, which keeps its generic copy. `above_solver_fill_cap`
56
+ * reaches the panel as `amount_too_large`, the float gate as `no_liquidity`,
57
+ * and an unreadable preapproval as a plain 503: all retryable, all generic.
58
+ */
59
+ export declare function cantonDecline(errorCategory: string | undefined): CantonDecline | null;
60
+ /** What the escrow panel renders, read off Riddler's status and the lock alone. */
61
+ export interface CantonEscrowView {
62
+ progress: EscrowProgress;
63
+ /** Unix seconds the refund opens (the lock's), or null until the lock is read. */
64
+ refundableAt: number | null;
65
+ /** The refund can be sent now: no delivery attested, the lock open, its time come. */
66
+ refundOpen: boolean;
67
+ /** The Canton update Riddler verified the delivery against, once attested. */
68
+ cantonUpdateId: string | null;
69
+ }
70
+ /**
71
+ * The escrow order's progress at `nowSec`, from the status poll's escrow
72
+ * fields and the lock read from the pinned escrow. Nothing else counts: not
73
+ * the intent's top-level status, a fill substatus or receipt, nor a balance.
74
+ *
75
+ * - The lock is the authority on claimed and refunded, and on `refundableAt`.
76
+ * - `delivered` needs Riddler's `cantonUpdateId` (`escrowProgress`).
77
+ * - `claimed` needs evidence of an attested delivery: the update id, or a lock
78
+ * that reads claimed. A status that says completed with neither is not
79
+ * believed, and reads `unknown` until one arrives.
80
+ * - A lock that is open while the status still says nothing is locked reads
81
+ * as locked.
82
+ */
83
+ export declare function cantonEscrowView(input: {
84
+ escrow: EscrowStatusData | null;
85
+ lock: EscrowLock | null;
86
+ nowSec: number;
87
+ }): CantonEscrowView;
88
+ /** Each escrow progress, worded for the panel. */
89
+ export declare const CANTON_ESCROW_COPY: Record<EscrowProgress, {
90
+ title: string;
91
+ detail: string;
92
+ }>;
93
+ /** The ccview link for an attested Canton update id (Canton has no 0x hash). */
94
+ export declare function cantonUpdateUrl(updateId: string): string;