auramaxx 1.0.0-alpha.4

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 (363) hide show
  1. package/LICENSE +26 -0
  2. package/README.md +112 -0
  3. package/bin/aurawallet.js +121 -0
  4. package/docs/ADAPTERS.md +467 -0
  5. package/docs/API.md +2679 -0
  6. package/docs/APPS.md +198 -0
  7. package/docs/ARCHITECTURE.md +350 -0
  8. package/docs/AUTH.md +698 -0
  9. package/docs/BEST-PRACTICES.md +121 -0
  10. package/docs/CLI.md +61 -0
  11. package/docs/DEVELOPING-APPS.md +452 -0
  12. package/docs/EXTENSION.md +97 -0
  13. package/docs/JOBS.md +33 -0
  14. package/docs/MCP.md +76 -0
  15. package/docs/PROTOCOL.md +142 -0
  16. package/docs/SETUP.md +219 -0
  17. package/docs/WORKSPACE.md +672 -0
  18. package/docs/agent-auth.md +63 -0
  19. package/docs/aura-file.md +48 -0
  20. package/docs/credentials.md +53 -0
  21. package/docs/external/getting-started.md +65 -0
  22. package/docs/external/overview.md +45 -0
  23. package/docs/external/use-cases.md +48 -0
  24. package/docs/external/why-aura.md +35 -0
  25. package/docs/jobs/connect-agent.md +77 -0
  26. package/docs/jobs/migrate-from-dotenv.md +79 -0
  27. package/docs/jobs/recover-from-lockout.md +72 -0
  28. package/docs/jobs/secure-ci.md +63 -0
  29. package/docs/oauth2.md +42 -0
  30. package/docs/passkeys.md +60 -0
  31. package/docs/security.md +540 -0
  32. package/docs/specs/aura-open-protocol.md +61 -0
  33. package/docs/specs/aura-provider-plugin.md +24 -0
  34. package/docs/specs/aura-registry-model.md +31 -0
  35. package/docs/specs/fixtures/invalid-bad-key.aura +1 -0
  36. package/docs/specs/fixtures/invalid-bad-unicode-escape.aura +1 -0
  37. package/docs/specs/fixtures/invalid-duplicate-key.aura +2 -0
  38. package/docs/specs/fixtures/valid-basic.aura +4 -0
  39. package/docs/specs/fixtures/valid-provider-ref.aura +1 -0
  40. package/docs/specs/fixtures/valid-quoted-escapes.aura +2 -0
  41. package/docs/templates/RELEASE_NOTES_TEMPLATE.md +22 -0
  42. package/docs/totp.md +40 -0
  43. package/docs/wallet/AI.md +508 -0
  44. package/docs/wallet/DEVELOPING-STRATEGIES.md +713 -0
  45. package/docs/wallet/README.md +47 -0
  46. package/docs/wallet/STRATEGY.md +89 -0
  47. package/next.config.ts +21 -0
  48. package/package.json +151 -0
  49. package/postcss.config.mjs +8 -0
  50. package/prisma/migrations/20260214170000_baseline/migration.sql +511 -0
  51. package/prisma/migrations/20260216214537_add_passkey_model/migration.sql +18 -0
  52. package/prisma/migrations/20260217150500_add_credential_access_audit/migration.sql +31 -0
  53. package/prisma/migrations/migration_lock.toml +3 -0
  54. package/prisma/schema.prisma +447 -0
  55. package/public/logo-chevron.svg +31 -0
  56. package/public/logo-concentric.svg +31 -0
  57. package/public/logo-crosshatch.svg +39 -0
  58. package/public/logo-dashed.svg +39 -0
  59. package/public/logo-horizontal.svg +31 -0
  60. package/public/logo-m56.svg +64 -0
  61. package/public/logo.webp +0 -0
  62. package/scripts/add-app.js +245 -0
  63. package/scripts/init.sh +57 -0
  64. package/scripts/migrate-apikeys-to-credentials.ts +35 -0
  65. package/scripts/sandbox-agent-flow.sh +235 -0
  66. package/scripts/sandbox.sh +175 -0
  67. package/scripts/validate-job-docs.mjs +125 -0
  68. package/server/abi/SwapHelper.json +438 -0
  69. package/server/cli/approval.ts +447 -0
  70. package/server/cli/commands/app.ts +204 -0
  71. package/server/cli/commands/cron.ts +24 -0
  72. package/server/cli/commands/doctor.ts +1007 -0
  73. package/server/cli/commands/env.ts +456 -0
  74. package/server/cli/commands/init.ts +752 -0
  75. package/server/cli/commands/mcp.ts +125 -0
  76. package/server/cli/commands/restore.ts +314 -0
  77. package/server/cli/commands/shell-hook.ts +468 -0
  78. package/server/cli/commands/start.ts +62 -0
  79. package/server/cli/commands/status.ts +59 -0
  80. package/server/cli/commands/stop.ts +14 -0
  81. package/server/cli/commands/token.ts +180 -0
  82. package/server/cli/commands/unlock.ts +49 -0
  83. package/server/cli/commands/vault.ts +417 -0
  84. package/server/cli/index.ts +328 -0
  85. package/server/cli/lib/aura-parser.ts +64 -0
  86. package/server/cli/lib/credential-create.ts +74 -0
  87. package/server/cli/lib/credential-resolve.ts +254 -0
  88. package/server/cli/lib/dotenv-migrate.ts +116 -0
  89. package/server/cli/lib/dotenv-parser.ts +146 -0
  90. package/server/cli/lib/http.ts +91 -0
  91. package/server/cli/lib/init-steps.ts +76 -0
  92. package/server/cli/lib/local-agent-trust.ts +45 -0
  93. package/server/cli/lib/process.ts +136 -0
  94. package/server/cli/lib/prompt.ts +85 -0
  95. package/server/cli/lib/theme.ts +240 -0
  96. package/server/cli/socket.ts +570 -0
  97. package/server/cli/transport-client.ts +50 -0
  98. package/server/cron/index.ts +137 -0
  99. package/server/cron/job.ts +31 -0
  100. package/server/cron/jobs/balance-sync.ts +436 -0
  101. package/server/cron/jobs/incoming-scan.ts +506 -0
  102. package/server/cron/jobs/native-price.ts +70 -0
  103. package/server/cron/jobs/orphan-cleanup.ts +40 -0
  104. package/server/cron/jobs/strategy-runner.ts +175 -0
  105. package/server/cron/scheduler.ts +125 -0
  106. package/server/index.ts +406 -0
  107. package/server/lib/adapters/factory.ts +110 -0
  108. package/server/lib/adapters/index.ts +19 -0
  109. package/server/lib/adapters/router.ts +297 -0
  110. package/server/lib/adapters/telegram.ts +645 -0
  111. package/server/lib/adapters/types.ts +89 -0
  112. package/server/lib/adapters/webhook.ts +95 -0
  113. package/server/lib/address.ts +49 -0
  114. package/server/lib/agent-auth/contracts.ts +1194 -0
  115. package/server/lib/agent-profiles.ts +328 -0
  116. package/server/lib/ai.ts +285 -0
  117. package/server/lib/api-registry/contracts.ts +86 -0
  118. package/server/lib/api-registry/validation.ts +172 -0
  119. package/server/lib/apikey-migration.ts +189 -0
  120. package/server/lib/app-installer.ts +505 -0
  121. package/server/lib/app-tokens.ts +247 -0
  122. package/server/lib/auth.ts +314 -0
  123. package/server/lib/batch.ts +242 -0
  124. package/server/lib/cold.ts +874 -0
  125. package/server/lib/config.ts +381 -0
  126. package/server/lib/credential-access-audit.ts +85 -0
  127. package/server/lib/credential-access-policy.ts +110 -0
  128. package/server/lib/credential-health.ts +343 -0
  129. package/server/lib/credential-import.ts +487 -0
  130. package/server/lib/credential-scope.ts +87 -0
  131. package/server/lib/credential-shares.ts +190 -0
  132. package/server/lib/credential-transport.ts +342 -0
  133. package/server/lib/credential-vault.ts +77 -0
  134. package/server/lib/credentials.ts +333 -0
  135. package/server/lib/crypto.ts +8 -0
  136. package/server/lib/db.ts +15 -0
  137. package/server/lib/defaults.ts +366 -0
  138. package/server/lib/dex/index.ts +80 -0
  139. package/server/lib/dex/relay.ts +235 -0
  140. package/server/lib/dex/types.ts +59 -0
  141. package/server/lib/dex/uniswap.ts +370 -0
  142. package/server/lib/e2e-agent/artifacts.ts +36 -0
  143. package/server/lib/e2e-agent/contracts.ts +112 -0
  144. package/server/lib/e2e-agent/validation.ts +135 -0
  145. package/server/lib/encrypt.ts +128 -0
  146. package/server/lib/error.ts +20 -0
  147. package/server/lib/events.ts +205 -0
  148. package/server/lib/hot.ts +357 -0
  149. package/server/lib/key-fingerprint.ts +28 -0
  150. package/server/lib/logger.ts +331 -0
  151. package/server/lib/network.ts +137 -0
  152. package/server/lib/notifications.ts +219 -0
  153. package/server/lib/oauth2-refresh.ts +241 -0
  154. package/server/lib/oursecret.ts +54 -0
  155. package/server/lib/passkey-credential.ts +360 -0
  156. package/server/lib/passkey.ts +68 -0
  157. package/server/lib/permissions.ts +248 -0
  158. package/server/lib/pino.ts +24 -0
  159. package/server/lib/policy-preview.ts +138 -0
  160. package/server/lib/price.ts +338 -0
  161. package/server/lib/prices.ts +34 -0
  162. package/server/lib/project-scope.ts +239 -0
  163. package/server/lib/resolve-action.ts +427 -0
  164. package/server/lib/resolve.ts +36 -0
  165. package/server/lib/sessions.ts +632 -0
  166. package/server/lib/solana/connection.ts +26 -0
  167. package/server/lib/solana/jupiter.ts +128 -0
  168. package/server/lib/solana/transfer.ts +108 -0
  169. package/server/lib/solana/wallet.ts +136 -0
  170. package/server/lib/strategy/emits.ts +21 -0
  171. package/server/lib/strategy/engine.ts +1305 -0
  172. package/server/lib/strategy/executor.ts +115 -0
  173. package/server/lib/strategy/hook-context.ts +158 -0
  174. package/server/lib/strategy/hooks.ts +990 -0
  175. package/server/lib/strategy/index.ts +28 -0
  176. package/server/lib/strategy/installer.ts +305 -0
  177. package/server/lib/strategy/loader.ts +256 -0
  178. package/server/lib/strategy/message.ts +235 -0
  179. package/server/lib/strategy/repository.ts +218 -0
  180. package/server/lib/strategy/session-logger.ts +693 -0
  181. package/server/lib/strategy/sources.ts +288 -0
  182. package/server/lib/strategy/state.ts +189 -0
  183. package/server/lib/strategy/templates.ts +403 -0
  184. package/server/lib/strategy/tick.ts +404 -0
  185. package/server/lib/strategy/types.ts +230 -0
  186. package/server/lib/swap.ts +3 -0
  187. package/server/lib/temp.ts +86 -0
  188. package/server/lib/token-metadata.ts +86 -0
  189. package/server/lib/token-safety.ts +200 -0
  190. package/server/lib/token-search.ts +444 -0
  191. package/server/lib/totp.ts +194 -0
  192. package/server/lib/transactions.ts +123 -0
  193. package/server/lib/transport.ts +75 -0
  194. package/server/lib/txhistory/decoder.ts +262 -0
  195. package/server/lib/txhistory/enricher.ts +652 -0
  196. package/server/lib/txhistory/index.ts +391 -0
  197. package/server/lib/txhistory/signatures.ts +59 -0
  198. package/server/lib/verified-summary.ts +421 -0
  199. package/server/mcp/profile-policy.ts +30 -0
  200. package/server/mcp/server.ts +619 -0
  201. package/server/mcp/tools.ts +523 -0
  202. package/server/middleware/auth.ts +119 -0
  203. package/server/middleware/requestLogger.ts +84 -0
  204. package/server/routes/actions.ts +459 -0
  205. package/server/routes/adapters.ts +703 -0
  206. package/server/routes/addressbook.ts +113 -0
  207. package/server/routes/ai.ts +34 -0
  208. package/server/routes/apikeys.ts +295 -0
  209. package/server/routes/apps.ts +601 -0
  210. package/server/routes/auth.ts +457 -0
  211. package/server/routes/backup.ts +340 -0
  212. package/server/routes/batch.ts +270 -0
  213. package/server/routes/bookmarks.ts +162 -0
  214. package/server/routes/credential-shares.ts +198 -0
  215. package/server/routes/credential-vaults.ts +154 -0
  216. package/server/routes/credentials.ts +1290 -0
  217. package/server/routes/dashboard.ts +71 -0
  218. package/server/routes/defaults.ts +124 -0
  219. package/server/routes/fund.ts +229 -0
  220. package/server/routes/import.ts +352 -0
  221. package/server/routes/launch.ts +665 -0
  222. package/server/routes/lock.ts +54 -0
  223. package/server/routes/logs.ts +68 -0
  224. package/server/routes/nuke.ts +111 -0
  225. package/server/routes/passkey-credentials.ts +99 -0
  226. package/server/routes/passkey.ts +346 -0
  227. package/server/routes/portfolio.ts +217 -0
  228. package/server/routes/price.ts +63 -0
  229. package/server/routes/resolve.ts +31 -0
  230. package/server/routes/security.ts +45 -0
  231. package/server/routes/send-evm.ts +241 -0
  232. package/server/routes/send-solana.ts +281 -0
  233. package/server/routes/send.ts +178 -0
  234. package/server/routes/setup.ts +210 -0
  235. package/server/routes/strategy.ts +894 -0
  236. package/server/routes/swap-evm.ts +353 -0
  237. package/server/routes/swap-solana.ts +177 -0
  238. package/server/routes/swap.ts +356 -0
  239. package/server/routes/token.ts +247 -0
  240. package/server/routes/unlock.ts +403 -0
  241. package/server/routes/wallet-assets.ts +361 -0
  242. package/server/routes/wallet-transactions.ts +515 -0
  243. package/server/routes/wallet.ts +710 -0
  244. package/server/types.ts +146 -0
  245. package/skills/aurawallet/SKILL.md +739 -0
  246. package/skills/aurawallet-setup/SKILL.md +74 -0
  247. package/skills/security-review/SKILL.md +148 -0
  248. package/src/app/api/agent-requests/route.ts +30 -0
  249. package/src/app/api/apps/install/route.ts +126 -0
  250. package/src/app/api/apps/manifests/route.ts +16 -0
  251. package/src/app/api/apps/static/[...path]/route.ts +57 -0
  252. package/src/app/api/events/route.ts +92 -0
  253. package/src/app/api/page.tsx +212 -0
  254. package/src/app/api/workspace/[id]/apps/[wid]/route.ts +119 -0
  255. package/src/app/api/workspace/[id]/apps/route.ts +81 -0
  256. package/src/app/api/workspace/[id]/export/route.ts +67 -0
  257. package/src/app/api/workspace/[id]/route.ts +168 -0
  258. package/src/app/api/workspace/auth.ts +34 -0
  259. package/src/app/api/workspace/config/route.ts +106 -0
  260. package/src/app/api/workspace/import/route.ts +127 -0
  261. package/src/app/api/workspace/route.ts +116 -0
  262. package/src/app/app/page.tsx +2122 -0
  263. package/src/app/apple-icon.png +0 -0
  264. package/src/app/docs/page.tsx +178 -0
  265. package/src/app/favicon.ico +0 -0
  266. package/src/app/globals.css +572 -0
  267. package/src/app/health/page.tsx +5 -0
  268. package/src/app/hello/page.tsx +15 -0
  269. package/src/app/icon.png +0 -0
  270. package/src/app/layout.tsx +34 -0
  271. package/src/app/page.tsx +986 -0
  272. package/src/app/providers.tsx +90 -0
  273. package/src/app/share/[token]/page.tsx +295 -0
  274. package/src/components/ChainSelector.tsx +144 -0
  275. package/src/components/HumanActionBar.tsx +695 -0
  276. package/src/components/NotificationDrawer.tsx +129 -0
  277. package/src/components/apps/AgentKeysApp.tsx +490 -0
  278. package/src/components/apps/App.tsx +153 -0
  279. package/src/components/apps/AppGrid.tsx +15 -0
  280. package/src/components/apps/DetailedAddressDrawer.tsx +325 -0
  281. package/src/components/apps/DraggableApp.tsx +562 -0
  282. package/src/components/apps/IFrameApp.tsx +73 -0
  283. package/src/components/apps/LogsApp.tsx +360 -0
  284. package/src/components/apps/SendApp.tsx +394 -0
  285. package/src/components/apps/SetupWizardApp.tsx +1004 -0
  286. package/src/components/apps/SystemDefaultsApp.tsx +845 -0
  287. package/src/components/apps/ThirdPartyApp.tsx +428 -0
  288. package/src/components/apps/TokenApp.tsx +319 -0
  289. package/src/components/apps/TransactionsApp.tsx +438 -0
  290. package/src/components/apps/WalletDetailApp.tsx +1505 -0
  291. package/src/components/apps/index.ts +13 -0
  292. package/src/components/design-system/Button.tsx +53 -0
  293. package/src/components/design-system/ChainIndicator.tsx +65 -0
  294. package/src/components/design-system/ChainSelector.tsx +137 -0
  295. package/src/components/design-system/ConfirmationModal.tsx +106 -0
  296. package/src/components/design-system/ConfirmationPopover.tsx +81 -0
  297. package/src/components/design-system/Drawer.tsx +123 -0
  298. package/src/components/design-system/FilterDropdown.tsx +72 -0
  299. package/src/components/design-system/Modal.tsx +206 -0
  300. package/src/components/design-system/Popover.tsx +142 -0
  301. package/src/components/design-system/TextInput.tsx +85 -0
  302. package/src/components/design-system/Toggle.tsx +58 -0
  303. package/src/components/design-system/index.ts +11 -0
  304. package/src/components/docs/DocsThemeToggle.tsx +49 -0
  305. package/src/components/health/CredentialHealthDashboard.tsx +214 -0
  306. package/src/components/icons/ChainIcons.tsx +72 -0
  307. package/src/components/layout/AppStoreDrawer.tsx +369 -0
  308. package/src/components/layout/ContentArea.tsx +21 -0
  309. package/src/components/layout/TabBar.tsx +278 -0
  310. package/src/components/layout/WalletSidebar.tsx +1033 -0
  311. package/src/components/layout/index.ts +4 -0
  312. package/src/components/marketing/AuraWalletSpecOverlay.tsx +635 -0
  313. package/src/components/marketing/DeviceMorphExperience.tsx +216 -0
  314. package/src/components/vault/ApiKeysConsole.tsx +1080 -0
  315. package/src/components/vault/AuditConsole.tsx +584 -0
  316. package/src/components/vault/CredentialDetail.tsx +455 -0
  317. package/src/components/vault/CredentialEmpty.tsx +55 -0
  318. package/src/components/vault/CredentialField.tsx +361 -0
  319. package/src/components/vault/CredentialForm.tsx +1212 -0
  320. package/src/components/vault/CredentialList.tsx +165 -0
  321. package/src/components/vault/CredentialRow.tsx +97 -0
  322. package/src/components/vault/CredentialShareModal.tsx +178 -0
  323. package/src/components/vault/CredentialVault.tsx +754 -0
  324. package/src/components/vault/CredentialWalletWidget.tsx +103 -0
  325. package/src/components/vault/ImportCredentialsModal.tsx +515 -0
  326. package/src/components/vault/LargeTypeModal.tsx +64 -0
  327. package/src/components/vault/PasswordGenerator.tsx +224 -0
  328. package/src/components/vault/TOTPDisplay.tsx +123 -0
  329. package/src/components/vault/VaultSidebar.tsx +413 -0
  330. package/src/components/vault/types.ts +54 -0
  331. package/src/context/AuthContext.tsx +337 -0
  332. package/src/context/PriceContext.tsx +113 -0
  333. package/src/context/ThemeContext.tsx +164 -0
  334. package/src/context/WebSocketContext.tsx +269 -0
  335. package/src/context/WorkspaceContext.tsx +668 -0
  336. package/src/hooks/index.ts +3 -0
  337. package/src/hooks/useAgentActions.ts +368 -0
  338. package/src/hooks/useBalance.ts +103 -0
  339. package/src/hooks/useBalances.ts +129 -0
  340. package/src/instrumentation.ts +12 -0
  341. package/src/lib/api.ts +449 -0
  342. package/src/lib/app-loader.ts +148 -0
  343. package/src/lib/app-registry.ts +178 -0
  344. package/src/lib/app-sdk.ts +157 -0
  345. package/src/lib/audit-console-adapter.ts +151 -0
  346. package/src/lib/auth-client.ts +75 -0
  347. package/src/lib/config.ts +74 -0
  348. package/src/lib/crypto.ts +112 -0
  349. package/src/lib/db.ts +21 -0
  350. package/src/lib/docs.ts +390 -0
  351. package/src/lib/events.ts +361 -0
  352. package/src/lib/pino.ts +24 -0
  353. package/src/lib/theme-handlers.ts +168 -0
  354. package/src/lib/theme.ts +351 -0
  355. package/src/lib/tokenData.ts +378 -0
  356. package/src/lib/vault-crypto.ts +129 -0
  357. package/src/lib/websocket-server.ts +302 -0
  358. package/src/lib/websocket-setup.ts +79 -0
  359. package/src/lib/wordlist.ts +2050 -0
  360. package/src/lib/workspace-handlers.ts +285 -0
  361. package/start.sh +80 -0
  362. package/tailwind.config.ts +99 -0
  363. package/tsconfig.json +42 -0
@@ -0,0 +1,438 @@
1
+ /**
2
+ * TransactionsApp — Global transaction list across all wallets.
3
+ *
4
+ * Fetches from GET /wallets/transactions with filter/pagination support.
5
+ * Subscribes to tx:created WebSocket events for live updates.
6
+ * Clicking a token address opens the token app; clicking a wallet opens walletDetail.
7
+ */
8
+ import { useState, useEffect, useCallback, useRef } from 'react';
9
+ import { ArrowUpDown, ExternalLink, Loader2, Search } from 'lucide-react';
10
+ import { api, Api } from '@/lib/api';
11
+ import { useWebSocket } from '@/context/WebSocketContext';
12
+ import { useWorkspace } from '@/context/WorkspaceContext';
13
+ import { useAuth } from '@/context/AuthContext';
14
+ import { FilterDropdown, TextInput, ChainSelector } from '@/components/design-system';
15
+
16
+ // ------------------------------------------------------------------
17
+ // Constants (duplicated locally — matches codebase convention)
18
+ // ------------------------------------------------------------------
19
+
20
+ const TX_TYPE_COLORS: Record<string, string> = {
21
+ send: 'var(--color-warning, #ff4d00)',
22
+ receive: 'var(--color-success, #00c853)',
23
+ swap: 'var(--color-info, #0047ff)',
24
+ contract: 'var(--color-text-muted, #888)',
25
+ manual: 'var(--color-text-muted, #888)',
26
+ launch: 'var(--color-accent, #8b5cf6)',
27
+ };
28
+
29
+ const TX_TYPE_OPTIONS = [
30
+ { value: 'all', label: 'ALL' },
31
+ { value: 'send', label: 'SEND' },
32
+ { value: 'receive', label: 'RECEIVE' },
33
+ { value: 'swap', label: 'SWAP' },
34
+ { value: 'contract', label: 'CONTRACT' },
35
+ { value: 'manual', label: 'MANUAL' },
36
+ { value: 'launch', label: 'LAUNCH' },
37
+ ];
38
+
39
+ function formatTimeAgo(dateString: string): string {
40
+ const date = new Date(dateString);
41
+ const now = new Date();
42
+ const diffMs = now.getTime() - date.getTime();
43
+ const diffMins = Math.floor(diffMs / 60000);
44
+ const diffHours = Math.floor(diffMins / 60);
45
+ const diffDays = Math.floor(diffHours / 24);
46
+
47
+ if (diffMins < 1) return 'just now';
48
+ if (diffMins < 60) return `${diffMins}m ago`;
49
+ if (diffHours < 24) return `${diffHours}h ago`;
50
+ return `${diffDays}d ago`;
51
+ }
52
+
53
+ // ------------------------------------------------------------------
54
+ // Types
55
+ // ------------------------------------------------------------------
56
+
57
+ interface Transaction {
58
+ id: string;
59
+ walletAddress: string;
60
+ txHash: string | null;
61
+ type: string;
62
+ status: string;
63
+ amount: string | null;
64
+ tokenAddress: string | null;
65
+ tokenAmount: string | null;
66
+ from: string | null;
67
+ to: string | null;
68
+ description: string | null;
69
+ chain: string;
70
+ createdAt: string;
71
+ }
72
+
73
+ interface TransactionsResponse {
74
+ success: boolean;
75
+ transactions: Transaction[];
76
+ pagination: { total: number; limit: number; offset: number; hasMore: boolean };
77
+ }
78
+
79
+ interface WalletInfo {
80
+ address: string;
81
+ name: string | null;
82
+ emoji: string | null;
83
+ chain: string;
84
+ }
85
+
86
+ interface TxCreatedData {
87
+ walletAddress: string;
88
+ id: string;
89
+ type: string;
90
+ txHash?: string;
91
+ amount?: string;
92
+ tokenAddress?: string;
93
+ tokenAmount?: string;
94
+ description?: string;
95
+ }
96
+
97
+ interface TransactionsAppProps {
98
+ config?: {
99
+ defaultWallet?: string;
100
+ defaultType?: string;
101
+ defaultChain?: string;
102
+ };
103
+ }
104
+
105
+ // ------------------------------------------------------------------
106
+ // Component
107
+ // ------------------------------------------------------------------
108
+
109
+ function TransactionsApp({ config }: TransactionsAppProps) {
110
+ const { subscribe } = useWebSocket();
111
+ const { addApp } = useWorkspace();
112
+ const { getConfiguredChains, getChainConfig } = useAuth();
113
+
114
+ // Chain options for the selector
115
+ const chainOptions = Object.keys(getConfiguredChains()).map(c => c);
116
+
117
+ // State
118
+ const [transactions, setTransactions] = useState<Transaction[]>([]);
119
+ const [loading, setLoading] = useState(true);
120
+ const [hasMore, setHasMore] = useState(false);
121
+ const [offset, setOffset] = useState(0);
122
+
123
+ // Filters
124
+ const [typeFilter, setTypeFilter] = useState(config?.defaultType || 'all');
125
+ const [chainFilter, setChainFilter] = useState(config?.defaultChain || '');
126
+ const [search, setSearch] = useState('');
127
+ const [walletFilter] = useState(config?.defaultWallet || '');
128
+
129
+ // Wallet lookup map (address → name/emoji)
130
+ const [walletMap, setWalletMap] = useState<Record<string, WalletInfo>>({});
131
+
132
+ // Debounce search
133
+ const searchTimerRef = useRef<ReturnType<typeof setTimeout>>(undefined);
134
+ const [debouncedSearch, setDebouncedSearch] = useState('');
135
+
136
+ useEffect(() => {
137
+ clearTimeout(searchTimerRef.current);
138
+ searchTimerRef.current = setTimeout(() => setDebouncedSearch(search), 300);
139
+ return () => clearTimeout(searchTimerRef.current);
140
+ }, [search]);
141
+
142
+ // Fetch wallet map for name lookups
143
+ useEffect(() => {
144
+ (async () => {
145
+ try {
146
+ const data = await api.get<{ wallets: WalletInfo[] }>(Api.Wallet, '/wallets');
147
+ const map: Record<string, WalletInfo> = {};
148
+ for (const w of data.wallets || []) {
149
+ map[w.address.toLowerCase()] = w;
150
+ }
151
+ setWalletMap(map);
152
+ } catch {
153
+ // non-critical
154
+ }
155
+ })();
156
+ }, []);
157
+
158
+ // Fetch transactions
159
+ const fetchTransactions = useCallback(async (reset = false) => {
160
+ setLoading(true);
161
+ try {
162
+ const skip = reset ? 0 : offset;
163
+ const params: Record<string, string | number> = {
164
+ limit: 50,
165
+ offset: skip,
166
+ sortBy: 'createdAt',
167
+ sortDir: 'desc',
168
+ };
169
+ if (typeFilter !== 'all') params.type = typeFilter;
170
+ if (chainFilter) params.chain = chainFilter;
171
+ if (debouncedSearch) params.search = debouncedSearch;
172
+ if (walletFilter) params.wallet = walletFilter;
173
+
174
+ const data = await api.get<TransactionsResponse>(Api.Wallet, '/wallets/transactions', params);
175
+ if (data.success) {
176
+ if (reset) {
177
+ setTransactions(data.transactions);
178
+ setOffset(data.transactions.length);
179
+ } else {
180
+ setTransactions(prev => [...prev, ...data.transactions]);
181
+ setOffset(skip + data.transactions.length);
182
+ }
183
+ setHasMore(data.pagination.hasMore);
184
+ }
185
+ } catch (err) {
186
+ console.error('[TransactionsApp] Failed to fetch:', err);
187
+ } finally {
188
+ setLoading(false);
189
+ }
190
+ }, [offset, typeFilter, chainFilter, debouncedSearch, walletFilter]);
191
+
192
+ // Reset + refetch when filters change
193
+ useEffect(() => {
194
+ fetchTransactions(true);
195
+ // eslint-disable-next-line react-hooks/exhaustive-deps
196
+ }, [typeFilter, chainFilter, debouncedSearch, walletFilter]);
197
+
198
+ // WebSocket: prepend new transactions
199
+ useEffect(() => {
200
+ const unsub = subscribe('tx:created', (event) => {
201
+ const data = event.data as TxCreatedData;
202
+
203
+ const newTx: Transaction = {
204
+ id: data.id,
205
+ walletAddress: data.walletAddress,
206
+ txHash: data.txHash ?? null,
207
+ type: data.type,
208
+ status: 'confirmed',
209
+ amount: data.amount ?? null,
210
+ tokenAddress: data.tokenAddress ?? null,
211
+ tokenAmount: data.tokenAmount ?? null,
212
+ from: null,
213
+ to: null,
214
+ description: data.description ?? null,
215
+ chain: 'base',
216
+ createdAt: new Date().toISOString(),
217
+ };
218
+
219
+ setTransactions(prev => [newTx, ...prev]);
220
+ });
221
+ return unsub;
222
+ }, [subscribe]);
223
+
224
+ // Handlers
225
+ const handleLoadMore = () => fetchTransactions(false);
226
+
227
+ const openTokenApp = (tokenAddr: string, chain: string) => {
228
+ addApp('token', { defaultAddress: tokenAddr, defaultChain: chain });
229
+ };
230
+
231
+ const openWalletApp = (addr: string) => {
232
+ addApp('walletDetail', { walletAddress: addr }, undefined, `walletDetail-${addr}`);
233
+ };
234
+
235
+ return (
236
+ <div className="flex flex-col h-full gap-2 p-2 overflow-hidden">
237
+ {/* Filter row */}
238
+ <div className="flex gap-1.5 shrink-0">
239
+ <div className="w-24">
240
+ <FilterDropdown
241
+ options={TX_TYPE_OPTIONS}
242
+ value={typeFilter}
243
+ onChange={setTypeFilter}
244
+ compact
245
+ />
246
+ </div>
247
+ <div className="w-28">
248
+ <ChainSelector
249
+ value={chainFilter || chainOptions[0]}
250
+ onChange={(c) => setChainFilter(c === chainOptions[0] && !chainFilter ? '' : c)}
251
+ chains={chainOptions}
252
+ size="sm"
253
+ />
254
+ </div>
255
+ <div className="flex-1">
256
+ <TextInput
257
+ value={search}
258
+ onChange={(e) => setSearch(e.target.value)}
259
+ placeholder="Search..."
260
+ leftElement={<Search size={10} />}
261
+ compact
262
+ />
263
+ </div>
264
+ </div>
265
+
266
+ {/* Transaction list */}
267
+ <div className="flex-1 overflow-y-auto space-y-1 min-h-0">
268
+ {loading && transactions.length === 0 ? (
269
+ <div className="py-6 text-center">
270
+ <Loader2
271
+ size={20}
272
+ className="mx-auto mb-2 animate-spin"
273
+ style={{ color: 'var(--color-text-muted, #888)' }}
274
+ />
275
+ <div className="font-mono text-[9px]" style={{ color: 'var(--color-text-muted, #888)' }}>
276
+ LOADING TRANSACTIONS...
277
+ </div>
278
+ </div>
279
+ ) : transactions.length === 0 ? (
280
+ <div className="py-6 text-center">
281
+ <ArrowUpDown size={24} className="mx-auto mb-2" style={{ color: 'var(--color-text-muted, #888)' }} />
282
+ <div className="font-mono text-[9px]" style={{ color: 'var(--color-text-muted, #888)' }}>
283
+ NO TRANSACTIONS
284
+ </div>
285
+ <div className="font-mono text-[8px] mt-1" style={{ color: 'var(--color-text-faint, #aaa)' }}>
286
+ {debouncedSearch ? 'Try a different search' : 'Transactions will appear here'}
287
+ </div>
288
+ </div>
289
+ ) : (
290
+ <>
291
+ {transactions.map((tx) => {
292
+ const typeColor = TX_TYPE_COLORS[tx.type] || 'var(--color-text-muted, #888)';
293
+ const wallet = walletMap[tx.walletAddress.toLowerCase()];
294
+ const walletLabel = wallet
295
+ ? `${wallet.emoji || ''} ${wallet.name || tx.walletAddress.slice(0, 8)}`.trim()
296
+ : tx.walletAddress.slice(0, 8) + '...';
297
+ const explorerUrl = getChainConfig(tx.chain).explorer;
298
+
299
+ return (
300
+ <div
301
+ key={tx.id}
302
+ className="p-2 rounded-sm"
303
+ style={{
304
+ background: 'var(--color-surface, #fff)',
305
+ border: '1px solid var(--color-border, #e5e5e5)',
306
+ }}
307
+ >
308
+ <div className="flex items-start justify-between gap-2">
309
+ <div className="flex items-center gap-2 min-w-0">
310
+ <div
311
+ className="w-1.5 h-1.5 rounded-full shrink-0"
312
+ style={{ background: typeColor }}
313
+ />
314
+ <div className="min-w-0">
315
+ <div className="flex items-center gap-1.5">
316
+ <span
317
+ className="font-mono text-[8px] font-bold uppercase"
318
+ style={{ color: typeColor }}
319
+ >
320
+ {tx.type}
321
+ </span>
322
+ {tx.amount && (
323
+ <span
324
+ className="font-mono text-[9px] font-bold"
325
+ style={{ color: 'var(--color-text, #0a0a0a)' }}
326
+ >
327
+ {parseFloat(tx.amount).toFixed(4)}
328
+ </span>
329
+ )}
330
+ {/* Wallet badge — clickable */}
331
+ <button
332
+ onClick={() => openWalletApp(tx.walletAddress)}
333
+ className="font-mono text-[8px] px-1 py-0.5 rounded-sm transition-colors truncate max-w-[100px]"
334
+ style={{
335
+ background: 'var(--color-background-alt, #f5f5f5)',
336
+ color: 'var(--color-text-muted, #888)',
337
+ }}
338
+ title={tx.walletAddress}
339
+ >
340
+ {walletLabel}
341
+ </button>
342
+ </div>
343
+ <div className="flex items-center gap-1 mt-0.5">
344
+ {tx.description && (
345
+ <div
346
+ className="font-mono text-[8px] truncate max-w-[200px]"
347
+ style={{ color: 'var(--color-text-muted, #888)' }}
348
+ >
349
+ {tx.description}
350
+ </div>
351
+ )}
352
+ {/* Token address — clickable */}
353
+ {tx.tokenAddress && (
354
+ <button
355
+ onClick={() => openTokenApp(tx.tokenAddress!, tx.chain)}
356
+ className="font-mono text-[7px] underline transition-colors shrink-0"
357
+ style={{ color: 'var(--color-info, #0047ff)' }}
358
+ title={tx.tokenAddress}
359
+ >
360
+ {tx.tokenAddress.slice(0, 6)}...{tx.tokenAddress.slice(-4)}
361
+ </button>
362
+ )}
363
+ </div>
364
+ {tx.txHash && (
365
+ <div className="flex items-center gap-1 mt-0.5">
366
+ <span
367
+ className="font-mono text-[7px]"
368
+ style={{ color: 'var(--color-text-faint, #aaa)' }}
369
+ >
370
+ tx:
371
+ </span>
372
+ {explorerUrl ? (
373
+ <a
374
+ href={`${explorerUrl}/tx/${tx.txHash}`}
375
+ target="_blank"
376
+ rel="noopener noreferrer"
377
+ className="font-mono text-[7px] transition-colors"
378
+ style={{ color: 'var(--color-text-faint, #aaa)' }}
379
+ title={tx.txHash}
380
+ >
381
+ {tx.txHash.slice(0, 10)}...{tx.txHash.slice(-6)}
382
+ </a>
383
+ ) : (
384
+ <span
385
+ className="font-mono text-[7px]"
386
+ style={{ color: 'var(--color-text-faint, #aaa)' }}
387
+ title={tx.txHash}
388
+ >
389
+ {tx.txHash.slice(0, 10)}...{tx.txHash.slice(-6)}
390
+ </span>
391
+ )}
392
+ </div>
393
+ )}
394
+ </div>
395
+ </div>
396
+ <div className="flex items-center gap-1 shrink-0">
397
+ <span className="font-mono text-[7px]" style={{ color: 'var(--color-text-faint, #aaa)' }}>
398
+ {formatTimeAgo(tx.createdAt)}
399
+ </span>
400
+ {tx.txHash && explorerUrl && (
401
+ <a
402
+ href={`${explorerUrl}/tx/${tx.txHash}`}
403
+ target="_blank"
404
+ rel="noopener noreferrer"
405
+ className="p-0.5 transition-colors"
406
+ style={{ color: 'var(--color-text-muted, #888)' }}
407
+ >
408
+ <ExternalLink size={9} />
409
+ </a>
410
+ )}
411
+ </div>
412
+ </div>
413
+ </div>
414
+ );
415
+ })}
416
+
417
+ {hasMore && (
418
+ <button
419
+ onClick={handleLoadMore}
420
+ disabled={loading}
421
+ className="w-full py-2 font-mono text-[8px] transition-colors"
422
+ style={{
423
+ color: 'var(--color-text-muted, #888)',
424
+ background: 'var(--color-background-alt, #f5f5f5)',
425
+ }}
426
+ >
427
+ {loading ? 'LOADING...' : 'LOAD MORE'}
428
+ </button>
429
+ )}
430
+ </>
431
+ )}
432
+ </div>
433
+ </div>
434
+ );
435
+ }
436
+
437
+ export { TransactionsApp };
438
+ export default TransactionsApp;