@solana/keys 2.0.0-experimental.021b83f → 2.0.0-experimental.025ef21
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 +122 -0
- package/dist/index.browser.cjs +120 -15
- package/dist/index.browser.cjs.map +1 -1
- package/dist/index.browser.js +115 -12
- package/dist/index.browser.js.map +1 -1
- package/dist/index.native.js +115 -12
- package/dist/index.native.js.map +1 -1
- package/dist/index.node.cjs +120 -15
- package/dist/index.node.cjs.map +1 -1
- package/dist/index.node.js +115 -12
- package/dist/index.node.js.map +1 -1
- package/dist/types/index.d.ts +3 -1
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/key-pair.d.ts +2 -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 +12 -0
- package/dist/types/signatures.d.ts.map +1 -0
- package/package.json +27 -26
- package/dist/index.development.js +0 -214
- package/dist/index.development.js.map +0 -1
- package/dist/index.production.min.js +0 -11
- package/dist/types/base58.d.ts +0 -5
- package/dist/types/base58.d.ts.map +0 -1
package/dist/index.node.cjs
CHANGED
|
@@ -1,33 +1,138 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var
|
|
3
|
+
var assertions = require('@solana/assertions');
|
|
4
|
+
var codecsStrings = require('@solana/codecs-strings');
|
|
4
5
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
6
|
+
// src/key-pair.ts
|
|
7
|
+
async function generateKeyPair() {
|
|
8
|
+
await assertions.assertKeyGenerationIsAvailable();
|
|
9
|
+
const keyPair = await crypto.subtle.generateKey(
|
|
10
|
+
/* algorithm */
|
|
11
|
+
"Ed25519",
|
|
12
|
+
// Native implementation status: https://github.com/WICG/webcrypto-secure-curves/issues/20
|
|
13
|
+
/* extractable */
|
|
14
|
+
false,
|
|
15
|
+
// Prevents the bytes of the private key from being visible to JS.
|
|
16
|
+
/* allowed uses */
|
|
17
|
+
["sign", "verify"]
|
|
18
|
+
);
|
|
19
|
+
return keyPair;
|
|
20
|
+
}
|
|
8
21
|
|
|
9
|
-
// src/
|
|
10
|
-
function
|
|
22
|
+
// src/private-key.ts
|
|
23
|
+
function addPkcs8Header(bytes) {
|
|
24
|
+
return new Uint8Array([
|
|
25
|
+
/**
|
|
26
|
+
* PKCS#8 header
|
|
27
|
+
*/
|
|
28
|
+
48,
|
|
29
|
+
// ASN.1 sequence tag
|
|
30
|
+
46,
|
|
31
|
+
// Length of sequence (46 more bytes)
|
|
32
|
+
2,
|
|
33
|
+
// ASN.1 integer tag
|
|
34
|
+
1,
|
|
35
|
+
// Length of integer
|
|
36
|
+
0,
|
|
37
|
+
// Version number
|
|
38
|
+
48,
|
|
39
|
+
// ASN.1 sequence tag
|
|
40
|
+
5,
|
|
41
|
+
// Length of sequence
|
|
42
|
+
6,
|
|
43
|
+
// ASN.1 object identifier tag
|
|
44
|
+
3,
|
|
45
|
+
// Length of object identifier
|
|
46
|
+
// Edwards curve algorithms identifier https://oid-rep.orange-labs.fr/get/1.3.101.112
|
|
47
|
+
43,
|
|
48
|
+
// 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)
|
|
49
|
+
101,
|
|
50
|
+
// thawte(101)
|
|
51
|
+
// Ed25519 identifier
|
|
52
|
+
112,
|
|
53
|
+
// id-Ed25519(112)
|
|
54
|
+
/**
|
|
55
|
+
* Private key payload
|
|
56
|
+
*/
|
|
57
|
+
4,
|
|
58
|
+
// ASN.1 octet string tag
|
|
59
|
+
34,
|
|
60
|
+
// String length (34 more bytes)
|
|
61
|
+
// Private key bytes as octet string
|
|
62
|
+
4,
|
|
63
|
+
// ASN.1 octet string tag
|
|
64
|
+
32,
|
|
65
|
+
// String length (32 bytes)
|
|
66
|
+
...bytes
|
|
67
|
+
]);
|
|
68
|
+
}
|
|
69
|
+
async function createPrivateKeyFromBytes(bytes, extractable) {
|
|
70
|
+
if (bytes.byteLength !== 32) {
|
|
71
|
+
throw new Error("Private key bytes must be of length 32");
|
|
72
|
+
}
|
|
73
|
+
const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
|
|
74
|
+
return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
|
|
75
|
+
}
|
|
76
|
+
var base58Encoder;
|
|
77
|
+
function assertIsSignature(putativeSignature) {
|
|
78
|
+
if (!base58Encoder)
|
|
79
|
+
base58Encoder = codecsStrings.getBase58Encoder();
|
|
11
80
|
try {
|
|
12
81
|
if (
|
|
13
|
-
// Lowest
|
|
14
|
-
|
|
15
|
-
|
|
82
|
+
// Lowest value (64 bytes of zeroes)
|
|
83
|
+
putativeSignature.length < 64 || // Highest value (64 bytes of 255)
|
|
84
|
+
putativeSignature.length > 88
|
|
16
85
|
) {
|
|
17
|
-
throw new Error("Expected input string to decode to a byte array of length
|
|
86
|
+
throw new Error("Expected input string to decode to a byte array of length 64.");
|
|
18
87
|
}
|
|
19
|
-
const bytes =
|
|
88
|
+
const bytes = base58Encoder.encode(putativeSignature);
|
|
20
89
|
const numBytes = bytes.byteLength;
|
|
21
|
-
if (numBytes !==
|
|
22
|
-
throw new Error(`Expected input string to decode to a byte array of length
|
|
90
|
+
if (numBytes !== 64) {
|
|
91
|
+
throw new Error(`Expected input string to decode to a byte array of length 64. Actual length: ${numBytes}`);
|
|
23
92
|
}
|
|
24
93
|
} catch (e) {
|
|
25
|
-
throw new Error(`\`${
|
|
94
|
+
throw new Error(`\`${putativeSignature}\` is not a signature`, {
|
|
26
95
|
cause: e
|
|
27
96
|
});
|
|
28
97
|
}
|
|
29
98
|
}
|
|
99
|
+
function isSignature(putativeSignature) {
|
|
100
|
+
if (!base58Encoder)
|
|
101
|
+
base58Encoder = codecsStrings.getBase58Encoder();
|
|
102
|
+
if (
|
|
103
|
+
// Lowest value (64 bytes of zeroes)
|
|
104
|
+
putativeSignature.length < 64 || // Highest value (64 bytes of 255)
|
|
105
|
+
putativeSignature.length > 88
|
|
106
|
+
) {
|
|
107
|
+
return false;
|
|
108
|
+
}
|
|
109
|
+
const bytes = base58Encoder.encode(putativeSignature);
|
|
110
|
+
const numBytes = bytes.byteLength;
|
|
111
|
+
if (numBytes !== 64) {
|
|
112
|
+
return false;
|
|
113
|
+
}
|
|
114
|
+
return true;
|
|
115
|
+
}
|
|
116
|
+
async function signBytes(key, data) {
|
|
117
|
+
await assertions.assertSigningCapabilityIsAvailable();
|
|
118
|
+
const signedData = await crypto.subtle.sign("Ed25519", key, data);
|
|
119
|
+
return new Uint8Array(signedData);
|
|
120
|
+
}
|
|
121
|
+
function signature(putativeSignature) {
|
|
122
|
+
assertIsSignature(putativeSignature);
|
|
123
|
+
return putativeSignature;
|
|
124
|
+
}
|
|
125
|
+
async function verifySignature(key, signature2, data) {
|
|
126
|
+
await assertions.assertVerificationCapabilityIsAvailable();
|
|
127
|
+
return await crypto.subtle.verify("Ed25519", key, signature2, data);
|
|
128
|
+
}
|
|
30
129
|
|
|
31
|
-
exports.
|
|
130
|
+
exports.assertIsSignature = assertIsSignature;
|
|
131
|
+
exports.createPrivateKeyFromBytes = createPrivateKeyFromBytes;
|
|
132
|
+
exports.generateKeyPair = generateKeyPair;
|
|
133
|
+
exports.isSignature = isSignature;
|
|
134
|
+
exports.signBytes = signBytes;
|
|
135
|
+
exports.signature = signature;
|
|
136
|
+
exports.verifySignature = verifySignature;
|
|
32
137
|
//# sourceMappingURL=out.js.map
|
|
33
138
|
//# sourceMappingURL=index.node.cjs.map
|
package/dist/index.node.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/
|
|
1
|
+
{"version":3,"sources":["../src/key-pair.ts","../src/private-key.ts","../src/signatures.ts"],"names":["signature"],"mappings":";AAAA,SAAS,sCAAsC;AAE/C,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;;;ACVA,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;;;AC5CA,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';\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","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,27 +1,130 @@
|
|
|
1
|
-
import
|
|
1
|
+
import { assertKeyGenerationIsAvailable, assertSigningCapabilityIsAvailable, assertVerificationCapabilityIsAvailable } from '@solana/assertions';
|
|
2
|
+
import { getBase58Encoder } from '@solana/codecs-strings';
|
|
2
3
|
|
|
3
|
-
// src/
|
|
4
|
-
function
|
|
4
|
+
// src/key-pair.ts
|
|
5
|
+
async function generateKeyPair() {
|
|
6
|
+
await assertKeyGenerationIsAvailable();
|
|
7
|
+
const keyPair = await crypto.subtle.generateKey(
|
|
8
|
+
/* algorithm */
|
|
9
|
+
"Ed25519",
|
|
10
|
+
// Native implementation status: https://github.com/WICG/webcrypto-secure-curves/issues/20
|
|
11
|
+
/* extractable */
|
|
12
|
+
false,
|
|
13
|
+
// Prevents the bytes of the private key from being visible to JS.
|
|
14
|
+
/* allowed uses */
|
|
15
|
+
["sign", "verify"]
|
|
16
|
+
);
|
|
17
|
+
return keyPair;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
// src/private-key.ts
|
|
21
|
+
function addPkcs8Header(bytes) {
|
|
22
|
+
return new Uint8Array([
|
|
23
|
+
/**
|
|
24
|
+
* PKCS#8 header
|
|
25
|
+
*/
|
|
26
|
+
48,
|
|
27
|
+
// ASN.1 sequence tag
|
|
28
|
+
46,
|
|
29
|
+
// Length of sequence (46 more bytes)
|
|
30
|
+
2,
|
|
31
|
+
// ASN.1 integer tag
|
|
32
|
+
1,
|
|
33
|
+
// Length of integer
|
|
34
|
+
0,
|
|
35
|
+
// Version number
|
|
36
|
+
48,
|
|
37
|
+
// ASN.1 sequence tag
|
|
38
|
+
5,
|
|
39
|
+
// Length of sequence
|
|
40
|
+
6,
|
|
41
|
+
// ASN.1 object identifier tag
|
|
42
|
+
3,
|
|
43
|
+
// Length of object identifier
|
|
44
|
+
// Edwards curve algorithms identifier https://oid-rep.orange-labs.fr/get/1.3.101.112
|
|
45
|
+
43,
|
|
46
|
+
// 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)
|
|
47
|
+
101,
|
|
48
|
+
// thawte(101)
|
|
49
|
+
// Ed25519 identifier
|
|
50
|
+
112,
|
|
51
|
+
// id-Ed25519(112)
|
|
52
|
+
/**
|
|
53
|
+
* Private key payload
|
|
54
|
+
*/
|
|
55
|
+
4,
|
|
56
|
+
// ASN.1 octet string tag
|
|
57
|
+
34,
|
|
58
|
+
// String length (34 more bytes)
|
|
59
|
+
// Private key bytes as octet string
|
|
60
|
+
4,
|
|
61
|
+
// ASN.1 octet string tag
|
|
62
|
+
32,
|
|
63
|
+
// String length (32 bytes)
|
|
64
|
+
...bytes
|
|
65
|
+
]);
|
|
66
|
+
}
|
|
67
|
+
async function createPrivateKeyFromBytes(bytes, extractable) {
|
|
68
|
+
if (bytes.byteLength !== 32) {
|
|
69
|
+
throw new Error("Private key bytes must be of length 32");
|
|
70
|
+
}
|
|
71
|
+
const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
|
|
72
|
+
return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
|
|
73
|
+
}
|
|
74
|
+
var base58Encoder;
|
|
75
|
+
function assertIsSignature(putativeSignature) {
|
|
76
|
+
if (!base58Encoder)
|
|
77
|
+
base58Encoder = getBase58Encoder();
|
|
5
78
|
try {
|
|
6
79
|
if (
|
|
7
|
-
// Lowest
|
|
8
|
-
|
|
9
|
-
|
|
80
|
+
// Lowest value (64 bytes of zeroes)
|
|
81
|
+
putativeSignature.length < 64 || // Highest value (64 bytes of 255)
|
|
82
|
+
putativeSignature.length > 88
|
|
10
83
|
) {
|
|
11
|
-
throw new Error("Expected input string to decode to a byte array of length
|
|
84
|
+
throw new Error("Expected input string to decode to a byte array of length 64.");
|
|
12
85
|
}
|
|
13
|
-
const bytes =
|
|
86
|
+
const bytes = base58Encoder.encode(putativeSignature);
|
|
14
87
|
const numBytes = bytes.byteLength;
|
|
15
|
-
if (numBytes !==
|
|
16
|
-
throw new Error(`Expected input string to decode to a byte array of length
|
|
88
|
+
if (numBytes !== 64) {
|
|
89
|
+
throw new Error(`Expected input string to decode to a byte array of length 64. Actual length: ${numBytes}`);
|
|
17
90
|
}
|
|
18
91
|
} catch (e) {
|
|
19
|
-
throw new Error(`\`${
|
|
92
|
+
throw new Error(`\`${putativeSignature}\` is not a signature`, {
|
|
20
93
|
cause: e
|
|
21
94
|
});
|
|
22
95
|
}
|
|
23
96
|
}
|
|
97
|
+
function isSignature(putativeSignature) {
|
|
98
|
+
if (!base58Encoder)
|
|
99
|
+
base58Encoder = getBase58Encoder();
|
|
100
|
+
if (
|
|
101
|
+
// Lowest value (64 bytes of zeroes)
|
|
102
|
+
putativeSignature.length < 64 || // Highest value (64 bytes of 255)
|
|
103
|
+
putativeSignature.length > 88
|
|
104
|
+
) {
|
|
105
|
+
return false;
|
|
106
|
+
}
|
|
107
|
+
const bytes = base58Encoder.encode(putativeSignature);
|
|
108
|
+
const numBytes = bytes.byteLength;
|
|
109
|
+
if (numBytes !== 64) {
|
|
110
|
+
return false;
|
|
111
|
+
}
|
|
112
|
+
return true;
|
|
113
|
+
}
|
|
114
|
+
async function signBytes(key, data) {
|
|
115
|
+
await assertSigningCapabilityIsAvailable();
|
|
116
|
+
const signedData = await crypto.subtle.sign("Ed25519", key, data);
|
|
117
|
+
return new Uint8Array(signedData);
|
|
118
|
+
}
|
|
119
|
+
function signature(putativeSignature) {
|
|
120
|
+
assertIsSignature(putativeSignature);
|
|
121
|
+
return putativeSignature;
|
|
122
|
+
}
|
|
123
|
+
async function verifySignature(key, signature2, data) {
|
|
124
|
+
await assertVerificationCapabilityIsAvailable();
|
|
125
|
+
return await crypto.subtle.verify("Ed25519", key, signature2, data);
|
|
126
|
+
}
|
|
24
127
|
|
|
25
|
-
export {
|
|
128
|
+
export { assertIsSignature, createPrivateKeyFromBytes, generateKeyPair, isSignature, signBytes, signature, verifySignature };
|
|
26
129
|
//# sourceMappingURL=out.js.map
|
|
27
130
|
//# sourceMappingURL=index.node.js.map
|
package/dist/index.node.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/
|
|
1
|
+
{"version":3,"sources":["../src/key-pair.ts","../src/private-key.ts","../src/signatures.ts"],"names":["signature"],"mappings":";AAAA,SAAS,sCAAsC;AAE/C,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;;;ACVA,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;;;AC5CA,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';\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","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,
|
|
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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"key-pair.d.ts","sourceRoot":"","sources":["../../src/key-pair.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,IAAI,OAAO,CAAC,aAAa,CAAC,CAQ9D"}
|
|
@@ -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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export type Signature = string & {
|
|
2
|
+
readonly __brand: unique symbol;
|
|
3
|
+
};
|
|
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>;
|
|
12
|
+
//# sourceMappingURL=signatures.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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.025ef21",
|
|
4
4
|
"description": "Helpers for generating and transforming key material",
|
|
5
5
|
"exports": {
|
|
6
6
|
"browser": {
|
|
@@ -45,28 +45,31 @@
|
|
|
45
45
|
"supports bigint and not dead",
|
|
46
46
|
"maintained node versions"
|
|
47
47
|
],
|
|
48
|
+
"engine": {
|
|
49
|
+
"node": ">=17.4"
|
|
50
|
+
},
|
|
51
|
+
"dependencies": {
|
|
52
|
+
"@solana/assertions": "2.0.0-experimental.025ef21",
|
|
53
|
+
"@solana/codecs-core": "2.0.0-experimental.025ef21",
|
|
54
|
+
"@solana/codecs-strings": "2.0.0-experimental.025ef21"
|
|
55
|
+
},
|
|
48
56
|
"devDependencies": {
|
|
49
|
-
"@solana/eslint-config-solana": "^1.0.
|
|
50
|
-
"@swc/
|
|
51
|
-
"@
|
|
52
|
-
"@
|
|
53
|
-
"@typescript-eslint/
|
|
54
|
-
"@typescript-eslint/parser": "^5.57.1",
|
|
57
|
+
"@solana/eslint-config-solana": "^1.0.2",
|
|
58
|
+
"@swc/jest": "^0.2.29",
|
|
59
|
+
"@types/jest": "^29.5.11",
|
|
60
|
+
"@typescript-eslint/eslint-plugin": "^6.13.2",
|
|
61
|
+
"@typescript-eslint/parser": "^6.3.0",
|
|
55
62
|
"agadoo": "^3.0.0",
|
|
56
|
-
"eslint": "^8.
|
|
57
|
-
"eslint-plugin-jest": "^27.
|
|
58
|
-
"eslint-plugin-react-hooks": "^4.6.0",
|
|
63
|
+
"eslint": "^8.45.0",
|
|
64
|
+
"eslint-plugin-jest": "^27.4.2",
|
|
59
65
|
"eslint-plugin-sort-keys-fix": "^1.1.2",
|
|
60
|
-
"jest": "^29.
|
|
61
|
-
"jest-environment-jsdom": "^29.
|
|
62
|
-
"jest-runner-eslint": "^2.
|
|
66
|
+
"jest": "^29.7.0",
|
|
67
|
+
"jest-environment-jsdom": "^29.7.0",
|
|
68
|
+
"jest-runner-eslint": "^2.1.2",
|
|
63
69
|
"jest-runner-prettier": "^1.0.0",
|
|
64
|
-
"
|
|
65
|
-
"
|
|
66
|
-
"
|
|
67
|
-
"tsup": "6.7.0",
|
|
68
|
-
"turbo": "^1.6.3",
|
|
69
|
-
"typescript": "^5.0.3",
|
|
70
|
+
"prettier": "^3.1",
|
|
71
|
+
"tsup": "^8.0.1",
|
|
72
|
+
"typescript": "^5.2.2",
|
|
70
73
|
"version-from-git": "^1.1.1",
|
|
71
74
|
"build-scripts": "0.0.0",
|
|
72
75
|
"test-config": "0.0.0",
|
|
@@ -80,19 +83,17 @@
|
|
|
80
83
|
}
|
|
81
84
|
]
|
|
82
85
|
},
|
|
83
|
-
"dependencies": {
|
|
84
|
-
"bs58": "^5.0.0"
|
|
85
|
-
},
|
|
86
86
|
"scripts": {
|
|
87
|
-
"compile:js": "tsup --config build-scripts/tsup.config.
|
|
88
|
-
"compile:typedefs": "tsc -p ./tsconfig.declarations.json",
|
|
87
|
+
"compile:js": "tsup --config build-scripts/tsup.config.package.ts",
|
|
88
|
+
"compile:typedefs": "tsc -p ./tsconfig.declarations.json && node node_modules/build-scripts/add-js-extension-to-types.mjs",
|
|
89
89
|
"dev": "jest -c node_modules/test-config/jest-dev.config.ts --rootDir . --watch",
|
|
90
90
|
"publish-packages": "pnpm publish --tag experimental --access public --no-git-checks",
|
|
91
|
+
"style:fix": "pnpm eslint --fix src/* && pnpm prettier -w src/* package.json",
|
|
91
92
|
"test:lint": "jest -c node_modules/test-config/jest-lint.config.ts --rootDir . --silent",
|
|
92
93
|
"test:prettier": "jest -c node_modules/test-config/jest-prettier.config.ts --rootDir . --silent",
|
|
93
94
|
"test:treeshakability:browser": "agadoo dist/index.browser.js",
|
|
94
|
-
"test:treeshakability:native": "agadoo dist/index.
|
|
95
|
-
"test:treeshakability:node": "agadoo dist/index.
|
|
95
|
+
"test:treeshakability:native": "agadoo dist/index.native.js",
|
|
96
|
+
"test:treeshakability:node": "agadoo dist/index.node.js",
|
|
96
97
|
"test:typecheck": "tsc --noEmit",
|
|
97
98
|
"test:unit:browser": "jest -c node_modules/test-config/jest-unit.config.browser.ts --rootDir . --silent",
|
|
98
99
|
"test:unit:node": "jest -c node_modules/test-config/jest-unit.config.node.ts --rootDir . --silent"
|