@canton-network/wallet-gateway-remote 1.11.3 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (192) hide show
  1. package/dist/auth/jwt-auth-service.d.ts +5 -4
  2. package/dist/auth/jwt-auth-service.d.ts.map +1 -1
  3. package/dist/auth/jwt-auth-service.js +76 -8
  4. package/dist/auth/jwt-auth-service.test.js +193 -0
  5. package/dist/config/Config.d.ts +58 -7
  6. package/dist/config/Config.d.ts.map +1 -1
  7. package/dist/config/Config.test.js +9 -2
  8. package/dist/config/ConfigUtils.d.ts +1 -1
  9. package/dist/config/ConfigUtils.d.ts.map +1 -1
  10. package/dist/config/ConfigUtils.js +43 -8
  11. package/dist/dapp-api/controller.d.ts +5 -7
  12. package/dist/dapp-api/controller.d.ts.map +1 -1
  13. package/dist/dapp-api/controller.js +31 -21
  14. package/dist/dapp-api/controller.test.js +12 -16
  15. package/dist/dapp-api/rpc-gen/index.d.ts.map +1 -1
  16. package/dist/dapp-api/rpc-gen/schemas.d.ts +3 -0
  17. package/dist/dapp-api/rpc-gen/schemas.d.ts.map +1 -0
  18. package/dist/dapp-api/rpc-gen/schemas.js +201 -0
  19. package/dist/dapp-api/rpc-gen/typings.d.ts +8 -1
  20. package/dist/dapp-api/rpc-gen/typings.d.ts.map +1 -1
  21. package/dist/dapp-api/server.d.ts +8 -9
  22. package/dist/dapp-api/server.d.ts.map +1 -1
  23. package/dist/dapp-api/server.js +7 -43
  24. package/dist/dapp-api/server.test.js +41 -2
  25. package/dist/dapp-api/sse-sink.d.ts +18 -0
  26. package/dist/dapp-api/sse-sink.d.ts.map +1 -0
  27. package/dist/dapp-api/sse-sink.js +27 -0
  28. package/dist/dapp-api/sse-sink.test.d.ts +2 -0
  29. package/dist/dapp-api/sse-sink.test.d.ts.map +1 -0
  30. package/dist/dapp-api/sse-sink.test.js +30 -0
  31. package/dist/env.d.ts +0 -1
  32. package/dist/env.d.ts.map +1 -1
  33. package/dist/init.d.ts +2 -2
  34. package/dist/init.d.ts.map +1 -1
  35. package/dist/init.js +13 -4
  36. package/dist/ledger/party-allocation-service.d.ts +3 -3
  37. package/dist/ledger/party-allocation-service.d.ts.map +1 -1
  38. package/dist/ledger/self-issued-auth-service.d.ts +50 -0
  39. package/dist/ledger/self-issued-auth-service.d.ts.map +1 -0
  40. package/dist/ledger/self-issued-auth-service.js +263 -0
  41. package/dist/ledger/self-issued-auth-service.test.d.ts +2 -0
  42. package/dist/ledger/self-issued-auth-service.test.d.ts.map +1 -0
  43. package/dist/ledger/self-issued-auth-service.test.js +454 -0
  44. package/dist/ledger/wallet-allocation/signing-providers/bitgo-wallet-allocator.d.ts +7 -7
  45. package/dist/ledger/wallet-allocation/signing-providers/bitgo-wallet-allocator.d.ts.map +1 -1
  46. package/dist/ledger/wallet-allocation/signing-providers/blockdaemon-wallet-allocator.d.ts +7 -7
  47. package/dist/ledger/wallet-allocation/signing-providers/blockdaemon-wallet-allocator.d.ts.map +1 -1
  48. package/dist/ledger/wallet-allocation/signing-providers/blockdaemon-wallet-allocator.js +1 -1
  49. package/dist/ledger/wallet-allocation/signing-providers/dfns-wallet-allocator.d.ts +7 -7
  50. package/dist/ledger/wallet-allocation/signing-providers/dfns-wallet-allocator.d.ts.map +1 -1
  51. package/dist/ledger/wallet-allocation/signing-providers/dfns-wallet-allocator.js +1 -1
  52. package/dist/ledger/wallet-allocation/signing-providers/fireblocks-wallet-allocator.d.ts +7 -7
  53. package/dist/ledger/wallet-allocation/signing-providers/fireblocks-wallet-allocator.d.ts.map +1 -1
  54. package/dist/ledger/wallet-allocation/signing-providers/fireblocks-wallet-allocator.js +1 -1
  55. package/dist/ledger/wallet-allocation/signing-providers/kernel-wallet-allocator.d.ts +7 -7
  56. package/dist/ledger/wallet-allocation/signing-providers/kernel-wallet-allocator.d.ts.map +1 -1
  57. package/dist/ledger/wallet-allocation/signing-providers/kernel-wallet-allocator.js +1 -1
  58. package/dist/ledger/wallet-allocation/signing-providers/participant-wallet-allocator.d.ts +6 -6
  59. package/dist/ledger/wallet-allocation/signing-providers/participant-wallet-allocator.d.ts.map +1 -1
  60. package/dist/ledger/wallet-allocation/signing-providers/securosys-wallet-allocator.d.ts +7 -7
  61. package/dist/ledger/wallet-allocation/signing-providers/securosys-wallet-allocator.d.ts.map +1 -1
  62. package/dist/ledger/wallet-allocation/signing-providers/securosys-wallet-allocator.js +1 -1
  63. package/dist/ledger/wallet-allocation/wallet-allocation-service.d.ts +6 -6
  64. package/dist/ledger/wallet-allocation/wallet-allocation-service.d.ts.map +1 -1
  65. package/dist/ledger/wallet-sync-service.d.ts +12 -9
  66. package/dist/ledger/wallet-sync-service.d.ts.map +1 -1
  67. package/dist/ledger/wallet-sync-service.js +49 -15
  68. package/dist/ledger/wallet-sync-service.test.js +171 -11
  69. package/dist/middleware/apiKeyAuth.d.ts +3 -3
  70. package/dist/middleware/apiKeyAuth.d.ts.map +1 -1
  71. package/dist/middleware/apiKeyAuth.js +2 -2
  72. package/dist/middleware/errorHandler.d.ts +7 -1
  73. package/dist/middleware/errorHandler.d.ts.map +1 -1
  74. package/dist/middleware/errorHandler.js +85 -1
  75. package/dist/middleware/errorHandler.test.js +39 -1
  76. package/dist/middleware/jsonRpcHandler.d.ts +6 -4
  77. package/dist/middleware/jsonRpcHandler.d.ts.map +1 -1
  78. package/dist/middleware/jsonRpcHandler.js +46 -7
  79. package/dist/middleware/jsonRpcHandler.test.js +101 -1
  80. package/dist/middleware/jwtAuth.d.ts +2 -2
  81. package/dist/middleware/jwtAuth.d.ts.map +1 -1
  82. package/dist/middleware/sessionHandler.d.ts +6 -4
  83. package/dist/middleware/sessionHandler.d.ts.map +1 -1
  84. package/dist/middleware/sessionHandler.js +25 -1
  85. package/dist/middleware/sessionHandler.test.js +61 -1
  86. package/dist/signing/service-account-session.d.ts +3 -3
  87. package/dist/signing/service-account-session.d.ts.map +1 -1
  88. package/dist/signing/service-account-session.js +2 -2
  89. package/dist/signing/service-account-session.test.js +1 -2
  90. package/dist/signing/signing-worker.d.ts +18 -16
  91. package/dist/signing/signing-worker.d.ts.map +1 -1
  92. package/dist/signing/signing-worker.js +18 -12
  93. package/dist/signing/signing-worker.test.js +10 -7
  94. package/dist/user-api/controller.d.ts +11 -7
  95. package/dist/user-api/controller.d.ts.map +1 -1
  96. package/dist/user-api/controller.js +249 -86
  97. package/dist/user-api/controller.test.js +145 -17
  98. package/dist/user-api/rpc-gen/index.d.ts +18 -0
  99. package/dist/user-api/rpc-gen/index.d.ts.map +1 -1
  100. package/dist/user-api/rpc-gen/index.js +6 -0
  101. package/dist/user-api/rpc-gen/schemas.d.ts +3 -0
  102. package/dist/user-api/rpc-gen/schemas.d.ts.map +1 -0
  103. package/dist/user-api/rpc-gen/schemas.js +1035 -0
  104. package/dist/user-api/rpc-gen/typings.d.ts +202 -28
  105. package/dist/user-api/rpc-gen/typings.d.ts.map +1 -1
  106. package/dist/user-api/server.d.ts +7 -8
  107. package/dist/user-api/server.d.ts.map +1 -1
  108. package/dist/user-api/server.js +2 -0
  109. package/dist/user-api/server.test.js +3 -2
  110. package/dist/user-api/token-network-matching.d.ts +2 -2
  111. package/dist/user-api/token-network-matching.d.ts.map +1 -1
  112. package/dist/user-api/token-network-matching.js +9 -7
  113. package/dist/utils.d.ts +0 -29
  114. package/dist/utils.d.ts.map +1 -1
  115. package/dist/utils.js +0 -57
  116. package/dist/version.d.ts.map +1 -1
  117. package/dist/version.js +2 -5
  118. package/dist/web/frontend/404/index.html +2 -2
  119. package/dist/web/frontend/activities/index.html +3 -3
  120. package/dist/web/frontend/api-keys/add/index.html +2 -2
  121. package/dist/web/frontend/api-keys/index.html +2 -2
  122. package/dist/web/frontend/approve/index.html +3 -3
  123. package/dist/web/frontend/assets/404-B1XXXMXN.js +5 -0
  124. package/dist/web/frontend/assets/{activities-DSP_NZCE.js → activities-HZnPjlMp.js} +2 -2
  125. package/dist/web/frontend/assets/{addApiKey-Zv2CS3ub.js → addApiKey-BvkCtUF3.js} +3 -3
  126. package/dist/web/frontend/assets/addIdentityProvider-Dvjma837.js +28 -0
  127. package/dist/web/frontend/assets/{addNetwork-B620CvC-.js → addNetwork-Cahac0uo.js} +2 -2
  128. package/dist/web/frontend/assets/addParty-Cdoed_Yx.js +13 -0
  129. package/dist/web/frontend/assets/{apiKeys-ohQpjexi.js → apiKeys-BwV6ylWL.js} +3 -3
  130. package/dist/web/frontend/assets/approve-B0nIfe2y.js +26 -0
  131. package/dist/web/frontend/assets/callback-BieW5Ux2.js +7 -0
  132. package/dist/web/frontend/assets/{common-BCDg7K0r.js → common-Bv9twGrA.js} +2 -2
  133. package/dist/web/frontend/assets/editParty-OOjTHFay.js +14 -0
  134. package/dist/web/frontend/assets/{identityProviders-C26I4FyE.js → identityProviders-BxJAq1Ne.js} +2 -2
  135. package/dist/web/frontend/assets/index-Bo6MnlYI.js +2 -0
  136. package/dist/web/frontend/assets/index-CG_aFABR.js +1 -0
  137. package/dist/web/frontend/assets/index-D1Brmwbg.js +93 -0
  138. package/dist/web/frontend/assets/index-pMOoiNFq.js +4887 -0
  139. package/dist/web/frontend/assets/login-BHxgJEz_.js +11 -0
  140. package/dist/web/frontend/assets/{networks-CtFnklqS.js → networks-CBprjUF5.js} +3 -3
  141. package/dist/web/frontend/assets/onboarding-ChmWs-TC.js +84 -0
  142. package/dist/web/frontend/assets/reviewIdentityProvider-CCmKgN8N.js +43 -0
  143. package/dist/web/frontend/assets/reviewNetwork-CX8Bmuf3.js +43 -0
  144. package/dist/web/frontend/assets/signMessage-BN_6S5FV.js +79 -0
  145. package/dist/web/frontend/callback/index.html +2 -2
  146. package/dist/web/frontend/identity-providers/add/index.html +2 -2
  147. package/dist/web/frontend/identity-providers/index.html +2 -2
  148. package/dist/web/frontend/identity-providers/review/index.html +2 -2
  149. package/dist/web/frontend/index.html +1 -1
  150. package/dist/web/frontend/login/index.html +2 -2
  151. package/dist/web/frontend/networks/add/index.html +2 -2
  152. package/dist/web/frontend/networks/index.html +2 -2
  153. package/dist/web/frontend/networks/review/index.html +2 -2
  154. package/dist/web/frontend/onboarding/index.html +23 -0
  155. package/dist/web/frontend/parties/add/index.html +5 -4
  156. package/dist/web/frontend/parties/edit/index.html +5 -4
  157. package/dist/web/frontend/parties/index.html +3 -2
  158. package/dist/web/frontend/sign-message/index.html +2 -2
  159. package/dist/web/route-inputs.js +1 -1
  160. package/dist/web/server.d.ts +1 -1
  161. package/dist/web/server.d.ts.map +1 -1
  162. package/package.json +36 -30
  163. package/dist/ledger/transaction-service.d.ts +0 -27
  164. package/dist/ledger/transaction-service.d.ts.map +0 -1
  165. package/dist/ledger/transaction-service.js +0 -297
  166. package/dist/ledger/transaction-service.test.d.ts +0 -2
  167. package/dist/ledger/transaction-service.test.d.ts.map +0 -1
  168. package/dist/ledger/transaction-service.test.js +0 -551
  169. package/dist/notification/NotificationService.d.ts +0 -18
  170. package/dist/notification/NotificationService.d.ts.map +0 -1
  171. package/dist/notification/NotificationService.js +0 -26
  172. package/dist/notification/NotificationService.test.d.ts +0 -2
  173. package/dist/notification/NotificationService.test.d.ts.map +0 -1
  174. package/dist/notification/NotificationService.test.js +0 -110
  175. package/dist/signing/signing-drivers.d.ts +0 -7
  176. package/dist/signing/signing-drivers.d.ts.map +0 -1
  177. package/dist/signing/signing-drivers.js +0 -3
  178. package/dist/web/frontend/assets/404-Ds_FbOi_.js +0 -5
  179. package/dist/web/frontend/assets/addIdentityProvider-BqiC9u9A.js +0 -28
  180. package/dist/web/frontend/assets/addParty-CSMZt930.js +0 -13
  181. package/dist/web/frontend/assets/approve-D5YmfGHz.js +0 -21
  182. package/dist/web/frontend/assets/callback-Dk9tIdBj.js +0 -7
  183. package/dist/web/frontend/assets/editParty-DX9X91dp.js +0 -14
  184. package/dist/web/frontend/assets/index-BCECRB_Y.js +0 -4943
  185. package/dist/web/frontend/assets/index-Cvcr2Fng.js +0 -2
  186. package/dist/web/frontend/assets/index-DrEQVBtC.js +0 -93
  187. package/dist/web/frontend/assets/login-dmjNaK2x.js +0 -11
  188. package/dist/web/frontend/assets/reviewIdentityProvider-GBlomu4-.js +0 -43
  189. package/dist/web/frontend/assets/reviewNetwork-CWEgNcCg.js +0 -43
  190. package/dist/web/frontend/assets/settings-DSh9rqaO.js +0 -37
  191. package/dist/web/frontend/assets/signMessage-CT2_Y1LA.js +0 -79
  192. package/dist/web/frontend/settings/index.html +0 -15
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dapp-api/server.ts"],"names":[],"mappings":"AAGA,OAAO,OAAO,MAAM,SAAS,CAAA;AAG7B,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAG7B,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAOlD,eAAO,MAAM,IAAI,GACb,OAAO,MAAM,EACb,KAAK,OAAO,CAAC,OAAO,EACpB,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,YAAY,UAAU,EACtB,SAAS,MAAM,EACf,SAAS,MAAM,EACf,cAAc,YAAY,EAC1B,qBAAqB,mBAAmB,EACxC,OAAO,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,EAC/B,gBAAgB,kBAAkB,EAClC,sBAAsB,sBAAsB,kGAkH/C,CAAA"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dapp-api/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAGlC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAIlC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EACH,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAE3B,MAAM,sCAAsC,CAAA;AAG7C,eAAO,MAAM,IAAI,GACb,OAAO,MAAM,EACb,KAAK,OAAO,CAAC,OAAO,EACpB,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,YAAY,UAAU,EACtB,SAAS,MAAM,EACf,SAAS,MAAM,EACf,cAAc,YAAY,EAC1B,qBAAqB,mBAAmB,EACxC,OAAO,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,EAC/B,gBAAgB,kBAAkB,EAClC,sBAAsB,sBAAsB,kGA0E/C,CAAA"}
@@ -3,10 +3,9 @@
3
3
  import cors from 'cors';
4
4
  import { dappController } from './controller.js';
5
5
  import { jsonRpcHandler } from '../middleware/jsonRpcHandler.js';
6
- function writeSSE(res, event, data) {
7
- res.write(`event: ${event}\n`);
8
- res.write(`data: ${JSON.stringify(data)}\n\n`);
9
- }
6
+ import { paramSchemas } from './rpc-gen/schemas.js';
7
+ import { subscribeNotifications, } from '@canton-network/core-wallet-services';
8
+ import { SseNotificationSink } from './sse-sink.js';
10
9
  export const dapp = (route, app, logger, server, kernelInfo, dappUrl, userUrl, serverConfig, notificationService, store, controllerDeps, hashingSchemeVersion) => {
11
10
  app.use(cors({
12
11
  origin: serverConfig.allowedOrigins,
@@ -31,47 +30,11 @@ export const dapp = (route, app, logger, server, kernelInfo, dappUrl, userUrl, s
31
30
  res.setHeader('Connection', 'keep-alive');
32
31
  res.setHeader('X-Accel-Buffering', 'no');
33
32
  res.flushHeaders?.();
34
- // Events scoped to the user (e.g. wallet/account changes) are broadcast
35
- // across all of that user's sessions; events scoped to a session (e.g.
36
- // transaction progress, connection status) are delivered only to the
37
- // session that originated them.
38
- const sessionNotifier = notificationService.getNotifier(sessionId);
39
- const userNotifier = notificationService.getNotifier(context.userId);
40
- const onAccountsChanged = (...event) => {
41
- writeSSE(res, 'accountsChanged', event);
42
- };
43
- const onStatusChanged = (...event) => {
44
- logger.debug({ sessionId }, 'Emitting statusChanged event via SSE');
45
- writeSSE(res, 'statusChanged', event);
46
- };
47
- const onConnected = (...event) => {
48
- writeSSE(res, 'connected', event);
49
- };
50
- const onTxChanged = (...event) => {
51
- writeSSE(res, 'txChanged', event);
52
- };
53
- const onMessageSignature = (...event) => {
54
- writeSSE(res, 'messageSignature', event);
55
- };
56
- const onLogout = () => {
57
- logger.info({ userId: context.userId }, 'Session terinated by server. Forcing SSE teardown.');
58
- cleanup();
59
- res.end();
60
- };
61
- userNotifier.on('accountsChanged', onAccountsChanged);
62
- sessionNotifier.on('connected', onConnected);
63
- sessionNotifier.on('statusChanged', onStatusChanged);
64
- sessionNotifier.on('txChanged', onTxChanged);
65
- sessionNotifier.on('messageSignature', onMessageSignature);
66
- sessionNotifier.on('logout', onLogout);
33
+ const subscriber = { sessionId, userId: context.userId };
34
+ const unsubscribe = subscribeNotifications(notificationService, subscriber, new SseNotificationSink(res, logger, subscriber));
67
35
  const cleanup = () => {
68
36
  logger.debug('SSE client disconnected');
69
- userNotifier.removeListener('accountsChanged', onAccountsChanged);
70
- sessionNotifier.removeListener('connected', onConnected);
71
- sessionNotifier.removeListener('statusChanged', onStatusChanged);
72
- sessionNotifier.removeListener('txChanged', onTxChanged);
73
- sessionNotifier.removeListener('messageSignature', onMessageSignature);
74
- sessionNotifier.removeListener('logout', onLogout);
37
+ unsubscribe();
75
38
  };
76
39
  req.on('close', cleanup);
77
40
  req.on('error', cleanup);
@@ -81,6 +44,7 @@ export const dapp = (route, app, logger, server, kernelInfo, dappUrl, userUrl, s
81
44
  jsonRpcHandler({
82
45
  controller: dappController(kernelInfo, dappUrl, userUrl, store.withAuthContext(req.authContext), notificationService, logger, origin, controllerDeps, hashingSchemeVersion, req.authContext),
83
46
  logger,
47
+ paramSchemas,
84
48
  })(req, res, next);
85
49
  });
86
50
  return server;
@@ -1,13 +1,13 @@
1
1
  // Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
2
2
  // SPDX-License-Identifier: Apache-2.0
3
- import { expect, test } from 'vitest';
3
+ import { expect, test, vi } from 'vitest';
4
4
  import cors from 'cors';
5
5
  import request from 'supertest';
6
6
  import express from 'express';
7
7
  import { dapp } from './server.js';
8
8
  import { StoreInternal } from '@canton-network/core-wallet-store-inmemory';
9
9
  import { ConfigUtils, deriveUrls } from '../config/ConfigUtils.js';
10
- import { NotificationService } from '../notification/NotificationService.js';
10
+ import { NotificationService } from '@canton-network/core-wallet-services';
11
11
  import { pino } from 'pino';
12
12
  import { sink } from 'pino-test';
13
13
  import { createServer } from 'http';
@@ -38,3 +38,42 @@ test('call connect rpc', async () => {
38
38
  },
39
39
  });
40
40
  });
41
+ test('streams session & user notifications over SSE until logout', async () => {
42
+ const context = { userId: 'sse-user', accessToken: 'sse-token' };
43
+ await store.withAuthContext(context).setSession({
44
+ id: 'sse-session',
45
+ origin: 'http://localhost:8080',
46
+ network: 'network',
47
+ accessToken: context.accessToken,
48
+ });
49
+ const service = new NotificationService(pino(sink()));
50
+ const app = express();
51
+ app.use((req, _res, next) => {
52
+ req.authContext = context;
53
+ next();
54
+ });
55
+ const server = createServer(app);
56
+ const { dappApiUrl, publicUrl } = deriveUrls(config);
57
+ dapp('/api/v0/dapp', app, pino(sink()), server, config.kernel, dappApiUrl, publicUrl, config.server, service, store, { signingDrivers: {} }, 'HASHING_SCHEME_VERSION_V3');
58
+ const sessionNotifier = service.getNotifier('sse-session');
59
+ const userNotifier = service.getNotifier('sse-user');
60
+ // supertest only fires the request once awaited/then-ed
61
+ const response = request(app)
62
+ .get('/api/v0/dapp/events')
63
+ .then((res) => res);
64
+ // `emit` returns true once the SSE client has subscribed
65
+ await vi.waitFor(() => expect(sessionNotifier.emit('connected', { c: 1 })).toBe(true));
66
+ sessionNotifier.emit('txChanged', { status: 'pending' });
67
+ userNotifier.emit('accountsChanged', [{ partyId: 'p' }]);
68
+ service.getNotifier('other-session').emit('txChanged', { other: true });
69
+ sessionNotifier.emit('logout');
70
+ const res = await response;
71
+ expect(res.statusCode).toBe(200);
72
+ expect(res.headers['content-type']).toBe('text/event-stream');
73
+ expect(res.text).toBe('event: connected\ndata: [{"c":1}]\n\n' +
74
+ 'event: txChanged\ndata: [{"status":"pending"}]\n\n' +
75
+ 'event: accountsChanged\ndata: [[{"partyId":"p"}]]\n\n');
76
+ // subscription was torn down on logout
77
+ expect(sessionNotifier.emit('txChanged', {})).toBe(false);
78
+ expect(userNotifier.emit('accountsChanged', [])).toBe(false);
79
+ });
@@ -0,0 +1,18 @@
1
+ import type express from 'express';
2
+ import type { Logger } from 'pino';
3
+ import type { DappNotificationEvent, NotificationSink, NotificationSubscriber } from '@canton-network/core-wallet-services';
4
+ /**
5
+ * Delivers notifications to a dApp over Server-Sent Events.
6
+ *
7
+ * Wire format: one SSE `event` per notification, whose `data` is the JSON
8
+ * encoded array of the arguments the event was emitted with.
9
+ */
10
+ export declare class SseNotificationSink implements NotificationSink {
11
+ private readonly res;
12
+ private readonly logger;
13
+ private readonly subscriber;
14
+ constructor(res: express.Response, logger: Logger, subscriber: NotificationSubscriber);
15
+ send(event: DappNotificationEvent, args: unknown[]): void;
16
+ close(): void;
17
+ }
18
+ //# sourceMappingURL=sse-sink.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sse-sink.d.ts","sourceRoot":"","sources":["../../src/dapp-api/sse-sink.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,KAAK,EACR,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACzB,MAAM,sCAAsC,CAAA;AAO7C;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAEpD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAFV,GAAG,EAAE,OAAO,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,sBAAsB;IAGvD,IAAI,CAAC,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAQzD,KAAK,IAAI,IAAI;CAOhB"}
@@ -0,0 +1,27 @@
1
+ // Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
2
+ // SPDX-License-Identifier: Apache-2.0
3
+ function writeSSE(res, event, data) {
4
+ res.write(`event: ${event}\n`);
5
+ res.write(`data: ${JSON.stringify(data)}\n\n`);
6
+ }
7
+ /**
8
+ * Delivers notifications to a dApp over Server-Sent Events.
9
+ *
10
+ * Wire format: one SSE `event` per notification, whose `data` is the JSON
11
+ * encoded array of the arguments the event was emitted with.
12
+ */
13
+ export class SseNotificationSink {
14
+ constructor(res, logger, subscriber) {
15
+ this.res = res;
16
+ this.logger = logger;
17
+ this.subscriber = subscriber;
18
+ }
19
+ send(event, args) {
20
+ this.logger.debug({ sessionId: this.subscriber.sessionId, event }, `Emitting ${event} event via SSE`);
21
+ writeSSE(this.res, event, args);
22
+ }
23
+ close() {
24
+ this.logger.info({ userId: this.subscriber.userId }, 'Session terminated by server. Forcing SSE teardown.');
25
+ this.res.end();
26
+ }
27
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=sse-sink.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sse-sink.test.d.ts","sourceRoot":"","sources":["../../src/dapp-api/sse-sink.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,30 @@
1
+ // Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
2
+ // SPDX-License-Identifier: Apache-2.0
3
+ import { describe, expect, it, vi } from 'vitest';
4
+ import { pino } from 'pino';
5
+ import { sink } from 'pino-test';
6
+ import { SseNotificationSink } from './sse-sink.js';
7
+ function fakeResponse() {
8
+ return {
9
+ write: vi.fn(),
10
+ end: vi.fn(),
11
+ };
12
+ }
13
+ const subscriber = { sessionId: 'session-1', userId: 'user-1' };
14
+ describe('SseNotificationSink', () => {
15
+ it('writes each event as an SSE frame with the JSON encoded args', () => {
16
+ const res = fakeResponse();
17
+ const sseSink = new SseNotificationSink(res, pino(sink()), subscriber);
18
+ sseSink.send('txChanged', [{ status: 'pending', commandId: 'c1' }]);
19
+ expect(res.write.mock.calls.map(([chunk]) => chunk).join('')).toBe('event: txChanged\n' +
20
+ 'data: [{"status":"pending","commandId":"c1"}]\n\n');
21
+ expect(res.end).not.toHaveBeenCalled();
22
+ });
23
+ it('ends the response on close', () => {
24
+ const res = fakeResponse();
25
+ const sseSink = new SseNotificationSink(res, pino(sink()), subscriber);
26
+ sseSink.close();
27
+ expect(res.end).toHaveBeenCalledTimes(1);
28
+ expect(res.write).not.toHaveBeenCalled();
29
+ });
30
+ });
package/dist/env.d.ts CHANGED
@@ -1,4 +1,3 @@
1
- export type HASHING_SCHEME_VERSION = 'HASHING_SCHEME_VERSION_V2' | 'HASHING_SCHEME_VERSION_V3' | undefined;
2
1
  export declare class Env {
3
2
  static FIREBLOCKS_API_KEY: () => string | undefined;
4
3
  static FIREBLOCKS_SECRET: () => string | undefined;
package/dist/env.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,sBAAsB,GAC9B,2BAA2B,GAAG,2BAA2B,GAAG,SAAS,CAAA;AAEzE,qBAAa,GAAG;IACZ,MAAM,CAAC,kBAAkB,2BAAsC;IAC/D,MAAM,CAAC,iBAAiB,2BAAqC;IAC7D,MAAM,CAAC,mBAAmB,GAAI,UAAU,MAAM,YACE;IAChD,MAAM,CAAC,mBAAmB,GAAI,UAAU,MAAM,YACE;IAChD,MAAM,CAAC,mBAAmB,GAAI,UAAU,MAAM,YACE;IAChD,MAAM,CAAC,iBAAiB,GAAI,UAAU,MAAM,YACE;IAC9C,MAAM,CAAC,sBAAsB,2BAA0C;IACvE,MAAM,CAAC,oCAAoC,2BACQ;IACnD,MAAM,CAAC,mCAAmC,2BACQ;IAClD,MAAM,CAAC,0BAA0B,2BACQ;IACzC,MAAM,CAAC,2BAA2B,2BACQ;IAC1C,MAAM,CAAC,+BAA+B,2BACQ;IAC9C,MAAM,CAAC,0BAA0B,2BACQ;IACzC,MAAM,CAAC,iCAAiC,GAAI,UAAU,MAAM,YACE;IAC9D,MAAM,CAAC,WAAW,2BAA+B;IACjD,MAAM,CAAC,aAAa,GAAI,UAAU,MAAM,YACE;IAC1C,MAAM,CAAC,YAAY,2BAAgC;IACnD,MAAM,CAAC,gBAAgB,2BAAoC;IAC3D,MAAM,CAAC,eAAe,2BAAmC;IACzD,MAAM,CAAC,kBAAkB,2BAAsC;IAC/D,MAAM,CAAC,aAAa,GAAI,UAAU,MAAM,YACE;IAC1C,MAAM,CAAC,mBAAmB,2BAAuC;IACjE,MAAM,CAAC,UAAU,2BAA8B;IAE/C,MAAM,CAAC,GAAG,CACN,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAClD,MAAM;IACT,MAAM,CAAC,GAAG,CACN,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,MAAM;IACT,MAAM,CAAC,GAAG,CACN,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GAChE,MAAM,GAAG,SAAS;CAcxB"}
1
+ {"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,qBAAa,GAAG;IACZ,MAAM,CAAC,kBAAkB,2BAAsC;IAC/D,MAAM,CAAC,iBAAiB,2BAAqC;IAC7D,MAAM,CAAC,mBAAmB,GAAI,UAAU,MAAM,YACE;IAChD,MAAM,CAAC,mBAAmB,GAAI,UAAU,MAAM,YACE;IAChD,MAAM,CAAC,mBAAmB,GAAI,UAAU,MAAM,YACE;IAChD,MAAM,CAAC,iBAAiB,GAAI,UAAU,MAAM,YACE;IAC9C,MAAM,CAAC,sBAAsB,2BAA0C;IACvE,MAAM,CAAC,oCAAoC,2BACQ;IACnD,MAAM,CAAC,mCAAmC,2BACQ;IAClD,MAAM,CAAC,0BAA0B,2BACQ;IACzC,MAAM,CAAC,2BAA2B,2BACQ;IAC1C,MAAM,CAAC,+BAA+B,2BACQ;IAC9C,MAAM,CAAC,0BAA0B,2BACQ;IACzC,MAAM,CAAC,iCAAiC,GAAI,UAAU,MAAM,YACE;IAC9D,MAAM,CAAC,WAAW,2BAA+B;IACjD,MAAM,CAAC,aAAa,GAAI,UAAU,MAAM,YACE;IAC1C,MAAM,CAAC,YAAY,2BAAgC;IACnD,MAAM,CAAC,gBAAgB,2BAAoC;IAC3D,MAAM,CAAC,eAAe,2BAAmC;IACzD,MAAM,CAAC,kBAAkB,2BAAsC;IAC/D,MAAM,CAAC,aAAa,GAAI,UAAU,MAAM,YACE;IAC1C,MAAM,CAAC,mBAAmB,2BAAuC;IACjE,MAAM,CAAC,UAAU,2BAA8B;IAE/C,MAAM,CAAC,GAAG,CACN,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAClD,MAAM;IACT,MAAM,CAAC,GAAG,CACN,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,MAAM;IACT,MAAM,CAAC,GAAG,CACN,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GAChE,MAAM,GAAG,SAAS;CAcxB"}
package/dist/init.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { Logger } from 'pino';
2
- import { CliOptions } from './index.js';
1
+ import type { Logger } from 'pino';
2
+ import type { CliOptions } from './index.js';
3
3
  export declare function initialize(opts: CliOptions, logger: Logger): Promise<void>;
4
4
  //# sourceMappingURL=init.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AA6B7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AA2MvC,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBA4PhE"}
1
+ {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AA4BlC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AA+M5C,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAsQhE"}
package/dist/init.js CHANGED
@@ -11,8 +11,8 @@ import { ParticipantSigningDriver } from '@canton-network/core-signing-participa
11
11
  import { InternalSigningDriver } from '@canton-network/core-signing-internal';
12
12
  import DfnsSigningProvider from '@canton-network/core-signing-dfns';
13
13
  import FireblocksSigningProvider from '@canton-network/core-signing-fireblocks';
14
- import BlockdaemonSigningProvider from '@canton-network/core-signing-blockdaemon';
15
- import SecurosysSigningProvider from '@canton-network/core-signing-securosys';
14
+ import BlockdaemonSigningProvider, {} from '@canton-network/core-signing-blockdaemon';
15
+ import SecurosysSigningProvider, {} from '@canton-network/core-signing-securosys';
16
16
  import BitGoSigningProvider from '@canton-network/core-signing-bitgo';
17
17
  import { jwtAuthService } from './auth/jwt-auth-service.js';
18
18
  import express from 'express';
@@ -22,12 +22,12 @@ import { deriveUrls } from './config/ConfigUtils.js';
22
22
  import { existsSync } from 'fs';
23
23
  import { GATEWAY_VERSION } from './version.js';
24
24
  import { sessionHandler } from './middleware/sessionHandler.js';
25
- import { NotificationService } from './notification/NotificationService.js';
26
25
  import { sql } from 'kysely';
27
26
  import { Env } from './env.js';
28
27
  import { SigningWorker } from './signing/signing-worker.js';
29
28
  import { apiKeyAuth } from './middleware/apiKeyAuth.js';
30
29
  import { securityHeaders } from './middleware/securityHeaders.js';
30
+ import { NotificationService, } from '@canton-network/core-wallet-services';
31
31
  import { errorHandler } from './middleware/errorHandler.js';
32
32
  let isReady = false;
33
33
  let signingWorker;
@@ -276,6 +276,15 @@ export async function initialize(opts, logger) {
276
276
  'listIdps',
277
277
  'getUser',
278
278
  'selfSignedAccessToken',
279
+ 'addSelfIssuedSession',
280
+ ],
281
+ };
282
+ const onboardingPaths = {
283
+ [config.server.userPath]: [
284
+ 'getSelfIssuedOnboarding',
285
+ 'createSelfIssuedWallet',
286
+ 'allocateSelfIssuedWallet',
287
+ 'connectSelfIssuedSession',
279
288
  ],
280
289
  };
281
290
  const apiMiddleware = [
@@ -283,7 +292,7 @@ export async function initialize(opts, logger) {
283
292
  apiKeyAuth(store, config.server.dappPath, logger.child({ component: 'ApiKeyHandler' })),
284
293
  jwtAuth(authService, logger.child({ component: 'JwtHandler' })),
285
294
  postAuthRateLimit,
286
- sessionHandler(store, allowedPaths, logger.child({ component: 'SessionHandler' })),
295
+ sessionHandler(store, allowedPaths, logger.child({ component: 'SessionHandler' }), onboardingPaths),
287
296
  ];
288
297
  app.use(config.server.userPath, ...apiMiddleware);
289
298
  app.use(config.server.dappPath, ...apiMiddleware);
@@ -1,6 +1,6 @@
1
- import { GenerateTransactionResponse } from '@canton-network/core-ledger-client';
2
- import { AccessTokenProvider } from '@canton-network/core-wallet-auth';
3
- import { Logger } from 'pino';
1
+ import { type GenerateTransactionResponse } from '@canton-network/core-ledger-client';
2
+ import type { AccessTokenProvider } from '@canton-network/core-wallet-auth';
3
+ import type { Logger } from 'pino';
4
4
  export type AllocatedParty = {
5
5
  partyId: string;
6
6
  hint: string;
@@ -1 +1 @@
1
- {"version":3,"file":"party-allocation-service.d.ts","sourceRoot":"","sources":["../../src/ledger/party-allocation-service.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,2BAA2B,EAE9B,MAAM,oCAAoC,CAAA;AAE3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAE7B,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAEpD;;GAEG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,cAAc,CAAoB;gBAE9B,EACR,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,MAAM,GACT,EAAE;QACC,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,mBAAmB,EAAE,mBAAmB,CAAA;QACxC,aAAa,EAAE,MAAM,CAAA;QACrB,MAAM,EAAE,MAAM,CAAA;KACjB;IAUD;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAE1E;;;;;;OAMG;IACG,aAAa,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,WAAW,GAC7B,OAAO,CAAC,cAAc,CAAC;IAoB1B;;;OAGG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAanD;;;;;OAKG;IACH,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAsB5D;;;;OAIG;IACG,4BAA4B,CAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,2BAA2B,CAAC;IAevC;;;;;;OAMG;IACG,+BAA+B,CACjC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EAAE,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;YAgCJ,qBAAqB;YAoCrB,qBAAqB;CAsCtC"}
1
+ {"version":3,"file":"party-allocation-service.d.ts","sourceRoot":"","sources":["../../src/ledger/party-allocation-service.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,KAAK,2BAA2B,EAEnC,MAAM,oCAAoC,CAAA;AAE3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAEpD;;GAEG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,cAAc,CAAoB;gBAE9B,EACR,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,MAAM,GACT,EAAE;QACC,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,mBAAmB,EAAE,mBAAmB,CAAA;QACxC,aAAa,EAAE,MAAM,CAAA;QACrB,MAAM,EAAE,MAAM,CAAA;KACjB;IAUD;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAE1E;;;;;;OAMG;IACG,aAAa,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,WAAW,GAC7B,OAAO,CAAC,cAAc,CAAC;IAoB1B;;;OAGG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAanD;;;;;OAKG;IACH,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAsB5D;;;;OAIG;IACG,4BAA4B,CAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,2BAA2B,CAAC;IAevC;;;;;;OAMG;IACG,+BAA+B,CACjC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EAAE,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;YAgCJ,qBAAqB;YAoCrB,qBAAqB;CAsCtC"}
@@ -0,0 +1,50 @@
1
+ import { LedgerClient } from '@canton-network/core-ledger-client';
2
+ import { type AuthAware } from '@canton-network/core-wallet-auth';
3
+ import type { Network, Session, Store, Wallet } from '@canton-network/core-wallet-store';
4
+ import { SigningProvider } from '@canton-network/core-signing-lib';
5
+ import type { SigningDrivers } from '@canton-network/core-wallet-services';
6
+ import type { Logger } from 'pino';
7
+ import { WalletAllocationService } from './wallet-allocation/wallet-allocation-service.js';
8
+ export type SelfIssuedOnboardingSession = {
9
+ userId: string;
10
+ sessionId: string;
11
+ };
12
+ export type CreatePartyParams = {
13
+ partyHint: string;
14
+ signingProviderId: SigningProvider;
15
+ };
16
+ export type PartyParams = {
17
+ partyId: string;
18
+ };
19
+ export type SelfIssuedOnboardingState = {
20
+ userExists: boolean;
21
+ primaryPartyAuth: boolean;
22
+ wallets: Wallet[];
23
+ };
24
+ export declare function assertSelfIssuedOnboardingAllowed(store: Store & AuthAware<Store>, network: Network, username: string, logger: Logger): Promise<void>;
25
+ export declare class SelfIssuedAuthService {
26
+ private readonly session;
27
+ private readonly store;
28
+ private readonly logger;
29
+ private readonly walletAllocator;
30
+ private readonly ledgerClient;
31
+ private readonly drivers;
32
+ constructor(session: SelfIssuedOnboardingSession, store: Store, logger: Logger, walletAllocator: WalletAllocationService, ledgerClient: LedgerClient, drivers: SigningDrivers);
33
+ getOnboardingState(): Promise<SelfIssuedOnboardingState>;
34
+ private getExistingUser;
35
+ createWallet(params: CreatePartyParams): Promise<Wallet>;
36
+ allocateParty(params: PartyParams): Promise<Wallet>;
37
+ connectSession(params: PartyParams): Promise<{
38
+ wallet: Wallet;
39
+ accessToken: string;
40
+ session: Session;
41
+ }>;
42
+ private requireExistingAuthParty;
43
+ private setUserAuthParty;
44
+ private toWalletWithSyncedRights;
45
+ private requireWallet;
46
+ private mintAccessToken;
47
+ private authContext;
48
+ }
49
+ export declare function createSelfIssuedAuthService(bootstrapStore: Store & AuthAware<Store>, session: SelfIssuedOnboardingSession, drivers: SigningDrivers, logger: Logger): Promise<SelfIssuedAuthService>;
50
+ //# sourceMappingURL=self-issued-auth-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"self-issued-auth-service.d.ts","sourceRoot":"","sources":["../../src/ledger/self-issued-auth-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,YAAY,EACf,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACH,KAAK,SAAS,EAKjB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EACR,OAAO,EACP,OAAO,EACP,KAAK,EACL,MAAM,EACT,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAc,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAA;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAGlC,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAA;AAE1F,MAAM,MAAM,2BAA2B,GAAG;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,eAAe,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACtB,OAAO,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACpC,UAAU,EAAE,OAAO,CAAA;IACnB,gBAAgB,EAAE,OAAO,CAAA;IACzB,OAAO,EAAE,MAAM,EAAE,CAAA;CACpB,CAAA;AA+BD,wBAAsB,iCAAiC,CACnD,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,EAC/B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAwCf;AAID,qBAAa,qBAAqB;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBALP,OAAO,EAAE,2BAA2B,EACpC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,uBAAuB,EACxC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,cAAc;IAGtC,kBAAkB,IAAI,OAAO,CAAC,yBAAyB,CAAC;YAWhD,eAAe;IAIvB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDxD,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAcnD,cAAc,CAChB,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAiCrE,OAAO,CAAC,wBAAwB;YAYlB,gBAAgB;YA2BhB,wBAAwB;YAexB,aAAa;YAQb,eAAe;IAmE7B,OAAO,CAAC,WAAW;CAGtB;AAYD,wBAAsB,2BAA2B,CAC7C,cAAc,EAAE,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,EACxC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,CAuDhC"}
@@ -0,0 +1,263 @@
1
+ // Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
2
+ // SPDX-License-Identifier: Apache-2.0
3
+ import { isJsCantonError, LedgerClient, } from '@canton-network/core-ledger-client';
4
+ import { AuthTokenProvider, SelfIssuedTokenService, resolveAuthIdentityProviderId, } from '@canton-network/core-wallet-auth';
5
+ import { isRpcError, SigningProvider } from '@canton-network/core-signing-lib';
6
+ import { PartyAllocationService } from './party-allocation-service.js';
7
+ import { WalletSyncService } from './wallet-sync-service.js';
8
+ import { WalletAllocationService } from './wallet-allocation/wallet-allocation-service.js';
9
+ function isOnboarded(user) {
10
+ return !!user && !!user.primaryParty && !!user.primaryPartyAuthentication;
11
+ }
12
+ const SELF_ISSUED_LOGIN_UNAVAILABLE = 'Self-issued login is not available for this user.';
13
+ async function fetchLedgerUser(ledgerClient, userId) {
14
+ try {
15
+ const response = await ledgerClient.get('/v2/users/{user-id}', {
16
+ path: { 'user-id': userId },
17
+ });
18
+ return response.user ?? null;
19
+ }
20
+ catch (error) {
21
+ if (isJsCantonError(error) && error.code === 'USER_NOT_FOUND') {
22
+ return null;
23
+ }
24
+ throw error;
25
+ }
26
+ }
27
+ export async function assertSelfIssuedOnboardingAllowed(store, network, username, logger) {
28
+ if (!network.adminAuth) {
29
+ throw new Error('No admin auth configured');
30
+ }
31
+ const adminIdp = await store.getIdp(resolveAuthIdentityProviderId(network.adminAuth, network.identityProviderId));
32
+ const ledgerClient = new LedgerClient({
33
+ baseUrl: new URL(network.ledgerApi.baseUrl),
34
+ logger,
35
+ accessTokenProvider: AuthTokenProvider.fromGatewayConfig(adminIdp, network.adminAuth, logger),
36
+ });
37
+ const user = await fetchLedgerUser(ledgerClient, username);
38
+ if (!user) {
39
+ return;
40
+ }
41
+ const primaryParty = user.primaryParty;
42
+ const hasAuthWallet = !!primaryParty &&
43
+ !!user.primaryPartyAuthentication &&
44
+ (await store
45
+ .withAuthContext({ userId: username, accessToken: '' })
46
+ .getAllWallets({ networkIds: [network.id] })).some((wallet) => wallet.isAuthParty &&
47
+ wallet.userId === username &&
48
+ wallet.partyId === primaryParty);
49
+ if (!hasAuthWallet) {
50
+ throw new Error(SELF_ISSUED_LOGIN_UNAVAILABLE);
51
+ }
52
+ }
53
+ const ACCESS_TOKEN_TTL_SECONDS = 10 * 60;
54
+ export class SelfIssuedAuthService {
55
+ constructor(session, store, logger, walletAllocator, ledgerClient, drivers) {
56
+ this.session = session;
57
+ this.store = store;
58
+ this.logger = logger;
59
+ this.walletAllocator = walletAllocator;
60
+ this.ledgerClient = ledgerClient;
61
+ this.drivers = drivers;
62
+ }
63
+ async getOnboardingState() {
64
+ const user = await this.getExistingUser();
65
+ return {
66
+ userExists: user !== null,
67
+ primaryPartyAuth: isOnboarded(user),
68
+ wallets: (await this.store.getWallets()).filter((wallet) => wallet.isAuthParty),
69
+ };
70
+ }
71
+ async getExistingUser() {
72
+ return fetchLedgerUser(this.ledgerClient, this.session.userId);
73
+ }
74
+ async createWallet(params) {
75
+ const username = this.session.userId;
76
+ const partyHint = params.partyHint.trim();
77
+ if (!partyHint) {
78
+ throw new Error('partyHint is required');
79
+ }
80
+ if (params.signingProviderId === SigningProvider.PARTICIPANT) {
81
+ throw new Error('Signing provider participant is not supported for self-issued onboarding');
82
+ }
83
+ const existingUser = await this.getExistingUser();
84
+ if (isOnboarded(existingUser)) {
85
+ throw new Error('Primary party authentication is already configured for this user.');
86
+ }
87
+ // If user already exists but has no primaryPartyAuth and primaryParty set, it means either:
88
+ // - onboarding flow was interrupted before a wallet was allocated, but after user was created
89
+ // - the user was created outside of onboarding flow
90
+ if (!existingUser) {
91
+ await this.ledgerClient.post('/v2/users', {
92
+ user: {
93
+ id: username,
94
+ isDeactivated: false,
95
+ identityProviderId: '',
96
+ },
97
+ rights: [],
98
+ });
99
+ }
100
+ const wallet = await this.walletAllocator.createWallet(this.authContext(), partyHint, false, params.signingProviderId);
101
+ this.logger.info({
102
+ username,
103
+ partyHint,
104
+ partyId: wallet.partyId,
105
+ status: wallet.status,
106
+ signingProviderId: params.signingProviderId,
107
+ }, 'Created self-issued authentication party');
108
+ return this.toWalletWithSyncedRights(wallet);
109
+ }
110
+ async allocateParty(params) {
111
+ let wallet = await this.requireWallet(params.partyId);
112
+ if (wallet.status !== 'allocated') {
113
+ await this.walletAllocator.allocateParty(this.authContext(), wallet, wallet.signingProviderId);
114
+ wallet = await this.requireWallet(params.partyId);
115
+ }
116
+ return this.toWalletWithSyncedRights(wallet);
117
+ }
118
+ async connectSession(params) {
119
+ const username = this.session.userId;
120
+ const wallet = await this.requireWallet(params.partyId);
121
+ if (wallet.status !== 'allocated') {
122
+ throw new Error(`Wallet for party ${params.partyId} is not allocated`);
123
+ }
124
+ const existingUser = await this.getExistingUser();
125
+ const authPartyWallet = isOnboarded(existingUser)
126
+ ? this.requireExistingAuthParty(wallet, existingUser?.primaryParty)
127
+ : await this.setUserAuthParty(username, wallet);
128
+ const accessToken = await this.mintAccessToken(authPartyWallet);
129
+ const session = await this.store.upgradeOnboardingSession(this.session.sessionId, accessToken);
130
+ this.logger.info({
131
+ username,
132
+ partyId: authPartyWallet.partyId,
133
+ status: authPartyWallet.status,
134
+ signingProviderId: authPartyWallet.signingProviderId,
135
+ isAuthParty: authPartyWallet.isAuthParty,
136
+ }, 'Established self-issued session');
137
+ return { wallet: authPartyWallet, accessToken, session };
138
+ }
139
+ requireExistingAuthParty(wallet, userPrimaryParty) {
140
+ if (!wallet.isAuthParty || userPrimaryParty !== wallet.partyId) {
141
+ throw new Error(`Party ${wallet.partyId} is not the authentication party for this user`);
142
+ }
143
+ return wallet;
144
+ }
145
+ async setUserAuthParty(username, wallet) {
146
+ await this.ledgerClient.patch('/v2/users/{user-id}', {
147
+ user: {
148
+ id: username,
149
+ primaryParty: wallet.partyId,
150
+ primaryPartyAuthentication: true,
151
+ },
152
+ updateMask: {
153
+ paths: ['primary_party', 'primary_party_authentication'],
154
+ unknownFields: { fields: {} },
155
+ },
156
+ }, { path: { 'user-id': username } });
157
+ await this.store.updateWallet({
158
+ partyId: wallet.partyId,
159
+ networkId: wallet.networkId,
160
+ isAuthParty: true,
161
+ });
162
+ return this.requireWallet(wallet.partyId);
163
+ }
164
+ async toWalletWithSyncedRights(wallet) {
165
+ if (wallet.status !== 'allocated') {
166
+ return wallet;
167
+ }
168
+ await new WalletSyncService(this.store, this.ledgerClient, this.authContext(), this.logger).syncRights();
169
+ return this.requireWallet(wallet.partyId);
170
+ }
171
+ async requireWallet(partyId) {
172
+ const wallet = await this.store.getWallet(partyId);
173
+ if (!wallet) {
174
+ throw new Error(`Wallet not found for party ${partyId}`);
175
+ }
176
+ return wallet;
177
+ }
178
+ async mintAccessToken(wallet) {
179
+ const username = this.session.userId;
180
+ const network = await this.store.getCurrentNetwork();
181
+ if (network.auth.method !== 'self_issued') {
182
+ throw new Error('Network does not use self_issued authentication');
183
+ }
184
+ if (!network.synchronizerId) {
185
+ throw new Error('Current network has no synchronizerId');
186
+ }
187
+ const signingProviderId = wallet.signingProviderId;
188
+ const driver = this.drivers[signingProviderId]?.controller(username);
189
+ if (!driver) {
190
+ throw new Error(`Signing driver ${signingProviderId} is not available`);
191
+ }
192
+ const signingInput = await SelfIssuedTokenService.prepareForSigning(wallet.publicKey, {
193
+ audience: network.auth.audience,
194
+ scope: network.auth.scope,
195
+ partyId: wallet.partyId,
196
+ username,
197
+ synchronizerId: network.synchronizerId,
198
+ ttlSeconds: ACCESS_TOKEN_TTL_SECONDS,
199
+ });
200
+ // TODO(#2495) with other signing providers this will be async
201
+ const result = await driver.signMessage({
202
+ message: signingInput,
203
+ keyIdentifier: { publicKey: wallet.publicKey },
204
+ });
205
+ if (isRpcError(result) || !result.signature) {
206
+ throw new Error(isRpcError(result)
207
+ ? result.error_description
208
+ : 'signMessage failed');
209
+ }
210
+ const token = SelfIssuedTokenService.appendJwtSignature(signingInput, result.signature);
211
+ const probe = new LedgerClient({
212
+ baseUrl: new URL(network.ledgerApi.baseUrl),
213
+ logger: this.logger,
214
+ accessTokenProvider: AuthTokenProvider.fromToken(token, this.logger),
215
+ });
216
+ try {
217
+ await probe.get('/v2/authenticated-user');
218
+ }
219
+ catch (error) {
220
+ throw new Error('Self-issued token was rejected by the participant', { cause: error });
221
+ }
222
+ return token;
223
+ }
224
+ authContext() {
225
+ return toOnboardingAuthContext(this.session);
226
+ }
227
+ }
228
+ function toOnboardingAuthContext(session) {
229
+ return {
230
+ userId: session.userId,
231
+ accessToken: '',
232
+ sessionId: session.sessionId,
233
+ };
234
+ }
235
+ export async function createSelfIssuedAuthService(bootstrapStore, session, drivers, logger) {
236
+ const scopedStore = bootstrapStore.withAuthContext(toOnboardingAuthContext(session));
237
+ const network = await scopedStore.getCurrentNetwork();
238
+ if (network.auth.method !== 'self_issued') {
239
+ throw new Error('Network does not use self_issued authentication');
240
+ }
241
+ const idp = await bootstrapStore.getIdp(network.identityProviderId);
242
+ if (idp.type !== 'self_issued') {
243
+ throw new Error('Identity provider is not configured for self_issued authentication');
244
+ }
245
+ if (!network.adminAuth) {
246
+ throw new Error('No admin auth configured');
247
+ }
248
+ const adminIdp = await bootstrapStore.getIdp(resolveAuthIdentityProviderId(network.adminAuth, network.identityProviderId));
249
+ const adminTokenProvider = AuthTokenProvider.fromGatewayConfig(adminIdp, network.adminAuth, logger);
250
+ const partyAllocator = new PartyAllocationService({
251
+ synchronizerId: network.synchronizerId,
252
+ accessTokenProvider: adminTokenProvider,
253
+ httpLedgerUrl: network.ledgerApi.baseUrl,
254
+ logger,
255
+ });
256
+ const walletAllocationService = new WalletAllocationService(scopedStore, logger, partyAllocator, drivers);
257
+ const ledgerClient = new LedgerClient({
258
+ baseUrl: new URL(network.ledgerApi.baseUrl),
259
+ logger,
260
+ accessTokenProvider: adminTokenProvider,
261
+ });
262
+ return new SelfIssuedAuthService(session, scopedStore, logger, walletAllocationService, ledgerClient, drivers);
263
+ }