@solana/keys 2.0.0-experimental.0a6605f → 2.0.0-experimental.0af01ac

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,97 +1,69 @@
1
1
  'use strict';
2
2
 
3
- var umiSerializers = require('@metaplex-foundation/umi-serializers');
3
+ var assertions = require('@solana/assertions');
4
+ var errors = require('@solana/errors');
5
+ var codecsStrings = require('@solana/codecs-strings');
4
6
 
5
- // ../build-scripts/env-shim.ts
6
- var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
7
- function assertIsBase58EncodedAddress(putativeBase58EncodedAddress) {
8
- try {
9
- if (
10
- // Lowest address (32 bytes of zeroes)
11
- putativeBase58EncodedAddress.length < 32 || // Highest address (32 bytes of 255)
12
- putativeBase58EncodedAddress.length > 44
13
- ) {
14
- throw new Error("Expected input string to decode to a byte array of length 32.");
15
- }
16
- const bytes = umiSerializers.base58.serialize(putativeBase58EncodedAddress);
17
- const numBytes = bytes.byteLength;
18
- if (numBytes !== 32) {
19
- throw new Error(`Expected input string to decode to a byte array of length 32. Actual length: ${numBytes}`);
20
- }
21
- } catch (e) {
22
- throw new Error(`\`${putativeBase58EncodedAddress}\` is not a base-58 encoded address`, {
23
- cause: e
24
- });
25
- }
26
- }
27
- function getBase58EncodedAddressCodec(config) {
28
- return umiSerializers.string({
29
- description: config?.description ?? (__DEV__ ? "A 32-byte account address" : ""),
30
- encoding: umiSerializers.base58,
31
- size: 32
32
- });
33
- }
34
- function getBase58EncodedAddressComparator() {
35
- return new Intl.Collator("en", {
36
- caseFirst: "lower",
37
- ignorePunctuation: false,
38
- localeMatcher: "best fit",
39
- numeric: false,
40
- sensitivity: "variant",
41
- usage: "sort"
42
- }).compare;
43
- }
44
- var cachedEd25519Decision;
45
- async function isEd25519CurveSupported(subtle) {
46
- if (cachedEd25519Decision === void 0) {
47
- cachedEd25519Decision = new Promise((resolve) => {
48
- subtle.generateKey(
49
- "Ed25519",
50
- /* extractable */
51
- false,
52
- ["sign", "verify"]
53
- ).catch(() => {
54
- resolve(cachedEd25519Decision = false);
55
- }).then(() => {
56
- resolve(cachedEd25519Decision = true);
57
- });
58
- });
59
- }
60
- if (typeof cachedEd25519Decision === "boolean") {
61
- return cachedEd25519Decision;
62
- } else {
63
- return await cachedEd25519Decision;
64
- }
65
- }
66
- async function assertKeyGenerationIsAvailable() {
67
- if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.generateKey !== "function") {
68
- throw new Error("No key generation implementation could be found");
69
- }
70
- if (!await isEd25519CurveSupported(globalThis.crypto.subtle)) {
71
- throw new Error(
72
- "This runtime does not support the generation of Ed25519 key pairs.\n\nInstall and import `@solana/webcrypto-ed25519-polyfill` before generating keys in environments that do not support Ed25519.\n\nFor a list of runtimes that currently support Ed25519 operations, visit https://github.com/WICG/webcrypto-secure-curves/issues/20"
73
- );
74
- }
75
- }
76
- async function assertKeyExporterIsAvailable() {
77
- if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.exportKey !== "function") {
78
- throw new Error("No key export implementation could be found");
79
- }
80
- }
81
- async function assertSigningCapabilityIsAvailable() {
82
- if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.sign !== "function") {
83
- throw new Error("No signing implementation could be found");
84
- }
7
+ // src/key-pair.ts
8
+
9
+ // src/private-key.ts
10
+ function addPkcs8Header(bytes) {
11
+ return new Uint8Array([
12
+ /**
13
+ * PKCS#8 header
14
+ */
15
+ 48,
16
+ // ASN.1 sequence tag
17
+ 46,
18
+ // Length of sequence (46 more bytes)
19
+ 2,
20
+ // ASN.1 integer tag
21
+ 1,
22
+ // Length of integer
23
+ 0,
24
+ // Version number
25
+ 48,
26
+ // ASN.1 sequence tag
27
+ 5,
28
+ // Length of sequence
29
+ 6,
30
+ // ASN.1 object identifier tag
31
+ 3,
32
+ // Length of object identifier
33
+ // Edwards curve algorithms identifier https://oid-rep.orange-labs.fr/get/1.3.101.112
34
+ 43,
35
+ // iso(1) / identified-organization(3) (The first node is multiplied by the decimal 40 and the result is added to the value of the second node)
36
+ 101,
37
+ // thawte(101)
38
+ // Ed25519 identifier
39
+ 112,
40
+ // id-Ed25519(112)
41
+ /**
42
+ * Private key payload
43
+ */
44
+ 4,
45
+ // ASN.1 octet string tag
46
+ 34,
47
+ // String length (34 more bytes)
48
+ // Private key bytes as octet string
49
+ 4,
50
+ // ASN.1 octet string tag
51
+ 32,
52
+ // String length (32 bytes)
53
+ ...bytes
54
+ ]);
85
55
  }
86
- async function assertVerificationCapabilityIsAvailable() {
87
- if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.verify !== "function") {
88
- throw new Error("No signature verification implementation could be found");
56
+ async function createPrivateKeyFromBytes(bytes, extractable) {
57
+ if (bytes.byteLength !== 32) {
58
+ throw new Error("Private key bytes must be of length 32");
89
59
  }
60
+ const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
61
+ return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
90
62
  }
91
63
 
92
64
  // src/key-pair.ts
93
65
  async function generateKeyPair() {
94
- await assertKeyGenerationIsAvailable();
66
+ await assertions.assertKeyGenerationIsAvailable();
95
67
  const keyPair = await crypto.subtle.generateKey(
96
68
  /* algorithm */
97
69
  "Ed25519",
@@ -104,35 +76,84 @@ async function generateKeyPair() {
104
76
  );
105
77
  return keyPair;
106
78
  }
107
-
108
- // src/pubkey.ts
109
- async function getBase58EncodedAddressFromPublicKey(publicKey) {
110
- await assertKeyExporterIsAvailable();
111
- if (publicKey.type !== "public" || publicKey.algorithm.name !== "Ed25519") {
112
- throw new Error("The `CryptoKey` must be an `Ed25519` public key");
79
+ async function createKeyPairFromBytes(bytes, extractable) {
80
+ if (bytes.byteLength !== 64) {
81
+ throw new errors.SolanaError(errors.SOLANA_ERROR__INVALID_KEYPAIR_BYTES, { byteLength: bytes.byteLength });
113
82
  }
114
- const publicKeyBytes = await crypto.subtle.exportKey("raw", publicKey);
115
- const [base58EncodedAddress] = getBase58EncodedAddressCodec().deserialize(new Uint8Array(publicKeyBytes));
116
- return base58EncodedAddress;
83
+ const [publicKey, privateKey] = await Promise.all([
84
+ crypto.subtle.importKey(
85
+ "raw",
86
+ bytes.slice(32),
87
+ "Ed25519",
88
+ /* extractable */
89
+ true,
90
+ ["verify"]
91
+ ),
92
+ createPrivateKeyFromBytes(bytes.slice(0, 32), extractable)
93
+ ]);
94
+ return { privateKey, publicKey };
95
+ }
96
+ var base58Encoder;
97
+ function assertIsSignature(putativeSignature) {
98
+ if (!base58Encoder)
99
+ base58Encoder = codecsStrings.getBase58Encoder();
100
+ try {
101
+ if (
102
+ // Lowest value (64 bytes of zeroes)
103
+ putativeSignature.length < 64 || // Highest value (64 bytes of 255)
104
+ putativeSignature.length > 88
105
+ ) {
106
+ throw new Error("Expected input string to decode to a byte array of length 64.");
107
+ }
108
+ const bytes = base58Encoder.encode(putativeSignature);
109
+ const numBytes = bytes.byteLength;
110
+ if (numBytes !== 64) {
111
+ throw new Error(`Expected input string to decode to a byte array of length 64. Actual length: ${numBytes}`);
112
+ }
113
+ } catch (e) {
114
+ throw new Error(`\`${putativeSignature}\` is not a signature`, {
115
+ cause: e
116
+ });
117
+ }
118
+ }
119
+ function isSignature(putativeSignature) {
120
+ if (!base58Encoder)
121
+ base58Encoder = codecsStrings.getBase58Encoder();
122
+ if (
123
+ // Lowest value (64 bytes of zeroes)
124
+ putativeSignature.length < 64 || // Highest value (64 bytes of 255)
125
+ putativeSignature.length > 88
126
+ ) {
127
+ return false;
128
+ }
129
+ const bytes = base58Encoder.encode(putativeSignature);
130
+ const numBytes = bytes.byteLength;
131
+ if (numBytes !== 64) {
132
+ return false;
133
+ }
134
+ return true;
117
135
  }
118
-
119
- // src/signatures.ts
120
136
  async function signBytes(key, data) {
121
- await assertSigningCapabilityIsAvailable();
137
+ await assertions.assertSigningCapabilityIsAvailable();
122
138
  const signedData = await crypto.subtle.sign("Ed25519", key, data);
123
139
  return new Uint8Array(signedData);
124
140
  }
125
- async function verifySignature(key, signature, data) {
126
- await assertVerificationCapabilityIsAvailable();
127
- return await crypto.subtle.verify("Ed25519", key, signature, data);
141
+ function signature(putativeSignature) {
142
+ assertIsSignature(putativeSignature);
143
+ return putativeSignature;
144
+ }
145
+ async function verifySignature(key, signature2, data) {
146
+ await assertions.assertVerificationCapabilityIsAvailable();
147
+ return await crypto.subtle.verify("Ed25519", key, signature2, data);
128
148
  }
129
149
 
130
- exports.assertIsBase58EncodedAddress = assertIsBase58EncodedAddress;
150
+ exports.assertIsSignature = assertIsSignature;
151
+ exports.createKeyPairFromBytes = createKeyPairFromBytes;
152
+ exports.createPrivateKeyFromBytes = createPrivateKeyFromBytes;
131
153
  exports.generateKeyPair = generateKeyPair;
132
- exports.getBase58EncodedAddressCodec = getBase58EncodedAddressCodec;
133
- exports.getBase58EncodedAddressComparator = getBase58EncodedAddressComparator;
134
- exports.getBase58EncodedAddressFromPublicKey = getBase58EncodedAddressFromPublicKey;
154
+ exports.isSignature = isSignature;
135
155
  exports.signBytes = signBytes;
156
+ exports.signature = signature;
136
157
  exports.verifySignature = verifySignature;
137
158
  //# sourceMappingURL=out.js.map
138
159
  //# sourceMappingURL=index.node.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../../build-scripts/env-shim.ts","../src/base58.ts","../src/guard.ts","../src/key-pair.ts","../src/pubkey.ts","../src/signatures.ts"],"names":[],"mappings":";AACO,IAAM,UAA2B,uBAAO,QAAgB,KAAU,EAAE,aAAa,eAAe;;;ACDvG,SAAS,QAAoB,cAAc;AAMpC,SAAS,6BACZ,8BACiG;AACjG,MAAI;AAEA;AAAA;AAAA,MAEI,6BAA6B,SAAS;AAAA,MAEtC,6BAA6B,SAAS;AAAA,MACxC;AACE,YAAM,IAAI,MAAM,+DAA+D;AAAA,IACnF;AAEA,UAAM,QAAQ,OAAO,UAAU,4BAA4B;AAC3D,UAAM,WAAW,MAAM;AACvB,QAAI,aAAa,IAAI;AACjB,YAAM,IAAI,MAAM,gFAAgF,UAAU;AAAA,IAC9G;AAAA,EACJ,SAAS,GAAP;AACE,UAAM,IAAI,MAAM,KAAK,mEAAmE;AAAA,MACpF,OAAO;AAAA,IACX,CAAC;AAAA,EACL;AACJ;AAEO,SAAS,6BACZ,QAGgC;AAChC,SAAO,OAAO;AAAA,IACV,aAAa,QAAQ,gBAAgB,UAAU,8BAA8B;AAAA,IAC7E,UAAU;AAAA,IACV,MAAM;AAAA,EACV,CAAC;AACL;AAEO,SAAS,oCAAsE;AAClF,SAAO,IAAI,KAAK,SAAS,MAAM;AAAA,IAC3B,WAAW;AAAA,IACX,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,SAAS;AAAA,IACT,aAAa;AAAA,IACb,OAAO;AAAA,EACX,CAAC,EAAE;AACP;;;ACrDA,SAAS,wBAAwB;AAC7B,MAAI,OAA4C;AAE5C,UAAM,IAAI;AAAA,MACN;AAAA,IAEJ;AAAA,EACJ;AACJ;AAEA,IAAI;AACJ,eAAe,wBAAwB,QAAwC;AAC3E,MAAI,0BAA0B,QAAW;AACrC,4BAAwB,IAAI,QAAQ,aAAW;AAC3C,aACK;AAAA,QAAY;AAAA;AAAA,QAA6B;AAAA,QAAO,CAAC,QAAQ,QAAQ;AAAA,MAAC,EAClE,MAAM,MAAM;AACT,gBAAS,wBAAwB,KAAM;AAAA,MAC3C,CAAC,EACA,KAAK,MAAM;AACR,gBAAS,wBAAwB,IAAK;AAAA,MAC1C,CAAC;AAAA,IACT,CAAC;AAAA,EACL;AACA,MAAI,OAAO,0BAA0B,WAAW;AAC5C,WAAO;AAAA,EACX,OAAO;AACH,WAAO,MAAM;AAAA,EACjB;AACJ;AAEA,eAAsB,iCAAiC;AACnD,wBAAsB;AACtB,MAAI,OAAO,WAAW,WAAW,eAAe,OAAO,WAAW,OAAO,QAAQ,gBAAgB,YAAY;AAEzG,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACrE;AACA,MAAI,CAAE,MAAM,wBAAwB,WAAW,OAAO,MAAM,GAAI;AAE5D,UAAM,IAAI;AAAA,MACN;AAAA,IAKJ;AAAA,EACJ;AACJ;AAEA,eAAsB,+BAA+B;AACjD,wBAAsB;AACtB,MAAI,OAAO,WAAW,WAAW,eAAe,OAAO,WAAW,OAAO,QAAQ,cAAc,YAAY;AAEvG,UAAM,IAAI,MAAM,6CAA6C;AAAA,EACjE;AACJ;AAEA,eAAsB,qCAAqC;AACvD,wBAAsB;AACtB,MAAI,OAAO,WAAW,WAAW,eAAe,OAAO,WAAW,OAAO,QAAQ,SAAS,YAAY;AAElG,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC9D;AACJ;AAEA,eAAsB,0CAA0C;AAC5D,wBAAsB;AACtB,MAAI,OAAO,WAAW,WAAW,eAAe,OAAO,WAAW,OAAO,QAAQ,WAAW,YAAY;AAEpG,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC7E;AACJ;;;ACrEA,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;;;ACPA,eAAsB,qCAAqC,WAAqD;AAC5G,QAAM,6BAA6B;AACnC,MAAI,UAAU,SAAS,YAAY,UAAU,UAAU,SAAS,WAAW;AAEvE,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACrE;AACA,QAAM,iBAAiB,MAAM,OAAO,OAAO,UAAU,OAAO,SAAS;AACrE,QAAM,CAAC,oBAAoB,IAAI,6BAA6B,EAAE,YAAY,IAAI,WAAW,cAAc,CAAC;AACxG,SAAO;AACX;;;ACRA,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":["// Clever obfuscation to prevent the build system from inlining the value of `NODE_ENV`\nexport const __DEV__ = /* @__PURE__ */ (() => (process as any)['en' + 'v'].NODE_ENV === 'development')();\n","import { base58, Serializer, string } from '@metaplex-foundation/umi-serializers';\n\nexport type Base58EncodedAddress<TAddress extends string = string> = TAddress & {\n readonly __base58EncodedAddress: unique symbol;\n};\n\nexport function assertIsBase58EncodedAddress(\n putativeBase58EncodedAddress: string\n): asserts putativeBase58EncodedAddress is Base58EncodedAddress<typeof putativeBase58EncodedAddress> {\n try {\n // Fast-path; see if the input string is of an acceptable length.\n if (\n // Lowest address (32 bytes of zeroes)\n putativeBase58EncodedAddress.length < 32 ||\n // Highest address (32 bytes of 255)\n putativeBase58EncodedAddress.length > 44\n ) {\n throw new Error('Expected input string to decode to a byte array of length 32.');\n }\n // Slow-path; actually attempt to decode the input string.\n const bytes = base58.serialize(putativeBase58EncodedAddress);\n const numBytes = bytes.byteLength;\n if (numBytes !== 32) {\n throw new Error(`Expected input string to decode to a byte array of length 32. Actual length: ${numBytes}`);\n }\n } catch (e) {\n throw new Error(`\\`${putativeBase58EncodedAddress}\\` is not a base-58 encoded address`, {\n cause: e,\n });\n }\n}\n\nexport function getBase58EncodedAddressCodec(\n config?: Readonly<{\n description: string;\n }>\n): Serializer<Base58EncodedAddress> {\n return string({\n description: config?.description ?? (__DEV__ ? 'A 32-byte account address' : ''),\n encoding: base58,\n size: 32,\n }) as unknown as Serializer<Base58EncodedAddress>;\n}\n\nexport function getBase58EncodedAddressComparator(): (x: string, y: string) => number {\n return new Intl.Collator('en', {\n caseFirst: 'lower',\n ignorePunctuation: false,\n localeMatcher: 'best fit',\n numeric: false,\n sensitivity: 'variant',\n usage: 'sort',\n }).compare;\n}\n","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 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 './guard';\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 { Base58EncodedAddress, getBase58EncodedAddressCodec } from './base58';\nimport { assertKeyExporterIsAvailable } from './guard';\n\nexport async function getBase58EncodedAddressFromPublicKey(publicKey: CryptoKey): Promise<Base58EncodedAddress> {\n await assertKeyExporterIsAvailable();\n if (publicKey.type !== 'public' || publicKey.algorithm.name !== 'Ed25519') {\n // TODO: Coded error.\n throw new Error('The `CryptoKey` must be an `Ed25519` public key');\n }\n const publicKeyBytes = await crypto.subtle.exportKey('raw', publicKey);\n const [base58EncodedAddress] = getBase58EncodedAddressCodec().deserialize(new Uint8Array(publicKeyBytes));\n return base58EncodedAddress;\n}\n","import { assertSigningCapabilityIsAvailable, assertVerificationCapabilityIsAvailable } from './guard';\n\nexport type Ed25519Signature = Uint8Array & { readonly __ed25519Signature: 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
+ {"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"]}
@@ -1,90 +1,62 @@
1
- import { base58, string } from '@metaplex-foundation/umi-serializers';
1
+ import { assertKeyGenerationIsAvailable, assertSigningCapabilityIsAvailable, assertVerificationCapabilityIsAvailable } from '@solana/assertions';
2
+ import { SolanaError, SOLANA_ERROR__INVALID_KEYPAIR_BYTES } from '@solana/errors';
3
+ import { getBase58Encoder } from '@solana/codecs-strings';
2
4
 
3
- // ../build-scripts/env-shim.ts
4
- var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
5
- function assertIsBase58EncodedAddress(putativeBase58EncodedAddress) {
6
- try {
7
- if (
8
- // Lowest address (32 bytes of zeroes)
9
- putativeBase58EncodedAddress.length < 32 || // Highest address (32 bytes of 255)
10
- putativeBase58EncodedAddress.length > 44
11
- ) {
12
- throw new Error("Expected input string to decode to a byte array of length 32.");
13
- }
14
- const bytes = base58.serialize(putativeBase58EncodedAddress);
15
- const numBytes = bytes.byteLength;
16
- if (numBytes !== 32) {
17
- throw new Error(`Expected input string to decode to a byte array of length 32. Actual length: ${numBytes}`);
18
- }
19
- } catch (e) {
20
- throw new Error(`\`${putativeBase58EncodedAddress}\` is not a base-58 encoded address`, {
21
- cause: e
22
- });
23
- }
24
- }
25
- function getBase58EncodedAddressCodec(config) {
26
- return string({
27
- description: config?.description ?? (__DEV__ ? "A 32-byte account address" : ""),
28
- encoding: base58,
29
- size: 32
30
- });
31
- }
32
- function getBase58EncodedAddressComparator() {
33
- return new Intl.Collator("en", {
34
- caseFirst: "lower",
35
- ignorePunctuation: false,
36
- localeMatcher: "best fit",
37
- numeric: false,
38
- sensitivity: "variant",
39
- usage: "sort"
40
- }).compare;
41
- }
42
- var cachedEd25519Decision;
43
- async function isEd25519CurveSupported(subtle) {
44
- if (cachedEd25519Decision === void 0) {
45
- cachedEd25519Decision = new Promise((resolve) => {
46
- subtle.generateKey(
47
- "Ed25519",
48
- /* extractable */
49
- false,
50
- ["sign", "verify"]
51
- ).catch(() => {
52
- resolve(cachedEd25519Decision = false);
53
- }).then(() => {
54
- resolve(cachedEd25519Decision = true);
55
- });
56
- });
57
- }
58
- if (typeof cachedEd25519Decision === "boolean") {
59
- return cachedEd25519Decision;
60
- } else {
61
- return await cachedEd25519Decision;
62
- }
63
- }
64
- async function assertKeyGenerationIsAvailable() {
65
- if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.generateKey !== "function") {
66
- throw new Error("No key generation implementation could be found");
67
- }
68
- if (!await isEd25519CurveSupported(globalThis.crypto.subtle)) {
69
- throw new Error(
70
- "This runtime does not support the generation of Ed25519 key pairs.\n\nInstall and import `@solana/webcrypto-ed25519-polyfill` before generating keys in environments that do not support Ed25519.\n\nFor a list of runtimes that currently support Ed25519 operations, visit https://github.com/WICG/webcrypto-secure-curves/issues/20"
71
- );
72
- }
73
- }
74
- async function assertKeyExporterIsAvailable() {
75
- if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.exportKey !== "function") {
76
- throw new Error("No key export implementation could be found");
77
- }
78
- }
79
- async function assertSigningCapabilityIsAvailable() {
80
- if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.sign !== "function") {
81
- throw new Error("No signing implementation could be found");
82
- }
5
+ // src/key-pair.ts
6
+
7
+ // src/private-key.ts
8
+ function addPkcs8Header(bytes) {
9
+ return new Uint8Array([
10
+ /**
11
+ * PKCS#8 header
12
+ */
13
+ 48,
14
+ // ASN.1 sequence tag
15
+ 46,
16
+ // Length of sequence (46 more bytes)
17
+ 2,
18
+ // ASN.1 integer tag
19
+ 1,
20
+ // Length of integer
21
+ 0,
22
+ // Version number
23
+ 48,
24
+ // ASN.1 sequence tag
25
+ 5,
26
+ // Length of sequence
27
+ 6,
28
+ // ASN.1 object identifier tag
29
+ 3,
30
+ // Length of object identifier
31
+ // Edwards curve algorithms identifier https://oid-rep.orange-labs.fr/get/1.3.101.112
32
+ 43,
33
+ // iso(1) / identified-organization(3) (The first node is multiplied by the decimal 40 and the result is added to the value of the second node)
34
+ 101,
35
+ // thawte(101)
36
+ // Ed25519 identifier
37
+ 112,
38
+ // id-Ed25519(112)
39
+ /**
40
+ * Private key payload
41
+ */
42
+ 4,
43
+ // ASN.1 octet string tag
44
+ 34,
45
+ // String length (34 more bytes)
46
+ // Private key bytes as octet string
47
+ 4,
48
+ // ASN.1 octet string tag
49
+ 32,
50
+ // String length (32 bytes)
51
+ ...bytes
52
+ ]);
83
53
  }
84
- async function assertVerificationCapabilityIsAvailable() {
85
- if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.subtle?.verify !== "function") {
86
- throw new Error("No signature verification implementation could be found");
54
+ async function createPrivateKeyFromBytes(bytes, extractable) {
55
+ if (bytes.byteLength !== 32) {
56
+ throw new Error("Private key bytes must be of length 32");
87
57
  }
58
+ const privateKeyBytesPkcs8 = addPkcs8Header(bytes);
59
+ return await crypto.subtle.importKey("pkcs8", privateKeyBytesPkcs8, "Ed25519", extractable ?? false, ["sign"]);
88
60
  }
89
61
 
90
62
  // src/key-pair.ts
@@ -102,29 +74,77 @@ async function generateKeyPair() {
102
74
  );
103
75
  return keyPair;
104
76
  }
105
-
106
- // src/pubkey.ts
107
- async function getBase58EncodedAddressFromPublicKey(publicKey) {
108
- await assertKeyExporterIsAvailable();
109
- if (publicKey.type !== "public" || publicKey.algorithm.name !== "Ed25519") {
110
- throw new Error("The `CryptoKey` must be an `Ed25519` public key");
77
+ async function createKeyPairFromBytes(bytes, extractable) {
78
+ if (bytes.byteLength !== 64) {
79
+ throw new SolanaError(SOLANA_ERROR__INVALID_KEYPAIR_BYTES, { byteLength: bytes.byteLength });
111
80
  }
112
- const publicKeyBytes = await crypto.subtle.exportKey("raw", publicKey);
113
- const [base58EncodedAddress] = getBase58EncodedAddressCodec().deserialize(new Uint8Array(publicKeyBytes));
114
- return base58EncodedAddress;
81
+ const [publicKey, privateKey] = await Promise.all([
82
+ crypto.subtle.importKey(
83
+ "raw",
84
+ bytes.slice(32),
85
+ "Ed25519",
86
+ /* extractable */
87
+ true,
88
+ ["verify"]
89
+ ),
90
+ createPrivateKeyFromBytes(bytes.slice(0, 32), extractable)
91
+ ]);
92
+ return { privateKey, publicKey };
93
+ }
94
+ var base58Encoder;
95
+ function assertIsSignature(putativeSignature) {
96
+ if (!base58Encoder)
97
+ base58Encoder = getBase58Encoder();
98
+ try {
99
+ if (
100
+ // Lowest value (64 bytes of zeroes)
101
+ putativeSignature.length < 64 || // Highest value (64 bytes of 255)
102
+ putativeSignature.length > 88
103
+ ) {
104
+ throw new Error("Expected input string to decode to a byte array of length 64.");
105
+ }
106
+ const bytes = base58Encoder.encode(putativeSignature);
107
+ const numBytes = bytes.byteLength;
108
+ if (numBytes !== 64) {
109
+ throw new Error(`Expected input string to decode to a byte array of length 64. Actual length: ${numBytes}`);
110
+ }
111
+ } catch (e) {
112
+ throw new Error(`\`${putativeSignature}\` is not a signature`, {
113
+ cause: e
114
+ });
115
+ }
116
+ }
117
+ function isSignature(putativeSignature) {
118
+ if (!base58Encoder)
119
+ base58Encoder = getBase58Encoder();
120
+ if (
121
+ // Lowest value (64 bytes of zeroes)
122
+ putativeSignature.length < 64 || // Highest value (64 bytes of 255)
123
+ putativeSignature.length > 88
124
+ ) {
125
+ return false;
126
+ }
127
+ const bytes = base58Encoder.encode(putativeSignature);
128
+ const numBytes = bytes.byteLength;
129
+ if (numBytes !== 64) {
130
+ return false;
131
+ }
132
+ return true;
115
133
  }
116
-
117
- // src/signatures.ts
118
134
  async function signBytes(key, data) {
119
135
  await assertSigningCapabilityIsAvailable();
120
136
  const signedData = await crypto.subtle.sign("Ed25519", key, data);
121
137
  return new Uint8Array(signedData);
122
138
  }
123
- async function verifySignature(key, signature, data) {
139
+ function signature(putativeSignature) {
140
+ assertIsSignature(putativeSignature);
141
+ return putativeSignature;
142
+ }
143
+ async function verifySignature(key, signature2, data) {
124
144
  await assertVerificationCapabilityIsAvailable();
125
- return await crypto.subtle.verify("Ed25519", key, signature, data);
145
+ return await crypto.subtle.verify("Ed25519", key, signature2, data);
126
146
  }
127
147
 
128
- export { assertIsBase58EncodedAddress, generateKeyPair, getBase58EncodedAddressCodec, getBase58EncodedAddressComparator, getBase58EncodedAddressFromPublicKey, signBytes, verifySignature };
148
+ export { assertIsSignature, createKeyPairFromBytes, createPrivateKeyFromBytes, generateKeyPair, isSignature, signBytes, signature, verifySignature };
129
149
  //# sourceMappingURL=out.js.map
130
150
  //# sourceMappingURL=index.node.js.map