@solana/keys 2.0.0-experimental.df45965 → 2.0.0-experimental.dfb72ea
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +79 -2
- package/dist/index.browser.cjs +127 -2
- package/dist/index.browser.cjs.map +1 -1
- package/dist/index.browser.js +123 -3
- package/dist/index.browser.js.map +1 -1
- package/dist/index.native.js +123 -3
- package/dist/index.native.js.map +1 -1
- package/dist/index.node.cjs +127 -2
- package/dist/index.node.cjs.map +1 -1
- package/dist/index.node.js +123 -3
- package/dist/index.node.js.map +1 -1
- package/dist/types/index.d.ts +3 -2
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/key-pair.d.ts +1 -0
- package/dist/types/key-pair.d.ts.map +1 -1
- 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 +9 -3
- package/dist/types/signatures.d.ts.map +1 -1
- package/package.json +14 -32
- package/dist/index.development.js +0 -94
- package/dist/index.development.js.map +0 -1
- package/dist/index.production.min.js +0 -17
package/README.md
CHANGED
|
@@ -18,7 +18,11 @@ This package contains utilities for validating, generating, and manipulating add
|
|
|
18
18
|
|
|
19
19
|
## Types
|
|
20
20
|
|
|
21
|
-
### `
|
|
21
|
+
### `Signature`
|
|
22
|
+
|
|
23
|
+
This type represents a 64-byte Ed25519 signature of some data with a private key, as a base58-encoded string.
|
|
24
|
+
|
|
25
|
+
### `SignatureBytes`
|
|
22
26
|
|
|
23
27
|
This type represents a 64-byte Ed25519 signature of some data with a private key.
|
|
24
28
|
|
|
@@ -26,6 +30,31 @@ Whenever you need to verify that a particular signature is, in fact, the one tha
|
|
|
26
30
|
|
|
27
31
|
## Functions
|
|
28
32
|
|
|
33
|
+
### `assertIsSignature()`
|
|
34
|
+
|
|
35
|
+
From time to time you might acquire a string that you expect to be a base58-encoded signature (eg. of a transaction) from an untrusted network API or user input. To assert that such an arbitrary string is in fact an Ed25519 signature, use the `assertIsSignature` function.
|
|
36
|
+
|
|
37
|
+
```ts
|
|
38
|
+
import { assertIsSignature } from '@solana/keys';
|
|
39
|
+
|
|
40
|
+
// Imagine a function that asserts whether a user-supplied signature is valid or not.
|
|
41
|
+
function handleSubmit() {
|
|
42
|
+
// We know only that what the user typed conforms to the `string` type.
|
|
43
|
+
const signature: string = signatureInput.value;
|
|
44
|
+
try {
|
|
45
|
+
// If this type assertion function doesn't throw, then
|
|
46
|
+
// Typescript will upcast `signature` to `Signature`.
|
|
47
|
+
assertIsSignature(signature);
|
|
48
|
+
// At this point, `signature` is a `Signature` that can be used with the RPC.
|
|
49
|
+
const {
|
|
50
|
+
value: [status],
|
|
51
|
+
} = await rpc.getSignatureStatuses([signature]).send();
|
|
52
|
+
} catch (e) {
|
|
53
|
+
// `signature` turned out not to be a base58-encoded signature
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
29
58
|
### `generateKeyPair()`
|
|
30
59
|
|
|
31
60
|
Generates an Ed25519 public/private key pair for use with other methods in this package that accept `CryptoKey` objects.
|
|
@@ -36,6 +65,41 @@ import { generateKeyPair } from '@solana/keys';
|
|
|
36
65
|
const { privateKey, publicKey } = await generateKeyPair();
|
|
37
66
|
```
|
|
38
67
|
|
|
68
|
+
### `createKeyPairFromBytes()`
|
|
69
|
+
|
|
70
|
+
Given a 64-bytes `Uint8Array` secret key, creates an Ed25519 public/private key pair for use with other methods in this package that accept `CryptoKey` objects.
|
|
71
|
+
|
|
72
|
+
```ts
|
|
73
|
+
import fs from 'fs';
|
|
74
|
+
import { createKeyPairFromBytes } from '@solana/keys';
|
|
75
|
+
|
|
76
|
+
// Get bytes from local keypair file.
|
|
77
|
+
const keypairFile = fs.readFileSync('~/.config/solana/id.json');
|
|
78
|
+
const keypairBytes = new Uint8Array(JSON.parse(keypairFile.toString()));
|
|
79
|
+
|
|
80
|
+
// Create a CryptoKeyPair from the bytes.
|
|
81
|
+
const { privateKey, publicKey } = await createKeyPairFromBytes(keypairBytes);
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### `isSignature()`
|
|
85
|
+
|
|
86
|
+
This is a type guard that accepts a string as input. It will both return `true` if the string conforms to the `Signature` type and will refine the type for use in your program.
|
|
87
|
+
|
|
88
|
+
```ts
|
|
89
|
+
import { isSignature } from '@solana/keys';
|
|
90
|
+
|
|
91
|
+
if (isSignature(signature)) {
|
|
92
|
+
// At this point, `signature` has been refined to a
|
|
93
|
+
// `Signature` that can be used with the RPC.
|
|
94
|
+
const {
|
|
95
|
+
value: [status],
|
|
96
|
+
} = await rpc.getSignatureStatuses([signature]).send();
|
|
97
|
+
setSignatureStatus(status);
|
|
98
|
+
} else {
|
|
99
|
+
setError(`${signature} is not a transaction signature`);
|
|
100
|
+
}
|
|
101
|
+
```
|
|
102
|
+
|
|
39
103
|
### `signBytes()`
|
|
40
104
|
|
|
41
105
|
Given a private `CryptoKey` and a `Uint8Array` of bytes, this method will return the 64-byte Ed25519 signature of that data as a `Uint8Array`.
|
|
@@ -47,9 +111,22 @@ const data = new Uint8Array([1, 2, 3]);
|
|
|
47
111
|
const signature = await signBytes(privateKey, data);
|
|
48
112
|
```
|
|
49
113
|
|
|
114
|
+
### `signature()`
|
|
115
|
+
|
|
116
|
+
This helper combines _asserting_ that a string is an Ed25519 signature with _coercing_ it to the `Signature` type. It's best used with untrusted input.
|
|
117
|
+
|
|
118
|
+
```ts
|
|
119
|
+
import { signature } from '@solana/keys';
|
|
120
|
+
|
|
121
|
+
const signature = signature(userSuppliedSignature);
|
|
122
|
+
const {
|
|
123
|
+
value: [status],
|
|
124
|
+
} = await rpc.getSignatureStatuses([signature]).send();
|
|
125
|
+
```
|
|
126
|
+
|
|
50
127
|
### `verifySignature()`
|
|
51
128
|
|
|
52
|
-
Given a public `CryptoKey`,
|
|
129
|
+
Given a public `CryptoKey`, some `SignatureBytes`, and a `Uint8Array` of data, this method will return `true` if the signature was produced by signing the data using the private key associated with the public key, and `false` otherwise.
|
|
53
130
|
|
|
54
131
|
```ts
|
|
55
132
|
import { verifySignature } from '@solana/keys';
|
package/dist/index.browser.cjs
CHANGED
|
@@ -1,6 +1,65 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
3
|
var assertions = require('@solana/assertions');
|
|
4
|
+
var errors = require('@solana/errors');
|
|
5
|
+
var codecsStrings = require('@solana/codecs-strings');
|
|
6
|
+
|
|
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
|
+
]);
|
|
55
|
+
}
|
|
56
|
+
async function createPrivateKeyFromBytes(bytes, extractable) {
|
|
57
|
+
if (bytes.byteLength !== 32) {
|
|
58
|
+
throw new Error("Private key bytes must be of length 32");
|
|
59
|
+
}
|
|
60
|
+
const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
|
|
61
|
+
return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
|
|
62
|
+
}
|
|
4
63
|
|
|
5
64
|
// src/key-pair.ts
|
|
6
65
|
async function generateKeyPair() {
|
|
@@ -17,18 +76,84 @@ async function generateKeyPair() {
|
|
|
17
76
|
);
|
|
18
77
|
return keyPair;
|
|
19
78
|
}
|
|
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 });
|
|
82
|
+
}
|
|
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;
|
|
135
|
+
}
|
|
20
136
|
async function signBytes(key, data) {
|
|
21
137
|
await assertions.assertSigningCapabilityIsAvailable();
|
|
22
138
|
const signedData = await crypto.subtle.sign("Ed25519", key, data);
|
|
23
139
|
return new Uint8Array(signedData);
|
|
24
140
|
}
|
|
25
|
-
|
|
141
|
+
function signature(putativeSignature) {
|
|
142
|
+
assertIsSignature(putativeSignature);
|
|
143
|
+
return putativeSignature;
|
|
144
|
+
}
|
|
145
|
+
async function verifySignature(key, signature2, data) {
|
|
26
146
|
await assertions.assertVerificationCapabilityIsAvailable();
|
|
27
|
-
return await crypto.subtle.verify("Ed25519", key,
|
|
147
|
+
return await crypto.subtle.verify("Ed25519", key, signature2, data);
|
|
28
148
|
}
|
|
29
149
|
|
|
150
|
+
exports.assertIsSignature = assertIsSignature;
|
|
151
|
+
exports.createKeyPairFromBytes = createKeyPairFromBytes;
|
|
152
|
+
exports.createPrivateKeyFromBytes = createPrivateKeyFromBytes;
|
|
30
153
|
exports.generateKeyPair = generateKeyPair;
|
|
154
|
+
exports.isSignature = isSignature;
|
|
31
155
|
exports.signBytes = signBytes;
|
|
156
|
+
exports.signature = signature;
|
|
32
157
|
exports.verifySignature = verifySignature;
|
|
33
158
|
//# sourceMappingURL=out.js.map
|
|
34
159
|
//# sourceMappingURL=index.browser.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/key-pair.ts","../src/signatures.ts"],"names":[],"mappings":";AAAA,SAAS,sCAAsC;
|
|
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.browser.js
CHANGED
|
@@ -1,4 +1,63 @@
|
|
|
1
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';
|
|
4
|
+
|
|
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
|
+
]);
|
|
53
|
+
}
|
|
54
|
+
async function createPrivateKeyFromBytes(bytes, extractable) {
|
|
55
|
+
if (bytes.byteLength !== 32) {
|
|
56
|
+
throw new Error("Private key bytes must be of length 32");
|
|
57
|
+
}
|
|
58
|
+
const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
|
|
59
|
+
return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
|
|
60
|
+
}
|
|
2
61
|
|
|
3
62
|
// src/key-pair.ts
|
|
4
63
|
async function generateKeyPair() {
|
|
@@ -15,16 +74,77 @@ async function generateKeyPair() {
|
|
|
15
74
|
);
|
|
16
75
|
return keyPair;
|
|
17
76
|
}
|
|
77
|
+
async function createKeyPairFromBytes(bytes, extractable) {
|
|
78
|
+
if (bytes.byteLength !== 64) {
|
|
79
|
+
throw new SolanaError(SOLANA_ERROR__INVALID_KEYPAIR_BYTES, { byteLength: bytes.byteLength });
|
|
80
|
+
}
|
|
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;
|
|
133
|
+
}
|
|
18
134
|
async function signBytes(key, data) {
|
|
19
135
|
await assertSigningCapabilityIsAvailable();
|
|
20
136
|
const signedData = await crypto.subtle.sign("Ed25519", key, data);
|
|
21
137
|
return new Uint8Array(signedData);
|
|
22
138
|
}
|
|
23
|
-
|
|
139
|
+
function signature(putativeSignature) {
|
|
140
|
+
assertIsSignature(putativeSignature);
|
|
141
|
+
return putativeSignature;
|
|
142
|
+
}
|
|
143
|
+
async function verifySignature(key, signature2, data) {
|
|
24
144
|
await assertVerificationCapabilityIsAvailable();
|
|
25
|
-
return await crypto.subtle.verify("Ed25519", key,
|
|
145
|
+
return await crypto.subtle.verify("Ed25519", key, signature2, data);
|
|
26
146
|
}
|
|
27
147
|
|
|
28
|
-
export { generateKeyPair, signBytes, verifySignature };
|
|
148
|
+
export { assertIsSignature, createKeyPairFromBytes, createPrivateKeyFromBytes, generateKeyPair, isSignature, signBytes, signature, verifySignature };
|
|
29
149
|
//# sourceMappingURL=out.js.map
|
|
30
150
|
//# sourceMappingURL=index.browser.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/key-pair.ts","../src/signatures.ts"],"names":[],"mappings":";AAAA,SAAS,sCAAsC;
|
|
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.native.js
CHANGED
|
@@ -1,4 +1,63 @@
|
|
|
1
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';
|
|
4
|
+
|
|
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
|
+
]);
|
|
53
|
+
}
|
|
54
|
+
async function createPrivateKeyFromBytes(bytes, extractable) {
|
|
55
|
+
if (bytes.byteLength !== 32) {
|
|
56
|
+
throw new Error("Private key bytes must be of length 32");
|
|
57
|
+
}
|
|
58
|
+
const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
|
|
59
|
+
return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
|
|
60
|
+
}
|
|
2
61
|
|
|
3
62
|
// src/key-pair.ts
|
|
4
63
|
async function generateKeyPair() {
|
|
@@ -15,16 +74,77 @@ async function generateKeyPair() {
|
|
|
15
74
|
);
|
|
16
75
|
return keyPair;
|
|
17
76
|
}
|
|
77
|
+
async function createKeyPairFromBytes(bytes, extractable) {
|
|
78
|
+
if (bytes.byteLength !== 64) {
|
|
79
|
+
throw new SolanaError(SOLANA_ERROR__INVALID_KEYPAIR_BYTES, { byteLength: bytes.byteLength });
|
|
80
|
+
}
|
|
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;
|
|
133
|
+
}
|
|
18
134
|
async function signBytes(key, data) {
|
|
19
135
|
await assertSigningCapabilityIsAvailable();
|
|
20
136
|
const signedData = await crypto.subtle.sign("Ed25519", key, data);
|
|
21
137
|
return new Uint8Array(signedData);
|
|
22
138
|
}
|
|
23
|
-
|
|
139
|
+
function signature(putativeSignature) {
|
|
140
|
+
assertIsSignature(putativeSignature);
|
|
141
|
+
return putativeSignature;
|
|
142
|
+
}
|
|
143
|
+
async function verifySignature(key, signature2, data) {
|
|
24
144
|
await assertVerificationCapabilityIsAvailable();
|
|
25
|
-
return await crypto.subtle.verify("Ed25519", key,
|
|
145
|
+
return await crypto.subtle.verify("Ed25519", key, signature2, data);
|
|
26
146
|
}
|
|
27
147
|
|
|
28
|
-
export { generateKeyPair, signBytes, verifySignature };
|
|
148
|
+
export { assertIsSignature, createKeyPairFromBytes, createPrivateKeyFromBytes, generateKeyPair, isSignature, signBytes, signature, verifySignature };
|
|
29
149
|
//# sourceMappingURL=out.js.map
|
|
30
150
|
//# sourceMappingURL=index.native.js.map
|
package/dist/index.native.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/key-pair.ts","../src/signatures.ts"],"names":[],"mappings":";AAAA,SAAS,sCAAsC;
|
|
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.cjs
CHANGED
|
@@ -1,6 +1,65 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
3
|
var assertions = require('@solana/assertions');
|
|
4
|
+
var errors = require('@solana/errors');
|
|
5
|
+
var codecsStrings = require('@solana/codecs-strings');
|
|
6
|
+
|
|
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
|
+
]);
|
|
55
|
+
}
|
|
56
|
+
async function createPrivateKeyFromBytes(bytes, extractable) {
|
|
57
|
+
if (bytes.byteLength !== 32) {
|
|
58
|
+
throw new Error("Private key bytes must be of length 32");
|
|
59
|
+
}
|
|
60
|
+
const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
|
|
61
|
+
return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
|
|
62
|
+
}
|
|
4
63
|
|
|
5
64
|
// src/key-pair.ts
|
|
6
65
|
async function generateKeyPair() {
|
|
@@ -17,18 +76,84 @@ async function generateKeyPair() {
|
|
|
17
76
|
);
|
|
18
77
|
return keyPair;
|
|
19
78
|
}
|
|
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 });
|
|
82
|
+
}
|
|
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;
|
|
135
|
+
}
|
|
20
136
|
async function signBytes(key, data) {
|
|
21
137
|
await assertions.assertSigningCapabilityIsAvailable();
|
|
22
138
|
const signedData = await crypto.subtle.sign("Ed25519", key, data);
|
|
23
139
|
return new Uint8Array(signedData);
|
|
24
140
|
}
|
|
25
|
-
|
|
141
|
+
function signature(putativeSignature) {
|
|
142
|
+
assertIsSignature(putativeSignature);
|
|
143
|
+
return putativeSignature;
|
|
144
|
+
}
|
|
145
|
+
async function verifySignature(key, signature2, data) {
|
|
26
146
|
await assertions.assertVerificationCapabilityIsAvailable();
|
|
27
|
-
return await crypto.subtle.verify("Ed25519", key,
|
|
147
|
+
return await crypto.subtle.verify("Ed25519", key, signature2, data);
|
|
28
148
|
}
|
|
29
149
|
|
|
150
|
+
exports.assertIsSignature = assertIsSignature;
|
|
151
|
+
exports.createKeyPairFromBytes = createKeyPairFromBytes;
|
|
152
|
+
exports.createPrivateKeyFromBytes = createPrivateKeyFromBytes;
|
|
30
153
|
exports.generateKeyPair = generateKeyPair;
|
|
154
|
+
exports.isSignature = isSignature;
|
|
31
155
|
exports.signBytes = signBytes;
|
|
156
|
+
exports.signature = signature;
|
|
32
157
|
exports.verifySignature = verifySignature;
|
|
33
158
|
//# sourceMappingURL=out.js.map
|
|
34
159
|
//# sourceMappingURL=index.node.cjs.map
|
package/dist/index.node.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/key-pair.ts","../src/signatures.ts"],"names":[],"mappings":";AAAA,SAAS,sCAAsC;
|
|
1
|
+
{"version":3,"sources":["../src/key-pair.ts","../src/private-key.ts","../src/signatures.ts"],"names":["signature"],"mappings":";AAAA,SAAS,sCAAsC;AAC/C,SAAS,qCAAqC,mBAAmB;;;ACDjE,SAAS,eAAe,OAA+B;AAEnD,SAAO,IAAI,WAAW;AAAA;AAAA;AAAA;AAAA,IAIlB;AAAA;AAAA,IACA;AAAA;AAAA,IAEI;AAAA;AAAA,IACA;AAAA;AAAA,IACI;AAAA;AAAA,IAEJ;AAAA;AAAA,IACA;AAAA;AAAA,IACI;AAAA;AAAA,IACA;AAAA;AAAA;AAAA,IAEQ;AAAA;AAAA,IACA;AAAA;AAAA;AAAA,IAEA;AAAA;AAAA;AAAA;AAAA;AAAA,IAKhB;AAAA;AAAA,IACA;AAAA;AAAA;AAAA,IAGI;AAAA;AAAA,IACA;AAAA;AAAA,IAEJ,GAAG;AAAA,EACP,CAAC;AACL;AAEA,eAAsB,0BAA0B,OAAmB,aAA2C;AAC1G,MAAI,MAAM,eAAe,IAAI;AAEzB,UAAM,IAAI,MAAM,wCAAwC;AAAA,EAC5D;AACA,QAAM,uBAAuB,eAAe,KAAK;AACjD,SAAO,MAAM,OAAO,OAAO,UAAU,SAAS,sBAAsB,WAAW,eAAe,OAAO,CAAC,MAAM,CAAC;AACjH;;;ADvCA,eAAsB,kBAA0C;AAC5D,QAAM,+BAA+B;AACrC,QAAM,UAAU,MAAM,OAAO,OAAO;AAAA;AAAA,IAChB;AAAA;AAAA;AAAA,IACE;AAAA;AAAA;AAAA,IACC,CAAC,QAAQ,QAAQ;AAAA,EACxC;AACA,SAAO;AACX;AAEA,eAAsB,uBAAuB,OAAmB,aAA+C;AAC3G,MAAI,MAAM,eAAe,IAAI;AACzB,UAAM,IAAI,YAAY,qCAAqC,EAAE,YAAY,MAAM,WAAW,CAAC;AAAA,EAC/F;AACA,QAAM,CAAC,WAAW,UAAU,IAAI,MAAM,QAAQ,IAAI;AAAA,IAC9C,OAAO,OAAO;AAAA,MAAU;AAAA,MAAO,MAAM,MAAM,EAAE;AAAA,MAAG;AAAA;AAAA,MAA6B;AAAA,MAAM,CAAC,QAAQ;AAAA,IAAC;AAAA,IAC7F,0BAA0B,MAAM,MAAM,GAAG,EAAE,GAAG,WAAW;AAAA,EAC7D,CAAC;AACD,SAAO,EAAE,YAAY,UAAU;AACnC;;;AExBA,SAAS,oCAAoC,+CAA+C;AAE5F,SAAS,wBAAwB;AAKjC,IAAI;AAEG,SAAS,kBAAkB,mBAAmE;AACjG,MAAI,CAAC;AAAe,oBAAgB,iBAAiB;AAErD,MAAI;AAEA;AAAA;AAAA,MAEI,kBAAkB,SAAS;AAAA,MAE3B,kBAAkB,SAAS;AAAA,MAC7B;AACE,YAAM,IAAI,MAAM,+DAA+D;AAAA,IACnF;AAEA,UAAM,QAAQ,cAAc,OAAO,iBAAiB;AACpD,UAAM,WAAW,MAAM;AACvB,QAAI,aAAa,IAAI;AACjB,YAAM,IAAI,MAAM,gFAAgF,QAAQ,EAAE;AAAA,IAC9G;AAAA,EACJ,SAAS,GAAG;AACR,UAAM,IAAI,MAAM,KAAK,iBAAiB,yBAAyB;AAAA,MAC3D,OAAO;AAAA,IACX,CAAC;AAAA,EACL;AACJ;AAEO,SAAS,YAAY,mBAA2D;AACnF,MAAI,CAAC;AAAe,oBAAgB,iBAAiB;AAGrD;AAAA;AAAA,IAEI,kBAAkB,SAAS;AAAA,IAE3B,kBAAkB,SAAS;AAAA,IAC7B;AACE,WAAO;AAAA,EACX;AAEA,QAAM,QAAQ,cAAc,OAAO,iBAAiB;AACpD,QAAM,WAAW,MAAM;AACvB,MAAI,aAAa,IAAI;AACjB,WAAO;AAAA,EACX;AACA,SAAO;AACX;AAEA,eAAsB,UAAU,KAAgB,MAA2C;AACvF,QAAM,mCAAmC;AACzC,QAAM,aAAa,MAAM,OAAO,OAAO,KAAK,WAAW,KAAK,IAAI;AAChE,SAAO,IAAI,WAAW,UAAU;AACpC;AAEO,SAAS,UAAU,mBAAsC;AAC5D,oBAAkB,iBAAiB;AACnC,SAAO;AACX;AAEA,eAAsB,gBAAgB,KAAgBA,YAA2B,MAAoC;AACjH,QAAM,wCAAwC;AAC9C,SAAO,MAAM,OAAO,OAAO,OAAO,WAAW,KAAKA,YAAW,IAAI;AACrE","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,4 +1,63 @@
|
|
|
1
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';
|
|
4
|
+
|
|
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
|
+
]);
|
|
53
|
+
}
|
|
54
|
+
async function createPrivateKeyFromBytes(bytes, extractable) {
|
|
55
|
+
if (bytes.byteLength !== 32) {
|
|
56
|
+
throw new Error("Private key bytes must be of length 32");
|
|
57
|
+
}
|
|
58
|
+
const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
|
|
59
|
+
return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
|
|
60
|
+
}
|
|
2
61
|
|
|
3
62
|
// src/key-pair.ts
|
|
4
63
|
async function generateKeyPair() {
|
|
@@ -15,16 +74,77 @@ async function generateKeyPair() {
|
|
|
15
74
|
);
|
|
16
75
|
return keyPair;
|
|
17
76
|
}
|
|
77
|
+
async function createKeyPairFromBytes(bytes, extractable) {
|
|
78
|
+
if (bytes.byteLength !== 64) {
|
|
79
|
+
throw new SolanaError(SOLANA_ERROR__INVALID_KEYPAIR_BYTES, { byteLength: bytes.byteLength });
|
|
80
|
+
}
|
|
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;
|
|
133
|
+
}
|
|
18
134
|
async function signBytes(key, data) {
|
|
19
135
|
await assertSigningCapabilityIsAvailable();
|
|
20
136
|
const signedData = await crypto.subtle.sign("Ed25519", key, data);
|
|
21
137
|
return new Uint8Array(signedData);
|
|
22
138
|
}
|
|
23
|
-
|
|
139
|
+
function signature(putativeSignature) {
|
|
140
|
+
assertIsSignature(putativeSignature);
|
|
141
|
+
return putativeSignature;
|
|
142
|
+
}
|
|
143
|
+
async function verifySignature(key, signature2, data) {
|
|
24
144
|
await assertVerificationCapabilityIsAvailable();
|
|
25
|
-
return await crypto.subtle.verify("Ed25519", key,
|
|
145
|
+
return await crypto.subtle.verify("Ed25519", key, signature2, data);
|
|
26
146
|
}
|
|
27
147
|
|
|
28
|
-
export { generateKeyPair, signBytes, verifySignature };
|
|
148
|
+
export { assertIsSignature, createKeyPairFromBytes, createPrivateKeyFromBytes, generateKeyPair, isSignature, signBytes, signature, verifySignature };
|
|
29
149
|
//# sourceMappingURL=out.js.map
|
|
30
150
|
//# sourceMappingURL=index.node.js.map
|
package/dist/index.node.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/key-pair.ts","../src/signatures.ts"],"names":[],"mappings":";AAAA,SAAS,sCAAsC;
|
|
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/types/index.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}
|
package/dist/types/key-pair.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"key-pair.d.ts","sourceRoot":"","sources":["../../src/key-pair.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"key-pair.d.ts","sourceRoot":"","sources":["../../src/key-pair.ts"],"names":[],"mappings":"AAKA,wBAAsB,eAAe,IAAI,OAAO,CAAC,aAAa,CAAC,CAQ9D;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAS7G"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"private-key.d.ts","sourceRoot":"","sources":["../../src/private-key.ts"],"names":[],"mappings":"AAqCA,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAO5G"}
|
|
@@ -1,6 +1,12 @@
|
|
|
1
|
-
export type
|
|
1
|
+
export type Signature = string & {
|
|
2
2
|
readonly __brand: unique symbol;
|
|
3
3
|
};
|
|
4
|
-
export
|
|
5
|
-
|
|
4
|
+
export type SignatureBytes = Uint8Array & {
|
|
5
|
+
readonly __brand: unique symbol;
|
|
6
|
+
};
|
|
7
|
+
export declare function assertIsSignature(putativeSignature: string): asserts putativeSignature is Signature;
|
|
8
|
+
export declare function isSignature(putativeSignature: string): putativeSignature is Signature;
|
|
9
|
+
export declare function signBytes(key: CryptoKey, data: Uint8Array): Promise<SignatureBytes>;
|
|
10
|
+
export declare function signature(putativeSignature: string): Signature;
|
|
11
|
+
export declare function verifySignature(key: CryptoKey, signature: SignatureBytes, data: Uint8Array): Promise<boolean>;
|
|
6
12
|
//# sourceMappingURL=signatures.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"signatures.d.ts","sourceRoot":"","sources":["../../src/signatures.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"signatures.d.ts","sourceRoot":"","sources":["../../src/signatures.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AACrE,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAI9E,wBAAgB,iBAAiB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,IAAI,SAAS,CAwBnG;AAED,wBAAgB,WAAW,CAAC,iBAAiB,EAAE,MAAM,GAAG,iBAAiB,IAAI,SAAS,CAmBrF;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAIzF;AAED,wBAAgB,SAAS,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAG9D;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAGnH"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@solana/keys",
|
|
3
|
-
"version": "2.0.0-experimental.
|
|
3
|
+
"version": "2.0.0-experimental.dfb72ea",
|
|
4
4
|
"description": "Helpers for generating and transforming key material",
|
|
5
5
|
"exports": {
|
|
6
6
|
"browser": {
|
|
@@ -49,29 +49,10 @@
|
|
|
49
49
|
"node": ">=17.4"
|
|
50
50
|
},
|
|
51
51
|
"dependencies": {
|
|
52
|
-
"@solana/
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
"@solana/
|
|
56
|
-
"@swc/jest": "^0.2.29",
|
|
57
|
-
"@types/jest": "^29.5.6",
|
|
58
|
-
"@typescript-eslint/eslint-plugin": "^6.7.0",
|
|
59
|
-
"@typescript-eslint/parser": "^6.3.0",
|
|
60
|
-
"agadoo": "^3.0.0",
|
|
61
|
-
"eslint": "^8.45.0",
|
|
62
|
-
"eslint-plugin-jest": "^27.4.2",
|
|
63
|
-
"eslint-plugin-sort-keys-fix": "^1.1.2",
|
|
64
|
-
"jest": "^29.7.0",
|
|
65
|
-
"jest-environment-jsdom": "^29.7.0",
|
|
66
|
-
"jest-runner-eslint": "^2.1.2",
|
|
67
|
-
"jest-runner-prettier": "^1.0.0",
|
|
68
|
-
"prettier": "^2.8",
|
|
69
|
-
"tsup": "7.2.0",
|
|
70
|
-
"typescript": "^5.2.2",
|
|
71
|
-
"version-from-git": "^1.1.1",
|
|
72
|
-
"build-scripts": "0.0.0",
|
|
73
|
-
"test-config": "0.0.0",
|
|
74
|
-
"tsconfig": "0.0.0"
|
|
52
|
+
"@solana/codecs-strings": "2.0.0-experimental.dfb72ea",
|
|
53
|
+
"@solana/assertions": "2.0.0-experimental.dfb72ea",
|
|
54
|
+
"@solana/errors": "2.0.0-experimental.dfb72ea",
|
|
55
|
+
"@solana/codecs-core": "2.0.0-experimental.dfb72ea"
|
|
75
56
|
},
|
|
76
57
|
"bundlewatch": {
|
|
77
58
|
"defaultCompression": "gzip",
|
|
@@ -82,18 +63,19 @@
|
|
|
82
63
|
]
|
|
83
64
|
},
|
|
84
65
|
"scripts": {
|
|
85
|
-
"compile:js": "tsup --config build-scripts/tsup.config.
|
|
86
|
-
"compile:typedefs": "tsc -p ./tsconfig.declarations.json",
|
|
87
|
-
"dev": "jest -c node_modules/test-config/jest-dev.config.ts --rootDir . --watch",
|
|
88
|
-
"publish-
|
|
66
|
+
"compile:js": "tsup --config build-scripts/tsup.config.package.ts",
|
|
67
|
+
"compile:typedefs": "tsc -p ./tsconfig.declarations.json && node node_modules/@solana/build-scripts/add-js-extension-to-types.mjs",
|
|
68
|
+
"dev": "jest -c node_modules/@solana/test-config/jest-dev.config.ts --rootDir . --watch",
|
|
69
|
+
"publish-impl": "npm view $npm_package_name@$npm_package_version > /dev/null 2>&1 || pnpm publish --tag experimental --access public --no-git-checks",
|
|
70
|
+
"publish-packages": "pnpm prepublishOnly && pnpm publish-impl",
|
|
89
71
|
"style:fix": "pnpm eslint --fix src/* && pnpm prettier -w src/* package.json",
|
|
90
|
-
"test:lint": "jest -c node_modules/test-config/jest-lint.config.ts --rootDir . --silent",
|
|
91
|
-
"test:prettier": "jest -c node_modules/test-config/jest-prettier.config.ts --rootDir . --silent",
|
|
72
|
+
"test:lint": "jest -c node_modules/@solana/test-config/jest-lint.config.ts --rootDir . --silent",
|
|
73
|
+
"test:prettier": "jest -c node_modules/@solana/test-config/jest-prettier.config.ts --rootDir . --silent",
|
|
92
74
|
"test:treeshakability:browser": "agadoo dist/index.browser.js",
|
|
93
75
|
"test:treeshakability:native": "agadoo dist/index.native.js",
|
|
94
76
|
"test:treeshakability:node": "agadoo dist/index.node.js",
|
|
95
77
|
"test:typecheck": "tsc --noEmit",
|
|
96
|
-
"test:unit:browser": "jest -c node_modules/test-config/jest-unit.config.browser.ts --rootDir . --silent",
|
|
97
|
-
"test:unit:node": "jest -c node_modules/test-config/jest-unit.config.node.ts --rootDir . --silent"
|
|
78
|
+
"test:unit:browser": "jest -c node_modules/@solana/test-config/jest-unit.config.browser.ts --rootDir . --silent",
|
|
79
|
+
"test:unit:node": "jest -c node_modules/@solana/test-config/jest-unit.config.node.ts --rootDir . --silent"
|
|
98
80
|
}
|
|
99
81
|
}
|
|
@@ -1,94 +0,0 @@
|
|
|
1
|
-
this.globalThis = this.globalThis || {};
|
|
2
|
-
this.globalThis.solanaWeb3 = (function (exports) {
|
|
3
|
-
'use strict';
|
|
4
|
-
|
|
5
|
-
// ../assertions/dist/index.browser.js
|
|
6
|
-
function assertIsSecureContext() {
|
|
7
|
-
if (!globalThis.isSecureContext) {
|
|
8
|
-
throw new Error(
|
|
9
|
-
"Cryptographic operations are only allowed in secure browser contexts. Read more here: https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts"
|
|
10
|
-
);
|
|
11
|
-
}
|
|
12
|
-
}
|
|
13
|
-
var cachedEd25519Decision;
|
|
14
|
-
async function isEd25519CurveSupported(subtle) {
|
|
15
|
-
if (cachedEd25519Decision === void 0) {
|
|
16
|
-
cachedEd25519Decision = new Promise((resolve) => {
|
|
17
|
-
subtle.generateKey(
|
|
18
|
-
"Ed25519",
|
|
19
|
-
/* extractable */
|
|
20
|
-
false,
|
|
21
|
-
["sign", "verify"]
|
|
22
|
-
).catch(() => {
|
|
23
|
-
resolve(cachedEd25519Decision = false);
|
|
24
|
-
}).then(() => {
|
|
25
|
-
resolve(cachedEd25519Decision = true);
|
|
26
|
-
});
|
|
27
|
-
});
|
|
28
|
-
}
|
|
29
|
-
if (typeof cachedEd25519Decision === "boolean") {
|
|
30
|
-
return cachedEd25519Decision;
|
|
31
|
-
} else {
|
|
32
|
-
return await cachedEd25519Decision;
|
|
33
|
-
}
|
|
34
|
-
}
|
|
35
|
-
async function assertKeyGenerationIsAvailable() {
|
|
36
|
-
assertIsSecureContext();
|
|
37
|
-
if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.generateKey !== "function") {
|
|
38
|
-
throw new Error("No key generation implementation could be found");
|
|
39
|
-
}
|
|
40
|
-
if (!await isEd25519CurveSupported(globalThis.crypto.subtle)) {
|
|
41
|
-
throw new Error(
|
|
42
|
-
"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"
|
|
43
|
-
);
|
|
44
|
-
}
|
|
45
|
-
}
|
|
46
|
-
async function assertSigningCapabilityIsAvailable() {
|
|
47
|
-
assertIsSecureContext();
|
|
48
|
-
if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.sign !== "function") {
|
|
49
|
-
throw new Error("No signing implementation could be found");
|
|
50
|
-
}
|
|
51
|
-
}
|
|
52
|
-
async function assertVerificationCapabilityIsAvailable() {
|
|
53
|
-
assertIsSecureContext();
|
|
54
|
-
if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.verify !== "function") {
|
|
55
|
-
throw new Error("No signature verification implementation could be found");
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
// src/key-pair.ts
|
|
60
|
-
async function generateKeyPair() {
|
|
61
|
-
await assertKeyGenerationIsAvailable();
|
|
62
|
-
const keyPair = await crypto.subtle.generateKey(
|
|
63
|
-
/* algorithm */
|
|
64
|
-
"Ed25519",
|
|
65
|
-
// Native implementation status: https://github.com/WICG/webcrypto-secure-curves/issues/20
|
|
66
|
-
/* extractable */
|
|
67
|
-
false,
|
|
68
|
-
// Prevents the bytes of the private key from being visible to JS.
|
|
69
|
-
/* allowed uses */
|
|
70
|
-
["sign", "verify"]
|
|
71
|
-
);
|
|
72
|
-
return keyPair;
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
// src/signatures.ts
|
|
76
|
-
async function signBytes(key, data) {
|
|
77
|
-
await assertSigningCapabilityIsAvailable();
|
|
78
|
-
const signedData = await crypto.subtle.sign("Ed25519", key, data);
|
|
79
|
-
return new Uint8Array(signedData);
|
|
80
|
-
}
|
|
81
|
-
async function verifySignature(key, signature, data) {
|
|
82
|
-
await assertVerificationCapabilityIsAvailable();
|
|
83
|
-
return await crypto.subtle.verify("Ed25519", key, signature, data);
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
exports.generateKeyPair = generateKeyPair;
|
|
87
|
-
exports.signBytes = signBytes;
|
|
88
|
-
exports.verifySignature = verifySignature;
|
|
89
|
-
|
|
90
|
-
return exports;
|
|
91
|
-
|
|
92
|
-
})({});
|
|
93
|
-
//# sourceMappingURL=out.js.map
|
|
94
|
-
//# sourceMappingURL=index.development.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../assertions/src/subtle-crypto.ts","../src/key-pair.ts","../src/signatures.ts"],"names":[],"mappings":";AAAA,SAAS,wBAAwB;AAC7B,MAAmB,CAAC,WAAW,iBAAiB;AAE5C,UAAM,IAAI;MACN;IAEJ;EACJ;AACJ;AAEA,IAAI;AACJ,eAAe,wBAAwB,QAAwC;AAC3E,MAAI,0BAA0B,QAAW;AACrC,4BAAwB,IAAI,QAAQ,CAAA,YAAW;AAC3C,aACK;QAAY;;QAA6B;QAAO,CAAC,QAAQ,QAAQ;MAAC,EAClE,MAAM,MAAM;AACT,gBAAS,wBAAwB,KAAM;MAC3C,CAAC,EACA,KAAK,MAAM;AACR,gBAAS,wBAAwB,IAAK;MAC1C,CAAC;IACT,CAAC;EACL;AACA,MAAI,OAAO,0BAA0B,WAAW;AAC5C,WAAO;EACX,OAAO;AACH,WAAO,MAAM;EACjB;AACJ;AAUA,eAAsB,iCAAiC;AACnD,wBAAsB;AACtB,MAAI,OAAO,WAAW,WAAW,eAAe,OAAO,WAAW,OAAO,QAAQ,gBAAgB,YAAY;AAEzG,UAAM,IAAI,MAAM,iDAAiD;EACrE;AACA,MAAI,CAAE,MAAM,wBAAwB,WAAW,OAAO,MAAM,GAAI;AAE5D,UAAM,IAAI;MACN;IAKJ;EACJ;AACJ;AAUA,eAAsB,qCAAqC;AACvD,wBAAsB;AACtB,MAAI,OAAO,WAAW,WAAW,eAAe,OAAO,WAAW,OAAO,QAAQ,SAAS,YAAY;AAElG,UAAM,IAAI,MAAM,0CAA0C;EAC9D;AACJ;AAEA,eAAsB,0CAA0C;AAC5D,wBAAsB;AACtB,MAAI,OAAO,WAAW,WAAW,eAAe,OAAO,WAAW,OAAO,QAAQ,WAAW,YAAY;AAEpG,UAAM,IAAI,MAAM,yDAAyD;EAC7E;AACJ;;;AC7EA,eAAsB,kBAA0C;AAC5D,QAAM,+BAA+B;AACrC,QAAM,UAAU,MAAM,OAAO,OAAO;AAAA;AAAA,IAChB;AAAA;AAAA;AAAA,IACE;AAAA;AAAA;AAAA,IACC,CAAC,QAAQ,QAAQ;AAAA,EACxC;AACA,SAAO;AACX;;;ACNA,eAAsB,UAAU,KAAgB,MAA6C;AACzF,QAAM,mCAAmC;AACzC,QAAM,aAAa,MAAM,OAAO,OAAO,KAAK,WAAW,KAAK,IAAI;AAChE,SAAO,IAAI,WAAW,UAAU;AACpC;AAEA,eAAsB,gBAAgB,KAAgB,WAA6B,MAAoC;AACnH,QAAM,wCAAwC;AAC9C,SAAO,MAAM,OAAO,OAAO,OAAO,WAAW,KAAK,WAAW,IAAI;AACrE","sourcesContent":["function assertIsSecureContext() {\n if (__BROWSER__ && !globalThis.isSecureContext) {\n // TODO: Coded error.\n throw new Error(\n 'Cryptographic operations are only allowed in secure browser contexts. Read more ' +\n 'here: https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts'\n );\n }\n}\n\nlet cachedEd25519Decision: PromiseLike<boolean> | boolean | undefined;\nasync function isEd25519CurveSupported(subtle: SubtleCrypto): Promise<boolean> {\n if (cachedEd25519Decision === undefined) {\n cachedEd25519Decision = new Promise(resolve => {\n subtle\n .generateKey('Ed25519', /* extractable */ false, ['sign', 'verify'])\n .catch(() => {\n resolve((cachedEd25519Decision = false));\n })\n .then(() => {\n resolve((cachedEd25519Decision = true));\n });\n });\n }\n if (typeof cachedEd25519Decision === 'boolean') {\n return cachedEd25519Decision;\n } else {\n return await cachedEd25519Decision;\n }\n}\n\nexport async function assertDigestCapabilityIsAvailable() {\n assertIsSecureContext();\n if (typeof globalThis.crypto === 'undefined' || typeof globalThis.crypto.subtle?.digest !== 'function') {\n // TODO: Coded error.\n throw new Error('No digest implementation could be found');\n }\n}\n\nexport async function assertKeyGenerationIsAvailable() {\n assertIsSecureContext();\n if (typeof globalThis.crypto === 'undefined' || typeof globalThis.crypto.subtle?.generateKey !== 'function') {\n // TODO: Coded error.\n throw new Error('No key generation implementation could be found');\n }\n if (!(await isEd25519CurveSupported(globalThis.crypto.subtle))) {\n // TODO: Coded error.\n throw new Error(\n 'This runtime does not support the generation of Ed25519 key pairs.\\n\\nInstall and ' +\n 'import `@solana/webcrypto-ed25519-polyfill` before generating keys in ' +\n 'environments that do not support Ed25519.\\n\\nFor a list of runtimes that ' +\n 'currently support Ed25519 operations, visit ' +\n 'https://github.com/WICG/webcrypto-secure-curves/issues/20'\n );\n }\n}\n\nexport async function assertKeyExporterIsAvailable() {\n assertIsSecureContext();\n if (typeof globalThis.crypto === 'undefined' || typeof globalThis.crypto.subtle?.exportKey !== 'function') {\n // TODO: Coded error.\n throw new Error('No key export implementation could be found');\n }\n}\n\nexport async function assertSigningCapabilityIsAvailable() {\n assertIsSecureContext();\n if (typeof globalThis.crypto === 'undefined' || typeof globalThis.crypto.subtle?.sign !== 'function') {\n // TODO: Coded error.\n throw new Error('No signing implementation could be found');\n }\n}\n\nexport async function assertVerificationCapabilityIsAvailable() {\n assertIsSecureContext();\n if (typeof globalThis.crypto === 'undefined' || typeof globalThis.crypto.subtle?.verify !== 'function') {\n // TODO: Coded error.\n throw new Error('No signature verification implementation could be found');\n }\n}\n","import { assertKeyGenerationIsAvailable } from '@solana/assertions';\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","import { assertSigningCapabilityIsAvailable, assertVerificationCapabilityIsAvailable } from '@solana/assertions';\n\nexport type Ed25519Signature = Uint8Array & { readonly __brand: unique symbol };\n\nexport async function signBytes(key: CryptoKey, data: Uint8Array): Promise<Ed25519Signature> {\n await assertSigningCapabilityIsAvailable();\n const signedData = await crypto.subtle.sign('Ed25519', key, data);\n return new Uint8Array(signedData) as Ed25519Signature;\n}\n\nexport async function verifySignature(key: CryptoKey, signature: Ed25519Signature, data: Uint8Array): Promise<boolean> {\n await assertVerificationCapabilityIsAvailable();\n return await crypto.subtle.verify('Ed25519', key, signature, data);\n}\n"]}
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
this.globalThis = this.globalThis || {};
|
|
2
|
-
this.globalThis.solanaWeb3 = (function (exports) {
|
|
3
|
-
'use strict';
|
|
4
|
-
|
|
5
|
-
function n(){if(!globalThis.isSecureContext)throw new Error("Cryptographic operations are only allowed in secure browser contexts. Read more here: https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts")}var e;async function y(t){return e===void 0&&(e=new Promise(o=>{t.generateKey("Ed25519",!1,["sign","verify"]).catch(()=>{o(e=!1);}).then(()=>{o(e=!0);});})),typeof e=="boolean"?e:await e}async function a(){if(n(),typeof globalThis.crypto>"u"||typeof globalThis.crypto.subtle?.generateKey!="function")throw new Error("No key generation implementation could be found");if(!await y(globalThis.crypto.subtle))throw new Error(`This runtime does not support the generation of Ed25519 key pairs.
|
|
6
|
-
|
|
7
|
-
Install and import \`@solana/webcrypto-ed25519-polyfill\` before generating keys in environments that do not support Ed25519.
|
|
8
|
-
|
|
9
|
-
For a list of runtimes that currently support Ed25519 operations, visit https://github.com/WICG/webcrypto-secure-curves/issues/20`)}async function s(){if(n(),typeof globalThis.crypto>"u"||typeof globalThis.crypto.subtle?.sign!="function")throw new Error("No signing implementation could be found")}async function l(){if(n(),typeof globalThis.crypto>"u"||typeof globalThis.crypto.subtle?.verify!="function")throw new Error("No signature verification implementation could be found")}async function d(){return await a(),await crypto.subtle.generateKey("Ed25519",!1,["sign","verify"])}async function m(t,o){await s();let r=await crypto.subtle.sign("Ed25519",t,o);return new Uint8Array(r)}async function w(t,o,r){return await l(),await crypto.subtle.verify("Ed25519",t,o,r)}
|
|
10
|
-
|
|
11
|
-
exports.generateKeyPair = d;
|
|
12
|
-
exports.signBytes = m;
|
|
13
|
-
exports.verifySignature = w;
|
|
14
|
-
|
|
15
|
-
return exports;
|
|
16
|
-
|
|
17
|
-
})({});
|