1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
|
const std = @import("std");
const ascii = std.ascii;
const base32 = @import("base32.zig");
const crc16 = @import("crc16.zig");
const crypto = std.crypto;
const Ed25519 = crypto.sign.Ed25519;
const mem = std.mem;
const testing = std.testing;
pub const InvalidPrefixByteError = error{InvalidPrefixByte};
pub const InvalidEncodingError = error{InvalidEncoding};
pub const InvalidPrivateKeyError = error{InvalidPrivateKey};
pub const InvalidSeedError = error{InvalidSeed};
pub const InvalidSignatureError = error{InvalidSignature};
pub const NoNkeySeedFoundError = error{NoNkeySeedFound};
pub const NoNkeyUserSeedFoundError = error{NoNkeyUserSeedFound};
pub const DecodeError = InvalidPrefixByteError || base32.DecodeError || crc16.InvalidChecksumError;
pub const SeedDecodeError = DecodeError || InvalidSeedError || crypto.errors.IdentityElementError;
pub const PrivateKeyDecodeError = DecodeError || InvalidPrivateKeyError || crypto.errors.IdentityElementError;
pub const SignError = crypto.errors.IdentityElementError || crypto.errors.WeakPublicKeyError || crypto.errors.KeyMismatchError;
pub const prefix_byte_account = 0; // A
pub const prefix_byte_cluster = 2 << 3; // C
pub const prefix_byte_operator = 14 << 3; // O
pub const prefix_byte_private = 15 << 3; // P
pub const prefix_byte_seed = 18 << 3; // S
pub const prefix_byte_server = 13 << 3; // N
pub const prefix_byte_user = 20 << 3; // U
pub fn prefixByteToLetter(prefix_byte: u8) ?u8 {
return switch (prefix_byte) {
prefix_byte_account => 'A',
prefix_byte_cluster => 'C',
prefix_byte_operator => 'O',
prefix_byte_private => 'P',
prefix_byte_seed => 'S',
prefix_byte_server => 'N',
prefix_byte_user => 'U',
else => null,
};
}
pub fn prefixByteFromLetter(letter: u8) ?u8 {
return switch (letter) {
'A' => prefix_byte_account,
'C' => prefix_byte_cluster,
'O' => prefix_byte_operator,
'P' => prefix_byte_private,
'S' => prefix_byte_seed,
'N' => prefix_byte_server,
'U' => prefix_byte_user,
else => null,
};
}
pub const Role = enum(u8) {
const Self = @This();
account,
cluster,
operator,
server,
user,
pub fn fromPublicPrefixByte(b: u8) ?Self {
return switch (b) {
prefix_byte_account => .account,
prefix_byte_cluster => .cluster,
prefix_byte_operator => .operator,
prefix_byte_server => .server,
prefix_byte_user => .user,
else => null,
};
}
pub fn publicPrefixByte(self: Self) u8 {
return switch (self) {
.account => prefix_byte_account,
.cluster => prefix_byte_cluster,
.operator => prefix_byte_operator,
.server => prefix_byte_server,
.user => prefix_byte_user,
};
}
pub fn letter(self: Self) u8 {
return prefixByteToLetter(self.publicPrefixByte()) orelse unreachable;
}
};
// One prefix byte, two CRC bytes
const binary_private_size = 1 + Ed25519.secret_length + 2;
// One prefix byte, two CRC bytes
const binary_public_size = 1 + Ed25519.public_length + 2;
// Two prefix bytes, two CRC bytes
const binary_seed_size = 2 + Ed25519.seed_length + 2;
pub const text_private_len = base32.Encoder.calcSize(binary_private_size);
pub const text_public_len = base32.Encoder.calcSize(binary_public_size);
pub const text_seed_len = base32.Encoder.calcSize(binary_seed_size);
pub const text_private = [text_private_len]u8;
pub const text_public = [text_public_len]u8;
pub const text_seed = [text_seed_len]u8;
pub const SeedKeyPair = struct {
const Self = @This();
role: Role,
kp: Ed25519.KeyPair,
pub fn generate(role: Role) crypto.errors.IdentityElementError!Self {
var raw_seed: [Ed25519.seed_length]u8 = undefined;
crypto.random.bytes(&raw_seed);
defer wipeBytes(&raw_seed);
return Self{ .role = role, .kp = try Ed25519.KeyPair.create(raw_seed) };
}
pub fn fromTextSeed(text: *const text_seed) SeedDecodeError!Self {
var decoded = try decode(2, Ed25519.seed_length, text);
defer decoded.wipe(); // gets copied
var key_ty_prefix = decoded.prefix[0] & 0b11111000;
var role_prefix = (decoded.prefix[0] << 5) | (decoded.prefix[1] >> 3);
if (key_ty_prefix != prefix_byte_seed)
return error.InvalidSeed;
return Self{
.role = Role.fromPublicPrefixByte(role_prefix) orelse return error.InvalidPrefixByte,
.kp = try Ed25519.KeyPair.create(decoded.data),
};
}
pub fn fromRawSeed(
role: Role,
raw_seed: *const [Ed25519.seed_length]u8,
) crypto.errors.IdentityElementError!Self {
return Self{ .role = role, .kp = try Ed25519.KeyPair.create(raw_seed.*) };
}
pub fn sign(self: *const Self, msg: []const u8) SignError![Ed25519.signature_length]u8 {
return Ed25519.sign(msg, self.kp, null);
}
pub fn verify(self: *const Self, msg: []const u8, sig: [Ed25519.signature_length]u8) InvalidSignatureError!void {
Ed25519.verify(sig, msg, self.kp.public_key) catch return error.InvalidSignature;
}
pub fn seedText(self: *const Self) text_seed {
const public_prefix = self.role.publicPrefixByte();
const full_prefix = &[_]u8{
prefix_byte_seed | (public_prefix >> 5),
(public_prefix & 0b00011111) << 3,
};
const seed = self.kp.secret_key[0..Ed25519.seed_length];
return encode(full_prefix.len, seed.len, full_prefix, seed);
}
pub fn privateKeyText(self: *const Self) text_private {
return encode(1, self.kp.secret_key.len, &.{prefix_byte_private}, &self.kp.secret_key);
}
pub fn publicKeyText(self: *const Self) text_public {
return encode(1, self.kp.public_key.len, &.{self.role.publicPrefixByte()}, &self.kp.public_key);
}
pub fn intoPublicKey(self: *const Self) PublicKey {
return PublicKey{
.role = self.role,
.key = self.kp.public_key,
};
}
pub fn intoPrivateKey(self: *const Self) PrivateKey {
return PrivateKey{ .kp = self.kp };
}
pub fn wipe(self: *Self) void {
self.role = .account;
wipeKeyPair(&self.kp);
}
};
pub const PublicKey = struct {
const Self = @This();
role: Role,
key: [Ed25519.public_length]u8,
pub fn fromTextPublicKey(text: *const text_public) DecodeError!Self {
var decoded = try decode(1, Ed25519.public_length, text);
defer decoded.wipe(); // gets copied
return PublicKey{
.role = Role.fromPublicPrefixByte(decoded.prefix[0]) orelse return error.InvalidPrefixByte,
.key = decoded.data,
};
}
pub fn fromRawPublicKey(role: Role, raw_key: *const [Ed25519.public_length]u8) Self {
return Self{ .role = role, .key = raw_key.* };
}
pub fn publicKeyText(self: *const Self) text_public {
return encode(1, self.key.len, &.{self.role.publicPrefixByte()}, &self.key);
}
pub fn verify(self: *const Self, msg: []const u8, sig: [Ed25519.signature_length]u8) InvalidSignatureError!void {
Ed25519.verify(sig, msg, self.key) catch return error.InvalidSignature;
}
pub fn wipe(self: *Self) void {
self.role = .account;
wipeBytes(&self.key);
}
};
pub const PrivateKey = struct {
const Self = @This();
kp: Ed25519.KeyPair,
pub fn fromTextPrivateKey(text: *const text_private) PrivateKeyDecodeError!Self {
var decoded = try decode(1, Ed25519.secret_length, text);
defer decoded.wipe(); // gets copied
if (decoded.prefix[0] != prefix_byte_private)
return error.InvalidPrivateKey;
return PrivateKey{ .kp = Ed25519.KeyPair.fromSecretKey(decoded.data) };
}
pub fn fromRawPrivateKey(raw_key: *const [Ed25519.secret_length]u8) Self {
return Self{ .kp = Ed25519.KeyPair.fromSecretKey(raw_key.*) };
}
pub fn intoSeedKeyPair(self: *const Self, role: Role) SeedKeyPair {
return SeedKeyPair{
.role = role,
.kp = self.kp,
};
}
pub fn intoPublicKey(self: *const Self, role: Role) PublicKey {
return PublicKey{
.role = role,
.key = self.kp.public_key,
};
}
pub fn privateKeyText(self: *const Self) text_private {
return encode(1, self.kp.secret_key.len, &.{prefix_byte_private}, &self.kp.secret_key);
}
pub fn sign(self: *const Self, msg: []const u8) SignError![Ed25519.signature_length]u8 {
return Ed25519.sign(msg, self.kp, null);
}
pub fn verify(self: *const Self, msg: []const u8, sig: [Ed25519.signature_length]u8) InvalidSignatureError!void {
Ed25519.verify(sig, msg, self.kp.public_key) catch return error.InvalidSignature;
}
pub fn wipe(self: *Self) void {
wipeKeyPair(&self.kp);
}
};
fn encoded_key(comptime prefix_len: usize, comptime data_len: usize) type {
return [base32.Encoder.calcSize(prefix_len + data_len + 2)]u8;
}
fn encode(
comptime prefix_len: usize,
comptime data_len: usize,
prefix: *const [prefix_len]u8,
data: *const [data_len]u8,
) encoded_key(prefix_len, data_len) {
var buf: [prefix_len + data_len + 2]u8 = undefined;
defer wipeBytes(&buf);
mem.copy(u8, &buf, prefix[0..]);
mem.copy(u8, buf[prefix_len..], data[0..]);
var off = prefix_len + data_len;
var checksum = crc16.make(buf[0..off]);
mem.writeIntLittle(u16, buf[buf.len - 2 .. buf.len], checksum);
var text: encoded_key(prefix_len, data_len) = undefined;
std.debug.assert(base32.Encoder.encode(&text, &buf).len == text.len);
return text;
}
fn DecodedNkey(comptime prefix_len: usize, comptime data_len: usize) type {
return struct {
const Self = @This();
prefix: [prefix_len]u8,
data: [data_len]u8,
pub fn wipe(self: *Self) void {
self.prefix[0] = Role.account.publicPrefixByte();
wipeBytes(&self.data);
}
};
}
fn decode(
comptime prefix_len: usize,
comptime data_len: usize,
text: *const [base32.Encoder.calcSize(prefix_len + data_len + 2)]u8,
) (base32.DecodeError || crc16.InvalidChecksumError)!DecodedNkey(prefix_len, data_len) {
var raw: [prefix_len + data_len + 2]u8 = undefined;
defer wipeBytes(&raw);
std.debug.assert((try base32.Decoder.decode(&raw, text[0..])).len == raw.len);
var checksum = mem.readIntLittle(u16, raw[raw.len - 2 .. raw.len]);
try crc16.validate(raw[0 .. raw.len - 2], checksum);
return DecodedNkey(prefix_len, data_len){
.prefix = raw[0..prefix_len].*,
.data = raw[prefix_len .. raw.len - 2].*,
};
}
pub fn isValidEncoding(text: []const u8) bool {
if (text.len < 4) return false;
var made_crc: u16 = 0;
var dec = base32.Decoder.init(text);
var crc_buf: [2]u8 = undefined;
var crc_buf_len: u8 = 0;
var expect_len: usize = base32.Decoder.calcSize(text.len);
var wrote_n_total: usize = 0;
while (dec.next() catch return false) |b| {
wrote_n_total += 1;
if (crc_buf_len == 2) made_crc = crc16.update(made_crc, &.{crc_buf[0]});
crc_buf[0] = crc_buf[1];
crc_buf[1] = b;
if (crc_buf_len != 2) crc_buf_len += 1;
}
std.debug.assert(wrote_n_total == expect_len);
if (crc_buf_len != 2) unreachable;
var got_crc = mem.readIntLittle(u16, &crc_buf);
return made_crc == got_crc;
}
pub fn isValidSeed(text: []const u8, with_role: ?Role) bool {
if (text.len < text_seed_len) return false;
var res = SeedKeyPair.fromTextSeed(text[0..text_seed_len]) catch return false;
defer res.wipe();
return if (with_role) |role| res.role == role else true;
}
pub fn isValidPublicKey(text: []const u8, with_role: ?Role) bool {
if (text.len < text_public_len) return false;
var res = PublicKey.fromTextPublicKey(text[0..text_public_len]) catch return false;
defer res.wipe();
return if (with_role) |role| res.role == role else true;
}
pub fn isValidPrivateKey(text: []const u8) bool {
if (text.len < text_private_len) return false;
var res = PrivateKey.fromTextPrivateKey(text[0..text_private_len]) catch return false;
res.wipe();
return true;
}
// `line` must not contain CR or LF characters.
pub fn isKeySectionBarrier(line: []const u8, opening: bool) bool {
if (line.len < 6) return false;
const start = mem.indexOf(u8, line, "---") orelse return false;
if (!opening and start != 0) return false;
if (line.len - start < 6) return false;
return mem.endsWith(u8, line, "---");
}
const allowed_creds_section_chars_table: [256]bool = allowed: {
var table = [_]bool{false} ** 256;
const chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-.=";
for (chars) |char| table[char] = true;
break :allowed table;
};
pub fn areKeySectionContentsValid(contents: []const u8) bool {
for (contents) |c| if (!allowed_creds_section_chars_table[c]) return false;
return true;
}
pub fn findKeySection(text: []const u8, line_it: *std.mem.SplitIterator) ?[]const u8 {
while (true) {
const opening_line = line_it.next() orelse return null;
if (!isKeySectionBarrier(opening_line, true)) continue;
const contents_line = line_it.next() orelse return null;
if (!areKeySectionContentsValid(contents_line)) continue;
const closing_line = line_it.next() orelse return null;
if (!isKeySectionBarrier(closing_line, false)) continue;
return contents_line;
}
}
pub fn parseDecoratedJwt(contents: []const u8) []const u8 {
var line_it = mem.split(contents, "\n");
return findKeySection(contents, &line_it) orelse return contents;
}
pub fn parseDecoratedNkey(contents: []const u8) NoNkeySeedFoundError!SeedKeyPair {
var line_it = mem.split(contents, "\n");
var current_off: usize = 0;
var seed: ?[]const u8 = null;
if (findKeySection(contents, &line_it) != null)
seed = findKeySection(contents, &line_it);
if (seed == null)
seed = findNkey(contents) orelse return error.NoNkeySeedFound;
if (!isValidCredsNkey(seed.?))
return error.NoNkeySeedFound;
return SeedKeyPair.fromTextSeed(seed.?[0..text_seed_len]) catch return error.NoNkeySeedFound;
}
pub fn parseDecoratedUserNkey(contents: []const u8) (NoNkeySeedFoundError || NoNkeyUserSeedFoundError)!SeedKeyPair {
var key = try parseDecoratedNkey(contents);
if (!mem.startsWith(u8, &key.seedText(), "SU")) return error.NoNkeyUserSeedFound;
defer key.wipe();
return key;
}
fn isValidCredsNkey(text: []const u8) bool {
const valid_prefix =
mem.startsWith(u8, text, "SO") or
mem.startsWith(u8, text, "SA") or
mem.startsWith(u8, text, "SU");
const valid_len = text.len >= text_seed_len;
return valid_prefix and valid_len;
}
fn findNkey(text: []const u8) ?[]const u8 {
var line_it = std.mem.split(text, "\n");
var current_off: usize = 0;
while (line_it.next()) |line| {
for (line) |c, i| {
if (!ascii.isSpace(c)) {
if (isValidCredsNkey(line[i..])) return line[i..];
break;
}
}
}
return null;
}
fn wipeKeyPair(kp: *Ed25519.KeyPair) void {
wipeBytes(&kp.public_key);
wipeBytes(&kp.secret_key);
}
fn wipeBytes(bs: []u8) void {
for (bs) |*b| b.* = 0;
}
test "reference all delcarations" {
testing.refAllDecls(@This());
testing.refAllDecls(Role);
testing.refAllDecls(SeedKeyPair);
testing.refAllDecls(PublicKey);
testing.refAllDecls(PrivateKey);
}
test "key conversions" {
var key_pair = try SeedKeyPair.generate(.server);
var decoded_seed = try SeedKeyPair.fromTextSeed(&key_pair.seedText());
try testing.expect(isValidEncoding(&decoded_seed.seedText()));
var pub_key_str_a = key_pair.publicKeyText();
var priv_key_str_a = key_pair.privateKeyText();
try testing.expect(pub_key_str_a.len != 0);
try testing.expect(priv_key_str_a.len != 0);
try testing.expect(isValidEncoding(&pub_key_str_a));
try testing.expect(isValidEncoding(&priv_key_str_a));
var pub_key = key_pair.intoPublicKey();
var pub_key_str_b = pub_key.publicKeyText();
try testing.expectEqualStrings(&pub_key_str_a, &pub_key_str_b);
var priv_key = key_pair.intoPrivateKey();
var priv_key_str_b = priv_key.privateKeyText();
try testing.expectEqualStrings(&priv_key_str_a, &priv_key_str_b);
}
test "decode" {
const kp = try SeedKeyPair.generate(.account);
const seed_text = kp.seedText();
const pub_key_text = kp.publicKeyText();
const priv_key_text = kp.privateKeyText();
_ = try SeedKeyPair.fromTextSeed(&seed_text);
_ = try PublicKey.fromTextPublicKey(&pub_key_text);
_ = try PrivateKey.fromTextPrivateKey(&priv_key_text);
try testing.expectError(error.InvalidChecksum, PublicKey.fromTextPublicKey(seed_text[0..text_public_len]));
try testing.expectError(error.InvalidChecksum, SeedKeyPair.fromTextSeed(priv_key_text[0..text_seed_len]));
}
test "seed" {
inline for (@typeInfo(Role).Enum.fields) |field| {
const role = @field(Role, field.name);
const kp = try SeedKeyPair.generate(role);
const decoded = try SeedKeyPair.fromTextSeed(&kp.seedText());
if (decoded.role != role) {
std.debug.print("expected role {}, found role {}\n", .{ role, decoded.role });
return error.TestUnexpectedError;
}
}
}
test "public key" {
inline for (@typeInfo(Role).Enum.fields) |field| {
const role = @field(Role, field.name);
const kp = try SeedKeyPair.generate(role);
const decoded_pub_key = try PublicKey.fromTextPublicKey(&kp.publicKeyText());
if (decoded_pub_key.role != role) {
std.debug.print("expected role {}, found role {}\n", .{ role, decoded_pub_key.role });
return error.TestUnexpectedError;
}
}
}
test "different key types" {
inline for (@typeInfo(Role).Enum.fields) |field| {
const role = @field(Role, field.name);
const kp = try SeedKeyPair.generate(role);
_ = try SeedKeyPair.fromTextSeed(&kp.seedText());
const pub_key_str = kp.publicKeyText();
try testing.expect(pub_key_str[0] == role.letter());
try testing.expect(isValidPublicKey(&pub_key_str, role));
const priv_key_str = kp.privateKeyText();
try testing.expect(priv_key_str[0] == 'P');
try testing.expect(isValidPrivateKey(&priv_key_str));
const data = "Hello, world!";
const sig = try kp.sign(data);
try testing.expect(sig.len == Ed25519.signature_length);
try kp.verify(data, sig);
}
}
test "validation" {
const roles = @typeInfo(Role).Enum.fields;
inline for (roles) |field, i| {
const role = @field(Role, field.name);
const next_role = next: {
const next_field_i = if (i == roles.len - 1) 0 else i + 1;
std.debug.assert(next_field_i != i);
break :next @field(Role, roles[next_field_i].name);
};
const kp = try SeedKeyPair.generate(role);
const seed_str = kp.seedText();
const pub_key_str = kp.publicKeyText();
const priv_key_str = kp.privateKeyText();
try testing.expect(isValidSeed(&seed_str, role));
try testing.expect(isValidSeed(&seed_str, null));
try testing.expect(isValidPublicKey(&pub_key_str, null));
try testing.expect(isValidPublicKey(&pub_key_str, role));
try testing.expect(isValidPrivateKey(&priv_key_str));
try testing.expect(!isValidSeed(&seed_str, next_role));
try testing.expect(!isValidSeed(&pub_key_str, null));
try testing.expect(!isValidSeed(&priv_key_str, null));
try testing.expect(!isValidPublicKey(&pub_key_str, next_role));
try testing.expect(!isValidPublicKey(&seed_str, null));
try testing.expect(!isValidPublicKey(&priv_key_str, null));
try testing.expect(!isValidPrivateKey(&seed_str));
try testing.expect(!isValidPrivateKey(&pub_key_str));
}
try testing.expect(!isValidSeed("seed", null));
try testing.expect(!isValidPublicKey("public key", null));
try testing.expect(!isValidPrivateKey("private key"));
}
test "from seed" {
const kp = try SeedKeyPair.generate(.account);
const kp_from_raw = try SeedKeyPair.fromRawSeed(kp.role, kp.kp.secret_key[0..Ed25519.seed_length]);
try testing.expect(std.meta.eql(kp, kp_from_raw));
const data = "Hello, World!";
const sig = try kp.sign(data);
const seed = kp.seedText();
try testing.expect(mem.startsWith(u8, &seed, "SA"));
const kp2 = try SeedKeyPair.fromTextSeed(&seed);
try kp2.verify(data, sig);
}
test "from public key" {
const kp = try SeedKeyPair.generate(.user);
const pk_text = kp.publicKeyText();
const pk_text_clone = kp.publicKeyText();
try testing.expectEqualStrings(&pk_text, &pk_text_clone);
const pk = try PublicKey.fromTextPublicKey(&pk_text);
const pk_text_clone_2 = pk.publicKeyText();
try testing.expect(std.meta.eql(pk, kp.intoPublicKey()));
try testing.expect(std.meta.eql(pk, PublicKey.fromRawPublicKey(kp.role, &kp.kp.public_key)));
try testing.expectEqualStrings(&pk_text, &pk_text_clone_2);
const data = "Hello, world!";
const sig = try kp.sign(data);
try pk.verify(data, sig);
// Create another user to sign and make sure verification fails
const kp2 = try SeedKeyPair.generate(.user);
const sig2 = try kp2.sign(data);
try testing.expectError(error.InvalidSignature, pk.verify(data, sig2));
}
test "from private key" {
const kp = try SeedKeyPair.generate(.account);
const pk_text = kp.privateKeyText();
const pk_text_clone = kp.privateKeyText();
try testing.expectEqualStrings(&pk_text, &pk_text_clone);
const pk = try PrivateKey.fromTextPrivateKey(&pk_text);
const pk_text_clone_2 = pk.privateKeyText();
try testing.expect(std.meta.eql(pk, kp.intoPrivateKey()));
try testing.expect(std.meta.eql(kp, pk.intoSeedKeyPair(.account)));
try testing.expect(std.meta.eql(pk, PrivateKey.fromRawPrivateKey(&kp.kp.secret_key)));
try testing.expectEqualStrings(&pk_text, &pk_text_clone_2);
const data = "Hello, World!";
const sig0 = try kp.sign(data);
const sig1 = try pk.sign(data);
try testing.expectEqualSlices(u8, &sig0, &sig1);
try pk.verify(data, sig0);
try kp.verify(data, sig1);
const kp2 = try SeedKeyPair.generate(.account);
const sig2 = try kp2.sign(data);
try testing.expectError(error.InvalidSignature, pk.verify(data, sig2));
}
test "bad decode" {
const kp = try SeedKeyPair.fromTextSeed("SAAHPQF3GOP4IP5SHKHCNBOHD5TMGSW4QQL6RTZAPEEYOQ2NRBIAKCCLQA");
var bad_seed = kp.seedText();
bad_seed[1] = 'S';
try testing.expectError(error.InvalidChecksum, SeedKeyPair.fromTextSeed(&bad_seed));
var bad_pub_key = kp.publicKeyText();
bad_pub_key[bad_pub_key.len - 1] = 'O';
bad_pub_key[bad_pub_key.len - 2] = 'O';
try testing.expectError(error.InvalidChecksum, PublicKey.fromTextPublicKey(&bad_pub_key));
var bad_priv_key = kp.privateKeyText();
bad_priv_key[bad_priv_key.len - 1] = 'O';
bad_priv_key[bad_priv_key.len - 2] = 'O';
try testing.expectError(error.InvalidChecksum, PrivateKey.fromTextPrivateKey(&bad_priv_key));
}
test "wipe" {
const kp = try SeedKeyPair.generate(.account);
const pub_key = kp.intoPublicKey();
const priv_key = kp.intoPrivateKey();
var kp_clone = kp;
kp_clone.wipe();
try testing.expect(!std.meta.eql(kp_clone.kp, kp.kp));
var pub_key_clone = pub_key;
pub_key_clone.wipe();
try testing.expect(!std.meta.eql(pub_key_clone.key, pub_key.key));
var priv_key_clone = priv_key;
priv_key_clone.wipe();
try testing.expect(!std.meta.eql(priv_key_clone.kp, priv_key.kp));
}
test "parse decorated JWT (bad)" {
try testing.expectEqualStrings("foo", parseDecoratedJwt("foo"));
}
test "parse decorated seed (bad)" {
try testing.expectError(error.NoNkeySeedFound, parseDecoratedNkey("foo"));
}
test "parse decorated seed and JWT" {
const creds =
\\-----BEGIN NATS USER JWT-----
\\eyJ0eXAiOiJKV1QiLCJhbGciOiJlZDI1NTE5LW5rZXkifQ.eyJqdGkiOiJUWEg1TUxDNTdPTUJUQURYNUJNU0RLWkhSQUtXUFM0TkdHRFFPVlJXRzUyRFdaUlFFVERBIiwiaWF0IjoxNjIxNTgyOTU1LCJpc3MiOiJBQ1ZUQVZMQlFKTklQRjdNWFZWSlpZUFhaTkdFQUZMWVpTUjJSNVRZNk9ESjNSTTRYV0FDNUVFRiIsIm5hbWUiOiJ0ZXN0Iiwic3ViIjoiVUJHSlhLRkVWUlFEM05LM0lDRVc1Q0lDSzM1NkdESVZORkhaRUU0SzdMMkRYWTdORVNQVlFVNEwiLCJuYXRzIjp7InB1YiI6e30sInN1YiI6e30sInN1YnMiOi0xLCJkYXRhIjotMSwicGF5bG9hZCI6LTEsInR5cGUiOiJ1c2VyIiwidmVyc2lvbiI6Mn19.OhPLDZflyJ_keg2xBRDHZZhG5x_Qf_Yb61k9eHLs9zLRf0_ETwMd0PNZI_isuBhXYevobXHVoYA3oxvMVGlDCQ
\\------END NATS USER JWT------
\\
\\************************* IMPORTANT *************************
\\NKEY Seed printed below can be used to sign and prove identity.
\\NKEYs are sensitive and should be treated as secrets.
\\
\\-----BEGIN USER NKEY SEED-----
\\SUAGIEYODKBBTUMOB666Z5KA4FCWAZV7HWSGRHOD7MK6UM5IYLWLACH7DQ
\\------END USER NKEY SEED------
\\
\\*************************************************************
;
const jwt = "eyJ0eXAiOiJKV1QiLCJhbGciOiJlZDI1NTE5LW5rZXkifQ.eyJqdGkiOiJUWEg1TUxDNTdPTUJUQURYNUJNU0RLWkhSQUtXUFM0TkdHRFFPVlJXRzUyRFdaUlFFVERBIiwiaWF0IjoxNjIxNTgyOTU1LCJpc3MiOiJBQ1ZUQVZMQlFKTklQRjdNWFZWSlpZUFhaTkdFQUZMWVpTUjJSNVRZNk9ESjNSTTRYV0FDNUVFRiIsIm5hbWUiOiJ0ZXN0Iiwic3ViIjoiVUJHSlhLRkVWUlFEM05LM0lDRVc1Q0lDSzM1NkdESVZORkhaRUU0SzdMMkRYWTdORVNQVlFVNEwiLCJuYXRzIjp7InB1YiI6e30sInN1YiI6e30sInN1YnMiOi0xLCJkYXRhIjotMSwicGF5bG9hZCI6LTEsInR5cGUiOiJ1c2VyIiwidmVyc2lvbiI6Mn19.OhPLDZflyJ_keg2xBRDHZZhG5x_Qf_Yb61k9eHLs9zLRf0_ETwMd0PNZI_isuBhXYevobXHVoYA3oxvMVGlDCQ";
const seed = "SUAGIEYODKBBTUMOB666Z5KA4FCWAZV7HWSGRHOD7MK6UM5IYLWLACH7DQ";
var got_kp = try parseDecoratedUserNkey(creds);
try testing.expectEqualStrings(seed, &got_kp.seedText());
got_kp = try parseDecoratedNkey(creds);
try testing.expectEqualStrings(seed, &got_kp.seedText());
var got_jwt = parseDecoratedJwt(creds);
try testing.expectEqualStrings(jwt, got_jwt);
}
|