@canton-network/core-signing-dfns 0.2.2 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/dfns.d.ts +16 -13
- package/dist/dfns.d.ts.map +1 -1
- package/dist/index.cjs +58 -24
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +58 -24
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/dist/dfns.d.ts
CHANGED
|
@@ -40,6 +40,7 @@ export declare class DfnsHandler {
|
|
|
40
40
|
private client;
|
|
41
41
|
private orgId;
|
|
42
42
|
private baseUrl;
|
|
43
|
+
private signatureKey;
|
|
43
44
|
constructor(orgId: string, baseUrl: string, credentials: DfnsCredentials);
|
|
44
45
|
private createClient;
|
|
45
46
|
/**
|
|
@@ -58,23 +59,25 @@ export declare class DfnsHandler {
|
|
|
58
59
|
*/
|
|
59
60
|
findKeyByPublicKey(publicKeyBase64: string): Promise<DfnsKey | undefined>;
|
|
60
61
|
/**
|
|
61
|
-
*
|
|
62
|
-
*
|
|
63
|
-
*
|
|
62
|
+
* Sign a Canton hash (raw or multihash-framed) by handing the bytes to
|
|
63
|
+
* Dfns's `Message` kind, which signs the supplied hex with raw ed25519 —
|
|
64
|
+
* the same shape Fireblocks's `RAW` operation produces.
|
|
64
65
|
*
|
|
65
|
-
*
|
|
66
|
-
*
|
|
67
|
-
*
|
|
68
|
-
*
|
|
69
|
-
*
|
|
70
|
-
*
|
|
71
|
-
* @param hashBase64 32-byte hash, base64-encoded (Canton TxHash format).
|
|
66
|
+
* `kind: 'Hash'` would be the natural fit but its regex caps at 32 bytes,
|
|
67
|
+
* forcing us to strip the multihash prefix; Canton then rejects the
|
|
68
|
+
* resulting signature because it verifies over the full 34-byte
|
|
69
|
+
* multihash, not the digest. Every Canton-tagged kind (Hash/Message/
|
|
70
|
+
* Transaction + `blockchainKind: 'Canton'`) is server-rejected, so we
|
|
71
|
+
* use plain `Message` (no `blockchainKind`) and pass the raw bytes.
|
|
72
72
|
*/
|
|
73
|
-
signHash(keyId: string, hashBase64: string): Promise<DfnsSignature>;
|
|
73
|
+
signHash(keyId: string, hashBase64: string, externalId?: string): Promise<DfnsSignature>;
|
|
74
|
+
private submitSignatureRequest;
|
|
74
75
|
getSignature(keyId: string, signatureId: string): Promise<DfnsSignature | undefined>;
|
|
75
76
|
/**
|
|
76
|
-
* Locate a signature
|
|
77
|
-
*
|
|
77
|
+
* Locate a signature by id. Prefers the cached key from the originating
|
|
78
|
+
* sign call — `listKeys` is eventually-consistent, so iterating right
|
|
79
|
+
* after creating a key would miss the signature. Falls back to iteration
|
|
80
|
+
* when the cache misses (e.g. across a gateway restart).
|
|
78
81
|
*/
|
|
79
82
|
findSignature(signatureId: string): Promise<DfnsSignature | undefined>;
|
|
80
83
|
listSignatures(keyId: string): AsyncGenerator<DfnsSignature>;
|
package/dist/dfns.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dfns.d.ts","sourceRoot":"","sources":["../src/dfns.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAOhE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,OAAO;IACpB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC1B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAA;IACV,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,aAAa,CAAA;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;
|
|
1
|
+
{"version":3,"file":"dfns.d.ts","sourceRoot":"","sources":["../src/dfns.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAOhE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,OAAO;IACpB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC1B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAA;IACV,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,aAAa,CAAA;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAkBD,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAQ;IAKvB,OAAO,CAAC,YAAY,CAA4B;gBAEpC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe;IAMxE,OAAO,CAAC,YAAY;IAcpB;;;;OAIG;IACU,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBxC,WAAW,IAAI,cAAc,CAAC,OAAO,CAAC;IA4BvC,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAa9B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAoBhE;;;;OAIG;IACU,kBAAkB,CAC3B,eAAe,EAAE,MAAM,GACxB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAS/B;;;;;;;;;;;OAWG;IACU,QAAQ,CACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,aAAa,CAAC;YAUX,sBAAsB;IAgCvB,YAAY,CACrB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAkBrC;;;;;OAKG;IACU,aAAa,CACtB,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAcvB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,aAAa,CAAC;IAwB1E,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,SAAS;CAiBpB"}
|
package/dist/index.cjs
CHANGED
|
@@ -18,8 +18,11 @@ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { en
|
|
|
18
18
|
var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
|
|
19
19
|
var logger = pino.pino({ name: "dfns-handler", level: "debug" });
|
|
20
20
|
var DFNS_LIST_PAGE_SIZE = 50;
|
|
21
|
+
function stripHexPrefix(hex) {
|
|
22
|
+
return hex.startsWith("0x") ? hex.slice(2) : hex;
|
|
23
|
+
}
|
|
21
24
|
function hexToBase64(hex) {
|
|
22
|
-
return Buffer.from(hex, "hex").toString("base64");
|
|
25
|
+
return Buffer.from(stripHexPrefix(hex), "hex").toString("base64");
|
|
23
26
|
}
|
|
24
27
|
function base64ToHex(base64) {
|
|
25
28
|
return Buffer.from(base64, "base64").toString("hex");
|
|
@@ -32,6 +35,11 @@ var DfnsHandler = class {
|
|
|
32
35
|
__publicField(this, "client");
|
|
33
36
|
__publicField(this, "orgId");
|
|
34
37
|
__publicField(this, "baseUrl");
|
|
38
|
+
// Tracks the key that produced each signature so getSignature can look it
|
|
39
|
+
// up directly. `listKeys` (used by `iterateKeys`) is eventually-consistent
|
|
40
|
+
// — a key created moments ago may not yet appear in the list, so iterating
|
|
41
|
+
// would 404 even though the signature exists under the just-used key.
|
|
42
|
+
__publicField(this, "signatureKey", /* @__PURE__ */ new Map());
|
|
35
43
|
this.orgId = orgId;
|
|
36
44
|
this.baseUrl = baseUrl;
|
|
37
45
|
this.client = this.createClient(credentials);
|
|
@@ -136,37 +144,51 @@ var DfnsHandler = class {
|
|
|
136
144
|
return void 0;
|
|
137
145
|
}
|
|
138
146
|
/**
|
|
139
|
-
*
|
|
140
|
-
*
|
|
141
|
-
*
|
|
142
|
-
*
|
|
143
|
-
* The hash is reused as the Dfns idempotency key — re-signing the same
|
|
144
|
-
* hash returns the existing signature rather than producing a duplicate,
|
|
145
|
-
* which is safe because Canton's command deduplication handles repeats
|
|
146
|
-
* at the ledger level.
|
|
147
|
+
* Sign a Canton hash (raw or multihash-framed) by handing the bytes to
|
|
148
|
+
* Dfns's `Message` kind, which signs the supplied hex with raw ed25519 —
|
|
149
|
+
* the same shape Fireblocks's `RAW` operation produces.
|
|
147
150
|
*
|
|
148
|
-
*
|
|
149
|
-
*
|
|
151
|
+
* `kind: 'Hash'` would be the natural fit but its regex caps at 32 bytes,
|
|
152
|
+
* forcing us to strip the multihash prefix; Canton then rejects the
|
|
153
|
+
* resulting signature because it verifies over the full 34-byte
|
|
154
|
+
* multihash, not the digest. Every Canton-tagged kind (Hash/Message/
|
|
155
|
+
* Transaction + `blockchainKind: 'Canton'`) is server-rejected, so we
|
|
156
|
+
* use plain `Message` (no `blockchainKind`) and pass the raw bytes.
|
|
150
157
|
*/
|
|
151
|
-
async signHash(keyId, hashBase64) {
|
|
158
|
+
async signHash(keyId, hashBase64, externalId) {
|
|
159
|
+
const messageHex = base64ToHex(hashBase64);
|
|
160
|
+
const body = {
|
|
161
|
+
kind: "Message",
|
|
162
|
+
message: messageHex,
|
|
163
|
+
...externalId ? { externalId } : {}
|
|
164
|
+
};
|
|
165
|
+
return this.submitSignatureRequest(keyId, body);
|
|
166
|
+
}
|
|
167
|
+
async submitSignatureRequest(keyId, body) {
|
|
152
168
|
try {
|
|
153
169
|
const result = await this.client.keys.generateSignature({
|
|
154
170
|
keyId,
|
|
155
|
-
body
|
|
156
|
-
kind: "Hash",
|
|
157
|
-
hash: base64ToHex(hashBase64),
|
|
158
|
-
blockchainKind: "Canton",
|
|
159
|
-
externalId: base64ToHex(hashBase64)
|
|
160
|
-
}
|
|
171
|
+
body
|
|
161
172
|
});
|
|
173
|
+
const mapped = this.mapStatus(result.status);
|
|
174
|
+
if (mapped === "failed" || mapped === "rejected") {
|
|
175
|
+
logger.error(
|
|
176
|
+
{ keyId, result },
|
|
177
|
+
`Dfns signing returned ${result.status}`
|
|
178
|
+
);
|
|
179
|
+
}
|
|
180
|
+
this.signatureKey.set(result.id, keyId);
|
|
162
181
|
return {
|
|
163
182
|
id: result.id,
|
|
164
183
|
keyId,
|
|
165
|
-
status:
|
|
184
|
+
status: mapped,
|
|
166
185
|
signature: this.extractSignature(result.signature)
|
|
167
186
|
};
|
|
168
187
|
} catch (error) {
|
|
169
|
-
logger.error(
|
|
188
|
+
logger.error(
|
|
189
|
+
{ keyId, err: error },
|
|
190
|
+
"Error generating Dfns signature"
|
|
191
|
+
);
|
|
170
192
|
throw error;
|
|
171
193
|
}
|
|
172
194
|
}
|
|
@@ -188,11 +210,19 @@ var DfnsHandler = class {
|
|
|
188
210
|
}
|
|
189
211
|
}
|
|
190
212
|
/**
|
|
191
|
-
* Locate a signature
|
|
192
|
-
*
|
|
213
|
+
* Locate a signature by id. Prefers the cached key from the originating
|
|
214
|
+
* sign call — `listKeys` is eventually-consistent, so iterating right
|
|
215
|
+
* after creating a key would miss the signature. Falls back to iteration
|
|
216
|
+
* when the cache misses (e.g. across a gateway restart).
|
|
193
217
|
*/
|
|
194
218
|
async findSignature(signatureId) {
|
|
219
|
+
const cachedKeyId = this.signatureKey.get(signatureId);
|
|
220
|
+
if (cachedKeyId) {
|
|
221
|
+
const sig = await this.getSignature(cachedKeyId, signatureId);
|
|
222
|
+
if (sig) return sig;
|
|
223
|
+
}
|
|
195
224
|
for await (const key of this.iterateKeys()) {
|
|
225
|
+
if (key.id === cachedKeyId) continue;
|
|
196
226
|
const sig = await this.getSignature(key.id, signatureId);
|
|
197
227
|
if (sig) return sig;
|
|
198
228
|
}
|
|
@@ -221,7 +251,7 @@ var DfnsHandler = class {
|
|
|
221
251
|
}
|
|
222
252
|
extractSignature(signature) {
|
|
223
253
|
if (!signature) return void 0;
|
|
224
|
-
const hex = signature.encoded
|
|
254
|
+
const hex = signature.encoded ? stripHexPrefix(signature.encoded) : `${stripHexPrefix(signature.r)}${stripHexPrefix(signature.s)}`;
|
|
225
255
|
return hexToBase64(hex);
|
|
226
256
|
}
|
|
227
257
|
mapStatus(dfnsStatus) {
|
|
@@ -284,7 +314,11 @@ var DfnsSigningDriver = class {
|
|
|
284
314
|
error_description: "txHash is required to sign with Dfns."
|
|
285
315
|
};
|
|
286
316
|
}
|
|
287
|
-
const sig = await this.dfns.signHash(
|
|
317
|
+
const sig = await this.dfns.signHash(
|
|
318
|
+
keyId,
|
|
319
|
+
params.txHash,
|
|
320
|
+
params.internalTxId
|
|
321
|
+
);
|
|
288
322
|
return toTransaction(sig, params.keyIdentifier.publicKey);
|
|
289
323
|
} catch (error) {
|
|
290
324
|
return {
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/dfns.ts","../src/index.ts"],"names":["pino","AsymmetricKeySigner","DfnsApiClient","z","PartyMode","SigningProvider","buildController","_"],"mappings":"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","file":"index.cjs","sourcesContent":["// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { DfnsApiClient } from '@dfns/sdk'\nimport { AsymmetricKeySigner } from '@dfns/sdk-keysigner'\nimport { SigningStatus } from '@canton-network/core-signing-lib'\nimport { pino } from 'pino'\n\nconst logger = pino({ name: 'dfns-handler', level: 'debug' })\n\nconst DFNS_LIST_PAGE_SIZE = 50\n\n/**\n * Credentials for a Dfns service account. Dfns uses two-layer auth: a\n * long-lived bearer token plus per-request signing with a private key.\n */\nexport interface DfnsCredentials {\n /** ID of the Dfns credential (key) registered against the service account. */\n credId: string\n /**\n * PEM-encoded private key paired with `credId`. Used to sign every\n * sensitive Dfns API request as a U2F-style second factor. Configured\n * once per deployment; not derived from `authToken`.\n */\n privateKey: string\n /**\n * Long-lived service account bearer JWT issued by the Dfns dashboard.\n * Does not auto-expire and is not regenerated from `privateKey`/`credId`.\n * Rotate by issuing a new token in the Dfns dashboard.\n */\n authToken: string\n}\n\nexport interface DfnsKey {\n /** Dfns key id (e.g. `key-...`). */\n id: string\n /** Human-readable name configured on the Dfns key. */\n name: string\n /** ed25519 public key, base64-encoded (Canton format). */\n publicKey: string\n}\n\nexport interface DfnsSignature {\n /** Dfns signature id (used as the txId returned to the gateway). */\n id: string\n /** Dfns key id the signature was produced with. */\n keyId: string\n status: SigningStatus\n /** ed25519 signature, base64-encoded (Canton SIGNATURE_FORMAT_CONCAT). */\n signature?: string\n}\n\nfunction hexToBase64(hex: string): string {\n return Buffer.from(hex, 'hex').toString('base64')\n}\n\nfunction base64ToHex(base64: string): string {\n return Buffer.from(base64, 'base64').toString('hex')\n}\n\nfunction isCantonKey(scheme: string, curve: string): boolean {\n return scheme === 'EdDSA' && curve === 'ed25519'\n}\n\nexport class DfnsHandler {\n private client: DfnsApiClient\n private orgId: string\n private baseUrl: string\n\n constructor(orgId: string, baseUrl: string, credentials: DfnsCredentials) {\n this.orgId = orgId\n this.baseUrl = baseUrl\n this.client = this.createClient(credentials)\n }\n\n private createClient(credentials: DfnsCredentials): DfnsApiClient {\n const signer = new AsymmetricKeySigner({\n credId: credentials.credId,\n privateKey: credentials.privateKey,\n })\n\n return new DfnsApiClient({\n orgId: this.orgId,\n authToken: credentials.authToken,\n baseUrl: this.baseUrl,\n signer,\n })\n }\n\n /**\n * Create a raw ed25519 key in Dfns suitable for signing Canton topology\n * and ledger transactions. The key is not bound to a network — chain\n * activation happens on the gateway against its configured validator.\n */\n public async createKey(name: string): Promise<DfnsKey> {\n try {\n const key = await this.client.keys.createKey({\n body: {\n scheme: 'EdDSA',\n curve: 'ed25519',\n name,\n },\n })\n return {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n } catch (error) {\n logger.error(error, 'Error creating Dfns key')\n throw error\n }\n }\n\n public async *iterateKeys(): AsyncGenerator<DfnsKey> {\n let paginationToken: string | undefined\n do {\n const response = await this.client.keys.listKeys({\n query: {\n limit: DFNS_LIST_PAGE_SIZE,\n ...(paginationToken ? { paginationToken } : {}),\n },\n })\n\n for (const key of response.items) {\n if (\n key.status !== 'Active' ||\n !isCantonKey(key.scheme, key.curve)\n ) {\n continue\n }\n yield {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n }\n\n paginationToken = response.nextPageToken\n } while (paginationToken)\n }\n\n public async listKeys(): Promise<DfnsKey[]> {\n const keys: DfnsKey[] = []\n try {\n for await (const key of this.iterateKeys()) {\n keys.push(key)\n }\n } catch (error) {\n logger.error(error, 'Error listing Dfns keys')\n throw error\n }\n return keys\n }\n\n public async getKey(keyId: string): Promise<DfnsKey | undefined> {\n try {\n const key = await this.client.keys.getKey({ keyId })\n if (\n key.status !== 'Active' ||\n !isCantonKey(key.scheme, key.curve)\n ) {\n return undefined\n }\n return {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n } catch (error) {\n logger.debug(error, `Key ${keyId} not found`)\n return undefined\n }\n }\n\n /**\n * Resolve a key by base64 ed25519 public key. Iterates Dfns keys —\n * acceptable for first iteration since most deployments hold a single\n * Canton key per credential.\n */\n public async findKeyByPublicKey(\n publicKeyBase64: string\n ): Promise<DfnsKey | undefined> {\n for await (const key of this.iterateKeys()) {\n if (key.publicKey === publicKeyBase64) {\n return key\n }\n }\n return undefined\n }\n\n /**\n * Submit a hash signing request to Dfns. Returns immediately with the\n * signature id and current status; signature bytes are fetched via\n * {@link getSignature} once the request reaches `signed` status.\n *\n * The hash is reused as the Dfns idempotency key — re-signing the same\n * hash returns the existing signature rather than producing a duplicate,\n * which is safe because Canton's command deduplication handles repeats\n * at the ledger level.\n *\n * @param keyId Dfns key id resolved from the gateway's key identifier.\n * @param hashBase64 32-byte hash, base64-encoded (Canton TxHash format).\n */\n public async signHash(\n keyId: string,\n hashBase64: string\n ): Promise<DfnsSignature> {\n try {\n const result = await this.client.keys.generateSignature({\n keyId,\n body: {\n kind: 'Hash',\n hash: base64ToHex(hashBase64),\n blockchainKind: 'Canton',\n externalId: base64ToHex(hashBase64),\n },\n })\n return {\n id: result.id,\n keyId,\n status: this.mapStatus(result.status),\n signature: this.extractSignature(result.signature),\n }\n } catch (error) {\n logger.error(error, 'Error signing hash with Dfns')\n throw error\n }\n }\n\n public async getSignature(\n keyId: string,\n signatureId: string\n ): Promise<DfnsSignature | undefined> {\n try {\n const result = await this.client.keys.getSignature({\n keyId,\n signatureId,\n })\n return {\n id: result.id,\n keyId,\n status: this.mapStatus(result.status),\n signature: this.extractSignature(result.signature),\n }\n } catch (error) {\n logger.debug(error, `Signature ${signatureId} not found`)\n return undefined\n }\n }\n\n /**\n * Locate a signature across all Canton keys. Used when the gateway\n * polls by signature id without knowing the originating key id.\n */\n public async findSignature(\n signatureId: string\n ): Promise<DfnsSignature | undefined> {\n for await (const key of this.iterateKeys()) {\n const sig = await this.getSignature(key.id, signatureId)\n if (sig) return sig\n }\n return undefined\n }\n\n public async *listSignatures(keyId: string): AsyncGenerator<DfnsSignature> {\n let paginationToken: string | undefined\n do {\n const response = await this.client.keys.listSignatures({\n keyId,\n query: {\n limit: DFNS_LIST_PAGE_SIZE,\n ...(paginationToken ? { paginationToken } : {}),\n },\n })\n\n for (const sig of response.items) {\n yield {\n id: sig.id,\n keyId,\n status: this.mapStatus(sig.status),\n signature: this.extractSignature(sig.signature),\n }\n }\n\n paginationToken = response.nextPageToken\n } while (paginationToken)\n }\n\n private extractSignature(signature?: {\n encoded?: string\n r: string\n s: string\n }): string | undefined {\n if (!signature) return undefined\n // For ed25519, `encoded` is the 64-byte r||s concat in hex; fall back\n // to assembling it from r/s if `encoded` is not populated.\n const hex = signature.encoded ?? `${signature.r}${signature.s}`\n return hexToBase64(hex)\n }\n\n private mapStatus(dfnsStatus: string): SigningStatus {\n switch (dfnsStatus) {\n case 'Signed':\n case 'Confirmed':\n return 'signed'\n case 'Pending':\n case 'Executing':\n return 'pending'\n case 'Rejected':\n return 'rejected'\n case 'Failed':\n return 'failed'\n default:\n logger.warn(`Unknown Dfns signature status: ${dfnsStatus}`)\n return 'pending'\n }\n }\n}\n","// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport {\n buildController,\n PartyMode,\n SigningDriverInterface,\n SigningProvider,\n} from '@canton-network/core-signing-lib'\n\nimport {\n SignTransactionParams,\n SignTransactionResult,\n GetTransactionParams,\n GetTransactionResult,\n GetTransactionsResult,\n GetTransactionsParams,\n GetKeysResult,\n CreateKeyParams,\n CreateKeyResult,\n GetConfigurationResult,\n SetConfigurationParams,\n SubscribeTransactionsParams,\n SubscribeTransactionsResult,\n SetConfigurationResult,\n Transaction,\n} from '@canton-network/core-signing-lib'\nimport { DfnsHandler, DfnsCredentials, DfnsSignature } from './dfns.js'\nimport { AuthContext } from '@canton-network/core-wallet-auth'\nimport _ from 'lodash'\nimport { z } from 'zod'\n\nexport type { DfnsCredentials, DfnsKey, DfnsSignature } from './dfns.js'\nexport { DfnsHandler } from './dfns.js'\n\nexport interface DfnsConfig {\n orgId: string\n baseUrl: string\n credentials: DfnsCredentials\n}\n\nconst DfnsCredentialsSchema = z.object({\n credId: z.string().min(1),\n privateKey: z.string().min(1),\n authToken: z.string().min(1),\n})\n\nconst DfnsConfigSchema = z.object({\n orgId: z.string().min(1),\n baseUrl: z.string().url(),\n credentials: DfnsCredentialsSchema,\n})\n\nconst createDfnsHandler = (config: DfnsConfig): DfnsHandler =>\n new DfnsHandler(config.orgId, config.baseUrl, config.credentials)\n\nfunction toTransaction(sig: DfnsSignature, publicKey?: string): Transaction {\n const tx: Transaction = {\n txId: sig.id,\n status: sig.status,\n }\n if (sig.signature) tx.signature = sig.signature\n if (publicKey) tx.publicKey = publicKey\n return tx\n}\n\nexport default class DfnsSigningDriver implements SigningDriverInterface {\n private dfns: DfnsHandler\n private config: DfnsConfig\n\n constructor(config: DfnsConfig) {\n this.config = config\n this.dfns = createDfnsHandler(config)\n }\n\n public partyMode = PartyMode.EXTERNAL\n public signingProvider = SigningProvider.DFNS\n\n private async resolveKeyId(keyIdentifier: {\n id?: string\n publicKey?: string\n }): Promise<string | undefined> {\n if (keyIdentifier.id) return keyIdentifier.id\n if (!keyIdentifier.publicKey) return undefined\n\n const key = await this.dfns.findKeyByPublicKey(keyIdentifier.publicKey)\n return key?.id\n }\n\n public controller = (\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _userId: AuthContext['userId'] | undefined\n ) =>\n buildController({\n signTransaction: async (\n params: SignTransactionParams\n ): Promise<SignTransactionResult> => {\n try {\n const keyId = await this.resolveKeyId(params.keyIdentifier)\n if (!keyId) {\n return {\n error: 'key_not_found',\n error_description:\n 'No Dfns key found for the provided key identifier.',\n }\n }\n\n if (!params.txHash) {\n return {\n error: 'bad_arguments',\n error_description:\n 'txHash is required to sign with Dfns.',\n }\n }\n\n const sig = await this.dfns.signHash(keyId, params.txHash)\n\n return toTransaction(sig, params.keyIdentifier.publicKey)\n } catch (error) {\n return {\n error: 'signing_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getTransaction: async (\n params: GetTransactionParams\n ): Promise<GetTransactionResult> => {\n try {\n const sig = await this.dfns.findSignature(params.txId)\n if (!sig) {\n return {\n error: 'transaction_not_found',\n error_description:\n 'The requested signature does not exist.',\n }\n }\n const key = await this.dfns.getKey(sig.keyId)\n return toTransaction(sig, key?.publicKey)\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getTransactions: async (\n params: GetTransactionsParams\n ): Promise<GetTransactionsResult> => {\n if (!params.publicKeys && !params.txIds) {\n return {\n error: 'bad_arguments',\n error_description:\n 'Either publicKeys or txIds must be provided.',\n }\n }\n\n try {\n const txIds = new Set(params.txIds || [])\n const publicKeys = new Set(params.publicKeys || [])\n const transactions: Transaction[] = []\n\n for await (const key of this.dfns.iterateKeys()) {\n if (\n params.publicKeys &&\n !publicKeys.has(key.publicKey)\n ) {\n continue\n }\n\n for await (const sig of this.dfns.listSignatures(\n key.id\n )) {\n if (params.txIds && !txIds.has(sig.id)) continue\n transactions.push(toTransaction(sig, key.publicKey))\n\n if (\n params.txIds &&\n !params.publicKeys &&\n transactions.length === txIds.size\n ) {\n return { transactions }\n }\n }\n }\n\n return { transactions }\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getKeys: async (): Promise<GetKeysResult> => {\n try {\n const keys = await this.dfns.listKeys()\n return {\n keys: keys.map((k) => ({\n id: k.id,\n name: k.name,\n publicKey: k.publicKey,\n })),\n }\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n createKey: async (\n params: CreateKeyParams\n ): Promise<CreateKeyResult> => {\n try {\n const key = await this.dfns.createKey(params.name)\n return {\n id: key.id,\n name: key.name,\n publicKey: key.publicKey,\n }\n } catch (error) {\n return {\n error: 'creation_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getConfiguration: async (): Promise<GetConfigurationResult> => ({\n orgId: this.config.orgId,\n baseUrl: this.config.baseUrl,\n credentials: this.config.credentials,\n }),\n\n setConfiguration: async (\n params: SetConfigurationParams\n ): Promise<SetConfigurationResult> => {\n const validated = DfnsConfigSchema.safeParse(params)\n if (!validated.success) {\n return {\n error: 'bad_arguments',\n error_description: validated.error.message,\n }\n }\n\n const newConfig: DfnsConfig = {\n orgId: validated.data.orgId,\n baseUrl: validated.data.baseUrl,\n credentials: validated.data.credentials,\n }\n\n if (!_.isEqual(newConfig, this.config)) {\n this.config = newConfig\n this.dfns = createDfnsHandler(this.config)\n }\n\n return params\n },\n\n subscribeTransactions: async (\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _params: SubscribeTransactionsParams\n ): Promise<SubscribeTransactionsResult> => {\n return Promise.resolve({} as SubscribeTransactionsResult)\n },\n })\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/dfns.ts","../src/index.ts"],"names":["pino","AsymmetricKeySigner","DfnsApiClient","z","PartyMode","SigningProvider","buildController","_"],"mappings":"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","file":"index.cjs","sourcesContent":["// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { DfnsApiClient } from '@dfns/sdk'\nimport { AsymmetricKeySigner } from '@dfns/sdk-keysigner'\nimport { SigningStatus } from '@canton-network/core-signing-lib'\nimport { pino } from 'pino'\n\nconst logger = pino({ name: 'dfns-handler', level: 'debug' })\n\nconst DFNS_LIST_PAGE_SIZE = 50\n\n/**\n * Credentials for a Dfns service account. Dfns uses two-layer auth: a\n * long-lived bearer token plus per-request signing with a private key.\n */\nexport interface DfnsCredentials {\n /** ID of the Dfns credential (key) registered against the service account. */\n credId: string\n /**\n * PEM-encoded private key paired with `credId`. Used to sign every\n * sensitive Dfns API request as a U2F-style second factor. Configured\n * once per deployment; not derived from `authToken`.\n */\n privateKey: string\n /**\n * Long-lived service account bearer JWT issued by the Dfns dashboard.\n * Does not auto-expire and is not regenerated from `privateKey`/`credId`.\n * Rotate by issuing a new token in the Dfns dashboard.\n */\n authToken: string\n}\n\nexport interface DfnsKey {\n /** Dfns key id (e.g. `key-...`). */\n id: string\n /** Human-readable name configured on the Dfns key. */\n name: string\n /** ed25519 public key, base64-encoded (Canton format). */\n publicKey: string\n}\n\nexport interface DfnsSignature {\n /** Dfns signature id (used as the txId returned to the gateway). */\n id: string\n /** Dfns key id the signature was produced with. */\n keyId: string\n status: SigningStatus\n /** ed25519 signature, base64-encoded (Canton SIGNATURE_FORMAT_CONCAT). */\n signature?: string\n}\n\nfunction stripHexPrefix(hex: string): string {\n return hex.startsWith('0x') ? hex.slice(2) : hex\n}\n\nfunction hexToBase64(hex: string): string {\n return Buffer.from(stripHexPrefix(hex), 'hex').toString('base64')\n}\n\nfunction base64ToHex(base64: string): string {\n return Buffer.from(base64, 'base64').toString('hex')\n}\n\nfunction isCantonKey(scheme: string, curve: string): boolean {\n return scheme === 'EdDSA' && curve === 'ed25519'\n}\n\nexport class DfnsHandler {\n private client: DfnsApiClient\n private orgId: string\n private baseUrl: string\n // Tracks the key that produced each signature so getSignature can look it\n // up directly. `listKeys` (used by `iterateKeys`) is eventually-consistent\n // — a key created moments ago may not yet appear in the list, so iterating\n // would 404 even though the signature exists under the just-used key.\n private signatureKey = new Map<string, string>()\n\n constructor(orgId: string, baseUrl: string, credentials: DfnsCredentials) {\n this.orgId = orgId\n this.baseUrl = baseUrl\n this.client = this.createClient(credentials)\n }\n\n private createClient(credentials: DfnsCredentials): DfnsApiClient {\n const signer = new AsymmetricKeySigner({\n credId: credentials.credId,\n privateKey: credentials.privateKey,\n })\n\n return new DfnsApiClient({\n orgId: this.orgId,\n authToken: credentials.authToken,\n baseUrl: this.baseUrl,\n signer,\n })\n }\n\n /**\n * Create a raw ed25519 key in Dfns suitable for signing Canton topology\n * and ledger transactions. The key is not bound to a network — chain\n * activation happens on the gateway against its configured validator.\n */\n public async createKey(name: string): Promise<DfnsKey> {\n try {\n const key = await this.client.keys.createKey({\n body: {\n scheme: 'EdDSA',\n curve: 'ed25519',\n name,\n },\n })\n return {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n } catch (error) {\n logger.error(error, 'Error creating Dfns key')\n throw error\n }\n }\n\n public async *iterateKeys(): AsyncGenerator<DfnsKey> {\n let paginationToken: string | undefined\n do {\n const response = await this.client.keys.listKeys({\n query: {\n limit: DFNS_LIST_PAGE_SIZE,\n ...(paginationToken ? { paginationToken } : {}),\n },\n })\n\n for (const key of response.items) {\n if (\n key.status !== 'Active' ||\n !isCantonKey(key.scheme, key.curve)\n ) {\n continue\n }\n yield {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n }\n\n paginationToken = response.nextPageToken\n } while (paginationToken)\n }\n\n public async listKeys(): Promise<DfnsKey[]> {\n const keys: DfnsKey[] = []\n try {\n for await (const key of this.iterateKeys()) {\n keys.push(key)\n }\n } catch (error) {\n logger.error(error, 'Error listing Dfns keys')\n throw error\n }\n return keys\n }\n\n public async getKey(keyId: string): Promise<DfnsKey | undefined> {\n try {\n const key = await this.client.keys.getKey({ keyId })\n if (\n key.status !== 'Active' ||\n !isCantonKey(key.scheme, key.curve)\n ) {\n return undefined\n }\n return {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n } catch (error) {\n logger.debug(error, `Key ${keyId} not found`)\n return undefined\n }\n }\n\n /**\n * Resolve a key by base64 ed25519 public key. Iterates Dfns keys —\n * acceptable for first iteration since most deployments hold a single\n * Canton key per credential.\n */\n public async findKeyByPublicKey(\n publicKeyBase64: string\n ): Promise<DfnsKey | undefined> {\n for await (const key of this.iterateKeys()) {\n if (key.publicKey === publicKeyBase64) {\n return key\n }\n }\n return undefined\n }\n\n /**\n * Sign a Canton hash (raw or multihash-framed) by handing the bytes to\n * Dfns's `Message` kind, which signs the supplied hex with raw ed25519 —\n * the same shape Fireblocks's `RAW` operation produces.\n *\n * `kind: 'Hash'` would be the natural fit but its regex caps at 32 bytes,\n * forcing us to strip the multihash prefix; Canton then rejects the\n * resulting signature because it verifies over the full 34-byte\n * multihash, not the digest. Every Canton-tagged kind (Hash/Message/\n * Transaction + `blockchainKind: 'Canton'`) is server-rejected, so we\n * use plain `Message` (no `blockchainKind`) and pass the raw bytes.\n */\n public async signHash(\n keyId: string,\n hashBase64: string,\n externalId?: string\n ): Promise<DfnsSignature> {\n const messageHex = base64ToHex(hashBase64)\n const body = {\n kind: 'Message' as const,\n message: messageHex,\n ...(externalId ? { externalId } : {}),\n }\n return this.submitSignatureRequest(keyId, body)\n }\n\n private async submitSignatureRequest(\n keyId: string,\n body: Parameters<DfnsApiClient['keys']['generateSignature']>[0]['body']\n ): Promise<DfnsSignature> {\n try {\n const result = await this.client.keys.generateSignature({\n keyId,\n body,\n })\n const mapped = this.mapStatus(result.status)\n if (mapped === 'failed' || mapped === 'rejected') {\n logger.error(\n { keyId, result },\n `Dfns signing returned ${result.status}`\n )\n }\n this.signatureKey.set(result.id, keyId)\n return {\n id: result.id,\n keyId,\n status: mapped,\n signature: this.extractSignature(result.signature),\n }\n } catch (error) {\n logger.error(\n { keyId, err: error },\n 'Error generating Dfns signature'\n )\n throw error\n }\n }\n\n public async getSignature(\n keyId: string,\n signatureId: string\n ): Promise<DfnsSignature | undefined> {\n try {\n const result = await this.client.keys.getSignature({\n keyId,\n signatureId,\n })\n return {\n id: result.id,\n keyId,\n status: this.mapStatus(result.status),\n signature: this.extractSignature(result.signature),\n }\n } catch (error) {\n logger.debug(error, `Signature ${signatureId} not found`)\n return undefined\n }\n }\n\n /**\n * Locate a signature by id. Prefers the cached key from the originating\n * sign call — `listKeys` is eventually-consistent, so iterating right\n * after creating a key would miss the signature. Falls back to iteration\n * when the cache misses (e.g. across a gateway restart).\n */\n public async findSignature(\n signatureId: string\n ): Promise<DfnsSignature | undefined> {\n const cachedKeyId = this.signatureKey.get(signatureId)\n if (cachedKeyId) {\n const sig = await this.getSignature(cachedKeyId, signatureId)\n if (sig) return sig\n }\n for await (const key of this.iterateKeys()) {\n if (key.id === cachedKeyId) continue\n const sig = await this.getSignature(key.id, signatureId)\n if (sig) return sig\n }\n return undefined\n }\n\n public async *listSignatures(keyId: string): AsyncGenerator<DfnsSignature> {\n let paginationToken: string | undefined\n do {\n const response = await this.client.keys.listSignatures({\n keyId,\n query: {\n limit: DFNS_LIST_PAGE_SIZE,\n ...(paginationToken ? { paginationToken } : {}),\n },\n })\n\n for (const sig of response.items) {\n yield {\n id: sig.id,\n keyId,\n status: this.mapStatus(sig.status),\n signature: this.extractSignature(sig.signature),\n }\n }\n\n paginationToken = response.nextPageToken\n } while (paginationToken)\n }\n\n private extractSignature(signature?: {\n encoded?: string\n r: string\n s: string\n }): string | undefined {\n if (!signature) return undefined\n // For ed25519, `encoded` is the 64-byte r||s concat in hex; fall back\n // to assembling it from r/s if `encoded` is not populated. Each field\n // may carry an 0x prefix that must be stripped before hex decoding.\n const hex = signature.encoded\n ? stripHexPrefix(signature.encoded)\n : `${stripHexPrefix(signature.r)}${stripHexPrefix(signature.s)}`\n return hexToBase64(hex)\n }\n\n private mapStatus(dfnsStatus: string): SigningStatus {\n switch (dfnsStatus) {\n case 'Signed':\n case 'Confirmed':\n return 'signed'\n case 'Pending':\n case 'Executing':\n return 'pending'\n case 'Rejected':\n return 'rejected'\n case 'Failed':\n return 'failed'\n default:\n logger.warn(`Unknown Dfns signature status: ${dfnsStatus}`)\n return 'pending'\n }\n }\n}\n","// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport {\n buildController,\n PartyMode,\n SigningDriverInterface,\n SigningProvider,\n} from '@canton-network/core-signing-lib'\n\nimport {\n SignTransactionParams,\n SignTransactionResult,\n GetTransactionParams,\n GetTransactionResult,\n GetTransactionsResult,\n GetTransactionsParams,\n GetKeysResult,\n CreateKeyParams,\n CreateKeyResult,\n GetConfigurationResult,\n SetConfigurationParams,\n SubscribeTransactionsParams,\n SubscribeTransactionsResult,\n SetConfigurationResult,\n Transaction,\n} from '@canton-network/core-signing-lib'\nimport { DfnsHandler, DfnsCredentials, DfnsSignature } from './dfns.js'\nimport { AuthContext } from '@canton-network/core-wallet-auth'\nimport _ from 'lodash'\nimport { z } from 'zod'\n\nexport type { DfnsCredentials, DfnsKey, DfnsSignature } from './dfns.js'\nexport { DfnsHandler } from './dfns.js'\n\nexport interface DfnsConfig {\n orgId: string\n baseUrl: string\n credentials: DfnsCredentials\n}\n\nconst DfnsCredentialsSchema = z.object({\n credId: z.string().min(1),\n privateKey: z.string().min(1),\n authToken: z.string().min(1),\n})\n\nconst DfnsConfigSchema = z.object({\n orgId: z.string().min(1),\n baseUrl: z.string().url(),\n credentials: DfnsCredentialsSchema,\n})\n\nconst createDfnsHandler = (config: DfnsConfig): DfnsHandler =>\n new DfnsHandler(config.orgId, config.baseUrl, config.credentials)\n\nfunction toTransaction(sig: DfnsSignature, publicKey?: string): Transaction {\n const tx: Transaction = {\n txId: sig.id,\n status: sig.status,\n }\n if (sig.signature) tx.signature = sig.signature\n if (publicKey) tx.publicKey = publicKey\n return tx\n}\n\nexport default class DfnsSigningDriver implements SigningDriverInterface {\n private dfns: DfnsHandler\n private config: DfnsConfig\n\n constructor(config: DfnsConfig) {\n this.config = config\n this.dfns = createDfnsHandler(config)\n }\n\n public partyMode = PartyMode.EXTERNAL\n public signingProvider = SigningProvider.DFNS\n\n private async resolveKeyId(keyIdentifier: {\n id?: string\n publicKey?: string\n }): Promise<string | undefined> {\n if (keyIdentifier.id) return keyIdentifier.id\n if (!keyIdentifier.publicKey) return undefined\n\n const key = await this.dfns.findKeyByPublicKey(keyIdentifier.publicKey)\n return key?.id\n }\n\n public controller = (\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _userId: AuthContext['userId'] | undefined\n ) =>\n buildController({\n signTransaction: async (\n params: SignTransactionParams\n ): Promise<SignTransactionResult> => {\n try {\n const keyId = await this.resolveKeyId(params.keyIdentifier)\n if (!keyId) {\n return {\n error: 'key_not_found',\n error_description:\n 'No Dfns key found for the provided key identifier.',\n }\n }\n\n if (!params.txHash) {\n return {\n error: 'bad_arguments',\n error_description:\n 'txHash is required to sign with Dfns.',\n }\n }\n\n const sig = await this.dfns.signHash(\n keyId,\n params.txHash,\n params.internalTxId\n )\n\n return toTransaction(sig, params.keyIdentifier.publicKey)\n } catch (error) {\n return {\n error: 'signing_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getTransaction: async (\n params: GetTransactionParams\n ): Promise<GetTransactionResult> => {\n try {\n const sig = await this.dfns.findSignature(params.txId)\n if (!sig) {\n return {\n error: 'transaction_not_found',\n error_description:\n 'The requested signature does not exist.',\n }\n }\n const key = await this.dfns.getKey(sig.keyId)\n return toTransaction(sig, key?.publicKey)\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getTransactions: async (\n params: GetTransactionsParams\n ): Promise<GetTransactionsResult> => {\n if (!params.publicKeys && !params.txIds) {\n return {\n error: 'bad_arguments',\n error_description:\n 'Either publicKeys or txIds must be provided.',\n }\n }\n\n try {\n const txIds = new Set(params.txIds || [])\n const publicKeys = new Set(params.publicKeys || [])\n const transactions: Transaction[] = []\n\n for await (const key of this.dfns.iterateKeys()) {\n if (\n params.publicKeys &&\n !publicKeys.has(key.publicKey)\n ) {\n continue\n }\n\n for await (const sig of this.dfns.listSignatures(\n key.id\n )) {\n if (params.txIds && !txIds.has(sig.id)) continue\n transactions.push(toTransaction(sig, key.publicKey))\n\n if (\n params.txIds &&\n !params.publicKeys &&\n transactions.length === txIds.size\n ) {\n return { transactions }\n }\n }\n }\n\n return { transactions }\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getKeys: async (): Promise<GetKeysResult> => {\n try {\n const keys = await this.dfns.listKeys()\n return {\n keys: keys.map((k) => ({\n id: k.id,\n name: k.name,\n publicKey: k.publicKey,\n })),\n }\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n createKey: async (\n params: CreateKeyParams\n ): Promise<CreateKeyResult> => {\n try {\n const key = await this.dfns.createKey(params.name)\n return {\n id: key.id,\n name: key.name,\n publicKey: key.publicKey,\n }\n } catch (error) {\n return {\n error: 'creation_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getConfiguration: async (): Promise<GetConfigurationResult> => ({\n orgId: this.config.orgId,\n baseUrl: this.config.baseUrl,\n credentials: this.config.credentials,\n }),\n\n setConfiguration: async (\n params: SetConfigurationParams\n ): Promise<SetConfigurationResult> => {\n const validated = DfnsConfigSchema.safeParse(params)\n if (!validated.success) {\n return {\n error: 'bad_arguments',\n error_description: validated.error.message,\n }\n }\n\n const newConfig: DfnsConfig = {\n orgId: validated.data.orgId,\n baseUrl: validated.data.baseUrl,\n credentials: validated.data.credentials,\n }\n\n if (!_.isEqual(newConfig, this.config)) {\n this.config = newConfig\n this.dfns = createDfnsHandler(this.config)\n }\n\n return params\n },\n\n subscribeTransactions: async (\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _params: SubscribeTransactionsParams\n ): Promise<SubscribeTransactionsResult> => {\n return Promise.resolve({} as SubscribeTransactionsResult)\n },\n })\n}\n"]}
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,SAAS,EACT,sBAAsB,EACtB,eAAe,EAClB,MAAM,kCAAkC,CAAA;AAmBzC,OAAO,EAAe,eAAe,EAAiB,MAAM,WAAW,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAI9D,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEvC,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,eAAe,CAAA;CAC/B;AA2BD,MAAM,CAAC,OAAO,OAAO,iBAAkB,YAAW,sBAAsB;IACpE,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,UAAU;IAKvB,SAAS,YAAqB;IAC9B,eAAe,kBAAuB;YAE/B,YAAY;IAWnB,UAAU,GAEb,SAAS,WAAW,CAAC,QAAQ,CAAC,GAAG,SAAS;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,SAAS,EACT,sBAAsB,EACtB,eAAe,EAClB,MAAM,kCAAkC,CAAA;AAmBzC,OAAO,EAAe,eAAe,EAAiB,MAAM,WAAW,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAI9D,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEvC,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,eAAe,CAAA;CAC/B;AA2BD,MAAM,CAAC,OAAO,OAAO,iBAAkB,YAAW,sBAAsB;IACpE,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,UAAU;IAKvB,SAAS,YAAqB;IAC9B,eAAe,kBAAuB;YAE/B,YAAY;IAWnB,UAAU,GAEb,SAAS,WAAW,CAAC,QAAQ,CAAC,GAAG,SAAS;;;;;;;;;MAuLxC;CACT"}
|
package/dist/index.js
CHANGED
|
@@ -10,8 +10,11 @@ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { en
|
|
|
10
10
|
var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
|
|
11
11
|
var logger = pino({ name: "dfns-handler", level: "debug" });
|
|
12
12
|
var DFNS_LIST_PAGE_SIZE = 50;
|
|
13
|
+
function stripHexPrefix(hex) {
|
|
14
|
+
return hex.startsWith("0x") ? hex.slice(2) : hex;
|
|
15
|
+
}
|
|
13
16
|
function hexToBase64(hex) {
|
|
14
|
-
return Buffer.from(hex, "hex").toString("base64");
|
|
17
|
+
return Buffer.from(stripHexPrefix(hex), "hex").toString("base64");
|
|
15
18
|
}
|
|
16
19
|
function base64ToHex(base64) {
|
|
17
20
|
return Buffer.from(base64, "base64").toString("hex");
|
|
@@ -24,6 +27,11 @@ var DfnsHandler = class {
|
|
|
24
27
|
__publicField(this, "client");
|
|
25
28
|
__publicField(this, "orgId");
|
|
26
29
|
__publicField(this, "baseUrl");
|
|
30
|
+
// Tracks the key that produced each signature so getSignature can look it
|
|
31
|
+
// up directly. `listKeys` (used by `iterateKeys`) is eventually-consistent
|
|
32
|
+
// — a key created moments ago may not yet appear in the list, so iterating
|
|
33
|
+
// would 404 even though the signature exists under the just-used key.
|
|
34
|
+
__publicField(this, "signatureKey", /* @__PURE__ */ new Map());
|
|
27
35
|
this.orgId = orgId;
|
|
28
36
|
this.baseUrl = baseUrl;
|
|
29
37
|
this.client = this.createClient(credentials);
|
|
@@ -128,37 +136,51 @@ var DfnsHandler = class {
|
|
|
128
136
|
return void 0;
|
|
129
137
|
}
|
|
130
138
|
/**
|
|
131
|
-
*
|
|
132
|
-
*
|
|
133
|
-
*
|
|
134
|
-
*
|
|
135
|
-
* The hash is reused as the Dfns idempotency key — re-signing the same
|
|
136
|
-
* hash returns the existing signature rather than producing a duplicate,
|
|
137
|
-
* which is safe because Canton's command deduplication handles repeats
|
|
138
|
-
* at the ledger level.
|
|
139
|
+
* Sign a Canton hash (raw or multihash-framed) by handing the bytes to
|
|
140
|
+
* Dfns's `Message` kind, which signs the supplied hex with raw ed25519 —
|
|
141
|
+
* the same shape Fireblocks's `RAW` operation produces.
|
|
139
142
|
*
|
|
140
|
-
*
|
|
141
|
-
*
|
|
143
|
+
* `kind: 'Hash'` would be the natural fit but its regex caps at 32 bytes,
|
|
144
|
+
* forcing us to strip the multihash prefix; Canton then rejects the
|
|
145
|
+
* resulting signature because it verifies over the full 34-byte
|
|
146
|
+
* multihash, not the digest. Every Canton-tagged kind (Hash/Message/
|
|
147
|
+
* Transaction + `blockchainKind: 'Canton'`) is server-rejected, so we
|
|
148
|
+
* use plain `Message` (no `blockchainKind`) and pass the raw bytes.
|
|
142
149
|
*/
|
|
143
|
-
async signHash(keyId, hashBase64) {
|
|
150
|
+
async signHash(keyId, hashBase64, externalId) {
|
|
151
|
+
const messageHex = base64ToHex(hashBase64);
|
|
152
|
+
const body = {
|
|
153
|
+
kind: "Message",
|
|
154
|
+
message: messageHex,
|
|
155
|
+
...externalId ? { externalId } : {}
|
|
156
|
+
};
|
|
157
|
+
return this.submitSignatureRequest(keyId, body);
|
|
158
|
+
}
|
|
159
|
+
async submitSignatureRequest(keyId, body) {
|
|
144
160
|
try {
|
|
145
161
|
const result = await this.client.keys.generateSignature({
|
|
146
162
|
keyId,
|
|
147
|
-
body
|
|
148
|
-
kind: "Hash",
|
|
149
|
-
hash: base64ToHex(hashBase64),
|
|
150
|
-
blockchainKind: "Canton",
|
|
151
|
-
externalId: base64ToHex(hashBase64)
|
|
152
|
-
}
|
|
163
|
+
body
|
|
153
164
|
});
|
|
165
|
+
const mapped = this.mapStatus(result.status);
|
|
166
|
+
if (mapped === "failed" || mapped === "rejected") {
|
|
167
|
+
logger.error(
|
|
168
|
+
{ keyId, result },
|
|
169
|
+
`Dfns signing returned ${result.status}`
|
|
170
|
+
);
|
|
171
|
+
}
|
|
172
|
+
this.signatureKey.set(result.id, keyId);
|
|
154
173
|
return {
|
|
155
174
|
id: result.id,
|
|
156
175
|
keyId,
|
|
157
|
-
status:
|
|
176
|
+
status: mapped,
|
|
158
177
|
signature: this.extractSignature(result.signature)
|
|
159
178
|
};
|
|
160
179
|
} catch (error) {
|
|
161
|
-
logger.error(
|
|
180
|
+
logger.error(
|
|
181
|
+
{ keyId, err: error },
|
|
182
|
+
"Error generating Dfns signature"
|
|
183
|
+
);
|
|
162
184
|
throw error;
|
|
163
185
|
}
|
|
164
186
|
}
|
|
@@ -180,11 +202,19 @@ var DfnsHandler = class {
|
|
|
180
202
|
}
|
|
181
203
|
}
|
|
182
204
|
/**
|
|
183
|
-
* Locate a signature
|
|
184
|
-
*
|
|
205
|
+
* Locate a signature by id. Prefers the cached key from the originating
|
|
206
|
+
* sign call — `listKeys` is eventually-consistent, so iterating right
|
|
207
|
+
* after creating a key would miss the signature. Falls back to iteration
|
|
208
|
+
* when the cache misses (e.g. across a gateway restart).
|
|
185
209
|
*/
|
|
186
210
|
async findSignature(signatureId) {
|
|
211
|
+
const cachedKeyId = this.signatureKey.get(signatureId);
|
|
212
|
+
if (cachedKeyId) {
|
|
213
|
+
const sig = await this.getSignature(cachedKeyId, signatureId);
|
|
214
|
+
if (sig) return sig;
|
|
215
|
+
}
|
|
187
216
|
for await (const key of this.iterateKeys()) {
|
|
217
|
+
if (key.id === cachedKeyId) continue;
|
|
188
218
|
const sig = await this.getSignature(key.id, signatureId);
|
|
189
219
|
if (sig) return sig;
|
|
190
220
|
}
|
|
@@ -213,7 +243,7 @@ var DfnsHandler = class {
|
|
|
213
243
|
}
|
|
214
244
|
extractSignature(signature) {
|
|
215
245
|
if (!signature) return void 0;
|
|
216
|
-
const hex = signature.encoded
|
|
246
|
+
const hex = signature.encoded ? stripHexPrefix(signature.encoded) : `${stripHexPrefix(signature.r)}${stripHexPrefix(signature.s)}`;
|
|
217
247
|
return hexToBase64(hex);
|
|
218
248
|
}
|
|
219
249
|
mapStatus(dfnsStatus) {
|
|
@@ -276,7 +306,11 @@ var DfnsSigningDriver = class {
|
|
|
276
306
|
error_description: "txHash is required to sign with Dfns."
|
|
277
307
|
};
|
|
278
308
|
}
|
|
279
|
-
const sig = await this.dfns.signHash(
|
|
309
|
+
const sig = await this.dfns.signHash(
|
|
310
|
+
keyId,
|
|
311
|
+
params.txHash,
|
|
312
|
+
params.internalTxId
|
|
313
|
+
);
|
|
280
314
|
return toTransaction(sig, params.keyIdentifier.publicKey);
|
|
281
315
|
} catch (error) {
|
|
282
316
|
return {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/dfns.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { DfnsApiClient } from '@dfns/sdk'\nimport { AsymmetricKeySigner } from '@dfns/sdk-keysigner'\nimport { SigningStatus } from '@canton-network/core-signing-lib'\nimport { pino } from 'pino'\n\nconst logger = pino({ name: 'dfns-handler', level: 'debug' })\n\nconst DFNS_LIST_PAGE_SIZE = 50\n\n/**\n * Credentials for a Dfns service account. Dfns uses two-layer auth: a\n * long-lived bearer token plus per-request signing with a private key.\n */\nexport interface DfnsCredentials {\n /** ID of the Dfns credential (key) registered against the service account. */\n credId: string\n /**\n * PEM-encoded private key paired with `credId`. Used to sign every\n * sensitive Dfns API request as a U2F-style second factor. Configured\n * once per deployment; not derived from `authToken`.\n */\n privateKey: string\n /**\n * Long-lived service account bearer JWT issued by the Dfns dashboard.\n * Does not auto-expire and is not regenerated from `privateKey`/`credId`.\n * Rotate by issuing a new token in the Dfns dashboard.\n */\n authToken: string\n}\n\nexport interface DfnsKey {\n /** Dfns key id (e.g. `key-...`). */\n id: string\n /** Human-readable name configured on the Dfns key. */\n name: string\n /** ed25519 public key, base64-encoded (Canton format). */\n publicKey: string\n}\n\nexport interface DfnsSignature {\n /** Dfns signature id (used as the txId returned to the gateway). */\n id: string\n /** Dfns key id the signature was produced with. */\n keyId: string\n status: SigningStatus\n /** ed25519 signature, base64-encoded (Canton SIGNATURE_FORMAT_CONCAT). */\n signature?: string\n}\n\nfunction hexToBase64(hex: string): string {\n return Buffer.from(hex, 'hex').toString('base64')\n}\n\nfunction base64ToHex(base64: string): string {\n return Buffer.from(base64, 'base64').toString('hex')\n}\n\nfunction isCantonKey(scheme: string, curve: string): boolean {\n return scheme === 'EdDSA' && curve === 'ed25519'\n}\n\nexport class DfnsHandler {\n private client: DfnsApiClient\n private orgId: string\n private baseUrl: string\n\n constructor(orgId: string, baseUrl: string, credentials: DfnsCredentials) {\n this.orgId = orgId\n this.baseUrl = baseUrl\n this.client = this.createClient(credentials)\n }\n\n private createClient(credentials: DfnsCredentials): DfnsApiClient {\n const signer = new AsymmetricKeySigner({\n credId: credentials.credId,\n privateKey: credentials.privateKey,\n })\n\n return new DfnsApiClient({\n orgId: this.orgId,\n authToken: credentials.authToken,\n baseUrl: this.baseUrl,\n signer,\n })\n }\n\n /**\n * Create a raw ed25519 key in Dfns suitable for signing Canton topology\n * and ledger transactions. The key is not bound to a network — chain\n * activation happens on the gateway against its configured validator.\n */\n public async createKey(name: string): Promise<DfnsKey> {\n try {\n const key = await this.client.keys.createKey({\n body: {\n scheme: 'EdDSA',\n curve: 'ed25519',\n name,\n },\n })\n return {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n } catch (error) {\n logger.error(error, 'Error creating Dfns key')\n throw error\n }\n }\n\n public async *iterateKeys(): AsyncGenerator<DfnsKey> {\n let paginationToken: string | undefined\n do {\n const response = await this.client.keys.listKeys({\n query: {\n limit: DFNS_LIST_PAGE_SIZE,\n ...(paginationToken ? { paginationToken } : {}),\n },\n })\n\n for (const key of response.items) {\n if (\n key.status !== 'Active' ||\n !isCantonKey(key.scheme, key.curve)\n ) {\n continue\n }\n yield {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n }\n\n paginationToken = response.nextPageToken\n } while (paginationToken)\n }\n\n public async listKeys(): Promise<DfnsKey[]> {\n const keys: DfnsKey[] = []\n try {\n for await (const key of this.iterateKeys()) {\n keys.push(key)\n }\n } catch (error) {\n logger.error(error, 'Error listing Dfns keys')\n throw error\n }\n return keys\n }\n\n public async getKey(keyId: string): Promise<DfnsKey | undefined> {\n try {\n const key = await this.client.keys.getKey({ keyId })\n if (\n key.status !== 'Active' ||\n !isCantonKey(key.scheme, key.curve)\n ) {\n return undefined\n }\n return {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n } catch (error) {\n logger.debug(error, `Key ${keyId} not found`)\n return undefined\n }\n }\n\n /**\n * Resolve a key by base64 ed25519 public key. Iterates Dfns keys —\n * acceptable for first iteration since most deployments hold a single\n * Canton key per credential.\n */\n public async findKeyByPublicKey(\n publicKeyBase64: string\n ): Promise<DfnsKey | undefined> {\n for await (const key of this.iterateKeys()) {\n if (key.publicKey === publicKeyBase64) {\n return key\n }\n }\n return undefined\n }\n\n /**\n * Submit a hash signing request to Dfns. Returns immediately with the\n * signature id and current status; signature bytes are fetched via\n * {@link getSignature} once the request reaches `signed` status.\n *\n * The hash is reused as the Dfns idempotency key — re-signing the same\n * hash returns the existing signature rather than producing a duplicate,\n * which is safe because Canton's command deduplication handles repeats\n * at the ledger level.\n *\n * @param keyId Dfns key id resolved from the gateway's key identifier.\n * @param hashBase64 32-byte hash, base64-encoded (Canton TxHash format).\n */\n public async signHash(\n keyId: string,\n hashBase64: string\n ): Promise<DfnsSignature> {\n try {\n const result = await this.client.keys.generateSignature({\n keyId,\n body: {\n kind: 'Hash',\n hash: base64ToHex(hashBase64),\n blockchainKind: 'Canton',\n externalId: base64ToHex(hashBase64),\n },\n })\n return {\n id: result.id,\n keyId,\n status: this.mapStatus(result.status),\n signature: this.extractSignature(result.signature),\n }\n } catch (error) {\n logger.error(error, 'Error signing hash with Dfns')\n throw error\n }\n }\n\n public async getSignature(\n keyId: string,\n signatureId: string\n ): Promise<DfnsSignature | undefined> {\n try {\n const result = await this.client.keys.getSignature({\n keyId,\n signatureId,\n })\n return {\n id: result.id,\n keyId,\n status: this.mapStatus(result.status),\n signature: this.extractSignature(result.signature),\n }\n } catch (error) {\n logger.debug(error, `Signature ${signatureId} not found`)\n return undefined\n }\n }\n\n /**\n * Locate a signature across all Canton keys. Used when the gateway\n * polls by signature id without knowing the originating key id.\n */\n public async findSignature(\n signatureId: string\n ): Promise<DfnsSignature | undefined> {\n for await (const key of this.iterateKeys()) {\n const sig = await this.getSignature(key.id, signatureId)\n if (sig) return sig\n }\n return undefined\n }\n\n public async *listSignatures(keyId: string): AsyncGenerator<DfnsSignature> {\n let paginationToken: string | undefined\n do {\n const response = await this.client.keys.listSignatures({\n keyId,\n query: {\n limit: DFNS_LIST_PAGE_SIZE,\n ...(paginationToken ? { paginationToken } : {}),\n },\n })\n\n for (const sig of response.items) {\n yield {\n id: sig.id,\n keyId,\n status: this.mapStatus(sig.status),\n signature: this.extractSignature(sig.signature),\n }\n }\n\n paginationToken = response.nextPageToken\n } while (paginationToken)\n }\n\n private extractSignature(signature?: {\n encoded?: string\n r: string\n s: string\n }): string | undefined {\n if (!signature) return undefined\n // For ed25519, `encoded` is the 64-byte r||s concat in hex; fall back\n // to assembling it from r/s if `encoded` is not populated.\n const hex = signature.encoded ?? `${signature.r}${signature.s}`\n return hexToBase64(hex)\n }\n\n private mapStatus(dfnsStatus: string): SigningStatus {\n switch (dfnsStatus) {\n case 'Signed':\n case 'Confirmed':\n return 'signed'\n case 'Pending':\n case 'Executing':\n return 'pending'\n case 'Rejected':\n return 'rejected'\n case 'Failed':\n return 'failed'\n default:\n logger.warn(`Unknown Dfns signature status: ${dfnsStatus}`)\n return 'pending'\n }\n }\n}\n","// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport {\n buildController,\n PartyMode,\n SigningDriverInterface,\n SigningProvider,\n} from '@canton-network/core-signing-lib'\n\nimport {\n SignTransactionParams,\n SignTransactionResult,\n GetTransactionParams,\n GetTransactionResult,\n GetTransactionsResult,\n GetTransactionsParams,\n GetKeysResult,\n CreateKeyParams,\n CreateKeyResult,\n GetConfigurationResult,\n SetConfigurationParams,\n SubscribeTransactionsParams,\n SubscribeTransactionsResult,\n SetConfigurationResult,\n Transaction,\n} from '@canton-network/core-signing-lib'\nimport { DfnsHandler, DfnsCredentials, DfnsSignature } from './dfns.js'\nimport { AuthContext } from '@canton-network/core-wallet-auth'\nimport _ from 'lodash'\nimport { z } from 'zod'\n\nexport type { DfnsCredentials, DfnsKey, DfnsSignature } from './dfns.js'\nexport { DfnsHandler } from './dfns.js'\n\nexport interface DfnsConfig {\n orgId: string\n baseUrl: string\n credentials: DfnsCredentials\n}\n\nconst DfnsCredentialsSchema = z.object({\n credId: z.string().min(1),\n privateKey: z.string().min(1),\n authToken: z.string().min(1),\n})\n\nconst DfnsConfigSchema = z.object({\n orgId: z.string().min(1),\n baseUrl: z.string().url(),\n credentials: DfnsCredentialsSchema,\n})\n\nconst createDfnsHandler = (config: DfnsConfig): DfnsHandler =>\n new DfnsHandler(config.orgId, config.baseUrl, config.credentials)\n\nfunction toTransaction(sig: DfnsSignature, publicKey?: string): Transaction {\n const tx: Transaction = {\n txId: sig.id,\n status: sig.status,\n }\n if (sig.signature) tx.signature = sig.signature\n if (publicKey) tx.publicKey = publicKey\n return tx\n}\n\nexport default class DfnsSigningDriver implements SigningDriverInterface {\n private dfns: DfnsHandler\n private config: DfnsConfig\n\n constructor(config: DfnsConfig) {\n this.config = config\n this.dfns = createDfnsHandler(config)\n }\n\n public partyMode = PartyMode.EXTERNAL\n public signingProvider = SigningProvider.DFNS\n\n private async resolveKeyId(keyIdentifier: {\n id?: string\n publicKey?: string\n }): Promise<string | undefined> {\n if (keyIdentifier.id) return keyIdentifier.id\n if (!keyIdentifier.publicKey) return undefined\n\n const key = await this.dfns.findKeyByPublicKey(keyIdentifier.publicKey)\n return key?.id\n }\n\n public controller = (\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _userId: AuthContext['userId'] | undefined\n ) =>\n buildController({\n signTransaction: async (\n params: SignTransactionParams\n ): Promise<SignTransactionResult> => {\n try {\n const keyId = await this.resolveKeyId(params.keyIdentifier)\n if (!keyId) {\n return {\n error: 'key_not_found',\n error_description:\n 'No Dfns key found for the provided key identifier.',\n }\n }\n\n if (!params.txHash) {\n return {\n error: 'bad_arguments',\n error_description:\n 'txHash is required to sign with Dfns.',\n }\n }\n\n const sig = await this.dfns.signHash(keyId, params.txHash)\n\n return toTransaction(sig, params.keyIdentifier.publicKey)\n } catch (error) {\n return {\n error: 'signing_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getTransaction: async (\n params: GetTransactionParams\n ): Promise<GetTransactionResult> => {\n try {\n const sig = await this.dfns.findSignature(params.txId)\n if (!sig) {\n return {\n error: 'transaction_not_found',\n error_description:\n 'The requested signature does not exist.',\n }\n }\n const key = await this.dfns.getKey(sig.keyId)\n return toTransaction(sig, key?.publicKey)\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getTransactions: async (\n params: GetTransactionsParams\n ): Promise<GetTransactionsResult> => {\n if (!params.publicKeys && !params.txIds) {\n return {\n error: 'bad_arguments',\n error_description:\n 'Either publicKeys or txIds must be provided.',\n }\n }\n\n try {\n const txIds = new Set(params.txIds || [])\n const publicKeys = new Set(params.publicKeys || [])\n const transactions: Transaction[] = []\n\n for await (const key of this.dfns.iterateKeys()) {\n if (\n params.publicKeys &&\n !publicKeys.has(key.publicKey)\n ) {\n continue\n }\n\n for await (const sig of this.dfns.listSignatures(\n key.id\n )) {\n if (params.txIds && !txIds.has(sig.id)) continue\n transactions.push(toTransaction(sig, key.publicKey))\n\n if (\n params.txIds &&\n !params.publicKeys &&\n transactions.length === txIds.size\n ) {\n return { transactions }\n }\n }\n }\n\n return { transactions }\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getKeys: async (): Promise<GetKeysResult> => {\n try {\n const keys = await this.dfns.listKeys()\n return {\n keys: keys.map((k) => ({\n id: k.id,\n name: k.name,\n publicKey: k.publicKey,\n })),\n }\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n createKey: async (\n params: CreateKeyParams\n ): Promise<CreateKeyResult> => {\n try {\n const key = await this.dfns.createKey(params.name)\n return {\n id: key.id,\n name: key.name,\n publicKey: key.publicKey,\n }\n } catch (error) {\n return {\n error: 'creation_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getConfiguration: async (): Promise<GetConfigurationResult> => ({\n orgId: this.config.orgId,\n baseUrl: this.config.baseUrl,\n credentials: this.config.credentials,\n }),\n\n setConfiguration: async (\n params: SetConfigurationParams\n ): Promise<SetConfigurationResult> => {\n const validated = DfnsConfigSchema.safeParse(params)\n if (!validated.success) {\n return {\n error: 'bad_arguments',\n error_description: validated.error.message,\n }\n }\n\n const newConfig: DfnsConfig = {\n orgId: validated.data.orgId,\n baseUrl: validated.data.baseUrl,\n credentials: validated.data.credentials,\n }\n\n if (!_.isEqual(newConfig, this.config)) {\n this.config = newConfig\n this.dfns = createDfnsHandler(this.config)\n }\n\n return params\n },\n\n subscribeTransactions: async (\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _params: SubscribeTransactionsParams\n ): Promise<SubscribeTransactionsResult> => {\n return Promise.resolve({} as SubscribeTransactionsResult)\n },\n })\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/dfns.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { DfnsApiClient } from '@dfns/sdk'\nimport { AsymmetricKeySigner } from '@dfns/sdk-keysigner'\nimport { SigningStatus } from '@canton-network/core-signing-lib'\nimport { pino } from 'pino'\n\nconst logger = pino({ name: 'dfns-handler', level: 'debug' })\n\nconst DFNS_LIST_PAGE_SIZE = 50\n\n/**\n * Credentials for a Dfns service account. Dfns uses two-layer auth: a\n * long-lived bearer token plus per-request signing with a private key.\n */\nexport interface DfnsCredentials {\n /** ID of the Dfns credential (key) registered against the service account. */\n credId: string\n /**\n * PEM-encoded private key paired with `credId`. Used to sign every\n * sensitive Dfns API request as a U2F-style second factor. Configured\n * once per deployment; not derived from `authToken`.\n */\n privateKey: string\n /**\n * Long-lived service account bearer JWT issued by the Dfns dashboard.\n * Does not auto-expire and is not regenerated from `privateKey`/`credId`.\n * Rotate by issuing a new token in the Dfns dashboard.\n */\n authToken: string\n}\n\nexport interface DfnsKey {\n /** Dfns key id (e.g. `key-...`). */\n id: string\n /** Human-readable name configured on the Dfns key. */\n name: string\n /** ed25519 public key, base64-encoded (Canton format). */\n publicKey: string\n}\n\nexport interface DfnsSignature {\n /** Dfns signature id (used as the txId returned to the gateway). */\n id: string\n /** Dfns key id the signature was produced with. */\n keyId: string\n status: SigningStatus\n /** ed25519 signature, base64-encoded (Canton SIGNATURE_FORMAT_CONCAT). */\n signature?: string\n}\n\nfunction stripHexPrefix(hex: string): string {\n return hex.startsWith('0x') ? hex.slice(2) : hex\n}\n\nfunction hexToBase64(hex: string): string {\n return Buffer.from(stripHexPrefix(hex), 'hex').toString('base64')\n}\n\nfunction base64ToHex(base64: string): string {\n return Buffer.from(base64, 'base64').toString('hex')\n}\n\nfunction isCantonKey(scheme: string, curve: string): boolean {\n return scheme === 'EdDSA' && curve === 'ed25519'\n}\n\nexport class DfnsHandler {\n private client: DfnsApiClient\n private orgId: string\n private baseUrl: string\n // Tracks the key that produced each signature so getSignature can look it\n // up directly. `listKeys` (used by `iterateKeys`) is eventually-consistent\n // — a key created moments ago may not yet appear in the list, so iterating\n // would 404 even though the signature exists under the just-used key.\n private signatureKey = new Map<string, string>()\n\n constructor(orgId: string, baseUrl: string, credentials: DfnsCredentials) {\n this.orgId = orgId\n this.baseUrl = baseUrl\n this.client = this.createClient(credentials)\n }\n\n private createClient(credentials: DfnsCredentials): DfnsApiClient {\n const signer = new AsymmetricKeySigner({\n credId: credentials.credId,\n privateKey: credentials.privateKey,\n })\n\n return new DfnsApiClient({\n orgId: this.orgId,\n authToken: credentials.authToken,\n baseUrl: this.baseUrl,\n signer,\n })\n }\n\n /**\n * Create a raw ed25519 key in Dfns suitable for signing Canton topology\n * and ledger transactions. The key is not bound to a network — chain\n * activation happens on the gateway against its configured validator.\n */\n public async createKey(name: string): Promise<DfnsKey> {\n try {\n const key = await this.client.keys.createKey({\n body: {\n scheme: 'EdDSA',\n curve: 'ed25519',\n name,\n },\n })\n return {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n } catch (error) {\n logger.error(error, 'Error creating Dfns key')\n throw error\n }\n }\n\n public async *iterateKeys(): AsyncGenerator<DfnsKey> {\n let paginationToken: string | undefined\n do {\n const response = await this.client.keys.listKeys({\n query: {\n limit: DFNS_LIST_PAGE_SIZE,\n ...(paginationToken ? { paginationToken } : {}),\n },\n })\n\n for (const key of response.items) {\n if (\n key.status !== 'Active' ||\n !isCantonKey(key.scheme, key.curve)\n ) {\n continue\n }\n yield {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n }\n\n paginationToken = response.nextPageToken\n } while (paginationToken)\n }\n\n public async listKeys(): Promise<DfnsKey[]> {\n const keys: DfnsKey[] = []\n try {\n for await (const key of this.iterateKeys()) {\n keys.push(key)\n }\n } catch (error) {\n logger.error(error, 'Error listing Dfns keys')\n throw error\n }\n return keys\n }\n\n public async getKey(keyId: string): Promise<DfnsKey | undefined> {\n try {\n const key = await this.client.keys.getKey({ keyId })\n if (\n key.status !== 'Active' ||\n !isCantonKey(key.scheme, key.curve)\n ) {\n return undefined\n }\n return {\n id: key.id,\n name: key.name || key.id,\n publicKey: hexToBase64(key.publicKey),\n }\n } catch (error) {\n logger.debug(error, `Key ${keyId} not found`)\n return undefined\n }\n }\n\n /**\n * Resolve a key by base64 ed25519 public key. Iterates Dfns keys —\n * acceptable for first iteration since most deployments hold a single\n * Canton key per credential.\n */\n public async findKeyByPublicKey(\n publicKeyBase64: string\n ): Promise<DfnsKey | undefined> {\n for await (const key of this.iterateKeys()) {\n if (key.publicKey === publicKeyBase64) {\n return key\n }\n }\n return undefined\n }\n\n /**\n * Sign a Canton hash (raw or multihash-framed) by handing the bytes to\n * Dfns's `Message` kind, which signs the supplied hex with raw ed25519 —\n * the same shape Fireblocks's `RAW` operation produces.\n *\n * `kind: 'Hash'` would be the natural fit but its regex caps at 32 bytes,\n * forcing us to strip the multihash prefix; Canton then rejects the\n * resulting signature because it verifies over the full 34-byte\n * multihash, not the digest. Every Canton-tagged kind (Hash/Message/\n * Transaction + `blockchainKind: 'Canton'`) is server-rejected, so we\n * use plain `Message` (no `blockchainKind`) and pass the raw bytes.\n */\n public async signHash(\n keyId: string,\n hashBase64: string,\n externalId?: string\n ): Promise<DfnsSignature> {\n const messageHex = base64ToHex(hashBase64)\n const body = {\n kind: 'Message' as const,\n message: messageHex,\n ...(externalId ? { externalId } : {}),\n }\n return this.submitSignatureRequest(keyId, body)\n }\n\n private async submitSignatureRequest(\n keyId: string,\n body: Parameters<DfnsApiClient['keys']['generateSignature']>[0]['body']\n ): Promise<DfnsSignature> {\n try {\n const result = await this.client.keys.generateSignature({\n keyId,\n body,\n })\n const mapped = this.mapStatus(result.status)\n if (mapped === 'failed' || mapped === 'rejected') {\n logger.error(\n { keyId, result },\n `Dfns signing returned ${result.status}`\n )\n }\n this.signatureKey.set(result.id, keyId)\n return {\n id: result.id,\n keyId,\n status: mapped,\n signature: this.extractSignature(result.signature),\n }\n } catch (error) {\n logger.error(\n { keyId, err: error },\n 'Error generating Dfns signature'\n )\n throw error\n }\n }\n\n public async getSignature(\n keyId: string,\n signatureId: string\n ): Promise<DfnsSignature | undefined> {\n try {\n const result = await this.client.keys.getSignature({\n keyId,\n signatureId,\n })\n return {\n id: result.id,\n keyId,\n status: this.mapStatus(result.status),\n signature: this.extractSignature(result.signature),\n }\n } catch (error) {\n logger.debug(error, `Signature ${signatureId} not found`)\n return undefined\n }\n }\n\n /**\n * Locate a signature by id. Prefers the cached key from the originating\n * sign call — `listKeys` is eventually-consistent, so iterating right\n * after creating a key would miss the signature. Falls back to iteration\n * when the cache misses (e.g. across a gateway restart).\n */\n public async findSignature(\n signatureId: string\n ): Promise<DfnsSignature | undefined> {\n const cachedKeyId = this.signatureKey.get(signatureId)\n if (cachedKeyId) {\n const sig = await this.getSignature(cachedKeyId, signatureId)\n if (sig) return sig\n }\n for await (const key of this.iterateKeys()) {\n if (key.id === cachedKeyId) continue\n const sig = await this.getSignature(key.id, signatureId)\n if (sig) return sig\n }\n return undefined\n }\n\n public async *listSignatures(keyId: string): AsyncGenerator<DfnsSignature> {\n let paginationToken: string | undefined\n do {\n const response = await this.client.keys.listSignatures({\n keyId,\n query: {\n limit: DFNS_LIST_PAGE_SIZE,\n ...(paginationToken ? { paginationToken } : {}),\n },\n })\n\n for (const sig of response.items) {\n yield {\n id: sig.id,\n keyId,\n status: this.mapStatus(sig.status),\n signature: this.extractSignature(sig.signature),\n }\n }\n\n paginationToken = response.nextPageToken\n } while (paginationToken)\n }\n\n private extractSignature(signature?: {\n encoded?: string\n r: string\n s: string\n }): string | undefined {\n if (!signature) return undefined\n // For ed25519, `encoded` is the 64-byte r||s concat in hex; fall back\n // to assembling it from r/s if `encoded` is not populated. Each field\n // may carry an 0x prefix that must be stripped before hex decoding.\n const hex = signature.encoded\n ? stripHexPrefix(signature.encoded)\n : `${stripHexPrefix(signature.r)}${stripHexPrefix(signature.s)}`\n return hexToBase64(hex)\n }\n\n private mapStatus(dfnsStatus: string): SigningStatus {\n switch (dfnsStatus) {\n case 'Signed':\n case 'Confirmed':\n return 'signed'\n case 'Pending':\n case 'Executing':\n return 'pending'\n case 'Rejected':\n return 'rejected'\n case 'Failed':\n return 'failed'\n default:\n logger.warn(`Unknown Dfns signature status: ${dfnsStatus}`)\n return 'pending'\n }\n }\n}\n","// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport {\n buildController,\n PartyMode,\n SigningDriverInterface,\n SigningProvider,\n} from '@canton-network/core-signing-lib'\n\nimport {\n SignTransactionParams,\n SignTransactionResult,\n GetTransactionParams,\n GetTransactionResult,\n GetTransactionsResult,\n GetTransactionsParams,\n GetKeysResult,\n CreateKeyParams,\n CreateKeyResult,\n GetConfigurationResult,\n SetConfigurationParams,\n SubscribeTransactionsParams,\n SubscribeTransactionsResult,\n SetConfigurationResult,\n Transaction,\n} from '@canton-network/core-signing-lib'\nimport { DfnsHandler, DfnsCredentials, DfnsSignature } from './dfns.js'\nimport { AuthContext } from '@canton-network/core-wallet-auth'\nimport _ from 'lodash'\nimport { z } from 'zod'\n\nexport type { DfnsCredentials, DfnsKey, DfnsSignature } from './dfns.js'\nexport { DfnsHandler } from './dfns.js'\n\nexport interface DfnsConfig {\n orgId: string\n baseUrl: string\n credentials: DfnsCredentials\n}\n\nconst DfnsCredentialsSchema = z.object({\n credId: z.string().min(1),\n privateKey: z.string().min(1),\n authToken: z.string().min(1),\n})\n\nconst DfnsConfigSchema = z.object({\n orgId: z.string().min(1),\n baseUrl: z.string().url(),\n credentials: DfnsCredentialsSchema,\n})\n\nconst createDfnsHandler = (config: DfnsConfig): DfnsHandler =>\n new DfnsHandler(config.orgId, config.baseUrl, config.credentials)\n\nfunction toTransaction(sig: DfnsSignature, publicKey?: string): Transaction {\n const tx: Transaction = {\n txId: sig.id,\n status: sig.status,\n }\n if (sig.signature) tx.signature = sig.signature\n if (publicKey) tx.publicKey = publicKey\n return tx\n}\n\nexport default class DfnsSigningDriver implements SigningDriverInterface {\n private dfns: DfnsHandler\n private config: DfnsConfig\n\n constructor(config: DfnsConfig) {\n this.config = config\n this.dfns = createDfnsHandler(config)\n }\n\n public partyMode = PartyMode.EXTERNAL\n public signingProvider = SigningProvider.DFNS\n\n private async resolveKeyId(keyIdentifier: {\n id?: string\n publicKey?: string\n }): Promise<string | undefined> {\n if (keyIdentifier.id) return keyIdentifier.id\n if (!keyIdentifier.publicKey) return undefined\n\n const key = await this.dfns.findKeyByPublicKey(keyIdentifier.publicKey)\n return key?.id\n }\n\n public controller = (\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _userId: AuthContext['userId'] | undefined\n ) =>\n buildController({\n signTransaction: async (\n params: SignTransactionParams\n ): Promise<SignTransactionResult> => {\n try {\n const keyId = await this.resolveKeyId(params.keyIdentifier)\n if (!keyId) {\n return {\n error: 'key_not_found',\n error_description:\n 'No Dfns key found for the provided key identifier.',\n }\n }\n\n if (!params.txHash) {\n return {\n error: 'bad_arguments',\n error_description:\n 'txHash is required to sign with Dfns.',\n }\n }\n\n const sig = await this.dfns.signHash(\n keyId,\n params.txHash,\n params.internalTxId\n )\n\n return toTransaction(sig, params.keyIdentifier.publicKey)\n } catch (error) {\n return {\n error: 'signing_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getTransaction: async (\n params: GetTransactionParams\n ): Promise<GetTransactionResult> => {\n try {\n const sig = await this.dfns.findSignature(params.txId)\n if (!sig) {\n return {\n error: 'transaction_not_found',\n error_description:\n 'The requested signature does not exist.',\n }\n }\n const key = await this.dfns.getKey(sig.keyId)\n return toTransaction(sig, key?.publicKey)\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getTransactions: async (\n params: GetTransactionsParams\n ): Promise<GetTransactionsResult> => {\n if (!params.publicKeys && !params.txIds) {\n return {\n error: 'bad_arguments',\n error_description:\n 'Either publicKeys or txIds must be provided.',\n }\n }\n\n try {\n const txIds = new Set(params.txIds || [])\n const publicKeys = new Set(params.publicKeys || [])\n const transactions: Transaction[] = []\n\n for await (const key of this.dfns.iterateKeys()) {\n if (\n params.publicKeys &&\n !publicKeys.has(key.publicKey)\n ) {\n continue\n }\n\n for await (const sig of this.dfns.listSignatures(\n key.id\n )) {\n if (params.txIds && !txIds.has(sig.id)) continue\n transactions.push(toTransaction(sig, key.publicKey))\n\n if (\n params.txIds &&\n !params.publicKeys &&\n transactions.length === txIds.size\n ) {\n return { transactions }\n }\n }\n }\n\n return { transactions }\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getKeys: async (): Promise<GetKeysResult> => {\n try {\n const keys = await this.dfns.listKeys()\n return {\n keys: keys.map((k) => ({\n id: k.id,\n name: k.name,\n publicKey: k.publicKey,\n })),\n }\n } catch (error) {\n return {\n error: 'fetch_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n createKey: async (\n params: CreateKeyParams\n ): Promise<CreateKeyResult> => {\n try {\n const key = await this.dfns.createKey(params.name)\n return {\n id: key.id,\n name: key.name,\n publicKey: key.publicKey,\n }\n } catch (error) {\n return {\n error: 'creation_error',\n error_description: (error as Error).message,\n }\n }\n },\n\n getConfiguration: async (): Promise<GetConfigurationResult> => ({\n orgId: this.config.orgId,\n baseUrl: this.config.baseUrl,\n credentials: this.config.credentials,\n }),\n\n setConfiguration: async (\n params: SetConfigurationParams\n ): Promise<SetConfigurationResult> => {\n const validated = DfnsConfigSchema.safeParse(params)\n if (!validated.success) {\n return {\n error: 'bad_arguments',\n error_description: validated.error.message,\n }\n }\n\n const newConfig: DfnsConfig = {\n orgId: validated.data.orgId,\n baseUrl: validated.data.baseUrl,\n credentials: validated.data.credentials,\n }\n\n if (!_.isEqual(newConfig, this.config)) {\n this.config = newConfig\n this.dfns = createDfnsHandler(this.config)\n }\n\n return params\n },\n\n subscribeTransactions: async (\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n _params: SubscribeTransactionsParams\n ): Promise<SubscribeTransactionsResult> => {\n return Promise.resolve({} as SubscribeTransactionsResult)\n },\n })\n}\n"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@canton-network/core-signing-dfns",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.1",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Dfns signing driver for Canton Network Wallet Gateway",
|
|
6
6
|
"license": "Apache-2.0",
|
|
@@ -24,8 +24,8 @@
|
|
|
24
24
|
"test": "jest"
|
|
25
25
|
},
|
|
26
26
|
"dependencies": {
|
|
27
|
-
"@canton-network/core-signing-lib": "^1.2.
|
|
28
|
-
"@canton-network/core-wallet-auth": "^1.2.
|
|
27
|
+
"@canton-network/core-signing-lib": "^1.2.3",
|
|
28
|
+
"@canton-network/core-wallet-auth": "^1.2.3",
|
|
29
29
|
"@dfns/sdk": "^0.8.9",
|
|
30
30
|
"@dfns/sdk-keysigner": "^0.8.9",
|
|
31
31
|
"lodash": "^4.17.21",
|