@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,21 @@
1
+ /**
2
+ * useWalletSession
3
+ *
4
+ * Manages the sign-in-with-wallet session that authorizes wallet-scoped reads
5
+ * and durable Tron-origin quote allocation. It does NOT prompt on connect:
6
+ * callers invoke `ensureSession` only at an explicit gated action, such as
7
+ * viewing Activity or requesting a deposit route.
8
+ *
9
+ * The hook keeps the local `state` in sync with the stored session (reflecting
10
+ * an existing one on mount, clearing a stale one when the wallet changes or
11
+ * disconnects) but never triggers a wallet popup on its own.
12
+ */
13
+ export type WalletSessionState = "idle" | "signing" | "active" | "rejected";
14
+ export interface UseWalletSessionReturn {
15
+ state: WalletSessionState;
16
+ /** True once a wallet-bound session exists for the connected wallet. */
17
+ isActive: boolean;
18
+ /** Ensure a session for the connected wallet, prompting a signature if needed. */
19
+ ensureSession: () => Promise<string | null>;
20
+ }
21
+ export declare function useWalletSession(): UseWalletSessionReturn;
@@ -0,0 +1,21 @@
1
+ /**
2
+ * useWrapEth Hook
3
+ *
4
+ * Wrap native ETH into WETH (`deposit`) and unwrap WETH back to ETH
5
+ * (`withdraw`) on the connected chain, via the canonical WETH contract.
6
+ * Real on-chain writes through wagmi; the caller drives amounts and reads
7
+ * balances from usePublicBalances.
8
+ */
9
+ export type WrapDirection = "wrap" | "unwrap";
10
+ export declare function useWrapEth(): {
11
+ chainId: number;
12
+ wethAvailable: boolean;
13
+ wrap: (amountWei: bigint) => Promise<`0x${string}`>;
14
+ unwrap: (amountWei: bigint) => Promise<`0x${string}`>;
15
+ hash: `0x${string}` | undefined;
16
+ isPending: boolean;
17
+ isConfirming: boolean;
18
+ isSuccess: boolean;
19
+ error: import("@wagmi/core").WriteContractErrorType | null;
20
+ reset: () => void;
21
+ };
@@ -0,0 +1,6 @@
1
+ /** Apply a fixed frame theme before its trading chunk loads. Does not affect configurator pages. */
2
+ export declare function applyInitialWidgetTheme(search: string): void;
3
+ export { configureWidget, readWidgetEmbedConfig, type WidgetEmbedConfig, type WidgetSettings, } from "./config.js";
4
+ /** Complete trading widget. Configure once and render inside React Suspense. */
5
+ export declare const Widget: import("react").LazyExoticComponent<typeof import("./EmbedApp.js").default>;
6
+ export * from "./ramp/peer/index.js";
@@ -0,0 +1,8 @@
1
+ function isVerifyState(value) {
2
+ if (typeof value !== "object" || value === null) return false;
3
+ const obj = value;
4
+ return typeof obj.score === "number" && Array.isArray(obj.connectedProviders) && obj.connectedProviders.every((p) => typeof p === "string");
5
+ }
6
+ export {
7
+ isVerifyState
8
+ };
@@ -0,0 +1,9 @@
1
+ import "./browser.js";
2
+ /** Shared browser modules used by the separately hosted affiliate dashboard. Load after configureWidget. */
3
+ export { WalletProvider } from "./components/WalletProvider.js";
4
+ export { AccountChip } from "./components/AccountChip.js";
5
+ export { useTheme } from "./hooks/useTheme.js";
6
+ export { useWalletSession, type WalletSessionState } from "./hooks/useWalletSession.js";
7
+ export { clearWalletSession, getWalletToken, hasWalletSession } from "./lib/walletSession.js";
8
+ export { apiGet } from "./lib/api.js";
9
+ export { STORAGE_KEYS } from "./constants.js";
@@ -0,0 +1,85 @@
1
+ import { canTransitionTo, getStatusLabel, isChainId, isRaceWebSocketMessage, isSelectableChainId } from "@xochi/client";
2
+ const DEFAULT_DESTINATION = {
3
+ type: "chain",
4
+ shielded: false
5
+ };
6
+ const STEALTH_DESTINATION = {
7
+ type: "stealth",
8
+ shielded: false
9
+ // L1, not Aztec shielded
10
+ };
11
+ const PAYMENT_METHODS = {
12
+ erc3009: {
13
+ method: "erc3009",
14
+ label: "Direct Auth",
15
+ description: "Sign once, transfer directly",
16
+ gasless: true
17
+ },
18
+ permit2: {
19
+ method: "permit2",
20
+ label: "Permit2",
21
+ description: "Universal gasless permit",
22
+ gasless: true
23
+ },
24
+ pimlico: {
25
+ method: "pimlico",
26
+ label: "Sponsored",
27
+ description: "Gas paid by protocol",
28
+ gasless: true
29
+ },
30
+ x402: {
31
+ method: "x402",
32
+ label: "Pay-per-call",
33
+ description: "Micropayment for execution",
34
+ gasless: false
35
+ },
36
+ mpp: {
37
+ method: "mpp",
38
+ label: "Agent Relay",
39
+ description: "Routed via payment agent",
40
+ gasless: true
41
+ },
42
+ approval: {
43
+ method: "approval",
44
+ label: "Approval",
45
+ description: "Onchain approval (gas required)",
46
+ gasless: false
47
+ },
48
+ deposit: {
49
+ method: "deposit",
50
+ label: "Deposit",
51
+ description: "Send the tokens manually",
52
+ // The user pays their own origin-chain network fee to make the transfer.
53
+ // Nothing about this route is sponsored, and the connected wallet signs
54
+ // nothing at all.
55
+ gasless: false
56
+ }
57
+ };
58
+ function isPaymentMethod(value) {
59
+ return typeof value === "string" && value in PAYMENT_METHODS;
60
+ }
61
+ function resolvePaymentMethod(serverMethod, permitType, gasless, depositAddress) {
62
+ if (depositAddress) return "deposit";
63
+ if (isPaymentMethod(serverMethod)) return serverMethod;
64
+ if (permitType === "erc3009") return "erc3009";
65
+ if (permitType === "permit2") return "permit2";
66
+ if (permitType === "eip2612") return "permit2";
67
+ if (gasless) return "pimlico";
68
+ return "approval";
69
+ }
70
+ function paysNoGas(method, approval) {
71
+ return PAYMENT_METHODS[method].gasless && (approval === "none" || approval === "covered");
72
+ }
73
+ export {
74
+ DEFAULT_DESTINATION,
75
+ PAYMENT_METHODS,
76
+ STEALTH_DESTINATION,
77
+ canTransitionTo,
78
+ getStatusLabel,
79
+ isChainId,
80
+ isPaymentMethod,
81
+ isRaceWebSocketMessage,
82
+ isSelectableChainId,
83
+ paysNoGas,
84
+ resolvePaymentMethod
85
+ };
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Pure value helpers for the activity feed.
3
+ *
4
+ * USD is shown only for tokens in the priced set (see usePrices / FALLBACK_PRICES);
5
+ * unknown tokens return null so the feed hides value rather than showing a
6
+ * misleading $1 par. The fee is reconstructed from the stored rate, so callers
7
+ * label it as an estimate.
8
+ */
9
+ /** USD value of a raw smallest-unit amount, or null when the token is unpriced. */
10
+ export declare function swapUsd(prices: Record<string, number>, rawAmount: string, decimals: number, symbol: string): number | null;
11
+ /**
12
+ * Estimated fee in USD from the stored percent rate. Null when USD-in is unknown
13
+ * or the rate is absent (e.g. an agent-stream row carries no fee), so the feed
14
+ * hides the fee rather than showing "$0".
15
+ */
16
+ export declare function estimatedFeeUsd(inUsd: number | null, feeRatePercent: number): number | null;
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Agent connect handoff (client-side, pure).
3
+ *
4
+ * When a user authorizes an agent, the client mints a per-agent stream key
5
+ * (`topicId`, see `agentRegistry.ts`). To let the agent actually post activity
6
+ * into the user's feed, the user hands that key to the agent out of band. This
7
+ * module builds the exact config the raxol agent pastes in, and gates the key so
8
+ * the UI can keep it hidden until the user chooses to reveal it.
9
+ *
10
+ * These are pure and dependency-free so the key is never transmitted or logged
11
+ * here. See raxol#578 for the side that consumes the config.
12
+ */
13
+ /**
14
+ * The ready-to-paste agent config. `=` aligned so both keys line up:
15
+ * xochi_api_url = <apiUrl>
16
+ * topic_id = <topicId>
17
+ */
18
+ export declare function buildAgentConnectSnippet(apiUrl: string, topicId: string): string;
19
+ /**
20
+ * The stream key to show, gated on reveal. Returns the topic only when the user
21
+ * has revealed it; otherwise null, so the caller renders nothing.
22
+ */
23
+ export declare function revealedTopic(topicId: string, revealed: boolean): string | null;
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Authorized-agent registry (client-side, privacy-first).
3
+ *
4
+ * When a user authorizes an agent (a Mandate they signed), the client stores the
5
+ * agent locally along with a freshly generated per-agent `topicId` -- a 128-bit
6
+ * random capability. The agent later pushes its swap activity to that topic and
7
+ * the client subscribes; the server only ever sees the topic as an opaque
8
+ * routing key, never tied to a human. See docs plan `agent-stream-design.md`.
9
+ *
10
+ * This is Phase 3.0: the data layer + the capability. The live stream (3.1-3.3)
11
+ * plugs into `topicId`; the Mandate-signing flow that calls `authorizeAgent`
12
+ * lands with the agent-auth surface. Nothing here touches the server.
13
+ */
14
+ export interface AuthorizedAgent {
15
+ /** The agent's own wallet (0x). Signs stream events; verified client-side. */
16
+ agentWallet: string;
17
+ /** Friendly, user-chosen name, e.g. "my rebalancer". */
18
+ label: string;
19
+ /** Per-agent stream capability: 128-bit random, base64url. Never leaves the client except as a routing key. */
20
+ topicId: string;
21
+ /** keccak256 of the signed Mandate envelope, when authorized via a real mandate. */
22
+ mandateHash: string | null;
23
+ /** Mandate scopes granted (e.g. ["quote"]). */
24
+ scopes: string[];
25
+ /** Unix seconds; null = no expiry. */
26
+ expiresAt: number | null;
27
+ /** Creation time (ms). */
28
+ addedAt: number;
29
+ }
30
+ export type AuthorizeInput = Pick<AuthorizedAgent, "agentWallet" | "label"> & Partial<Pick<AuthorizedAgent, "topicId" | "addedAt" | "mandateHash" | "scopes" | "expiresAt">>;
31
+ /** A fresh 128-bit random stream capability. */
32
+ export declare function generateTopicId(): string;
33
+ type Listener = () => void;
34
+ export declare function subscribeAgentRegistry(listener: Listener): () => void;
35
+ /** The wallet's authorized agents, newest first. */
36
+ export declare function listAgents(address: string | undefined): AuthorizedAgent[];
37
+ /** True when the agent's mandate has not expired. */
38
+ export declare function isAgentActive(agent: AuthorizedAgent, nowMs: number): boolean;
39
+ /**
40
+ * Authorize an agent (idempotent by `agentWallet`). A new agent gets a fresh
41
+ * `topicId`; re-authorizing an existing agent keeps its topic and updates the
42
+ * other fields. Returns the stored entry.
43
+ */
44
+ export declare function authorizeAgent(address: string | undefined, input: AuthorizeInput): AuthorizedAgent | null;
45
+ /** Revoke an agent: drop it from the registry (client stops trusting its topic). */
46
+ export declare function revokeAgent(address: string | undefined, agentWallet: string): void;
47
+ export {};
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Agent stream verification (client-side, authoritative).
3
+ *
4
+ * A relayed `agent_activity` message is trusted only if it comes from an agent
5
+ * the user authorized (in the local registry, unexpired) AND its signature
6
+ * verifies against that agent's wallet over the exact bytes the agent signed
7
+ * (`agentActivityDigest`). This makes a leaked topic non-exploitable: an
8
+ * attacker who learns the topicId can spam the channel, but cannot forge a row
9
+ * that passes both checks. See `agent-stream-design.md`.
10
+ */
11
+ import { type AgentActivityMessage } from "@xochi/client";
12
+ import { type AuthorizedAgent } from "./agentRegistry.js";
13
+ import type { SwapActivityItem } from "../types/activity.js";
14
+ /**
15
+ * Verify a relayed agent message against the local registry. Returns the
16
+ * authorized agent when the signature and membership check out, else null.
17
+ */
18
+ export declare function verifyAgentMessage(topicId: string, msg: AgentActivityMessage, agents: AuthorizedAgent[], nowMs: number): Promise<AuthorizedAgent | null>;
19
+ /**
20
+ * Build a feed row from a verified agent message.
21
+ *
22
+ * The wire `status` is an arbitrary bounded string, and an agent relays the
23
+ * solver's granular vocabulary verbatim ("pulling", "filling"), so it is bucketed
24
+ * into the union the app models rather than asserted into it. Storing the raw
25
+ * string is not merely a blank badge: the row is written to the same local log as
26
+ * the user's own swaps, where the status poll's transition guard reads the stored
27
+ * value and every other status the app models is a coarser bucket of it.
28
+ */
29
+ export declare function agentMessageToSwap(msg: AgentActivityMessage, agent: AuthorizedAgent): SwapActivityItem;
@@ -0,0 +1,41 @@
1
+ /**
2
+ * API Utilities
3
+ *
4
+ * Shared fetch wrapper with:
5
+ * - Automatic JSON parsing
6
+ * - Error handling with Result type
7
+ * - Timeout support
8
+ *
9
+ * SINGLE ATTEMPT, no retry, and deliberately so. This wrapper carried a
10
+ * `retries` option that no caller ever passed (it defaulted to 0, so the loop
11
+ * body never ran), and which was broken in three ways had anyone used it: one
12
+ * `AbortController` outside the loop meant a timed-out first attempt left the
13
+ * signal permanently aborted so every retry failed instantly; one `setTimeout`,
14
+ * cleared on the first attempt, left later attempts with no timeout at all; and
15
+ * `timeout` was silently a budget for all attempts combined rather than per
16
+ * attempt.
17
+ *
18
+ * The working retry lives in `@xochi/client`'s transport (`intentAPI`), which
19
+ * owns a per-attempt timeout, retries only 502/503/504 and honours
20
+ * `Retry-After`. Route anything that needs retrying through there rather than
21
+ * reviving this.
22
+ */
23
+ import { type Result } from "../types/result.js";
24
+ export interface FetchOptions extends Omit<RequestInit, "body"> {
25
+ /** Request body (will be JSON stringified) */
26
+ body?: unknown;
27
+ /** Timeout in ms (default: 30000) */
28
+ timeout?: number;
29
+ }
30
+ /**
31
+ * Fetch with automatic JSON handling and Result type.
32
+ */
33
+ export declare function apiFetch<T>(endpoint: string, options?: FetchOptions): Promise<Result<T>>;
34
+ /** GET request */
35
+ export declare function apiGet<T>(endpoint: string, options?: Omit<FetchOptions, "method" | "body">): Promise<Result<T>>;
36
+ /** POST request */
37
+ export declare function apiPost<T>(endpoint: string, body?: unknown, options?: Omit<FetchOptions, "method">): Promise<Result<T>>;
38
+ /**
39
+ * Build URL with query parameters
40
+ */
41
+ export declare function buildUrl(endpoint: string, params?: Record<string, string | number | boolean | undefined>): string;
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Passkey Authentication (Privacy-First)
3
+ *
4
+ * Reads the passkey-issued JWT, which lives in sessionStorage.
5
+ */
6
+ export declare const getAuthToken: () => string | null;
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Auth-aware fetch wrapper.
3
+ *
4
+ * Injects the passkey-issued JWT into all API requests.
5
+ * Falls through to normal fetch if no token is present.
6
+ */
7
+ /**
8
+ * The token attached to authenticated API calls. Prefer the wallet-bound SIWE
9
+ * token when present: it authenticates the session AND proves wallet ownership,
10
+ * so it passes the server's wallet-ownership guard on wallet-scoped reads. Falls
11
+ * back to the pseudonymous passkey token for non-wallet Member features.
12
+ */
13
+ export declare function getActiveToken(): string | null;
14
+ export declare function authFetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Aztec tokens the activity feed can name.
3
+ *
4
+ * An Aztec payout's `to_token` is a 32-byte Aztec address, which no EVM token
5
+ * list knows. Keyed by that full address alone, never by a chain id: the
6
+ * tracer stores the Aztec network's L1 chain id as `to_chain_id`, so a lookup by
7
+ * chain would land in that EVM chain's list, and a 20-byte EVM address can never
8
+ * match a 32-byte key. Values follow the shielded corridor manifest.
9
+ */
10
+ export interface AztecTokenInfo {
11
+ symbol: string;
12
+ decimals: number;
13
+ }
14
+ /** Display metadata for a known Aztec token address, or null. Hex, so case-insensitive. */
15
+ export declare function getAztecTokenInfo(address: string): AztecTokenInfo | null;
@@ -0,0 +1,88 @@
1
+ /**
2
+ * Public balance types + pure helpers.
3
+ *
4
+ * Kept separate from the wagmi hook (usePublicBalances) so the aggregation and
5
+ * lookup logic is unit-testable without a wallet/provider.
6
+ */
7
+ import { type ChainId } from "@xochi/client";
8
+ import type { SolverCapabilities } from "@xochi/signer";
9
+ /** A single token balance on a single chain (raw, native units). */
10
+ export interface PublicBalance {
11
+ chainId: number;
12
+ /** ERC20 contract address, or "native" for the chain's gas token. */
13
+ address: string;
14
+ symbol: string;
15
+ decimals: number;
16
+ balance: bigint;
17
+ isNative: boolean;
18
+ /**
19
+ * Set when the read has not succeeded (pending or failed). `balance` is then
20
+ * 0n and means UNKNOWN, not an empty wallet. Absent on a successful read.
21
+ */
22
+ unread?: true;
23
+ }
24
+ /** A token's balance summed across chains, with a nonzero per-chain breakdown. */
25
+ export interface AggregatedHolding {
26
+ symbol: string;
27
+ decimals: number;
28
+ amount: number;
29
+ perChain: {
30
+ chainId: number;
31
+ amount: number;
32
+ }[];
33
+ }
34
+ export interface PublicBalanceToken {
35
+ chainId: ChainId;
36
+ address: string;
37
+ symbol: string;
38
+ decimals: number;
39
+ }
40
+ /**
41
+ * Wallet discovery is independent of executable routes. Keep known public
42
+ * assets, and include newly advertised deployments with explicit precision.
43
+ * Registry metadata wins for a known chain/address (notably Arc's 6-decimal
44
+ * ERC-20 view of native USDC).
45
+ */
46
+ export declare function publicBalanceTokens(capabilities?: Pick<SolverCapabilities, "tokens">): PublicBalanceToken[];
47
+ /** Preserve a failed or pending read as unknown, not a genuine empty balance. */
48
+ export declare function erc20Balances(tokens: readonly PublicBalanceToken[], results: readonly ({
49
+ status: "success";
50
+ result: bigint;
51
+ } | {
52
+ status: "failure";
53
+ error?: unknown;
54
+ })[] | undefined): PublicBalance[];
55
+ /**
56
+ * May the panel state the connected wallet's balance for the RECEIVING leg?
57
+ *
58
+ * The receiving header says "you hold", so it may only be shown when the payout
59
+ * actually lands in the connected wallet. Two cases where it does not, and both
60
+ * have to render "--" rather than a number:
61
+ *
62
+ * - a non-EVM destination pays an address the user typed. That address's
63
+ * balance is a real and useful fact, but it is somebody's balance, not
64
+ * necessarily the user's, and the recipient field already states it in those
65
+ * words. Putting it in the header would attribute it to the user.
66
+ * - no wallet is connected, so there is nothing to read.
67
+ *
68
+ * A predicate rather than an inline condition because the distinction it draws
69
+ * is between "unknown" and "zero". Reporting a chain never read as empty does
70
+ * not throw or look broken: it prints a confident 0.00 next to somebody else's
71
+ * money.
72
+ */
73
+ export declare function showsWalletDestinationBalance(isConnected: boolean, isNonEvmDestination: boolean, toChainId: number): boolean;
74
+ /** Convert a raw balance to human units. */
75
+ export declare function toAmount(balance: bigint, decimals: number): number;
76
+ /**
77
+ * The balance as a fact, or null when it is not one: no entry for the token, or
78
+ * a read that is pending or failed. Every displayed balance and offered amount
79
+ * uses this distinction; an unread wallet is not an empty wallet.
80
+ */
81
+ export declare function readBalance(balances: PublicBalance[], chainId: number, address: string): bigint | null;
82
+ /**
83
+ * Aggregate balances by symbol (e.g. total USDC across chains) with a nonzero
84
+ * per-chain breakdown, sorted by amount descending.
85
+ */
86
+ export declare function aggregateBySymbol(balances: PublicBalance[]): AggregatedHolding[];
87
+ /** Symbol used for USD pricing: WETH is priced as ETH. */
88
+ export declare function pricingSymbol(symbol: string): string;
@@ -0,0 +1,3 @@
1
+ import { type SolverCapabilities } from "@xochi/client";
2
+ /** Display continuity only: no exact routes, live authority or advertised Stealth factories. */
3
+ export declare const FALLBACK_CAPABILITIES: SolverCapabilities;
@@ -0,0 +1,114 @@
1
+ /**
2
+ * Submit a signed stealth claim, and keep resubmitting the SAME signed op while
3
+ * its outcome is not known.
4
+ *
5
+ * Riddler bounds its wait for the claim's receipt (Riddler #1124). When the
6
+ * bundler has accepted the op but it is not mined inside that wait, the worker
7
+ * answers 503 `error_category: claim_pending` with `opHash` + `retryAfter`. The
8
+ * op is in the mempool and will execute; resubmitting the same `userOpHash` +
9
+ * signature POLLS it (it is never resent) and answers 200 once the receipt is
10
+ * seen. Preparing or signing again instead would sponsor a second op for an
11
+ * account whose first op is about to land.
12
+ *
13
+ * Two windows bound the poll, as they bound the server:
14
+ *
15
+ * - Until the first pending answer, the prepare window (`deps.deadline`,
16
+ * measured from before the prepare request).
17
+ * - From the first pending answer, {@link CLAIM_PENDING_WINDOW_MS} from the
18
+ * START of the request that returned it. Riddler keeps a broadcast op
19
+ * pollable for 5 minutes from the broadcast, and the worker's session for 5
20
+ * minutes from its first pending answer. The broadcast happens inside that
21
+ * request, so its start is never later than either, and this deadline
22
+ * falls inside both.
23
+ *
24
+ * A 5xx other than `claim_pending`, or a transport error or timeout, says
25
+ * nothing about the op: the worker abandons Riddler at 15s, and a slow bundler
26
+ * send plus Riddler's 10s receipt wait can outrun that after the op was
27
+ * broadcast. Resubmitting is safe either way -- a broadcast op is polled, an
28
+ * unsent one is sent once -- so such an answer is retried, at most
29
+ * {@link MAX_UNKNOWN_OUTCOME_RETRIES} times before anything pends (a real outage
30
+ * should surface, not spin for five minutes) and for as long as the window lasts
31
+ * once the op is known to be in flight.
32
+ *
33
+ * Once it is in flight, only a 200 settles it. Any other terminal answer -- a
34
+ * 410 because a window closed, a 409 -- ends as `unconfirmed`, never `failed`:
35
+ * the op may still land, and "failed" invites a new claim that competes with it
36
+ * for the account's nonce.
37
+ */
38
+ import type { Result } from "../types/result.js";
39
+ export declare const CLAIM_SUBMIT_ENDPOINT = "/api/stealth/claim/submit";
40
+ /**
41
+ * How long a prepared claim can be submitted before anything pends. Mirrors the
42
+ * worker's `CLAIM_SESSION_TTL_SEC` and Riddler's prepared-op expiry, both
43
+ * measured from the prepare.
44
+ */
45
+ export declare const CLAIM_PREPARE_WINDOW_MS = 300000;
46
+ /**
47
+ * How long a pending op can be polled, from the start of the request that first
48
+ * answered `claim_pending`. Mirrors Riddler's broadcast-time expiry and the
49
+ * worker's `pending_at` window.
50
+ */
51
+ export declare const CLAIM_PENDING_WINDOW_MS = 300000;
52
+ /**
53
+ * Resubmits after an unknown outcome (5xx, transport error, timeout) before the
54
+ * op is known to be in flight. If the op WAS broadcast, the first resubmit
55
+ * finds Riddler's broadcast mark and answers pending or 200; two leaves room
56
+ * for one more slow answer without turning an outage into a five-minute spin.
57
+ */
58
+ export declare const MAX_UNKNOWN_OUTCOME_RETRIES = 2;
59
+ /**
60
+ * Floor on the gap between polls. Submit is metered at 12/min per wallet
61
+ * (`WALLET_RATE_LIMITS.claim_submit`); honouring a 5s `retryAfter` against an
62
+ * instant answer would be 12 in a minute plus the first submit, one over. 6s
63
+ * keeps a full window of polling under the ceiling.
64
+ */
65
+ export declare const MIN_CLAIM_POLL_INTERVAL_MS = 6000;
66
+ /**
67
+ * Per-request timeout for a submit. Above the worker's own 15s budget for the
68
+ * Riddler call, so the answer that budget produces -- pending or unavailable --
69
+ * reaches this client instead of racing its timeout.
70
+ */
71
+ export declare const CLAIM_SUBMIT_TIMEOUT_MS = 20000;
72
+ export interface ClaimSubmitBody {
73
+ userOpHash: string;
74
+ signature: string;
75
+ }
76
+ export interface ClaimSubmitted {
77
+ txHash: string;
78
+ opHash: string;
79
+ blockNumber?: number;
80
+ }
81
+ export type ClaimSubmitOutcome = {
82
+ kind: "submitted";
83
+ data: ClaimSubmitted;
84
+ } | {
85
+ kind: "failed";
86
+ error: string;
87
+ errorCategory?: string;
88
+ status?: number;
89
+ }
90
+ /**
91
+ * Accepted by the bundler and still unconfirmed when polling ended -- its
92
+ * window ran out, or the server stopped answering for it. The op may yet
93
+ * land, so this is not a failure either; a new claim is safe only because the
94
+ * account nonce lets at most one op execute.
95
+ */
96
+ | {
97
+ kind: "unconfirmed";
98
+ opHash: string;
99
+ };
100
+ export interface ClaimSubmitPollDeps {
101
+ post: (endpoint: string, body: ClaimSubmitBody, options: {
102
+ timeout: number;
103
+ }) => Promise<Result<ClaimSubmitted>>;
104
+ /**
105
+ * Epoch ms after which no further resubmit is sent, until the first pending
106
+ * answer replaces it with that answer's {@link CLAIM_PENDING_WINDOW_MS}.
107
+ */
108
+ deadline: number;
109
+ now: () => number;
110
+ sleep: (ms: number) => Promise<void>;
111
+ /** Called on every pending answer, before the wait. */
112
+ onPending?: (opHash: string) => void;
113
+ }
114
+ export declare function submitClaimUntilSettled(body: ClaimSubmitBody, deps: ClaimSubmitPollDeps): Promise<ClaimSubmitOutcome>;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Development-only console tracing.
3
+ *
4
+ * These calls are diagnostics, not error handling. They narrate cache hits,
5
+ * request dedup and status transitions while working on the app, and none of
6
+ * them carries information a user or operator can act on in production. On the
7
+ * stealth paths they are worse than noise: announcement and payment counts
8
+ * narrate a recipient's scan results to anyone with devtools open.
9
+ *
10
+ * Errors keep using console.warn/console.error directly so they stay visible in
11
+ * production -- this helper is only for traces that should disappear there.
12
+ */
13
+ export declare function debugLog(...args: unknown[]): void;
@@ -0,0 +1,55 @@
1
+ /**
2
+ * Amount-too-small decline guidance (trade-widget-mvp.md Phase 3; fable
3
+ * pass-1 3.3 and register R7).
4
+ *
5
+ * A below-the-minimum decline is guidance, never a dead end: the server names
6
+ * the smallest amount that works (`minimum_amount_usd`), so the panel offers
7
+ * "Increase to at least $X" and pre-fills the pay field with the converted
8
+ * figure so one tap re-quotes at an amount the server just said it accepts.
9
+ *
10
+ * R7's rules, encoded:
11
+ * - `minimum_amount_usd` can be absent even on `amount_too_small` (solver
12
+ * declines may omit it; only the worker's own cost-guard branch always
13
+ * carries it). Never render a template with a missing number: absent
14
+ * figure means a figure-less CTA plus the served prose.
15
+ * - The pre-fill converts USD to the pay token via the price feed (exact
16
+ * for USD stables, which are 1:1 by definition when the feed is silent).
17
+ * When neither a price nor the stable assumption is available, the figure
18
+ * still renders in copy but the CTA stays figure-less: offering a number
19
+ * the click cannot honor is worse than offering the action alone.
20
+ * - `min_fillable_usd` feeds fine print only. It is the solver's own cost
21
+ * to fill, so an order at exactly that figure delivers almost nothing;
22
+ * it must never become the CTA number.
23
+ * - The conversion rounds UP. Rounding down can re-decline at the exact
24
+ * figure the server just recommended.
25
+ */
26
+ import type { QuoteResponse } from "../types/intent.js";
27
+ export interface AmountTooSmallGuidance {
28
+ /** Served minimum in USD for the body copy, or null when omitted (R7). */
29
+ minimumUsd: number | null;
30
+ /**
31
+ * Pay-field pre-fill as a decimal string ("12.50"), or null when the CTA
32
+ * must stay figure-less.
33
+ */
34
+ prefillAmount: string | null;
35
+ /** Solver floor for the fine-print line, transparency only. */
36
+ fineprintUsd: number | null;
37
+ }
38
+ /**
39
+ * Guidance for an `amount_too_small` decline, or null when the quote is not
40
+ * one. Branches on the served machine key (`error_category`), never on the
41
+ * error prose, per the wire contract.
42
+ */
43
+ export declare function amountTooSmallGuidance(input: {
44
+ quote: Pick<QuoteResponse, "errorCategory" | "minimumAmountUsd" | "minFillableUsd"> | null;
45
+ fromSymbol: string;
46
+ /** USD price of the pay token from the price feed; undefined when missing. */
47
+ fromPriceUsd: number | undefined;
48
+ }): AmountTooSmallGuidance | null;
49
+ /**
50
+ * Served decline prose, capped to the same budget as ErrorDisplay's generic
51
+ * path (errorCategory.ts). The guidance panel renders the sentence inside a
52
+ * reassuring gold block, so upstream text is display data with a length
53
+ * budget there, never unbounded instruction-shaped copy.
54
+ */
55
+ export declare function truncateServedReason(reason: string): string;
@@ -0,0 +1,7 @@
1
+ /** Offline display continuity only; live typed routes alone authorize execution. */
2
+ export declare const FALLBACK_ORIGIN_TOKENS: readonly string[];
3
+ export declare const FALLBACK_DESTINATION_TOKENS: readonly string[];
4
+ /** Ordering for the token picker's popular section, never a route allowlist. */
5
+ export declare const POPULAR_SYMBOLS: readonly string[];
6
+ /** Estimated USD display values, never market rates or excessive-slippage inputs. */
7
+ export declare const FALLBACK_PRICES: Readonly<Record<string, number>>;