@canton-network/wallet-gateway-remote 1.11.3 → 1.13.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.
- package/README.md +105 -29
- package/dist/auth/jwt-auth-service.d.ts +5 -4
- package/dist/auth/jwt-auth-service.d.ts.map +1 -1
- package/dist/auth/jwt-auth-service.js +219 -78
- package/dist/config/Config.d.ts +194 -19
- package/dist/config/Config.d.ts.map +1 -1
- package/dist/config/Config.js +120 -6
- package/dist/config/ConfigUtils.d.ts +1 -1
- package/dist/config/ConfigUtils.d.ts.map +1 -1
- package/dist/config/ConfigUtils.js +46 -9
- package/dist/dapp-api/controller.d.ts +5 -7
- package/dist/dapp-api/controller.d.ts.map +1 -1
- package/dist/dapp-api/controller.js +43 -38
- package/dist/dapp-api/rpc-gen/index.d.ts.map +1 -1
- package/dist/dapp-api/rpc-gen/schemas.d.ts +3 -0
- package/dist/dapp-api/rpc-gen/schemas.d.ts.map +1 -0
- package/dist/dapp-api/rpc-gen/schemas.js +201 -0
- package/dist/dapp-api/rpc-gen/typings.d.ts +11 -4
- package/dist/dapp-api/rpc-gen/typings.d.ts.map +1 -1
- package/dist/dapp-api/server.d.ts +8 -9
- package/dist/dapp-api/server.d.ts.map +1 -1
- package/dist/dapp-api/server.js +7 -43
- package/dist/dapp-api/sse-sink.d.ts +18 -0
- package/dist/dapp-api/sse-sink.d.ts.map +1 -0
- package/dist/dapp-api/sse-sink.js +27 -0
- package/dist/env.d.ts +1 -25
- package/dist/env.d.ts.map +1 -1
- package/dist/env.js +0 -23
- package/dist/example-config.d.ts +40 -4
- package/dist/example-config.d.ts.map +1 -1
- package/dist/example-config.js +44 -8
- package/dist/index.d.ts +3 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +75 -28
- package/dist/init.d.ts +2 -2
- package/dist/init.d.ts.map +1 -1
- package/dist/init.js +30 -107
- package/dist/ledger/party-allocation-service.d.ts +3 -6
- package/dist/ledger/party-allocation-service.d.ts.map +1 -1
- package/dist/ledger/party-allocation-service.js +1 -3
- package/dist/ledger/self-issued-auth-service.d.ts +50 -0
- package/dist/ledger/self-issued-auth-service.d.ts.map +1 -0
- package/dist/ledger/self-issued-auth-service.js +264 -0
- package/dist/ledger/wallet-allocation/signing-providers/bitgo-wallet-allocator.d.ts +7 -7
- package/dist/ledger/wallet-allocation/signing-providers/bitgo-wallet-allocator.d.ts.map +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/bitgo-wallet-allocator.js +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/blockdaemon-wallet-allocator.d.ts +7 -7
- package/dist/ledger/wallet-allocation/signing-providers/blockdaemon-wallet-allocator.d.ts.map +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/blockdaemon-wallet-allocator.js +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/dfns-wallet-allocator.d.ts +7 -7
- package/dist/ledger/wallet-allocation/signing-providers/dfns-wallet-allocator.d.ts.map +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/dfns-wallet-allocator.js +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/fireblocks-wallet-allocator.d.ts +7 -7
- package/dist/ledger/wallet-allocation/signing-providers/fireblocks-wallet-allocator.d.ts.map +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/fireblocks-wallet-allocator.js +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/kernel-wallet-allocator.d.ts +7 -7
- package/dist/ledger/wallet-allocation/signing-providers/kernel-wallet-allocator.d.ts.map +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/kernel-wallet-allocator.js +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/participant-wallet-allocator.d.ts +6 -6
- package/dist/ledger/wallet-allocation/signing-providers/participant-wallet-allocator.d.ts.map +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/securosys-wallet-allocator.d.ts +7 -7
- package/dist/ledger/wallet-allocation/signing-providers/securosys-wallet-allocator.d.ts.map +1 -1
- package/dist/ledger/wallet-allocation/signing-providers/securosys-wallet-allocator.js +1 -1
- package/dist/ledger/wallet-allocation/wallet-allocation-service.d.ts +8 -8
- package/dist/ledger/wallet-allocation/wallet-allocation-service.d.ts.map +1 -1
- package/dist/ledger/wallet-allocation/wallet-allocation-service.js +2 -2
- package/dist/ledger/wallet-sync-service.d.ts +15 -9
- package/dist/ledger/wallet-sync-service.d.ts.map +1 -1
- package/dist/ledger/wallet-sync-service.js +184 -35
- package/dist/middleware/apiKeyAuth.d.ts +3 -3
- package/dist/middleware/apiKeyAuth.d.ts.map +1 -1
- package/dist/middleware/apiKeyAuth.js +6 -10
- package/dist/middleware/errorHandler.d.ts +7 -1
- package/dist/middleware/errorHandler.d.ts.map +1 -1
- package/dist/middleware/errorHandler.js +85 -1
- package/dist/middleware/jsonRpcHandler.d.ts +6 -4
- package/dist/middleware/jsonRpcHandler.d.ts.map +1 -1
- package/dist/middleware/jsonRpcHandler.js +49 -10
- package/dist/middleware/jwtAuth.d.ts +2 -2
- package/dist/middleware/jwtAuth.d.ts.map +1 -1
- package/dist/middleware/jwtAuth.js +17 -2
- package/dist/middleware/securityHeaders.d.ts.map +1 -1
- package/dist/middleware/sessionHandler.d.ts +6 -4
- package/dist/middleware/sessionHandler.d.ts.map +1 -1
- package/dist/middleware/sessionHandler.js +25 -1
- package/dist/signing/service-account-session.d.ts +3 -3
- package/dist/signing/service-account-session.d.ts.map +1 -1
- package/dist/signing/service-account-session.js +3 -3
- package/dist/signing/signing-worker.d.ts +18 -16
- package/dist/signing/signing-worker.d.ts.map +1 -1
- package/dist/signing/signing-worker.js +19 -16
- package/dist/signing-providers-registration.d.ts +6 -0
- package/dist/signing-providers-registration.d.ts.map +1 -0
- package/dist/signing-providers-registration.js +216 -0
- package/dist/user-api/controller.d.ts +14 -7
- package/dist/user-api/controller.d.ts.map +1 -1
- package/dist/user-api/controller.js +441 -154
- package/dist/user-api/rpc-gen/index.d.ts +27 -0
- package/dist/user-api/rpc-gen/index.d.ts.map +1 -1
- package/dist/user-api/rpc-gen/index.js +9 -0
- package/dist/user-api/rpc-gen/schemas.d.ts +3 -0
- package/dist/user-api/rpc-gen/schemas.d.ts.map +1 -0
- package/dist/user-api/rpc-gen/schemas.js +1067 -0
- package/dist/user-api/rpc-gen/typings.d.ts +237 -41
- package/dist/user-api/rpc-gen/typings.d.ts.map +1 -1
- package/dist/user-api/server.d.ts +7 -8
- package/dist/user-api/server.d.ts.map +1 -1
- package/dist/user-api/server.js +2 -0
- package/dist/user-api/token-network-matching.d.ts +2 -2
- package/dist/user-api/token-network-matching.d.ts.map +1 -1
- package/dist/user-api/token-network-matching.js +9 -7
- package/dist/utils.d.ts +0 -29
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +0 -57
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +2 -5
- package/dist/web/frontend/404/index.html +2 -2
- package/dist/web/frontend/activities/index.html +3 -3
- package/dist/web/frontend/api-keys/add/index.html +2 -2
- package/dist/web/frontend/api-keys/index.html +2 -2
- package/dist/web/frontend/approve/index.html +4 -3
- package/dist/web/frontend/assets/{404-Ds_FbOi_.js → 404-D6hNG1H8.js} +1 -1
- package/dist/web/frontend/assets/{activities-DSP_NZCE.js → activities-CSaNJ4Bw.js} +2 -2
- package/dist/web/frontend/assets/{addApiKey-Zv2CS3ub.js → addApiKey-IKOYP6lC.js} +2 -2
- package/dist/web/frontend/assets/addIdentityProvider-CnRS1C3U.js +28 -0
- package/dist/web/frontend/assets/{addNetwork-B620CvC-.js → addNetwork-Wq0K3t5Z.js} +4 -4
- package/dist/web/frontend/assets/addParty-B0GaqKvG.js +14 -0
- package/dist/web/frontend/assets/{apiKeys-ohQpjexi.js → apiKeys-BgJyxg5r.js} +2 -2
- package/dist/web/frontend/assets/approve-kKlT_54l.js +27 -0
- package/dist/web/frontend/assets/callback-83Lr1QFW.js +7 -0
- package/dist/web/frontend/assets/common-BkYw_tO_.js +31 -0
- package/dist/web/frontend/assets/editParty-DU9eMclk.js +15 -0
- package/dist/web/frontend/assets/{identityProviders-C26I4FyE.js → identityProviders-sWmbKlSu.js} +2 -2
- package/dist/web/frontend/assets/index-AvzB2hln.js +93 -0
- package/dist/web/frontend/assets/index-BF3EIXoM.js +2 -0
- package/dist/web/frontend/assets/index-CGK8ht7_.js +1 -0
- package/dist/web/frontend/assets/index-DRQ0oWml.js +4814 -0
- package/dist/web/frontend/assets/index-NgSpx7q_.js +3 -0
- package/dist/web/frontend/assets/login-BqK1nbQm.js +11 -0
- package/dist/web/frontend/assets/{networks-CtFnklqS.js → networks-C62lWsP4.js} +4 -4
- package/dist/web/frontend/assets/{reviewIdentityProvider-GBlomu4-.js → reviewIdentityProvider-pILqo6EV.js} +3 -3
- package/dist/web/frontend/assets/{reviewNetwork-CWEgNcCg.js → reviewNetwork-DZOWqkuG.js} +4 -4
- package/dist/web/frontend/assets/selfIssuedLogin-DarXIpvS.js +81 -0
- package/dist/web/frontend/assets/signMessage-k9b_lLxh.js +23 -0
- package/dist/web/frontend/callback/index.html +3 -2
- package/dist/web/frontend/identity-providers/add/index.html +2 -2
- package/dist/web/frontend/identity-providers/index.html +2 -2
- package/dist/web/frontend/identity-providers/review/index.html +2 -2
- package/dist/web/frontend/index.html +1 -1
- package/dist/web/frontend/login/index.html +3 -2
- package/dist/web/frontend/networks/add/index.html +2 -2
- package/dist/web/frontend/networks/index.html +2 -2
- package/dist/web/frontend/networks/review/index.html +2 -2
- package/dist/web/frontend/parties/add/index.html +5 -4
- package/dist/web/frontend/parties/edit/index.html +5 -4
- package/dist/web/frontend/parties/index.html +3 -2
- package/dist/web/frontend/self-issued-login/index.html +24 -0
- package/dist/web/frontend/sign-message/index.html +2 -2
- package/dist/web/route-inputs.js +1 -1
- package/dist/web/server.d.ts +1 -1
- package/dist/web/server.d.ts.map +1 -1
- package/dist/web/server.js +1 -1
- package/package.json +54 -50
- package/dist/auth/jwt-auth-service.test.d.ts +0 -2
- package/dist/auth/jwt-auth-service.test.d.ts.map +0 -1
- package/dist/auth/jwt-auth-service.test.js +0 -466
- package/dist/config/Config.test.d.ts +0 -2
- package/dist/config/Config.test.d.ts.map +0 -1
- package/dist/config/Config.test.js +0 -19
- package/dist/dapp-api/controller.test.d.ts +0 -2
- package/dist/dapp-api/controller.test.d.ts.map +0 -1
- package/dist/dapp-api/controller.test.js +0 -535
- package/dist/dapp-api/server.test.d.ts +0 -2
- package/dist/dapp-api/server.test.d.ts.map +0 -1
- package/dist/dapp-api/server.test.js +0 -40
- package/dist/ledger/party-allocation-service.test.d.ts +0 -2
- package/dist/ledger/party-allocation-service.test.d.ts.map +0 -1
- package/dist/ledger/party-allocation-service.test.js +0 -105
- package/dist/ledger/transaction-service.d.ts +0 -27
- package/dist/ledger/transaction-service.d.ts.map +0 -1
- package/dist/ledger/transaction-service.js +0 -297
- package/dist/ledger/transaction-service.test.d.ts +0 -2
- package/dist/ledger/transaction-service.test.d.ts.map +0 -1
- package/dist/ledger/transaction-service.test.js +0 -551
- package/dist/ledger/wallet-allocation/wallet-allocation-service.test.d.ts +0 -2
- package/dist/ledger/wallet-allocation/wallet-allocation-service.test.d.ts.map +0 -1
- package/dist/ledger/wallet-allocation/wallet-allocation-service.test.js +0 -1005
- package/dist/ledger/wallet-sync-service.test.d.ts +0 -2
- package/dist/ledger/wallet-sync-service.test.d.ts.map +0 -1
- package/dist/ledger/wallet-sync-service.test.js +0 -857
- package/dist/middleware/apiKeyAuth.test.d.ts +0 -2
- package/dist/middleware/apiKeyAuth.test.d.ts.map +0 -1
- package/dist/middleware/apiKeyAuth.test.js +0 -126
- package/dist/middleware/errorHandler.test.d.ts +0 -2
- package/dist/middleware/errorHandler.test.d.ts.map +0 -1
- package/dist/middleware/errorHandler.test.js +0 -100
- package/dist/middleware/jsonRpcHandler.test.d.ts +0 -2
- package/dist/middleware/jsonRpcHandler.test.d.ts.map +0 -1
- package/dist/middleware/jsonRpcHandler.test.js +0 -277
- package/dist/middleware/jwtAuth.test.d.ts +0 -2
- package/dist/middleware/jwtAuth.test.d.ts.map +0 -1
- package/dist/middleware/jwtAuth.test.js +0 -100
- package/dist/middleware/rateLimit.test.d.ts +0 -2
- package/dist/middleware/rateLimit.test.d.ts.map +0 -1
- package/dist/middleware/rateLimit.test.js +0 -56
- package/dist/middleware/securityHeaders.test.d.ts +0 -2
- package/dist/middleware/securityHeaders.test.d.ts.map +0 -1
- package/dist/middleware/securityHeaders.test.js +0 -18
- package/dist/middleware/sessionHandler.test.d.ts +0 -2
- package/dist/middleware/sessionHandler.test.d.ts.map +0 -1
- package/dist/middleware/sessionHandler.test.js +0 -155
- package/dist/notification/NotificationService.d.ts +0 -18
- package/dist/notification/NotificationService.d.ts.map +0 -1
- package/dist/notification/NotificationService.js +0 -26
- package/dist/notification/NotificationService.test.d.ts +0 -2
- package/dist/notification/NotificationService.test.d.ts.map +0 -1
- package/dist/notification/NotificationService.test.js +0 -110
- package/dist/signing/service-account-session.test.d.ts +0 -2
- package/dist/signing/service-account-session.test.d.ts.map +0 -1
- package/dist/signing/service-account-session.test.js +0 -89
- package/dist/signing/signing-drivers.d.ts +0 -7
- package/dist/signing/signing-drivers.d.ts.map +0 -1
- package/dist/signing/signing-drivers.js +0 -3
- package/dist/signing/signing-worker.test.d.ts +0 -2
- package/dist/signing/signing-worker.test.d.ts.map +0 -1
- package/dist/signing/signing-worker.test.js +0 -155
- package/dist/user-api/controller.test.d.ts +0 -2
- package/dist/user-api/controller.test.d.ts.map +0 -1
- package/dist/user-api/controller.test.js +0 -1100
- package/dist/user-api/server.test.d.ts +0 -2
- package/dist/user-api/server.test.d.ts.map +0 -1
- package/dist/user-api/server.test.js +0 -116
- package/dist/user-api/token-network-matching.test.d.ts +0 -2
- package/dist/user-api/token-network-matching.test.d.ts.map +0 -1
- package/dist/user-api/token-network-matching.test.js +0 -66
- package/dist/utils.test.d.ts +0 -2
- package/dist/utils.test.d.ts.map +0 -1
- package/dist/utils.test.js +0 -24
- package/dist/web/frontend/assets/addIdentityProvider-BqiC9u9A.js +0 -28
- package/dist/web/frontend/assets/addParty-CSMZt930.js +0 -13
- package/dist/web/frontend/assets/approve-D5YmfGHz.js +0 -21
- package/dist/web/frontend/assets/callback-Dk9tIdBj.js +0 -7
- package/dist/web/frontend/assets/common-BCDg7K0r.js +0 -31
- package/dist/web/frontend/assets/editParty-DX9X91dp.js +0 -14
- package/dist/web/frontend/assets/index-BCECRB_Y.js +0 -4943
- package/dist/web/frontend/assets/index-Cvcr2Fng.js +0 -2
- package/dist/web/frontend/assets/index-DrEQVBtC.js +0 -93
- package/dist/web/frontend/assets/login-dmjNaK2x.js +0 -11
- package/dist/web/frontend/assets/settings-DSh9rqaO.js +0 -37
- package/dist/web/frontend/assets/signMessage-CT2_Y1LA.js +0 -79
- package/dist/web/frontend/settings/index.html +0 -15
- package/dist/web/route-inputs.test.d.ts +0 -2
- package/dist/web/route-inputs.test.d.ts.map +0 -1
- package/dist/web/route-inputs.test.js +0 -30
package/README.md
CHANGED
|
@@ -44,50 +44,126 @@ wallet-gateway --config-schema
|
|
|
44
44
|
|
|
45
45
|
The JSON-RPC API specs from `api-specs/` are generated into strongly-typed method builders for the remote RPC server. To update the codegen, run `pnpm generate:dapp`.
|
|
46
46
|
|
|
47
|
-
##
|
|
47
|
+
## Signing providers
|
|
48
48
|
|
|
49
|
-
|
|
49
|
+
`signingProviders` configuration has two modes:
|
|
50
50
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
51
|
+
- **Legacy** - for backwards compatibility only, will be removed in the future. Omit the `signingProviders` config property. Every provider stays available
|
|
52
|
+
when its required environment variables are set. Non-secret settings also come
|
|
53
|
+
from those environment variables.
|
|
54
|
+
- **Explicit** - include `signingProviders` config property. Each listed provider is opt-in by
|
|
55
|
+
presence of its key. Non-secret settings come from the config object. Secret values stay in the environment variables,
|
|
56
|
+
Config allows altering names of those variables via `*Env` fields (each defaults to the name used in legacy config).
|
|
57
57
|
|
|
58
|
-
|
|
58
|
+
### Wallet Kernel
|
|
59
59
|
|
|
60
|
-
|
|
60
|
+
**Gateway config:**
|
|
61
61
|
|
|
62
|
-
|
|
62
|
+
- `signingProviders.walletKernel` - set it to {} to enable
|
|
63
|
+
- `signingStore` - required for this provider, the provider is unavailable when the signing store is omitted
|
|
63
64
|
|
|
64
|
-
|
|
65
|
+
**Environment variables:**
|
|
65
66
|
|
|
66
|
-
|
|
67
|
+
- None
|
|
67
68
|
|
|
68
|
-
|
|
69
|
+
### Participant
|
|
69
70
|
|
|
70
|
-
|
|
71
|
-
- `BLOCKDAEMON_API_KEY` - Your Blockdaemon API key
|
|
71
|
+
**Gateway config:**
|
|
72
72
|
|
|
73
|
-
|
|
73
|
+
- `signingProviders.participant` - set it to `{}` to enable
|
|
74
74
|
|
|
75
|
-
|
|
76
|
-
`SECUROSYS_TSB_BASE_URL` is set. Set these environment variables before starting
|
|
77
|
-
the Gateway:
|
|
75
|
+
**Environment variables:**
|
|
78
76
|
|
|
79
|
-
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
77
|
+
- None
|
|
78
|
+
|
|
79
|
+
### Dfns
|
|
80
|
+
|
|
81
|
+
Create a service account in the Dfns dashboard with permissions to create and sign with Canton wallets, then download its credentials.
|
|
82
|
+
|
|
83
|
+
**Gateway config:**
|
|
84
|
+
|
|
85
|
+
- `signingProviders.dfns` - include this object to enable
|
|
86
|
+
- `signingProviders.dfns.orgId` - required
|
|
87
|
+
- `signingProviders.dfns.credId` - required
|
|
88
|
+
- `signingProviders.dfns.baseUrl` - optional, defaults to `https://api.dfns.io`
|
|
89
|
+
- `signingProviders.dfns.privateKeyEnv` - optional name of the env var that holds the service account private key (PEM), defaults to `DFNS_PRIVATE_KEY`
|
|
90
|
+
- `signingProviders.dfns.authTokenEnv` - optional name of the env var that holds the service account auth token, defaults to `DFNS_AUTH_TOKEN`
|
|
91
|
+
|
|
92
|
+
**Environment variables:**
|
|
93
|
+
|
|
94
|
+
- The variables named by `privateKeyEnv` and `authTokenEnv` (defaults above)
|
|
95
|
+
|
|
96
|
+
### Fireblocks
|
|
97
|
+
|
|
98
|
+
Complete steps 1–3 from the instructions at https://github.com/canton-network/wallet/tree/main/core/signing-fireblocks.
|
|
99
|
+
|
|
100
|
+
**Gateway config:**
|
|
101
|
+
|
|
102
|
+
- `signingProviders.fireblocks` - include this object to enable
|
|
103
|
+
- `signingProviders.fireblocks.apiPath` - optional, defaults to `https://api.fireblocks.io/v1`
|
|
104
|
+
- `signingProviders.fireblocks.apiKeyEnv` - optional name of the env var that holds the API key, defaults to `FIREBLOCKS_API_KEY`
|
|
105
|
+
- `signingProviders.fireblocks.secretEnv` - optional name of the env var that holds the API secret, defaults to `FIREBLOCKS_SECRET`
|
|
106
|
+
|
|
107
|
+
**Environment variables:**
|
|
108
|
+
|
|
109
|
+
- The variables named by `apiKeyEnv` and `secretEnv` (defaults above)
|
|
110
|
+
|
|
111
|
+
### Blockdaemon
|
|
112
|
+
|
|
113
|
+
Create a system user in the Blockdaemon dashboard and save the API key displayed after successful creation.
|
|
114
|
+
|
|
115
|
+
**Gateway config:**
|
|
116
|
+
|
|
117
|
+
- `signingProviders.blockdaemon` - include this object to enable
|
|
118
|
+
- `signingProviders.blockdaemon.baseUrl` - optional, defaults to `http://localhost:5080/api/cwp/canton`
|
|
119
|
+
- `signingProviders.blockdaemon.caip2` - optional, defaults to `canton:testnet`
|
|
120
|
+
- `signingProviders.blockdaemon.apiKeyEnv` - optional name of the env var that holds the API key, defaults to `BLOCKDAEMON_API_KEY`
|
|
121
|
+
|
|
122
|
+
**Environment variables:**
|
|
123
|
+
|
|
124
|
+
- The variable named by `apiKeyEnv` (default above)
|
|
125
|
+
|
|
126
|
+
### Securosys
|
|
127
|
+
|
|
128
|
+
**Gateway config:**
|
|
129
|
+
|
|
130
|
+
- `signingProviders.securosys` - include this object to enable
|
|
131
|
+
- `signingProviders.securosys.baseUrl` - required
|
|
132
|
+
- `signingProviders.securosys.mtlsP12Path` - optional client PKCS#12/P12 file for mTLS
|
|
133
|
+
- `signingProviders.securosys.signatureAlgorithm` - optional TSB signature algorithm, defaults to `EDDSA`
|
|
134
|
+
- `signingProviders.securosys.keyManagementApiKeyEnv` - optional name of the env var that holds the key-management API key, defaults to `SECUROSYS_TSB_KEY_MANAGEMENT_API_KEY`
|
|
135
|
+
- `signingProviders.securosys.keyOperationApiKeyEnv` - optional name of the env var that holds the key-operation API key, defaults to `SECUROSYS_TSB_KEY_OPERATION_API_KEY`
|
|
136
|
+
- `signingProviders.securosys.bearerTokenEnv` - optional name of the env var that holds the bearer token, defaults to `SECUROSYS_TSB_BEARER_TOKEN`
|
|
137
|
+
- `signingProviders.securosys.mtlsP12PasswordEnv` - optional name of the env var that holds the PKCS#12/P12 password, defaults to `SECUROSYS_TSB_MTLS_P12_PASSWORD`
|
|
138
|
+
- `signingProviders.securosys.keyPasswordEnv` - optional name of the env var that holds the TSB key password, defaults to `SECUROSYS_TSB_KEY_PASSWORD`
|
|
139
|
+
|
|
140
|
+
**Environment variables:**
|
|
141
|
+
|
|
142
|
+
- The variables named by the `*Env` fields (defaults above)
|
|
87
143
|
|
|
88
144
|
See [`@canton-network/core-signing-securosys`](../../core/signing-securosys/README.md)
|
|
89
145
|
for key creation, public-key, and signature format details.
|
|
90
146
|
|
|
147
|
+
### BitGo
|
|
148
|
+
|
|
149
|
+
Create a long-lived access token in the BitGo dashboard and note the enterprise
|
|
150
|
+
ID used for wallet creation.
|
|
151
|
+
|
|
152
|
+
**Gateway config:**
|
|
153
|
+
|
|
154
|
+
- `signingProviders.bitgo` - include this object to enable
|
|
155
|
+
- `signingProviders.bitgo.baseUrl` - optional, defaults to `https://app.bitgo.com`
|
|
156
|
+
- `signingProviders.bitgo.enterpriseId` - optional, required for wallet creation and restart-safe transaction lookup
|
|
157
|
+
- `signingProviders.bitgo.coin` - optional, auto-detected from the API URL when omitted
|
|
158
|
+
- `signingProviders.bitgo.accessTokenEnv` - optional name of the env var that holds the access token, defaults to `BITGO_ACCESS_TOKEN`
|
|
159
|
+
|
|
160
|
+
**Environment variables:**
|
|
161
|
+
|
|
162
|
+
- The variable named by `accessTokenEnv` (default above)
|
|
163
|
+
|
|
164
|
+
See [`@canton-network/core-signing-bitgo`](../../core/signing-bitgo/README.md)
|
|
165
|
+
for credential setup and driver behavior.
|
|
166
|
+
|
|
91
167
|
## Postgres connection
|
|
92
168
|
|
|
93
169
|
To create a Postgres database you need to:
|
|
@@ -98,7 +174,7 @@ To create a Postgres database you need to:
|
|
|
98
174
|
$ docker run --network=host --name some-postgres -e POSTGRES_PASSWORD=postgres -d postgres
|
|
99
175
|
```
|
|
100
176
|
|
|
101
|
-
2. In the file
|
|
177
|
+
2. In the file `/wallet-gateway/test/config.json`, specify the connection settings for both databases - store (required) and signingStore (optional, only needed for signing provider `wallet-kernel`). The connection should look like this (it is important that `store.connection.database !== signingStore.connection.database !== 'postgres'`):
|
|
102
178
|
|
|
103
179
|
```json
|
|
104
180
|
{
|
|
@@ -1,9 +1,10 @@
|
|
|
1
|
-
import { AuthService } from '@canton-network/core-wallet-auth';
|
|
2
|
-
import { Store } from '@canton-network/core-wallet-store';
|
|
3
|
-
import { Logger } from 'pino';
|
|
1
|
+
import { type AuthService } from '@canton-network/core-wallet-auth';
|
|
2
|
+
import type { Store } from '@canton-network/core-wallet-store';
|
|
3
|
+
import type { Logger } from 'pino';
|
|
4
4
|
/**
|
|
5
5
|
* Creates an AuthService that verifies JWT tokens, using a remote JWK set for
|
|
6
|
-
* oauth identity providers
|
|
6
|
+
* oauth identity providers, the network's secret for self_signed ones, and the
|
|
7
|
+
* party's wallet public key for self-issued ones (iss === sub).
|
|
7
8
|
* @param store - The Store instance to access network configurations.
|
|
8
9
|
* @param logger - Logger instance for logging debug and warning messages.
|
|
9
10
|
* @returns An AuthService implementation that verifies JWT tokens.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"jwt-auth-service.d.ts","sourceRoot":"","sources":["../../src/auth/jwt-auth-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,WAAW,
|
|
1
|
+
{"version":3,"file":"jwt-auth-service.d.ts","sourceRoot":"","sources":["../../src/auth/jwt-auth-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,KAAK,WAAW,EAKnB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AAa9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAkNlC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,UAAW,KAAK,UAAU,MAAM,KAAG,WAkL7D,CAAA"}
|
|
@@ -1,7 +1,7 @@
|
|
|
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 {
|
|
4
|
-
import { createRemoteJWKSet, decodeJwt, decodeProtectedHeader, jwtVerify, } from 'jose';
|
|
3
|
+
import { createOidcClient, IdpUnavailableError, } from '@canton-network/core-wallet-auth';
|
|
4
|
+
import { createRemoteJWKSet, customFetch, decodeJwt, errors, decodeProtectedHeader, importJWK, jwtVerify, base64url, } from 'jose';
|
|
5
5
|
function getEmail(value) {
|
|
6
6
|
if (typeof value !== 'string' || value.length === 0) {
|
|
7
7
|
return undefined;
|
|
@@ -44,93 +44,234 @@ async function verifySelfSignedToken(jwt, idp, store, logger) {
|
|
|
44
44
|
...(email ? { email } : {}),
|
|
45
45
|
};
|
|
46
46
|
}
|
|
47
|
+
function getSelfIssuedUserId(payload) {
|
|
48
|
+
const daml = payload['daml.com'];
|
|
49
|
+
if (daml === null || typeof daml !== 'object' || Array.isArray(daml)) {
|
|
50
|
+
return undefined;
|
|
51
|
+
}
|
|
52
|
+
const usr = daml.usr;
|
|
53
|
+
if (typeof usr !== 'string' || usr.length === 0) {
|
|
54
|
+
return undefined;
|
|
55
|
+
}
|
|
56
|
+
return usr;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Fetches the JWKS for `createRemoteJWKSet`. jose reports a failed JWKS
|
|
60
|
+
* request as a generic error, indistinguishable from a bad token, so fail with
|
|
61
|
+
* IdpUnavailableError instead.
|
|
62
|
+
*/
|
|
63
|
+
async function fetchJwks(url, options) {
|
|
64
|
+
let response;
|
|
65
|
+
try {
|
|
66
|
+
response = await fetch(url, options);
|
|
67
|
+
}
|
|
68
|
+
catch (error) {
|
|
69
|
+
throw new IdpUnavailableError(`Failed to fetch JWKS: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
|
|
70
|
+
}
|
|
71
|
+
// Exactly 200, not any 2xx: jose's own JWKS fetch requires it (and OIDC
|
|
72
|
+
// Discovery 4.2 does for the discovery document). Anything else would
|
|
73
|
+
// surface from jose as a generic error and be mistaken for a bad token.
|
|
74
|
+
if (response.status !== 200) {
|
|
75
|
+
throw new IdpUnavailableError(`Failed to fetch JWKS: ${response.status} ${response.statusText}`);
|
|
76
|
+
}
|
|
77
|
+
let jwks;
|
|
78
|
+
try {
|
|
79
|
+
jwks = await response.json();
|
|
80
|
+
}
|
|
81
|
+
catch (error) {
|
|
82
|
+
throw new IdpUnavailableError('JWKS response is not valid JSON', {
|
|
83
|
+
cause: error,
|
|
84
|
+
});
|
|
85
|
+
}
|
|
86
|
+
// The original headers (content-length, content-encoding) don't describe
|
|
87
|
+
// the re-serialized body
|
|
88
|
+
return Response.json(jwks);
|
|
89
|
+
}
|
|
90
|
+
function normalizeAudienceClaim(value) {
|
|
91
|
+
if (typeof value === 'string') {
|
|
92
|
+
return [value];
|
|
93
|
+
}
|
|
94
|
+
if (Array.isArray(value)) {
|
|
95
|
+
return value;
|
|
96
|
+
}
|
|
97
|
+
return [];
|
|
98
|
+
}
|
|
99
|
+
// wallet.publicKey is 32 raw Ed25519 bytes as standard base64. jwtVerify
|
|
100
|
+
// wants a JWK: OKP = octet key pair, crv names Ed25519, x is the same
|
|
101
|
+
// point in base64url (RFC 8037).
|
|
102
|
+
async function ed25519KeyFromWalletPublicKey(publicKey) {
|
|
103
|
+
const raw = Buffer.from(publicKey, 'base64');
|
|
104
|
+
if (raw.length !== 32) {
|
|
105
|
+
throw new Error(`Wallet public key must be 32 raw bytes, got ${raw.length}`);
|
|
106
|
+
}
|
|
107
|
+
return importJWK({
|
|
108
|
+
kty: 'OKP',
|
|
109
|
+
crv: 'Ed25519',
|
|
110
|
+
x: base64url.encode(raw),
|
|
111
|
+
}, 'EdDSA');
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Verifies a self-issued token (iss === sub) against the party's wallet
|
|
115
|
+
* public key. The wallet is found via daml.com.usr, sub, and aud
|
|
116
|
+
* (exactly one self_issued network).
|
|
117
|
+
*/
|
|
118
|
+
async function verifySelfIssuedToken(jwt, payload, store, logger) {
|
|
119
|
+
const partyId = payload.sub;
|
|
120
|
+
const userId = getSelfIssuedUserId(payload);
|
|
121
|
+
if (!partyId || !userId) {
|
|
122
|
+
logger.warn('Self-issued JWT is missing sub or daml.com.usr');
|
|
123
|
+
return undefined;
|
|
124
|
+
}
|
|
125
|
+
const wallet = await store.getWalletByJwt(userId, partyId, normalizeAudienceClaim(payload.aud));
|
|
126
|
+
if (!wallet) {
|
|
127
|
+
logger.warn({ userId, partyId }, 'No wallet found for self-issued token');
|
|
128
|
+
return undefined;
|
|
129
|
+
}
|
|
130
|
+
if (!wallet.isAuthParty) {
|
|
131
|
+
logger.warn({ userId, partyId }, 'Wallet is not an auth party for self-issued tokens');
|
|
132
|
+
return undefined;
|
|
133
|
+
}
|
|
134
|
+
const jwk = await ed25519KeyFromWalletPublicKey(wallet.publicKey);
|
|
135
|
+
await jwtVerify(jwt, jwk, {
|
|
136
|
+
algorithms: ['EdDSA'],
|
|
137
|
+
requiredClaims: ['exp'],
|
|
138
|
+
});
|
|
139
|
+
const email = getEmail(payload.email);
|
|
140
|
+
return {
|
|
141
|
+
userId: wallet.userId,
|
|
142
|
+
accessToken: jwt,
|
|
143
|
+
...(email ? { email } : {}),
|
|
144
|
+
};
|
|
145
|
+
}
|
|
47
146
|
/**
|
|
48
147
|
* Creates an AuthService that verifies JWT tokens, using a remote JWK set for
|
|
49
|
-
* oauth identity providers
|
|
148
|
+
* oauth identity providers, the network's secret for self_signed ones, and the
|
|
149
|
+
* party's wallet public key for self-issued ones (iss === sub).
|
|
50
150
|
* @param store - The Store instance to access network configurations.
|
|
51
151
|
* @param logger - Logger instance for logging debug and warning messages.
|
|
52
152
|
* @returns An AuthService implementation that verifies JWT tokens.
|
|
53
153
|
*/
|
|
54
|
-
export const jwtAuthService = (store, logger) =>
|
|
55
|
-
|
|
56
|
-
|
|
154
|
+
export const jwtAuthService = (store, logger) => {
|
|
155
|
+
// Reused across verifications so the IDP isn't contacted on every request
|
|
156
|
+
const oidc = createOidcClient();
|
|
157
|
+
// One per jwks_uri of the configured IDPs. jose caches the keys itself,
|
|
158
|
+
// it refetches them after its cacheMaxAge and early for an unknown kid
|
|
159
|
+
const remoteJwks = new Map();
|
|
160
|
+
function getJwks(jwksUri) {
|
|
161
|
+
let jwks = remoteJwks.get(jwksUri);
|
|
162
|
+
if (!jwks) {
|
|
163
|
+
const remote = createRemoteJWKSet(new URL(jwksUri), {
|
|
164
|
+
[customFetch]: fetchJwks,
|
|
165
|
+
});
|
|
166
|
+
jwks = async (protectedHeader, token) => {
|
|
167
|
+
try {
|
|
168
|
+
return await remote(protectedHeader, token);
|
|
169
|
+
}
|
|
170
|
+
catch (error) {
|
|
171
|
+
// Thrown by jose when a key of the fetched JWKS can't be used,
|
|
172
|
+
// drop invalid jwks from cache and keep session alive
|
|
173
|
+
if (error instanceof errors.JWKSInvalid) {
|
|
174
|
+
remoteJwks.delete(jwksUri);
|
|
175
|
+
throw new IdpUnavailableError(`JWKS response is not valid: ${error.message}`, { cause: error });
|
|
176
|
+
}
|
|
177
|
+
throw error;
|
|
178
|
+
}
|
|
179
|
+
};
|
|
180
|
+
remoteJwks.set(jwksUri, jwks);
|
|
181
|
+
}
|
|
182
|
+
return jwks;
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* Resolves the email of an already verified user from the userinfo
|
|
186
|
+
* endpoint. Failures are logged and resolve to undefined, the email is
|
|
187
|
+
* optional.
|
|
188
|
+
*/
|
|
189
|
+
async function resolveUserEmail(config, authContext) {
|
|
190
|
+
if (!config.userinfo_endpoint) {
|
|
57
191
|
return undefined;
|
|
58
192
|
}
|
|
59
|
-
const jwt = accessToken.split(' ')[1];
|
|
60
|
-
logger.debug({ jwt }, 'Verifying JWT token');
|
|
61
193
|
try {
|
|
62
|
-
const
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
}
|
|
74
|
-
if (!decoded.scope && !decoded.scp) {
|
|
75
|
-
logger.warn('JWT does not contain a scope claim');
|
|
76
|
-
return undefined;
|
|
77
|
-
}
|
|
78
|
-
if (idp.type == 'self_signed') {
|
|
79
|
-
return await verifySelfSignedToken(jwt, idp, store, logger);
|
|
80
|
-
}
|
|
81
|
-
logger.debug({ idp }, 'Using IDP');
|
|
82
|
-
const response = await fetch(idp.configUrl);
|
|
83
|
-
const config = await response.json();
|
|
84
|
-
const jwks = createRemoteJWKSet(new URL(config.jwks_uri));
|
|
85
|
-
const { payload } = await jwtVerify(jwt, jwks, {
|
|
86
|
-
algorithms: ['RS256'],
|
|
87
|
-
});
|
|
88
|
-
if (!payload.sub) {
|
|
89
|
-
return undefined;
|
|
90
|
-
}
|
|
91
|
-
const networks = await store.listNetworks();
|
|
92
|
-
const networksForIdp = networks.filter((n) => n.identityProviderId === idp.id);
|
|
93
|
-
const expectedAudiences = networksForIdp
|
|
94
|
-
.map((n) => n.auth.audience)
|
|
95
|
-
.filter((aud) => aud !== undefined && aud !== '');
|
|
96
|
-
if (expectedAudiences.length === 0) {
|
|
97
|
-
logger.warn(`No networks configured for IDP ${idp.id}, cannot validate audience`);
|
|
194
|
+
const userInfo = await oidc.fetchUserInfo(config.userinfo_endpoint, authContext.accessToken, authContext.userId);
|
|
195
|
+
return getEmail(userInfo.email);
|
|
196
|
+
}
|
|
197
|
+
catch (error) {
|
|
198
|
+
logger.warn({ err: error }, 'Failed to resolve user email from OIDC userinfo');
|
|
199
|
+
return undefined;
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
return {
|
|
203
|
+
verifyToken: async (accessToken) => {
|
|
204
|
+
if (!accessToken || !accessToken.startsWith('Bearer ')) {
|
|
98
205
|
return undefined;
|
|
99
206
|
}
|
|
100
|
-
const
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
207
|
+
const jwt = accessToken.split(' ')[1];
|
|
208
|
+
logger.debug({ jwt }, 'Verifying JWT token');
|
|
209
|
+
try {
|
|
210
|
+
const decoded = decodeJwt(jwt);
|
|
211
|
+
const iss = decoded.iss;
|
|
212
|
+
if (!iss) {
|
|
213
|
+
logger.warn('JWT does not contain an issuer');
|
|
214
|
+
return undefined;
|
|
215
|
+
}
|
|
216
|
+
if (iss === decoded.sub) {
|
|
217
|
+
return await verifySelfIssuedToken(jwt, decoded, store, logger);
|
|
218
|
+
}
|
|
219
|
+
const idps = await store.listIdps();
|
|
220
|
+
const idp = idps.find((i) => i.type !== 'self_issued' && i.issuer === iss);
|
|
221
|
+
if (!idp) {
|
|
222
|
+
logger.warn(`No identity provider found for issuer: ${iss}`);
|
|
223
|
+
return undefined;
|
|
224
|
+
}
|
|
225
|
+
if (!decoded.scope && !decoded.scp) {
|
|
226
|
+
logger.warn('JWT does not contain a scope claim');
|
|
227
|
+
return undefined;
|
|
228
|
+
}
|
|
229
|
+
if (idp.type == 'self_signed') {
|
|
230
|
+
return await verifySelfSignedToken(jwt, idp, store, logger);
|
|
231
|
+
}
|
|
232
|
+
logger.debug({ idp }, 'Using IDP');
|
|
233
|
+
const config = await oidc.fetchDiscovery(idp.configUrl, idp.issuer);
|
|
234
|
+
const networks = await store.listNetworks();
|
|
235
|
+
const networksForIdp = networks.filter((n) => n.identityProviderId === idp.id);
|
|
236
|
+
const expectedAudiences = networksForIdp
|
|
237
|
+
.map((n) => n.auth.audience)
|
|
238
|
+
.filter((aud) => aud !== undefined && aud !== '');
|
|
239
|
+
if (expectedAudiences.length === 0) {
|
|
240
|
+
logger.warn(`No networks configured for IDP ${idp.id}, cannot validate audience`);
|
|
241
|
+
return undefined;
|
|
242
|
+
}
|
|
243
|
+
const jwks = getJwks(config.jwks_uri);
|
|
244
|
+
const { payload } = await jwtVerify(jwt, jwks, {
|
|
245
|
+
algorithms: ['RS256'],
|
|
246
|
+
issuer: idp.issuer,
|
|
247
|
+
audience: expectedAudiences,
|
|
248
|
+
});
|
|
249
|
+
if (!payload.sub) {
|
|
250
|
+
return undefined;
|
|
251
|
+
}
|
|
252
|
+
logger.debug({
|
|
253
|
+
userId: payload.sub,
|
|
254
|
+
accessToken: jwt,
|
|
255
|
+
email: getEmail(decoded.email),
|
|
256
|
+
}, 'JWT verified');
|
|
257
|
+
const authContext = {
|
|
258
|
+
userId: payload.sub,
|
|
259
|
+
accessToken: jwt,
|
|
260
|
+
};
|
|
261
|
+
const email = getEmail(decoded.email) ??
|
|
262
|
+
(await resolveUserEmail(config, authContext));
|
|
263
|
+
return email ? { ...authContext, email } : authContext;
|
|
104
264
|
}
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
}, 'JWT audience does not match any configured network');
|
|
265
|
+
catch (error) {
|
|
266
|
+
if (error instanceof IdpUnavailableError) {
|
|
267
|
+
logger.warn(error, `Failed to verify token: ${error.message}`);
|
|
268
|
+
throw error;
|
|
269
|
+
}
|
|
270
|
+
if (error instanceof Error) {
|
|
271
|
+
logger.warn(error, `Failed to verify token: ${error.message}`);
|
|
272
|
+
}
|
|
114
273
|
return undefined;
|
|
115
274
|
}
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
email: getEmail(decoded.email),
|
|
120
|
-
}, 'JWT verified');
|
|
121
|
-
const authContext = {
|
|
122
|
-
userId: payload.sub,
|
|
123
|
-
accessToken: jwt,
|
|
124
|
-
};
|
|
125
|
-
const email = getEmail(decoded.email) ??
|
|
126
|
-
(await resolveUserEmail(authContext, idp, logger));
|
|
127
|
-
return email ? { ...authContext, email } : authContext;
|
|
128
|
-
}
|
|
129
|
-
catch (error) {
|
|
130
|
-
if (error instanceof Error) {
|
|
131
|
-
logger.warn(error, `Failed to verify token: ${error.message}`);
|
|
132
|
-
}
|
|
133
|
-
return undefined;
|
|
134
|
-
}
|
|
135
|
-
},
|
|
136
|
-
});
|
|
275
|
+
},
|
|
276
|
+
};
|
|
277
|
+
};
|