@solana/keys 2.0.0-experimental.0a6605f → 2.0.0-experimental.0af01ac
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/LICENSE +1 -1
- package/README.md +58 -22
- package/dist/index.browser.cjs +124 -116
- package/dist/index.browser.cjs.map +1 -1
- package/dist/index.browser.js +117 -110
- package/dist/index.browser.js.map +1 -1
- package/dist/index.native.js +118 -98
- package/dist/index.native.js.map +1 -1
- package/dist/index.node.cjs +125 -104
- package/dist/index.node.cjs.map +1 -1
- package/dist/index.node.js +118 -98
- package/dist/index.node.js.map +1 -1
- package/dist/types/index.d.ts +3 -4
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/key-pair.d.ts +1 -0
- package/dist/types/key-pair.d.ts.map +1 -0
- package/dist/types/private-key.d.ts +2 -0
- package/dist/types/private-key.d.ts.map +1 -0
- package/dist/types/signatures.d.ts +10 -4
- package/dist/types/signatures.d.ts.map +1 -0
- package/package.json +17 -38
- package/dist/index.development.js +0 -418
- package/dist/index.development.js.map +0 -1
- package/dist/index.production.min.js +0 -21
- package/dist/types/base58.d.ts +0 -10
- package/dist/types/guard.d.ts +0 -5
- package/dist/types/pubkey.d.ts +0 -3
package/dist/index.node.cjs
CHANGED
|
@@ -1,97 +1,69 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var
|
|
3
|
+
var assertions = require('@solana/assertions');
|
|
4
|
+
var errors = require('@solana/errors');
|
|
5
|
+
var codecsStrings = require('@solana/codecs-strings');
|
|
4
6
|
|
|
5
|
-
//
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
).catch(() => {
|
|
54
|
-
resolve(cachedEd25519Decision = false);
|
|
55
|
-
}).then(() => {
|
|
56
|
-
resolve(cachedEd25519Decision = true);
|
|
57
|
-
});
|
|
58
|
-
});
|
|
59
|
-
}
|
|
60
|
-
if (typeof cachedEd25519Decision === "boolean") {
|
|
61
|
-
return cachedEd25519Decision;
|
|
62
|
-
} else {
|
|
63
|
-
return await cachedEd25519Decision;
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
async function assertKeyGenerationIsAvailable() {
|
|
67
|
-
if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.generateKey !== "function") {
|
|
68
|
-
throw new Error("No key generation implementation could be found");
|
|
69
|
-
}
|
|
70
|
-
if (!await isEd25519CurveSupported(globalThis.crypto.subtle)) {
|
|
71
|
-
throw new Error(
|
|
72
|
-
"This runtime does not support the generation of Ed25519 key pairs.\n\nInstall and import `@solana/webcrypto-ed25519-polyfill` before generating keys in environments that do not support Ed25519.\n\nFor a list of runtimes that currently support Ed25519 operations, visit https://github.com/WICG/webcrypto-secure-curves/issues/20"
|
|
73
|
-
);
|
|
74
|
-
}
|
|
75
|
-
}
|
|
76
|
-
async function assertKeyExporterIsAvailable() {
|
|
77
|
-
if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.exportKey !== "function") {
|
|
78
|
-
throw new Error("No key export implementation could be found");
|
|
79
|
-
}
|
|
80
|
-
}
|
|
81
|
-
async function assertSigningCapabilityIsAvailable() {
|
|
82
|
-
if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.sign !== "function") {
|
|
83
|
-
throw new Error("No signing implementation could be found");
|
|
84
|
-
}
|
|
7
|
+
// src/key-pair.ts
|
|
8
|
+
|
|
9
|
+
// src/private-key.ts
|
|
10
|
+
function addPkcs8Header(bytes) {
|
|
11
|
+
return new Uint8Array([
|
|
12
|
+
/**
|
|
13
|
+
* PKCS#8 header
|
|
14
|
+
*/
|
|
15
|
+
48,
|
|
16
|
+
// ASN.1 sequence tag
|
|
17
|
+
46,
|
|
18
|
+
// Length of sequence (46 more bytes)
|
|
19
|
+
2,
|
|
20
|
+
// ASN.1 integer tag
|
|
21
|
+
1,
|
|
22
|
+
// Length of integer
|
|
23
|
+
0,
|
|
24
|
+
// Version number
|
|
25
|
+
48,
|
|
26
|
+
// ASN.1 sequence tag
|
|
27
|
+
5,
|
|
28
|
+
// Length of sequence
|
|
29
|
+
6,
|
|
30
|
+
// ASN.1 object identifier tag
|
|
31
|
+
3,
|
|
32
|
+
// Length of object identifier
|
|
33
|
+
// Edwards curve algorithms identifier https://oid-rep.orange-labs.fr/get/1.3.101.112
|
|
34
|
+
43,
|
|
35
|
+
// iso(1) / identified-organization(3) (The first node is multiplied by the decimal 40 and the result is added to the value of the second node)
|
|
36
|
+
101,
|
|
37
|
+
// thawte(101)
|
|
38
|
+
// Ed25519 identifier
|
|
39
|
+
112,
|
|
40
|
+
// id-Ed25519(112)
|
|
41
|
+
/**
|
|
42
|
+
* Private key payload
|
|
43
|
+
*/
|
|
44
|
+
4,
|
|
45
|
+
// ASN.1 octet string tag
|
|
46
|
+
34,
|
|
47
|
+
// String length (34 more bytes)
|
|
48
|
+
// Private key bytes as octet string
|
|
49
|
+
4,
|
|
50
|
+
// ASN.1 octet string tag
|
|
51
|
+
32,
|
|
52
|
+
// String length (32 bytes)
|
|
53
|
+
...bytes
|
|
54
|
+
]);
|
|
85
55
|
}
|
|
86
|
-
async function
|
|
87
|
-
if (
|
|
88
|
-
throw new Error("
|
|
56
|
+
async function createPrivateKeyFromBytes(bytes, extractable) {
|
|
57
|
+
if (bytes.byteLength !== 32) {
|
|
58
|
+
throw new Error("Private key bytes must be of length 32");
|
|
89
59
|
}
|
|
60
|
+
const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
|
|
61
|
+
return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
|
|
90
62
|
}
|
|
91
63
|
|
|
92
64
|
// src/key-pair.ts
|
|
93
65
|
async function generateKeyPair() {
|
|
94
|
-
await assertKeyGenerationIsAvailable();
|
|
66
|
+
await assertions.assertKeyGenerationIsAvailable();
|
|
95
67
|
const keyPair = await crypto.subtle.generateKey(
|
|
96
68
|
/* algorithm */
|
|
97
69
|
"Ed25519",
|
|
@@ -104,35 +76,84 @@ async function generateKeyPair() {
|
|
|
104
76
|
);
|
|
105
77
|
return keyPair;
|
|
106
78
|
}
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
await assertKeyExporterIsAvailable();
|
|
111
|
-
if (publicKey.type !== "public" || publicKey.algorithm.name !== "Ed25519") {
|
|
112
|
-
throw new Error("The `CryptoKey` must be an `Ed25519` public key");
|
|
79
|
+
async function createKeyPairFromBytes(bytes, extractable) {
|
|
80
|
+
if (bytes.byteLength !== 64) {
|
|
81
|
+
throw new errors.SolanaError(errors.SOLANA_ERROR__INVALID_KEYPAIR_BYTES, { byteLength: bytes.byteLength });
|
|
113
82
|
}
|
|
114
|
-
const
|
|
115
|
-
|
|
116
|
-
|
|
83
|
+
const [publicKey, privateKey] = await Promise.all([
|
|
84
|
+
crypto.subtle.importKey(
|
|
85
|
+
"raw",
|
|
86
|
+
bytes.slice(32),
|
|
87
|
+
"Ed25519",
|
|
88
|
+
/* extractable */
|
|
89
|
+
true,
|
|
90
|
+
["verify"]
|
|
91
|
+
),
|
|
92
|
+
createPrivateKeyFromBytes(bytes.slice(0, 32), extractable)
|
|
93
|
+
]);
|
|
94
|
+
return { privateKey, publicKey };
|
|
95
|
+
}
|
|
96
|
+
var base58Encoder;
|
|
97
|
+
function assertIsSignature(putativeSignature) {
|
|
98
|
+
if (!base58Encoder)
|
|
99
|
+
base58Encoder = codecsStrings.getBase58Encoder();
|
|
100
|
+
try {
|
|
101
|
+
if (
|
|
102
|
+
// Lowest value (64 bytes of zeroes)
|
|
103
|
+
putativeSignature.length < 64 || // Highest value (64 bytes of 255)
|
|
104
|
+
putativeSignature.length > 88
|
|
105
|
+
) {
|
|
106
|
+
throw new Error("Expected input string to decode to a byte array of length 64.");
|
|
107
|
+
}
|
|
108
|
+
const bytes = base58Encoder.encode(putativeSignature);
|
|
109
|
+
const numBytes = bytes.byteLength;
|
|
110
|
+
if (numBytes !== 64) {
|
|
111
|
+
throw new Error(`Expected input string to decode to a byte array of length 64. Actual length: ${numBytes}`);
|
|
112
|
+
}
|
|
113
|
+
} catch (e) {
|
|
114
|
+
throw new Error(`\`${putativeSignature}\` is not a signature`, {
|
|
115
|
+
cause: e
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
function isSignature(putativeSignature) {
|
|
120
|
+
if (!base58Encoder)
|
|
121
|
+
base58Encoder = codecsStrings.getBase58Encoder();
|
|
122
|
+
if (
|
|
123
|
+
// Lowest value (64 bytes of zeroes)
|
|
124
|
+
putativeSignature.length < 64 || // Highest value (64 bytes of 255)
|
|
125
|
+
putativeSignature.length > 88
|
|
126
|
+
) {
|
|
127
|
+
return false;
|
|
128
|
+
}
|
|
129
|
+
const bytes = base58Encoder.encode(putativeSignature);
|
|
130
|
+
const numBytes = bytes.byteLength;
|
|
131
|
+
if (numBytes !== 64) {
|
|
132
|
+
return false;
|
|
133
|
+
}
|
|
134
|
+
return true;
|
|
117
135
|
}
|
|
118
|
-
|
|
119
|
-
// src/signatures.ts
|
|
120
136
|
async function signBytes(key, data) {
|
|
121
|
-
await assertSigningCapabilityIsAvailable();
|
|
137
|
+
await assertions.assertSigningCapabilityIsAvailable();
|
|
122
138
|
const signedData = await crypto.subtle.sign("Ed25519", key, data);
|
|
123
139
|
return new Uint8Array(signedData);
|
|
124
140
|
}
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
return
|
|
141
|
+
function signature(putativeSignature) {
|
|
142
|
+
assertIsSignature(putativeSignature);
|
|
143
|
+
return putativeSignature;
|
|
144
|
+
}
|
|
145
|
+
async function verifySignature(key, signature2, data) {
|
|
146
|
+
await assertions.assertVerificationCapabilityIsAvailable();
|
|
147
|
+
return await crypto.subtle.verify("Ed25519", key, signature2, data);
|
|
128
148
|
}
|
|
129
149
|
|
|
130
|
-
exports.
|
|
150
|
+
exports.assertIsSignature = assertIsSignature;
|
|
151
|
+
exports.createKeyPairFromBytes = createKeyPairFromBytes;
|
|
152
|
+
exports.createPrivateKeyFromBytes = createPrivateKeyFromBytes;
|
|
131
153
|
exports.generateKeyPair = generateKeyPair;
|
|
132
|
-
exports.
|
|
133
|
-
exports.getBase58EncodedAddressComparator = getBase58EncodedAddressComparator;
|
|
134
|
-
exports.getBase58EncodedAddressFromPublicKey = getBase58EncodedAddressFromPublicKey;
|
|
154
|
+
exports.isSignature = isSignature;
|
|
135
155
|
exports.signBytes = signBytes;
|
|
156
|
+
exports.signature = signature;
|
|
136
157
|
exports.verifySignature = verifySignature;
|
|
137
158
|
//# sourceMappingURL=out.js.map
|
|
138
159
|
//# sourceMappingURL=index.node.cjs.map
|
package/dist/index.node.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["
|
|
1
|
+
{"version":3,"sources":["../src/key-pair.ts","../src/private-key.ts","../src/signatures.ts"],"names":["signature"],"mappings":"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","sourcesContent":["import { assertKeyGenerationIsAvailable } from '@solana/assertions';\nimport { SOLANA_ERROR__INVALID_KEYPAIR_BYTES, SolanaError } from '@solana/errors';\n\nimport { createPrivateKeyFromBytes } from './private-key';\n\nexport async function generateKeyPair(): Promise<CryptoKeyPair> {\n await assertKeyGenerationIsAvailable();\n const keyPair = await crypto.subtle.generateKey(\n /* algorithm */ 'Ed25519', // Native implementation status: https://github.com/WICG/webcrypto-secure-curves/issues/20\n /* extractable */ false, // Prevents the bytes of the private key from being visible to JS.\n /* allowed uses */ ['sign', 'verify'],\n );\n return keyPair as CryptoKeyPair;\n}\n\nexport async function createKeyPairFromBytes(bytes: Uint8Array, extractable?: boolean): Promise<CryptoKeyPair> {\n if (bytes.byteLength !== 64) {\n throw new SolanaError(SOLANA_ERROR__INVALID_KEYPAIR_BYTES, { byteLength: bytes.byteLength });\n }\n const [publicKey, privateKey] = await Promise.all([\n crypto.subtle.importKey('raw', bytes.slice(32), 'Ed25519', /* extractable */ true, ['verify']),\n createPrivateKeyFromBytes(bytes.slice(0, 32), extractable),\n ]);\n return { privateKey, publicKey } as CryptoKeyPair;\n}\n","function addPkcs8Header(bytes: Uint8Array): Uint8Array {\n // prettier-ignore\n return new Uint8Array([\n /**\n * PKCS#8 header\n */\n 0x30, // ASN.1 sequence tag\n 0x2e, // Length of sequence (46 more bytes)\n\n 0x02, // ASN.1 integer tag\n 0x01, // Length of integer\n 0x00, // Version number\n\n 0x30, // ASN.1 sequence tag\n 0x05, // Length of sequence\n 0x06, // ASN.1 object identifier tag\n 0x03, // Length of object identifier\n // Edwards curve algorithms identifier https://oid-rep.orange-labs.fr/get/1.3.101.112\n 0x2b, // iso(1) / identified-organization(3) (The first node is multiplied by the decimal 40 and the result is added to the value of the second node)\n 0x65, // thawte(101)\n // Ed25519 identifier\n 0x70, // id-Ed25519(112)\n\n /**\n * Private key payload\n */\n 0x04, // ASN.1 octet string tag\n 0x22, // String length (34 more bytes)\n\n // Private key bytes as octet string\n 0x04, // ASN.1 octet string tag\n 0x20, // String length (32 bytes)\n\n ...bytes\n ]);\n}\n\nexport async function createPrivateKeyFromBytes(bytes: Uint8Array, extractable?: boolean): Promise<CryptoKey> {\n if (bytes.byteLength !== 32) {\n // TODO: Coded error.\n throw new Error('Private key bytes must be of length 32');\n }\n const privateKeyBytesPkcs8 = addPkcs8Header(bytes);\n return await crypto.subtle.importKey('pkcs8', privateKeyBytesPkcs8, 'Ed25519', extractable ?? false, ['sign']);\n}\n","import { assertSigningCapabilityIsAvailable, assertVerificationCapabilityIsAvailable } from '@solana/assertions';\nimport { Encoder } from '@solana/codecs-core';\nimport { getBase58Encoder } from '@solana/codecs-strings';\n\nexport type Signature = string & { readonly __brand: unique symbol };\nexport type SignatureBytes = Uint8Array & { readonly __brand: unique symbol };\n\nlet base58Encoder: Encoder<string> | undefined;\n\nexport function assertIsSignature(putativeSignature: string): asserts putativeSignature is Signature {\n if (!base58Encoder) base58Encoder = getBase58Encoder();\n\n try {\n // Fast-path; see if the input string is of an acceptable length.\n if (\n // Lowest value (64 bytes of zeroes)\n putativeSignature.length < 64 ||\n // Highest value (64 bytes of 255)\n putativeSignature.length > 88\n ) {\n throw new Error('Expected input string to decode to a byte array of length 64.');\n }\n // Slow-path; actually attempt to decode the input string.\n const bytes = base58Encoder.encode(putativeSignature);\n const numBytes = bytes.byteLength;\n if (numBytes !== 64) {\n throw new Error(`Expected input string to decode to a byte array of length 64. Actual length: ${numBytes}`);\n }\n } catch (e) {\n throw new Error(`\\`${putativeSignature}\\` is not a signature`, {\n cause: e,\n });\n }\n}\n\nexport function isSignature(putativeSignature: string): putativeSignature is Signature {\n if (!base58Encoder) base58Encoder = getBase58Encoder();\n\n // Fast-path; see if the input string is of an acceptable length.\n if (\n // Lowest value (64 bytes of zeroes)\n putativeSignature.length < 64 ||\n // Highest value (64 bytes of 255)\n putativeSignature.length > 88\n ) {\n return false;\n }\n // Slow-path; actually attempt to decode the input string.\n const bytes = base58Encoder.encode(putativeSignature);\n const numBytes = bytes.byteLength;\n if (numBytes !== 64) {\n return false;\n }\n return true;\n}\n\nexport async function signBytes(key: CryptoKey, data: Uint8Array): Promise<SignatureBytes> {\n await assertSigningCapabilityIsAvailable();\n const signedData = await crypto.subtle.sign('Ed25519', key, data);\n return new Uint8Array(signedData) as SignatureBytes;\n}\n\nexport function signature(putativeSignature: string): Signature {\n assertIsSignature(putativeSignature);\n return putativeSignature;\n}\n\nexport async function verifySignature(key: CryptoKey, signature: SignatureBytes, data: Uint8Array): Promise<boolean> {\n await assertVerificationCapabilityIsAvailable();\n return await crypto.subtle.verify('Ed25519', key, signature, data);\n}\n"]}
|
package/dist/index.node.js
CHANGED
|
@@ -1,90 +1,62 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { assertKeyGenerationIsAvailable, assertSigningCapabilityIsAvailable, assertVerificationCapabilityIsAvailable } from '@solana/assertions';
|
|
2
|
+
import { SolanaError, SOLANA_ERROR__INVALID_KEYPAIR_BYTES } from '@solana/errors';
|
|
3
|
+
import { getBase58Encoder } from '@solana/codecs-strings';
|
|
2
4
|
|
|
3
|
-
//
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
).catch(() => {
|
|
52
|
-
resolve(cachedEd25519Decision = false);
|
|
53
|
-
}).then(() => {
|
|
54
|
-
resolve(cachedEd25519Decision = true);
|
|
55
|
-
});
|
|
56
|
-
});
|
|
57
|
-
}
|
|
58
|
-
if (typeof cachedEd25519Decision === "boolean") {
|
|
59
|
-
return cachedEd25519Decision;
|
|
60
|
-
} else {
|
|
61
|
-
return await cachedEd25519Decision;
|
|
62
|
-
}
|
|
63
|
-
}
|
|
64
|
-
async function assertKeyGenerationIsAvailable() {
|
|
65
|
-
if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.generateKey !== "function") {
|
|
66
|
-
throw new Error("No key generation implementation could be found");
|
|
67
|
-
}
|
|
68
|
-
if (!await isEd25519CurveSupported(globalThis.crypto.subtle)) {
|
|
69
|
-
throw new Error(
|
|
70
|
-
"This runtime does not support the generation of Ed25519 key pairs.\n\nInstall and import `@solana/webcrypto-ed25519-polyfill` before generating keys in environments that do not support Ed25519.\n\nFor a list of runtimes that currently support Ed25519 operations, visit https://github.com/WICG/webcrypto-secure-curves/issues/20"
|
|
71
|
-
);
|
|
72
|
-
}
|
|
73
|
-
}
|
|
74
|
-
async function assertKeyExporterIsAvailable() {
|
|
75
|
-
if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.exportKey !== "function") {
|
|
76
|
-
throw new Error("No key export implementation could be found");
|
|
77
|
-
}
|
|
78
|
-
}
|
|
79
|
-
async function assertSigningCapabilityIsAvailable() {
|
|
80
|
-
if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.sign !== "function") {
|
|
81
|
-
throw new Error("No signing implementation could be found");
|
|
82
|
-
}
|
|
5
|
+
// src/key-pair.ts
|
|
6
|
+
|
|
7
|
+
// src/private-key.ts
|
|
8
|
+
function addPkcs8Header(bytes) {
|
|
9
|
+
return new Uint8Array([
|
|
10
|
+
/**
|
|
11
|
+
* PKCS#8 header
|
|
12
|
+
*/
|
|
13
|
+
48,
|
|
14
|
+
// ASN.1 sequence tag
|
|
15
|
+
46,
|
|
16
|
+
// Length of sequence (46 more bytes)
|
|
17
|
+
2,
|
|
18
|
+
// ASN.1 integer tag
|
|
19
|
+
1,
|
|
20
|
+
// Length of integer
|
|
21
|
+
0,
|
|
22
|
+
// Version number
|
|
23
|
+
48,
|
|
24
|
+
// ASN.1 sequence tag
|
|
25
|
+
5,
|
|
26
|
+
// Length of sequence
|
|
27
|
+
6,
|
|
28
|
+
// ASN.1 object identifier tag
|
|
29
|
+
3,
|
|
30
|
+
// Length of object identifier
|
|
31
|
+
// Edwards curve algorithms identifier https://oid-rep.orange-labs.fr/get/1.3.101.112
|
|
32
|
+
43,
|
|
33
|
+
// iso(1) / identified-organization(3) (The first node is multiplied by the decimal 40 and the result is added to the value of the second node)
|
|
34
|
+
101,
|
|
35
|
+
// thawte(101)
|
|
36
|
+
// Ed25519 identifier
|
|
37
|
+
112,
|
|
38
|
+
// id-Ed25519(112)
|
|
39
|
+
/**
|
|
40
|
+
* Private key payload
|
|
41
|
+
*/
|
|
42
|
+
4,
|
|
43
|
+
// ASN.1 octet string tag
|
|
44
|
+
34,
|
|
45
|
+
// String length (34 more bytes)
|
|
46
|
+
// Private key bytes as octet string
|
|
47
|
+
4,
|
|
48
|
+
// ASN.1 octet string tag
|
|
49
|
+
32,
|
|
50
|
+
// String length (32 bytes)
|
|
51
|
+
...bytes
|
|
52
|
+
]);
|
|
83
53
|
}
|
|
84
|
-
async function
|
|
85
|
-
if (
|
|
86
|
-
throw new Error("
|
|
54
|
+
async function createPrivateKeyFromBytes(bytes, extractable) {
|
|
55
|
+
if (bytes.byteLength !== 32) {
|
|
56
|
+
throw new Error("Private key bytes must be of length 32");
|
|
87
57
|
}
|
|
58
|
+
const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
|
|
59
|
+
return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
|
|
88
60
|
}
|
|
89
61
|
|
|
90
62
|
// src/key-pair.ts
|
|
@@ -102,29 +74,77 @@ async function generateKeyPair() {
|
|
|
102
74
|
);
|
|
103
75
|
return keyPair;
|
|
104
76
|
}
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
await assertKeyExporterIsAvailable();
|
|
109
|
-
if (publicKey.type !== "public" || publicKey.algorithm.name !== "Ed25519") {
|
|
110
|
-
throw new Error("The `CryptoKey` must be an `Ed25519` public key");
|
|
77
|
+
async function createKeyPairFromBytes(bytes, extractable) {
|
|
78
|
+
if (bytes.byteLength !== 64) {
|
|
79
|
+
throw new SolanaError(SOLANA_ERROR__INVALID_KEYPAIR_BYTES, { byteLength: bytes.byteLength });
|
|
111
80
|
}
|
|
112
|
-
const
|
|
113
|
-
|
|
114
|
-
|
|
81
|
+
const [publicKey, privateKey] = await Promise.all([
|
|
82
|
+
crypto.subtle.importKey(
|
|
83
|
+
"raw",
|
|
84
|
+
bytes.slice(32),
|
|
85
|
+
"Ed25519",
|
|
86
|
+
/* extractable */
|
|
87
|
+
true,
|
|
88
|
+
["verify"]
|
|
89
|
+
),
|
|
90
|
+
createPrivateKeyFromBytes(bytes.slice(0, 32), extractable)
|
|
91
|
+
]);
|
|
92
|
+
return { privateKey, publicKey };
|
|
93
|
+
}
|
|
94
|
+
var base58Encoder;
|
|
95
|
+
function assertIsSignature(putativeSignature) {
|
|
96
|
+
if (!base58Encoder)
|
|
97
|
+
base58Encoder = getBase58Encoder();
|
|
98
|
+
try {
|
|
99
|
+
if (
|
|
100
|
+
// Lowest value (64 bytes of zeroes)
|
|
101
|
+
putativeSignature.length < 64 || // Highest value (64 bytes of 255)
|
|
102
|
+
putativeSignature.length > 88
|
|
103
|
+
) {
|
|
104
|
+
throw new Error("Expected input string to decode to a byte array of length 64.");
|
|
105
|
+
}
|
|
106
|
+
const bytes = base58Encoder.encode(putativeSignature);
|
|
107
|
+
const numBytes = bytes.byteLength;
|
|
108
|
+
if (numBytes !== 64) {
|
|
109
|
+
throw new Error(`Expected input string to decode to a byte array of length 64. Actual length: ${numBytes}`);
|
|
110
|
+
}
|
|
111
|
+
} catch (e) {
|
|
112
|
+
throw new Error(`\`${putativeSignature}\` is not a signature`, {
|
|
113
|
+
cause: e
|
|
114
|
+
});
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
function isSignature(putativeSignature) {
|
|
118
|
+
if (!base58Encoder)
|
|
119
|
+
base58Encoder = getBase58Encoder();
|
|
120
|
+
if (
|
|
121
|
+
// Lowest value (64 bytes of zeroes)
|
|
122
|
+
putativeSignature.length < 64 || // Highest value (64 bytes of 255)
|
|
123
|
+
putativeSignature.length > 88
|
|
124
|
+
) {
|
|
125
|
+
return false;
|
|
126
|
+
}
|
|
127
|
+
const bytes = base58Encoder.encode(putativeSignature);
|
|
128
|
+
const numBytes = bytes.byteLength;
|
|
129
|
+
if (numBytes !== 64) {
|
|
130
|
+
return false;
|
|
131
|
+
}
|
|
132
|
+
return true;
|
|
115
133
|
}
|
|
116
|
-
|
|
117
|
-
// src/signatures.ts
|
|
118
134
|
async function signBytes(key, data) {
|
|
119
135
|
await assertSigningCapabilityIsAvailable();
|
|
120
136
|
const signedData = await crypto.subtle.sign("Ed25519", key, data);
|
|
121
137
|
return new Uint8Array(signedData);
|
|
122
138
|
}
|
|
123
|
-
|
|
139
|
+
function signature(putativeSignature) {
|
|
140
|
+
assertIsSignature(putativeSignature);
|
|
141
|
+
return putativeSignature;
|
|
142
|
+
}
|
|
143
|
+
async function verifySignature(key, signature2, data) {
|
|
124
144
|
await assertVerificationCapabilityIsAvailable();
|
|
125
|
-
return await crypto.subtle.verify("Ed25519", key,
|
|
145
|
+
return await crypto.subtle.verify("Ed25519", key, signature2, data);
|
|
126
146
|
}
|
|
127
147
|
|
|
128
|
-
export {
|
|
148
|
+
export { assertIsSignature, createKeyPairFromBytes, createPrivateKeyFromBytes, generateKeyPair, isSignature, signBytes, signature, verifySignature };
|
|
129
149
|
//# sourceMappingURL=out.js.map
|
|
130
150
|
//# sourceMappingURL=index.node.js.map
|