@ibgib/core-gib 0.1.62 → 0.1.64

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.
Files changed (102) hide show
  1. package/dist/keystone/keystone-constants.d.mts +1 -0
  2. package/dist/keystone/keystone-constants.d.mts.map +1 -1
  3. package/dist/keystone/keystone-constants.mjs +1 -0
  4. package/dist/keystone/keystone-constants.mjs.map +1 -1
  5. package/dist/keystone/keystone-helpers.d.mts +19 -1
  6. package/dist/keystone/keystone-helpers.d.mts.map +1 -1
  7. package/dist/keystone/keystone-helpers.mjs +191 -16
  8. package/dist/keystone/keystone-helpers.mjs.map +1 -1
  9. package/dist/keystone/keystone-service-v1.d.mts +84 -2
  10. package/dist/keystone/keystone-service-v1.d.mts.map +1 -1
  11. package/dist/keystone/keystone-service-v1.mjs +324 -28
  12. package/dist/keystone/keystone-service-v1.mjs.map +1 -1
  13. package/dist/keystone/keystone-service-v1.respec.mjs +447 -2
  14. package/dist/keystone/keystone-service-v1.respec.mjs.map +1 -1
  15. package/dist/keystone/keystone-types.d.mts +31 -2
  16. package/dist/keystone/keystone-types.d.mts.map +1 -1
  17. package/dist/keystone/keystone-types.mjs +13 -0
  18. package/dist/keystone/keystone-types.mjs.map +1 -1
  19. package/dist/keystone/policy/keystone-profile-builder.d.mts +1 -1
  20. package/dist/keystone/policy/keystone-profile-builder.d.mts.map +1 -1
  21. package/dist/keystone/policy/keystone-profile-builder.mjs +8 -0
  22. package/dist/keystone/policy/keystone-profile-builder.mjs.map +1 -1
  23. package/dist/keystone/policy/profiles/profile-domain.json +69 -0
  24. package/dist/keystone/policy/profiles/profile-sync.json +84 -0
  25. package/dist/keystone/policy/schemas/keystone.high.schema.json +1 -1
  26. package/dist/keystone/policy/schemas/keystone.medium.schema.json +1 -1
  27. package/dist/keystone/strategy/hash-reveal-v1/hash-reveal-v1.d.mts +8 -0
  28. package/dist/keystone/strategy/hash-reveal-v1/hash-reveal-v1.d.mts.map +1 -1
  29. package/dist/keystone/strategy/hash-reveal-v1/hash-reveal-v1.mjs +15 -1
  30. package/dist/keystone/strategy/hash-reveal-v1/hash-reveal-v1.mjs.map +1 -1
  31. package/dist/sync/sync-conflict-adv-multitimelines.withid.respec.mjs +16 -4
  32. package/dist/sync/sync-conflict-adv-multitimelines.withid.respec.mjs.map +1 -1
  33. package/dist/sync/sync-conflict-basic-divergence.withid.respec.mjs +4 -1
  34. package/dist/sync/sync-conflict-basic-divergence.withid.respec.mjs.map +1 -1
  35. package/dist/sync/sync-conflict-basic-multitimelines.withid.respec.mjs +4 -1
  36. package/dist/sync/sync-conflict-basic-multitimelines.withid.respec.mjs.map +1 -1
  37. package/dist/sync/sync-conflict-text-merge.withid.respec.mjs +10 -4
  38. package/dist/sync/sync-conflict-text-merge.withid.respec.mjs.map +1 -1
  39. package/dist/sync/sync-innerspace-constants.withid.respec.mjs +12 -3
  40. package/dist/sync/sync-innerspace-constants.withid.respec.mjs.map +1 -1
  41. package/dist/sync/sync-innerspace-deep-updates.withid.respec.mjs +4 -1
  42. package/dist/sync/sync-innerspace-deep-updates.withid.respec.mjs.map +1 -1
  43. package/dist/sync/sync-innerspace-dest-ahead.withid.respec.mjs +4 -1
  44. package/dist/sync/sync-innerspace-dest-ahead.withid.respec.mjs.map +1 -1
  45. package/dist/sync/sync-innerspace-multiple-timelines.withid.respec.mjs +4 -1
  46. package/dist/sync/sync-innerspace-multiple-timelines.withid.respec.mjs.map +1 -1
  47. package/dist/sync/sync-innerspace-partial-update.withid.respec.mjs +4 -1
  48. package/dist/sync/sync-innerspace-partial-update.withid.respec.mjs.map +1 -1
  49. package/dist/sync/sync-innerspace.withid.respec.mjs +4 -1
  50. package/dist/sync/sync-innerspace.withid.respec.mjs.map +1 -1
  51. package/dist/sync/sync-peer/sync-peer-types.d.mts +4 -0
  52. package/dist/sync/sync-peer/sync-peer-types.d.mts.map +1 -1
  53. package/dist/sync/sync-peer/sync-peer-v1.d.mts.map +1 -1
  54. package/dist/sync/sync-peer/sync-peer-v1.mjs +4 -1
  55. package/dist/sync/sync-peer/sync-peer-v1.mjs.map +1 -1
  56. package/dist/sync/sync-peer/sync-peer-websocket/sync-peer-websocket-receiver/sync-websocket-peer-helpers.d.mts.map +1 -1
  57. package/dist/sync/sync-peer/sync-peer-websocket/sync-peer-websocket-receiver/sync-websocket-peer-helpers.mjs +90 -22
  58. package/dist/sync/sync-peer/sync-peer-websocket/sync-peer-websocket-receiver/sync-websocket-peer-helpers.mjs.map +1 -1
  59. package/dist/sync/sync-saga-coordinator.d.mts +7 -10
  60. package/dist/sync/sync-saga-coordinator.d.mts.map +1 -1
  61. package/dist/sync/sync-saga-coordinator.mjs +14 -5
  62. package/dist/sync/sync-saga-coordinator.mjs.map +1 -1
  63. package/dist/sync/sync-types.d.mts +5 -0
  64. package/dist/sync/sync-types.d.mts.map +1 -1
  65. package/dist/sync/sync-types.mjs.map +1 -1
  66. package/dist/sync/sync-withid.connect.respec.mjs +4 -1
  67. package/dist/sync/sync-withid.connect.respec.mjs.map +1 -1
  68. package/dist/sync/sync-withid.establish.respec.mjs +4 -1
  69. package/dist/sync/sync-withid.establish.respec.mjs.map +1 -1
  70. package/dist/sync/sync-withid.pingpong.respec.mjs +4 -1
  71. package/dist/sync/sync-withid.pingpong.respec.mjs.map +1 -1
  72. package/package.json +2 -2
  73. package/src/keystone/keystone-constants.mts +1 -0
  74. package/src/keystone/keystone-helpers.mts +223 -15
  75. package/src/keystone/keystone-service-v1.mts +391 -28
  76. package/src/keystone/keystone-service-v1.respec.mts +1990 -1479
  77. package/src/keystone/keystone-types.mts +48 -2
  78. package/src/keystone/policy/keystone-profile-builder.mts +9 -1
  79. package/src/keystone/policy/profiles/profile-domain.json +69 -0
  80. package/src/keystone/policy/profiles/profile-sync.json +84 -0
  81. package/src/keystone/policy/schemas/keystone.high.schema.json +1 -1
  82. package/src/keystone/policy/schemas/keystone.medium.schema.json +1 -1
  83. package/src/keystone/strategy/hash-reveal-v1/hash-reveal-v1.mts +20 -1
  84. package/src/sync/sync-conflict-adv-multitimelines.withid.respec.mts +16 -4
  85. package/src/sync/sync-conflict-basic-divergence.withid.respec.mts +4 -1
  86. package/src/sync/sync-conflict-basic-multitimelines.withid.respec.mts +4 -1
  87. package/src/sync/sync-conflict-text-merge.withid.respec.mts +10 -4
  88. package/src/sync/sync-innerspace-constants.withid.respec.mts +12 -3
  89. package/src/sync/sync-innerspace-deep-updates.withid.respec.mts +4 -1
  90. package/src/sync/sync-innerspace-dest-ahead.withid.respec.mts +4 -1
  91. package/src/sync/sync-innerspace-multiple-timelines.withid.respec.mts +4 -1
  92. package/src/sync/sync-innerspace-partial-update.withid.respec.mts +4 -1
  93. package/src/sync/sync-innerspace.withid.respec.mts +4 -1
  94. package/src/sync/sync-peer/sync-peer-types.mts +4 -0
  95. package/src/sync/sync-peer/sync-peer-v1.mts +5 -1
  96. package/src/sync/sync-peer/sync-peer-websocket/sync-peer-websocket-receiver/sync-websocket-peer-helpers.mts +96 -22
  97. package/src/sync/sync-saga-coordinator.mts +17 -12
  98. package/src/sync/sync-types.mts +6 -0
  99. package/src/sync/sync-withid.connect.respec.mts +5 -2
  100. package/src/sync/sync-withid.establish.respec.mts +4 -1
  101. package/src/sync/sync-withid.pingpong.respec.mts +4 -1
  102. package/src/sync/unused-identity-backup.mts.md +0 -311
@@ -1,1538 +1,2049 @@
1
- import {
2
- respecfully, iReckon, ifWe, firstOfAll, firstOfEach, lastOfAll, lastOfEach, respecfullyDear, ifWeMight
3
- } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
4
- const maam = `[${import.meta.url}]`, sir = maam;
5
- import { clone, hash, getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
6
- import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
7
- import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
8
-
9
- import { GLOBAL_LOG_A_LOT } from '../core-constants.mjs';
10
- import { KeystoneStrategyFactory } from './strategy/keystone-strategy-factory.mjs';
11
- import { KeystoneChallengePool, KeystoneClaim, KeystoneIbGib_V1, KeystonePoolConfig_HashV1 } from './keystone-types.mjs';
12
- import { createRevocationPoolConfig, createStandardPoolConfig } from './keystone-config-builder.mjs';
13
- import { POOL_ID_DEFAULT, POOL_ID_REVOKE, KEYSTONE_VERB_REVOKE, KEYSTONE_VERB_MANAGE, POOL_ID_MANAGE } from './keystone-constants.mjs';
14
- import { KeystoneService_V1, } from './keystone-service-v1.mjs';
15
- import { selectChallengeIds, validateChallengePool, validateKeystoneIb, validateKeystoneTransition, validateGenesisKeystone } from './keystone-helpers.mjs';
16
- import { KeystoneProfileBuilder } from './policy/keystone-profile-builder.mjs';
17
- import { getTjpAddr } from '../common/other/ibgib-helper.mjs';
18
-
19
- const logalot = GLOBAL_LOG_A_LOT;
20
-
21
-
22
- /**
23
- * A simple in-memory map acting as a Space.
24
- * Pure Storage. No Indexing logic.
25
- */
26
- class MockIbGibSpace {
27
- store = new Map<string, IbGib_V1>();
28
-
29
- constructor(public name: string = "mock_space") { }
30
-
31
- async put({ ibGib }: { ibGib: IbGib_V1 }): Promise<void> {
32
- const addr = getIbGibAddr({ ibGib });
33
- this.store.set(addr, JSON.parse(JSON.stringify(ibGib))); // Deep copy
34
- }
35
-
36
- async get({ addr }: { addr: string }): Promise<IbGib_V1 | null> {
37
- const data = this.store.get(addr);
38
- return data ? JSON.parse(JSON.stringify(data)) : null;
39
- }
40
-
41
- async argy({ argData, ibGibs }: { argData: any; ibGibs?: IbGib_V1[] }): Promise<any> {
42
- return {
43
- ib: 'arg^gib',
44
- gib: 'arg_gib',
45
- data: argData,
46
- ibGibs,
47
- };
48
- }
49
-
50
- async witness(arg: any): Promise<any> {
51
- const cmd = arg.data?.cmd;
52
- const cmdModifiers = arg.data?.cmdModifiers || [];
53
- if (cmd === 'get') {
54
- const addrs = arg.data.ibGibAddrs || [];
55
- if (cmdModifiers.includes('latest') && cmdModifiers.includes('addrs')) {
56
- const latestAddrsMap: { [addr: string]: string } = {};
57
- for (const queryAddr of addrs) {
58
- const queryTjpGib = queryAddr.includes('.') ? queryAddr.split('.')[1] : queryAddr.split('^')[1];
59
- let latestAddr = queryAddr;
60
- let maxN = -1;
61
- for (const [addr, ibGib] of this.store.entries()) {
62
- const tjpGib = addr.includes('.') ? addr.split('.')[1] : addr.split('^')[1];
63
- if (tjpGib === queryTjpGib) {
64
- const n = ibGib.data?.n ?? 0;
65
- if (n > maxN) {
66
- maxN = n;
67
- latestAddr = addr;
68
- }
69
- }
70
- }
71
- latestAddrsMap[queryAddr] = latestAddr;
72
- }
73
- return {
74
- data: {
75
- success: true,
76
- latestAddrsMap,
77
- }
78
- };
79
- } else {
80
- const ibGibs: IbGib_V1[] = [];
81
- for (const addr of addrs) {
82
- const x = await this.get({ addr });
83
- if (x) { ibGibs.push(x); }
84
- }
85
- return {
86
- data: { success: true },
87
- ibGibs,
88
- };
89
- }
90
- }
91
- return undefined;
92
- }
93
- }
94
-
95
-
96
- /**
97
- * A partial mock of Metaspace.
98
- * Handles:
99
- * 1. Retrieving the local space.
100
- * 2. Delegating 'put' to the space.
101
- * 3. 'registerNewIbGib': Tracking the HEAD of a timeline.
102
- */
103
- class MockMetaspaceService {
104
-
105
- /**
106
- * Map of TJP Gib (Timeline ID) -> Latest IbGib Addr (Head)
107
- */
108
- timelineHeads = new Map<string, string>();
109
-
110
- constructor(public space: MockIbGibSpace) { }
111
-
112
- async getLocalUserSpace({ lock }: { lock: boolean }): Promise<MockIbGibSpace> {
113
- return this.space;
114
- }
115
-
116
- /**
117
- * Metaspace often acts as a facade for put, defaulting to local space.
118
- */
119
- async put(args: any): Promise<void> {
120
- const target = args.space || this.space;
121
- return target.put(args);
122
- }
123
-
124
- async get(args: { addr: string, space?: any }): Promise<{ success: boolean, ibGibs?: IbGib_V1[] }> {
125
- const target = args.space || this.space;
126
- const x = await target.get({ addr: args.addr });
127
- return {
128
- success: !!x,
129
- ibGibs: x ? [x] : [],
130
- };
131
- }
132
-
133
- /**
134
- * Tracks the latest version of an ibGib timeline.
135
- */
136
- async registerNewIbGib(args: { ibGib: IbGib_V1, space?: any }): Promise<void> {
137
- const { ibGib } = args;
138
- const targetSpace = args.space || this.space;
139
-
140
- // 1. Ensure it is stored
141
- await targetSpace.put({ ibGib });
142
-
143
- // 2. Extract TJP (Timeline Identifier)
144
- // Simplified logic mirroring getGibInfo
145
- const gib = ibGib.gib || '';
146
- let tjpGib = gib;
147
-
148
- if (gib.includes('.')) {
149
- // It's a frame in a timeline: "punctiliarHash.tjpHash"
150
- // The TJP is the suffix.
151
- const parts = gib.split('.');
152
- tjpGib = parts.slice(1).join('.');
153
- }
154
- // Else: It's a Primitive or a TJP itself (Genesis).
155
- // If Genesis (isTjp=true), the gib IS the tjpGib.
156
-
157
- const addr = getIbGibAddr({ ibGib });
158
- this.timelineHeads.set(tjpGib, addr);
159
- }
160
- }
161
-
162
- // ===========================================================================
163
- // SUITE A: STRATEGY VECTORS (The Math)
164
- // ===========================================================================
165
-
166
- await respecfully(sir, 'Suite A: Strategy Vectors (HashRevealV1)', async () => {
167
-
168
- // Setup generic variables
169
- const masterSecret = "TestSecret_12345";
170
- const poolId = "TestPool";
171
- let config: KeystonePoolConfig_HashV1;
172
-
173
- firstOfAll(sir, async () => {
174
- // Use our standard builder to get a valid config object
175
- const salt = (await getUUID()).substring(0, 16);
176
- config = createStandardPoolConfig({
177
- id: poolId,
178
- salt,
179
- }) as KeystonePoolConfig_HashV1;
180
- });
181
-
182
- await respecfully(sir, 'Derivation Logic', async () => {
183
-
184
- await ifWeMight(sir, 'derivePoolSecret with same inputs returns same output', async () => {
185
- const strategy = KeystoneStrategyFactory.create({ config });
186
-
187
- const secretA = await strategy.derivePoolSecret({ masterSecret });
188
- const secretB = await strategy.derivePoolSecret({ masterSecret });
189
-
190
- iReckon(sir, secretA).asTo('secret consistency').willEqual(secretB);
191
- iReckon(sir, secretA).asTo('secret length').isGonnaBeTruthy();
192
- });
193
-
194
- await ifWeMight(sir, 'derivePoolSecret with different master secret returns different output', async () => {
195
- const strategy = KeystoneStrategyFactory.create({ config });
196
-
197
- const secretA = await strategy.derivePoolSecret({ masterSecret });
198
- const secretB = await strategy.derivePoolSecret({ masterSecret: masterSecret + "_diff" });
199
-
200
- iReckon(sir, secretA).asTo('secrets differ').not.willEqual(secretB);
201
- });
202
-
203
- await ifWeMight(sir, 'derivePoolSecret with different salt returns different output', async () => {
204
- // Modify salt in a copy of config
205
- const configB = { ...config, salt: "OtherPool" };
206
- const strategyA = KeystoneStrategyFactory.create({ config });
207
- const strategyB = KeystoneStrategyFactory.create({ config: configB });
208
-
209
- const secretA = await strategyA.derivePoolSecret({ masterSecret });
210
- const secretB = await strategyB.derivePoolSecret({ masterSecret });
211
-
212
- iReckon(sir, secretA).asTo('salt affects secret').not.willEqual(secretB);
213
- });
214
- });
215
-
216
- await respecfully(sir, 'Challenge/Solution Logic', async () => {
217
-
218
- await ifWeMight(sir, 'generateSolution -> generateChallenge -> validateSolution loop works', async () => {
219
- const strategy = KeystoneStrategyFactory.create({ config });
220
- const poolSecret = await strategy.derivePoolSecret({ masterSecret });
221
- const challengeId = "a3ff7843552870fc28bef2b"; // arbitrary random challengeId
222
-
223
- // 1. Generate Solution
224
- const solution = await strategy.generateSolution({ poolSecret, poolId: config.id, challengeId });
225
- iReckon(sir, solution.value).asTo('solution value exists').isGonnaBeTruthy();
226
- iReckon(sir, solution.challengeId).asTo('id matches').willEqual(challengeId);
227
-
228
- // 2. Generate Public Challenge from Solution
229
- const challenge = await strategy.generateChallenge({ solution });
230
- iReckon(sir, challenge.hash).asTo('challenge hash exists').isGonnaBeTruthy();
231
-
232
- // 3. Validate
233
- const isValid = await strategy.validateSolution({ solution, challenge });
234
- iReckon(sir, isValid).asTo('valid pair should pass').isGonnaBeTrue();
235
- });
236
-
237
- await ifWeMight(sir, 'validateSolution fails for mismatched values', async () => {
238
- const strategy = KeystoneStrategyFactory.create({ config });
239
- const poolSecret = await strategy.derivePoolSecret({ masterSecret });
240
- const challengeId = "8c994f3ed598f150e25513"; // arbitrary random challengeId
241
-
242
- // Generate real pair
243
- const solution = await strategy.generateSolution({ poolSecret, poolId: config.id, challengeId });
244
- const challenge = await strategy.generateChallenge({ solution });
245
-
246
- // Tamper with solution value
247
- const badSolution = { ...solution, value: "hacked_value" };
248
-
249
- const isValid = await strategy.validateSolution({ solution: badSolution, challenge });
250
- iReckon(sir, isValid).asTo('tampered solution should fail').isGonnaBeFalse();
251
- });
252
-
253
- await ifWeMight(sir, 'validateSolution fails for mismatched challenge hashes', async () => {
254
- const strategy = KeystoneStrategyFactory.create({ config });
255
- const poolSecret = await strategy.derivePoolSecret({ masterSecret });
256
-
257
- // Generate pair A
258
- const challengeId_A = "416c38cfd6ee63dbf8d4e5ef36"; // arbitrary random challengeId
259
- const solutionA = await strategy.generateSolution({ poolSecret, poolId: config.id, challengeId: challengeId_A });
260
-
261
- // Generate pair B
262
- const challengeId_B = "c487ef6b7878fae798c3"; // arbitrary random challengeId
263
- const solutionB = await strategy.generateSolution({ poolSecret, poolId: config.id, challengeId: challengeId_B });
264
- const challengeB = await strategy.generateChallenge({ solution: solutionB });
265
-
266
- // Check A against B
267
- const isValid = await strategy.validateSolution({ solution: solutionA, challenge: challengeB });
268
- iReckon(sir, isValid).asTo('mismatched pair should fail').isGonnaBeFalse();
269
- });
270
- });
271
- });
272
-
273
- // ===========================================================================
274
- // SUITE B: SERVICE LIFECYCLE (Genesis -> Sign -> Validate)
275
- // ===========================================================================
276
-
277
- await respecfully(sir, 'Suite B: Service Lifecycle', async () => {
278
-
279
- const service = new KeystoneService_V1();
280
- const masterSecret = "AliceSecretKey_987654321";
281
-
282
- let mockSpace: MockIbGibSpace;
283
- let mockMetaspace: any;
284
-
285
- let genesisKeystone: KeystoneIbGib_V1;
286
- let signedKeystone: KeystoneIbGib_V1;
287
-
288
- firstOfAll(sir, async () => {
289
- mockSpace = new MockIbGibSpace();
290
- mockMetaspace = new MockMetaspaceService(mockSpace);
291
- });
292
-
293
- await respecfully(sir, 'Genesis', async () => {
294
- await ifWeMight(sir, 'creates a valid genesis frame and persists it', async () => {
295
- const salt = (await getUUID()).substring(0, 16);
296
- const config = createStandardPoolConfig({
297
- id: POOL_ID_DEFAULT,
298
- salt,
299
- });
300
-
301
- genesisKeystone = await service.genesis({
302
- masterSecret,
303
- configs: [config],
304
- metaspace: mockMetaspace,
305
- space: mockSpace as any,
306
- });
307
-
308
- // Verify Object
309
- iReckon(sir, genesisKeystone).asTo('genesis object').isGonnaBeTruthy();
310
- iReckon(sir, genesisKeystone.data?.isTjp).asTo('isTjp').isGonnaBeTrue();
311
-
312
- // Verify Persistence
313
- const addr = getIbGibAddr({ ibGib: genesisKeystone });
314
- const saved = await mockSpace.get({ addr });
315
-
316
- iReckon(sir, saved).asTo('persisted to space').isGonnaBeTruthy();
317
-
318
- // Verify Registration (Timeline Tracking)
319
- // Genesis gib should be registered as a timeline head
320
- const head = mockMetaspace.timelineHeads.get(genesisKeystone.gib!);
321
- iReckon(sir, head).asTo('genesis registered as timeline head').willEqual(addr);
322
- });
323
- });
324
-
325
- await respecfully(sir, 'Signing (Evolution)', async () => {
326
- await ifWeMight(sir, 'evolves the keystone with a valid proof', async () => {
327
- const claim: Partial<KeystoneClaim> = {
328
- target: "comment 123^gib",
329
- verb: "post"
330
- };
331
-
332
- const details = { note: "First post!" };
333
-
334
- signedKeystone = await service.sign({
335
- latestKeystone: genesisKeystone,
336
- masterSecret,
337
- claim,
338
- poolId: POOL_ID_DEFAULT,
339
- frameDetails: details,
340
- metaspace: mockMetaspace,
341
- space: mockSpace as any,
342
- });
343
-
344
- iReckon(sir, signedKeystone).asTo('new frame created').isGonnaBeTruthy();
345
- iReckon(sir, signedKeystone).asTo('is different frame').not.isGonnaBe(genesisKeystone);
346
-
347
- // NOTE: If this fails, check if 'sign' calls 'space.put' or 'metaspace.put'!
348
- // In your current 'sign' implementation, you return the object but might have missed the save step.
349
- const addr = getIbGibAddr({ ibGib: signedKeystone });
350
- const saved = await mockSpace.get({ addr });
351
- iReckon(sir, saved).asTo('persisted to space').isGonnaBeTruthy();
352
- });
353
- });
354
-
355
- await respecfully(sir, 'Validation', async () => {
356
- await ifWeMight(sir, 'validates the genesis->signed transition', async () => {
357
- const errors = await service.validate({
358
- prevIbGib: genesisKeystone,
359
- currentIbGib: signedKeystone,
360
- // metaspace: mockMetaspace,
361
- // space: mockSpace as any,
362
- });
363
-
364
- iReckon(sir, errors.length).asTo('signature validation has no errors').willEqual(0);
365
- });
366
- });
367
- });
368
-
369
- // ===========================================================================
370
- // SUITE C: SECURITY & SAD PATHS
371
- // ===========================================================================
372
-
373
- await respecfully(sir, 'Suite C: Security Vectors', async () => {
374
-
375
- const service = new KeystoneService_V1();
376
- const aliceSecret = "AliceSecret_111";
377
- const eveSecret = "EveSecret_666";
378
-
379
- let mockSpace: MockIbGibSpace;
380
- let mockMetaspace: any;
381
- let genesisKeystone: KeystoneIbGib_V1;
382
-
383
- firstOfAll(sir, async () => {
384
- mockSpace = new MockIbGibSpace();
385
- mockMetaspace = new MockMetaspaceService(mockSpace);
386
-
387
- // Setup Alice's Identity
388
- const salt = (await getUUID()).substring(0, 16);
389
- const config = createStandardPoolConfig({
390
- id: POOL_ID_DEFAULT,
391
- salt,
392
- targetBinding: 0,
393
- size: 10,
394
- });
395
- // config.behavior.size = 10;
396
- genesisKeystone = await service.genesis({
397
- masterSecret: aliceSecret,
398
- configs: [config],
1
+ import {
2
+ respecfully, iReckon, ifWe, firstOfAll, firstOfEach, lastOfAll, lastOfEach, respecfullyDear, ifWeMight
3
+ } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
4
+ const maam = `[${import.meta.url}]`, sir = maam;
5
+ import { clone, hash, getUUID } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
6
+ import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
7
+ import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
8
+
9
+ import { GLOBAL_LOG_A_LOT } from '../core-constants.mjs';
10
+ import { KeystoneStrategyFactory } from './strategy/keystone-strategy-factory.mjs';
11
+ import { KeystoneChallengePool, KeystoneClaim, KeystoneIbGib_V1, KeystonePoolConfig_HashV1, KeystoneReplenishStrategy, KeystoneClaimType, ClaimDetails_ChangePassword, ClaimDetails_AddPool, ClaimDetails_ReplacePool } from './keystone-types.mjs';
12
+ import { createRevocationPoolConfig, createStandardPoolConfig } from './keystone-config-builder.mjs';
13
+ import { POOL_ID_DEFAULT, POOL_ID_REVOKE, KEYSTONE_VERB_REVOKE, KEYSTONE_VERB_MANAGE, POOL_ID_MANAGE, KEYSTONE_VERB_SYNC, POOL_ID_CUSTODIAN_MANAGE } from './keystone-constants.mjs';
14
+ import { KeystoneService_V1, } from './keystone-service-v1.mjs';
15
+ import { selectChallengeIds, validateChallengePool, validateKeystoneIb, validateKeystoneTransition, validateGenesisKeystone, rotatePoolChallenges } from './keystone-helpers.mjs';
16
+ import { KeystoneProfileBuilder } from './policy/keystone-profile-builder.mjs';
17
+ import { getTjpAddr } from '../common/other/ibgib-helper.mjs';
18
+ import { deriveDelegateSecret } from './strategy/hash-reveal-v1/hash-reveal-v1.mjs';
19
+
20
+ const logalot = GLOBAL_LOG_A_LOT;
21
+
22
+
23
+ /**
24
+ * A simple in-memory map acting as a Space.
25
+ * Pure Storage. No Indexing logic.
26
+ */
27
+ class MockIbGibSpace {
28
+ store = new Map<string, IbGib_V1>();
29
+
30
+ constructor(public name: string = "mock_space") { }
31
+
32
+ async put({ ibGib }: { ibGib: IbGib_V1 }): Promise<void> {
33
+ const addr = getIbGibAddr({ ibGib });
34
+ this.store.set(addr, JSON.parse(JSON.stringify(ibGib))); // Deep copy
35
+ }
36
+
37
+ async get({ addr }: { addr: string }): Promise<IbGib_V1 | null> {
38
+ const data = this.store.get(addr);
39
+ return data ? JSON.parse(JSON.stringify(data)) : null;
40
+ }
41
+
42
+ async argy({ argData, ibGibs }: { argData: any; ibGibs?: IbGib_V1[] }): Promise<any> {
43
+ return {
44
+ ib: 'arg^gib',
45
+ gib: 'arg_gib',
46
+ data: argData,
47
+ ibGibs,
48
+ };
49
+ }
50
+
51
+ async witness(arg: any): Promise<any> {
52
+ const cmd = arg.data?.cmd;
53
+ const cmdModifiers = arg.data?.cmdModifiers || [];
54
+ if (cmd === 'get') {
55
+ const addrs = arg.data.ibGibAddrs || [];
56
+ if (cmdModifiers.includes('latest') && cmdModifiers.includes('addrs')) {
57
+ const latestAddrsMap: { [addr: string]: string } = {};
58
+ for (const queryAddr of addrs) {
59
+ const queryTjpGib = queryAddr.includes('.') ? queryAddr.split('.')[1] : queryAddr.split('^')[1];
60
+ let latestAddr = queryAddr;
61
+ let maxN = -1;
62
+ for (const [addr, ibGib] of this.store.entries()) {
63
+ const tjpGib = addr.includes('.') ? addr.split('.')[1] : addr.split('^')[1];
64
+ if (tjpGib === queryTjpGib) {
65
+ const n = ibGib.data?.n ?? 0;
66
+ if (n > maxN) {
67
+ maxN = n;
68
+ latestAddr = addr;
69
+ }
70
+ }
71
+ }
72
+ latestAddrsMap[queryAddr] = latestAddr;
73
+ }
74
+ return {
75
+ data: {
76
+ success: true,
77
+ latestAddrsMap,
78
+ }
79
+ };
80
+ } else {
81
+ const ibGibs: IbGib_V1[] = [];
82
+ for (const addr of addrs) {
83
+ const x = await this.get({ addr });
84
+ if (x) { ibGibs.push(x); }
85
+ }
86
+ return {
87
+ data: { success: true },
88
+ ibGibs,
89
+ };
90
+ }
91
+ }
92
+ return undefined;
93
+ }
94
+ }
95
+
96
+
97
+ /**
98
+ * A partial mock of Metaspace.
99
+ * Handles:
100
+ * 1. Retrieving the local space.
101
+ * 2. Delegating 'put' to the space.
102
+ * 3. 'registerNewIbGib': Tracking the HEAD of a timeline.
103
+ */
104
+ class MockMetaspaceService {
105
+
106
+ /**
107
+ * Map of TJP Gib (Timeline ID) -> Latest IbGib Addr (Head)
108
+ */
109
+ timelineHeads = new Map<string, string>();
110
+
111
+ constructor(public space: MockIbGibSpace) { }
112
+
113
+ async getLocalUserSpace({ lock }: { lock: boolean }): Promise<MockIbGibSpace> {
114
+ return this.space;
115
+ }
116
+
117
+ /**
118
+ * Metaspace often acts as a facade for put, defaulting to local space.
119
+ */
120
+ async put(args: any): Promise<void> {
121
+ const target = args.space || this.space;
122
+ return target.put(args);
123
+ }
124
+
125
+ async get(args: { addr: string, space?: any }): Promise<{ success: boolean, ibGibs?: IbGib_V1[] }> {
126
+ const target = args.space || this.space;
127
+ const x = await target.get({ addr: args.addr });
128
+ return {
129
+ success: !!x,
130
+ ibGibs: x ? [x] : [],
131
+ };
132
+ }
133
+
134
+ /**
135
+ * Tracks the latest version of an ibGib timeline.
136
+ */
137
+ async registerNewIbGib(args: { ibGib: IbGib_V1, space?: any }): Promise<void> {
138
+ const { ibGib } = args;
139
+ const targetSpace = args.space || this.space;
140
+
141
+ // 1. Ensure it is stored
142
+ await targetSpace.put({ ibGib });
143
+
144
+ // 2. Extract TJP (Timeline Identifier)
145
+ // Simplified logic mirroring getGibInfo
146
+ const gib = ibGib.gib || '';
147
+ let tjpGib = gib;
148
+
149
+ if (gib.includes('.')) {
150
+ // It's a frame in a timeline: "punctiliarHash.tjpHash"
151
+ // The TJP is the suffix.
152
+ const parts = gib.split('.');
153
+ tjpGib = parts.slice(1).join('.');
154
+ }
155
+ // Else: It's a Primitive or a TJP itself (Genesis).
156
+ // If Genesis (isTjp=true), the gib IS the tjpGib.
157
+
158
+ const addr = getIbGibAddr({ ibGib });
159
+ this.timelineHeads.set(tjpGib, addr);
160
+ }
161
+ }
162
+
163
+ // ===========================================================================
164
+ // SUITE A: STRATEGY VECTORS (The Math)
165
+ // ===========================================================================
166
+
167
+ await respecfully(sir, 'Suite A: Strategy Vectors (HashRevealV1)', async () => {
168
+
169
+ // Setup generic variables
170
+ const masterSecret = "TestSecret_12345";
171
+ const poolId = "TestPool";
172
+ let config: KeystonePoolConfig_HashV1;
173
+
174
+ firstOfAll(sir, async () => {
175
+ // Use our standard builder to get a valid config object
176
+ const salt = (await getUUID()).substring(0, 16);
177
+ config = createStandardPoolConfig({
178
+ id: poolId,
179
+ salt,
180
+ }) as KeystonePoolConfig_HashV1;
181
+ });
182
+
183
+ await respecfully(sir, 'Derivation Logic', async () => {
184
+
185
+ await ifWeMight(sir, 'derivePoolSecret with same inputs returns same output', async () => {
186
+ const strategy = KeystoneStrategyFactory.create({ config });
187
+
188
+ const secretA = await strategy.derivePoolSecret({ masterSecret });
189
+ const secretB = await strategy.derivePoolSecret({ masterSecret });
190
+
191
+ iReckon(sir, secretA).asTo('secret consistency').willEqual(secretB);
192
+ iReckon(sir, secretA).asTo('secret length').isGonnaBeTruthy();
193
+ });
194
+
195
+ await ifWeMight(sir, 'derivePoolSecret with different master secret returns different output', async () => {
196
+ const strategy = KeystoneStrategyFactory.create({ config });
197
+
198
+ const secretA = await strategy.derivePoolSecret({ masterSecret });
199
+ const secretB = await strategy.derivePoolSecret({ masterSecret: masterSecret + "_diff" });
200
+
201
+ iReckon(sir, secretA).asTo('secrets differ').not.willEqual(secretB);
202
+ });
203
+
204
+ await ifWeMight(sir, 'derivePoolSecret with different salt returns different output', async () => {
205
+ // Modify salt in a copy of config
206
+ const configB = { ...config, salt: "OtherPool" };
207
+ const strategyA = KeystoneStrategyFactory.create({ config });
208
+ const strategyB = KeystoneStrategyFactory.create({ config: configB });
209
+
210
+ const secretA = await strategyA.derivePoolSecret({ masterSecret });
211
+ const secretB = await strategyB.derivePoolSecret({ masterSecret });
212
+
213
+ iReckon(sir, secretA).asTo('salt affects secret').not.willEqual(secretB);
214
+ });
215
+
216
+ await ifWeMight(sir, 'deriveDelegateSecret derives a consistent secret using KDF', async () => {
217
+ const secretA = await deriveDelegateSecret({ masterSecret });
218
+ const secretB = await deriveDelegateSecret({ masterSecret });
219
+
220
+ iReckon(sir, secretA).asTo('consistency').willEqual(secretB);
221
+ iReckon(sir, secretA).asTo('truthy').isGonnaBeTruthy();
222
+
223
+ const secretC = await deriveDelegateSecret({ masterSecret: masterSecret + '_other' });
224
+ iReckon(sir, secretA).asTo('differ').not.willEqual(secretC);
225
+ });
226
+ });
227
+
228
+ await respecfully(sir, 'Challenge/Solution Logic', async () => {
229
+
230
+ await ifWeMight(sir, 'generateSolution -> generateChallenge -> validateSolution loop works', async () => {
231
+ const strategy = KeystoneStrategyFactory.create({ config });
232
+ const poolSecret = await strategy.derivePoolSecret({ masterSecret });
233
+ const challengeId = "a3ff7843552870fc28bef2b"; // arbitrary random challengeId
234
+
235
+ // 1. Generate Solution
236
+ const solution = await strategy.generateSolution({ poolSecret, poolId: config.id, challengeId });
237
+ iReckon(sir, solution.value).asTo('solution value exists').isGonnaBeTruthy();
238
+ iReckon(sir, solution.challengeId).asTo('id matches').willEqual(challengeId);
239
+
240
+ // 2. Generate Public Challenge from Solution
241
+ const challenge = await strategy.generateChallenge({ solution });
242
+ iReckon(sir, challenge.hash).asTo('challenge hash exists').isGonnaBeTruthy();
243
+
244
+ // 3. Validate
245
+ const isValid = await strategy.validateSolution({ solution, challenge });
246
+ iReckon(sir, isValid).asTo('valid pair should pass').isGonnaBeTrue();
247
+ });
248
+
249
+ await ifWeMight(sir, 'validateSolution fails for mismatched values', async () => {
250
+ const strategy = KeystoneStrategyFactory.create({ config });
251
+ const poolSecret = await strategy.derivePoolSecret({ masterSecret });
252
+ const challengeId = "8c994f3ed598f150e25513"; // arbitrary random challengeId
253
+
254
+ // Generate real pair
255
+ const solution = await strategy.generateSolution({ poolSecret, poolId: config.id, challengeId });
256
+ const challenge = await strategy.generateChallenge({ solution });
257
+
258
+ // Tamper with solution value
259
+ const badSolution = { ...solution, value: "hacked_value" };
260
+
261
+ const isValid = await strategy.validateSolution({ solution: badSolution, challenge });
262
+ iReckon(sir, isValid).asTo('tampered solution should fail').isGonnaBeFalse();
263
+ });
264
+
265
+ await ifWeMight(sir, 'validateSolution fails for mismatched challenge hashes', async () => {
266
+ const strategy = KeystoneStrategyFactory.create({ config });
267
+ const poolSecret = await strategy.derivePoolSecret({ masterSecret });
268
+
269
+ // Generate pair A
270
+ const challengeId_A = "416c38cfd6ee63dbf8d4e5ef36"; // arbitrary random challengeId
271
+ const solutionA = await strategy.generateSolution({ poolSecret, poolId: config.id, challengeId: challengeId_A });
272
+
273
+ // Generate pair B
274
+ const challengeId_B = "c487ef6b7878fae798c3"; // arbitrary random challengeId
275
+ const solutionB = await strategy.generateSolution({ poolSecret, poolId: config.id, challengeId: challengeId_B });
276
+ const challengeB = await strategy.generateChallenge({ solution: solutionB });
277
+
278
+ // Check A against B
279
+ const isValid = await strategy.validateSolution({ solution: solutionA, challenge: challengeB });
280
+ iReckon(sir, isValid).asTo('mismatched pair should fail').isGonnaBeFalse();
281
+ });
282
+ });
283
+ });
284
+
285
+ // ===========================================================================
286
+ // SUITE B: SERVICE LIFECYCLE (Genesis -> Sign -> Validate)
287
+ // ===========================================================================
288
+
289
+ await respecfully(sir, 'Suite B: Service Lifecycle', async () => {
290
+
291
+ const service = new KeystoneService_V1();
292
+ const masterSecret = "AliceSecretKey_987654321";
293
+
294
+ let mockSpace: MockIbGibSpace;
295
+ let mockMetaspace: any;
296
+
297
+ let genesisKeystone: KeystoneIbGib_V1;
298
+ let signedKeystone: KeystoneIbGib_V1;
299
+
300
+ firstOfAll(sir, async () => {
301
+ mockSpace = new MockIbGibSpace();
302
+ mockMetaspace = new MockMetaspaceService(mockSpace);
303
+ });
304
+
305
+ await respecfully(sir, 'Genesis', async () => {
306
+ await ifWeMight(sir, 'creates a valid genesis frame and persists it', async () => {
307
+ const salt = (await getUUID()).substring(0, 16);
308
+ const config = createStandardPoolConfig({
309
+ id: POOL_ID_DEFAULT,
310
+ salt,
311
+ });
312
+
313
+ genesisKeystone = await service.genesis({
314
+ masterSecret,
315
+ configs: [config],
316
+ metaspace: mockMetaspace,
317
+ space: mockSpace as any,
318
+ });
319
+
320
+ // Verify Object
321
+ iReckon(sir, genesisKeystone).asTo('genesis object').isGonnaBeTruthy();
322
+ iReckon(sir, genesisKeystone.data?.isTjp).asTo('isTjp').isGonnaBeTrue();
323
+
324
+ // Verify Persistence
325
+ const addr = getIbGibAddr({ ibGib: genesisKeystone });
326
+ const saved = await mockSpace.get({ addr });
327
+
328
+ iReckon(sir, saved).asTo('persisted to space').isGonnaBeTruthy();
329
+
330
+ // Verify Registration (Timeline Tracking)
331
+ // Genesis gib should be registered as a timeline head
332
+ const head = mockMetaspace.timelineHeads.get(genesisKeystone.gib!);
333
+ iReckon(sir, head).asTo('genesis registered as timeline head').willEqual(addr);
334
+ });
335
+ });
336
+
337
+ await respecfully(sir, 'Signing (Evolution)', async () => {
338
+ await ifWeMight(sir, 'evolves the keystone with a valid proof', async () => {
339
+ const claim: Partial<KeystoneClaim> = {
340
+ target: "comment 123^gib",
341
+ verb: "post"
342
+ };
343
+
344
+ const details = { note: "First post!" };
345
+
346
+ signedKeystone = await service.sign({
347
+ latestKeystone: genesisKeystone,
348
+ masterSecret,
349
+ claim,
350
+ poolId: POOL_ID_DEFAULT,
351
+ frameDetails: details,
352
+ metaspace: mockMetaspace,
353
+ space: mockSpace as any,
354
+ });
355
+
356
+ iReckon(sir, signedKeystone).asTo('new frame created').isGonnaBeTruthy();
357
+ iReckon(sir, signedKeystone).asTo('is different frame').not.isGonnaBe(genesisKeystone);
358
+
359
+ // NOTE: If this fails, check if 'sign' calls 'space.put' or 'metaspace.put'!
360
+ // In your current 'sign' implementation, you return the object but might have missed the save step.
361
+ const addr = getIbGibAddr({ ibGib: signedKeystone });
362
+ const saved = await mockSpace.get({ addr });
363
+ iReckon(sir, saved).asTo('persisted to space').isGonnaBeTruthy();
364
+ });
365
+ });
366
+
367
+ await respecfully(sir, 'Validation', async () => {
368
+ await ifWeMight(sir, 'validates the genesis->signed transition', async () => {
369
+ const errors = await service.validate({
370
+ prevIbGib: genesisKeystone,
371
+ currentIbGib: signedKeystone,
372
+ // metaspace: mockMetaspace,
373
+ // space: mockSpace as any,
374
+ });
375
+
376
+ iReckon(sir, errors.length).asTo('signature validation has no errors').willEqual(0);
377
+ });
378
+ });
379
+ });
380
+
381
+ // ===========================================================================
382
+ // SUITE C: SECURITY & SAD PATHS
383
+ // ===========================================================================
384
+
385
+ await respecfully(sir, 'Suite C: Security Vectors', async () => {
386
+
387
+ const service = new KeystoneService_V1();
388
+ const aliceSecret = "AliceSecret_111";
389
+ const eveSecret = "EveSecret_666";
390
+
391
+ let mockSpace: MockIbGibSpace;
392
+ let mockMetaspace: any;
393
+ let genesisKeystone: KeystoneIbGib_V1;
394
+
395
+ firstOfAll(sir, async () => {
396
+ mockSpace = new MockIbGibSpace();
397
+ mockMetaspace = new MockMetaspaceService(mockSpace);
398
+
399
+ // Setup Alice's Identity
400
+ const salt = (await getUUID()).substring(0, 16);
401
+ const config = createStandardPoolConfig({
402
+ id: POOL_ID_DEFAULT,
403
+ salt,
404
+ targetBinding: 0,
405
+ size: 10,
406
+ });
407
+ // config.behavior.size = 10;
408
+ genesisKeystone = await service.genesis({
409
+ masterSecret: aliceSecret,
410
+ configs: [config],
411
+ metaspace: mockMetaspace,
412
+ space: mockSpace as any,
413
+ });
414
+ });
415
+
416
+ await respecfully(sir, 'Wrong Secret (Forgery)', async () => {
417
+ await ifWeMight(sir, 'prevents creation of forged frames', async () => {
418
+ const claim: Partial<KeystoneClaim> = { target: "comment 123^gib", verb: "post" };
419
+
420
+ let errorCaught = false;
421
+ let errorMsg = "";
422
+
423
+ try {
424
+ // Eve tries to sign Alice's keystone.
425
+ // This MUST fail because sign() calls evolve(), which calls validate().
426
+ await service.sign({
427
+ latestKeystone: genesisKeystone,
428
+ masterSecret: eveSecret,
429
+ claim,
430
+ poolId: POOL_ID_DEFAULT,
431
+ metaspace: mockMetaspace,
432
+ space: mockSpace as any,
433
+ });
434
+ } catch (e: any) {
435
+ errorCaught = true;
436
+ errorMsg = e.message;
437
+ }
438
+
439
+ iReckon(sir, errorCaught).asTo('service rejected forgery').isGonnaBeTrue();
440
+ // Verify it was a crypto error, not something else
441
+ iReckon(sir, errorMsg).asTo('error mentions crypto violation').includes('Crypto Violation');
442
+ });
443
+ });
444
+
445
+ await respecfully(sir, 'Policy Violation (Restricted Verbs)', async () => {
446
+ await ifWeMight(sir, 'throws error if signing forbidden verb with restricted pool', async () => {
447
+ // Create a specific restricted pool config manually
448
+ const restrictedPoolId = "read_only_pool";
449
+ const restrictedConfig = createStandardPoolConfig({
450
+ id: restrictedPoolId,
451
+ salt: restrictedPoolId,
452
+ });
453
+ // Manually restrict it (since Builder defaults to undefined/allow-all)
454
+ restrictedConfig.allowedVerbs = ['read'];
455
+
456
+ const restrictedGenesis = await service.genesis({
457
+ masterSecret: aliceSecret,
458
+ configs: [restrictedConfig],
459
+ metaspace: mockMetaspace,
460
+ space: mockSpace as any,
461
+ });
462
+
463
+ // Try to sign "write" using "read_only_pool"
464
+ const claim: Partial<KeystoneClaim> = { target: "data^gib", verb: "write" };
465
+
466
+ let errorCaught = false;
467
+ try {
468
+ await service.sign({
469
+ latestKeystone: restrictedGenesis,
470
+ masterSecret: aliceSecret,
471
+ claim,
472
+ poolId: restrictedPoolId, // Force use of restricted pool
473
+ metaspace: mockMetaspace,
474
+ space: mockSpace as any,
475
+ });
476
+ } catch (e) {
477
+ errorCaught = true;
478
+ // Optional: Check error message contains "not authorized"
479
+ }
480
+
481
+ iReckon(sir, errorCaught).asTo('policy enforced').isGonnaBeTrue();
482
+ });
483
+ });
484
+ });
485
+
486
+ // ===========================================================================
487
+ // SUITE D: REVOCATION
488
+ // ===========================================================================
489
+
490
+ await respecfully(sir, 'Suite D: Revocation', async () => {
491
+
492
+ const service = new KeystoneService_V1();
493
+ const masterSecret = "AliceSecret_RevokeTest";
494
+
495
+ let mockSpace: MockIbGibSpace;
496
+ let mockMetaspace: any;
497
+ let genesisKeystone: KeystoneIbGib_V1;
498
+
499
+ firstOfAll(sir, async () => {
500
+ mockSpace = new MockIbGibSpace();
501
+ mockMetaspace = new MockMetaspaceService(mockSpace);
502
+
503
+ // Setup Identity WITH a Revocation Pool
504
+ const stdSalt = (await getUUID()).substring(0, 16);
505
+ const revokeSalt = (await getUUID()).substring(0, 16);
506
+ const stdConfig = createStandardPoolConfig({
507
+ id: POOL_ID_DEFAULT,
508
+ salt: stdSalt,
509
+ });
510
+ const revokeConfig = createRevocationPoolConfig({
511
+ id: POOL_ID_REVOKE,
512
+ salt: revokeSalt,
513
+ }); // Special Config
514
+
515
+ genesisKeystone = await service.genesis({
516
+ masterSecret,
517
+ configs: [stdConfig, revokeConfig],
518
+ metaspace: mockMetaspace,
519
+ space: mockSpace as any,
520
+ });
521
+ });
522
+
523
+ await respecfully(sir, 'Revoke Lifecycle', async () => {
524
+ let revokedKeystone: KeystoneIbGib_V1;
525
+
526
+ await ifWeMight(sir, 'successfully creates a revocation frame', async () => {
527
+ revokedKeystone = await service.revoke({
528
+ latestKeystone: genesisKeystone,
529
+ masterSecret,
530
+ reason: "Key compromised",
531
+ metaspace: mockMetaspace,
532
+ space: mockSpace as any,
533
+ });
534
+
535
+ iReckon(sir, revokedKeystone).isGonnaBeTruthy();
536
+
537
+ // Check Data
538
+ const data = revokedKeystone.data!;
539
+ iReckon(sir, data.revocationInfo).asTo('revocation info present').isGonnaBeTruthy();
540
+ iReckon(sir, data.revocationInfo!.reason).willEqual("Key compromised");
541
+ iReckon(sir, data.revocationInfo!.proof.claim.verb).willEqual(KEYSTONE_VERB_REVOKE);
542
+ });
543
+
544
+ await ifWeMight(sir, 'validates the revocation frame', async () => {
545
+ const errors = await service.validate({
546
+ prevIbGib: genesisKeystone,
547
+ currentIbGib: revokedKeystone!,
548
+ // metaspace: mockMetaspace,
549
+ // space: mockSpace as any,
550
+ });
551
+
552
+ iReckon(sir, errors.length).asTo('no validation errors').willEqual(0);
553
+ });
554
+
555
+ await ifWeMight(sir, 'consumed the revocation pool (Scorched Earth)', async () => {
556
+ const data = revokedKeystone!.data!;
557
+ const revokePool = data.challengePools.find(p => p.id === POOL_ID_REVOKE);
558
+
559
+ // The pool should exist...
560
+ iReckon(sir, revokePool).isGonnaBeTruthy();
561
+
562
+ // Should be empty (0 challenges)
563
+ const remaining = Object.keys(revokePool!.challenges);
564
+ iReckon(sir, remaining.length).asTo('pool depleted').willEqual(0);
565
+ });
566
+
567
+ await ifWeMight(sir, 'fails to sign any new claims after revocation', async () => {
568
+ let errorCaught = false;
569
+ try {
570
+ await service.sign({
571
+ latestKeystone: revokedKeystone,
572
+ masterSecret,
573
+ claim: { verb: "post", target: "some_target" },
574
+ metaspace: mockMetaspace,
575
+ space: mockSpace as any,
576
+ });
577
+ } catch (err: any) {
578
+ errorCaught = true;
579
+ iReckon(sir, err.message).includes("has been revoked");
580
+ }
581
+ iReckon(sir, errorCaught).asTo('signing blocked after revocation').isGonnaBeTrue();
582
+ });
583
+
584
+ await ifWeMight(sir, 'fails to evolve or add pools after revocation', async () => {
585
+ let errorCaught = false;
586
+ try {
587
+ const dummyConfig = createStandardPoolConfig({ id: "dummy", salt: "dummy" });
588
+ const dummyPool = { id: "dummy", config: dummyConfig, challenges: {} };
589
+ await service.addPools({
590
+ latestKeystone: revokedKeystone,
591
+ masterSecret,
592
+ newPools: [dummyPool],
593
+ metaspace: mockMetaspace,
594
+ space: mockSpace as any,
595
+ });
596
+ } catch (err: any) {
597
+ errorCaught = true;
598
+ iReckon(sir, err.message).includes("has been revoked");
599
+ }
600
+ iReckon(sir, errorCaught).asTo('adding pools blocked after revocation').isGonnaBeTrue();
601
+ });
602
+ });
603
+ });
604
+
605
+ // ===========================================================================
606
+ // SUITE E: STRUCTURAL EVOLUTION (addPools)
607
+ // ===========================================================================
608
+
609
+ await respecfully(sir, 'Suite E: Structural Evolution (addPools)', async () => {
610
+
611
+ const service = new KeystoneService_V1();
612
+ const aliceSecret = "Alice_Master_Key";
613
+ const bobSecret = "Bob_Foreign_Key";
614
+
615
+ let mockSpace: MockIbGibSpace;
616
+ let mockMetaspace: any;
617
+ let aliceKeystone: KeystoneIbGib_V1;
618
+
619
+ // Helper to generate a "Foreign" pool (e.g. from Bob)
620
+ const createForeignPool = async (id: string, verbs: string[] = []): Promise<KeystoneChallengePool> => {
621
+ const salt = (await getUUID()).substring(0, 16);
622
+ const config = createStandardPoolConfig({ id, salt });
623
+ config.allowedVerbs = verbs;
624
+
625
+ // We use the factory manually here to simulate Bob doing this offline
626
+ const strategy = KeystoneStrategyFactory.create({ config });
627
+ const poolSecret = await strategy.derivePoolSecret({ masterSecret: bobSecret });
628
+ const challenges: { [id: string]: any } = {};
629
+
630
+ for (let i = 0; i < 10; i++) {
631
+ // Manually replicate ID gen for test
632
+ const raw = await hash({ s: `${config.salt}${Date.now()}${i}` });
633
+ const challengeId = raw.substring(0, 16);
634
+
635
+ const solution = await strategy.generateSolution({
636
+ poolSecret, poolId: config.salt, challengeId,
637
+ });
638
+ const challenge = await strategy.generateChallenge({ solution });
639
+ challenges[challengeId] = challenge;
640
+ }
641
+
642
+ return {
643
+ id,
644
+ config,
645
+ challenges,
646
+ isForeign: true,
647
+ metadata: { owner: 'Bob' }
648
+ };
649
+ };
650
+
651
+ firstOfAll(sir, async () => {
652
+ mockSpace = new MockIbGibSpace();
653
+ mockMetaspace = new MockMetaspaceService(mockSpace);
654
+
655
+ // Alice Genesis: Standard pool (allows all verbs, including 'manage')
656
+ const salt = (await getUUID()).substring(0, 16);
657
+ const config = createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt });
658
+ aliceKeystone = await service.genesis({
659
+ masterSecret: aliceSecret,
660
+ configs: [config],
661
+ metaspace: mockMetaspace,
662
+ space: mockSpace as any,
663
+ });
664
+ });
665
+
666
+ await respecfully(sir, 'Happy Path', async () => {
667
+ await ifWeMight(sir, 'authorizes and adds a foreign pool', async () => {
668
+ const bobPool = await createForeignPool("pool_bob", ["post"]);
669
+
670
+ const updatedKeystone = await service.addPools({
671
+ latestKeystone: aliceKeystone,
672
+ masterSecret: aliceSecret,
673
+ newPools: [bobPool],
674
+ metaspace: mockMetaspace,
675
+ space: mockSpace as any,
676
+ });
677
+
678
+ // 1. Verify new state
679
+ iReckon(sir, updatedKeystone).isGonnaBeTruthy();
680
+ const pools = updatedKeystone.data!.challengePools;
681
+ iReckon(sir, pools.length).asTo('pool count increased').willEqual(2);
682
+
683
+ const foundBob = pools.find(p => p.id === "pool_bob");
684
+ iReckon(sir, foundBob).asTo('bob pool exists').isGonnaBeTruthy();
685
+ iReckon(sir, foundBob!.isForeign).asTo('isForeign flag').isGonnaBeTrue();
686
+
687
+ // 2. Verify Proof
688
+ const proof = updatedKeystone.data!.proofs[0];
689
+ iReckon(sir, proof.claim.verb).asTo('proof verb').willEqual("manage");
690
+ // Alice signed this using HER pool (default), not Bob's
691
+ iReckon(sir, proof.solutions[0].poolId).willEqual(POOL_ID_DEFAULT);
692
+
693
+ // 3. Verify Validity
694
+ const errors = await service.validate({
695
+ prevIbGib: aliceKeystone,
696
+ currentIbGib: updatedKeystone,
697
+ });
698
+ iReckon(sir, errors.length).asTo('validation passed').willEqual(0);
699
+
700
+ // Update local ref for next tests
701
+ aliceKeystone = updatedKeystone;
702
+ });
703
+ });
704
+
705
+ await respecfully(sir, 'Permissions & Logic', async () => {
706
+ await ifWeMight(sir, 'fails if no pool allows "manage" verb', async () => {
707
+ // 1. Create a restricted keystone
708
+ let id = "read_only";
709
+ const restrictedConfig = createStandardPoolConfig({ id, salt: id });
710
+ restrictedConfig.allowedVerbs = ['read']; // No 'manage'
711
+
712
+ const restrictedKeystone = await service.genesis({
713
+ masterSecret: aliceSecret,
714
+ configs: [restrictedConfig],
715
+ metaspace: mockMetaspace,
716
+ space: mockSpace as any,
717
+ });
718
+
719
+ const newPool = await createForeignPool("pool_test");
720
+ let errorCaught = false;
721
+
722
+ try {
723
+ await service.addPools({
724
+ latestKeystone: restrictedKeystone,
725
+ masterSecret: aliceSecret,
726
+ newPools: [newPool],
727
+ metaspace: mockMetaspace,
728
+ space: mockSpace as any,
729
+ });
730
+ } catch (e: any) {
731
+ errorCaught = true;
732
+ // Should fail in resolveTargetPool or addPools logic
733
+ // console.log("Caught expected error:", e.message);
734
+ }
735
+
736
+ iReckon(sir, errorCaught).asTo('permission denied').isGonnaBeTrue();
737
+ });
738
+
739
+ await ifWeMight(sir, 'fails on ID collision', async () => {
740
+ // Try to add "pool_bob" again (it was added in Happy Path)
741
+ const duplicatePool = await createForeignPool("pool_bob");
742
+
743
+ let errorCaught = false;
744
+ try {
745
+ await service.addPools({
746
+ latestKeystone: aliceKeystone, // This already has pool_bob
747
+ masterSecret: aliceSecret,
748
+ newPools: [duplicatePool],
749
+ metaspace: mockMetaspace,
750
+ space: mockSpace as any,
751
+ });
752
+ } catch (e: any) {
753
+ errorCaught = true;
754
+ iReckon(sir, e.message).includes("ID collision");
755
+ }
756
+
757
+ iReckon(sir, errorCaught).asTo('collision detected').isGonnaBeTrue();
758
+ });
759
+ });
760
+ });
761
+
762
+ // ===========================================================================
763
+ // SUITE E: STRUCTURAL EVOLUTION (addPools)
764
+ // ===========================================================================
765
+
766
+ await respecfully(sir, 'Suite E: Structural Evolution (addPools)', async () => {
767
+
768
+ const service = new KeystoneService_V1();
769
+ const aliceSecret = "Alice_Master_Key";
770
+ const bobSecret = "Bob_Foreign_Key";
771
+
772
+ let mockSpace: MockIbGibSpace;
773
+ let mockMetaspace: any;
774
+ let aliceKeystone: KeystoneIbGib_V1;
775
+
776
+ // Helper to simulate Bob creating a pool "offline" to give to Alice
777
+ const createForeignPool = async (id: string, verbs: string[] = []): Promise<KeystoneChallengePool> => {
778
+ const salt = (await getUUID()).substring(0, 16);
779
+ const config = createStandardPoolConfig({ id, salt });
780
+ config.allowedVerbs = verbs;
781
+
782
+ // We use the factory manually here to simulate Bob doing this on his own machine
783
+ const strategy = KeystoneStrategyFactory.create({ config });
784
+ const poolSecret = await strategy.derivePoolSecret({ masterSecret: bobSecret });
785
+ const challenges: { [id: string]: any } = {};
786
+
787
+ // Generate a small set of challenges
788
+ for (let i = 0; i < 10; i++) {
789
+ const raw = await hash({ s: `${config.salt}${Date.now()}${i}` });
790
+ const challengeId = raw.substring(0, 16);
791
+
792
+ const solution = await strategy.generateSolution({
793
+ poolSecret, poolId: config.salt, challengeId,
794
+ });
795
+ const challenge = await strategy.generateChallenge({ solution });
796
+ challenges[challengeId] = challenge;
797
+ }
798
+
799
+ return {
800
+ id,
801
+ config,
802
+ challenges,
803
+ isForeign: true,
804
+ metadata: { owner: 'Bob', role: 'Delegate' }
805
+ };
806
+ };
807
+
808
+ firstOfAll(sir, async () => {
809
+ mockSpace = new MockIbGibSpace();
810
+ mockMetaspace = new MockMetaspaceService(mockSpace);
811
+
812
+ // Alice Genesis: Standard pool (allows all verbs, including 'manage')
813
+ const salt = (await getUUID()).substring(0, 16);
814
+ const config = createStandardPoolConfig({
815
+ id: POOL_ID_DEFAULT,
816
+ salt,
817
+ });
818
+ aliceKeystone = await service.genesis({
819
+ masterSecret: aliceSecret,
820
+ configs: [config],
821
+ metaspace: mockMetaspace,
822
+ space: mockSpace as any,
823
+ });
824
+ });
825
+
826
+ await respecfully(sir, 'Happy Path', async () => {
827
+ await ifWeMight(sir, 'authorizes and adds a foreign pool', async () => {
828
+ const bobPool = await createForeignPool("pool_bob", ["post"]);
829
+
830
+ const updatedKeystone = await service.addPools({
831
+ latestKeystone: aliceKeystone,
832
+ masterSecret: aliceSecret,
833
+ newPools: [bobPool],
834
+ metaspace: mockMetaspace,
835
+ space: mockSpace as any,
836
+ });
837
+
838
+ // 1. Verify new state
839
+ iReckon(sir, updatedKeystone).isGonnaBeTruthy();
840
+ const pools = updatedKeystone.data!.challengePools;
841
+ iReckon(sir, pools.length).asTo('pool count increased').willEqual(2);
842
+
843
+ const foundBob = pools.find(p => p.id === "pool_bob");
844
+ iReckon(sir, foundBob).asTo('bob pool exists').isGonnaBeTruthy();
845
+ iReckon(sir, foundBob!.isForeign).asTo('isForeign flag').isGonnaBeTrue();
846
+
847
+ // 2. Verify Proof
848
+ const proof = updatedKeystone.data!.proofs[0];
849
+ iReckon(sir, proof.claim.verb).asTo('proof verb').willEqual(KEYSTONE_VERB_MANAGE);
850
+ // Alice signed this using HER pool (default), not Bob's
851
+ iReckon(sir, proof.solutions[0].poolId).willEqual(POOL_ID_DEFAULT);
852
+
853
+ // 3. Verify Validity
854
+ const errors = await service.validate({
855
+ prevIbGib: aliceKeystone,
856
+ currentIbGib: updatedKeystone,
857
+ });
858
+ iReckon(sir, errors.length).asTo('validation passed').willEqual(0);
859
+
860
+ // Update local ref for next tests
861
+ aliceKeystone = updatedKeystone;
862
+ });
863
+ });
864
+
865
+ await respecfully(sir, 'Permissions & Logic', async () => {
866
+ await ifWeMight(sir, 'fails if no pool allows "manage" verb', async () => {
867
+ // 1. Create a restricted keystone (read-only)
868
+ let id = "read_only";
869
+ const restrictedConfig = createStandardPoolConfig({ id, salt: id });
870
+ restrictedConfig.allowedVerbs = ['read']; // No 'manage'
871
+
872
+ const restrictedKeystone = await service.genesis({
873
+ masterSecret: aliceSecret,
874
+ configs: [restrictedConfig],
875
+ metaspace: mockMetaspace,
876
+ space: mockSpace as any,
877
+ });
878
+
879
+ const newPool = await createForeignPool("pool_test");
880
+ let errorCaught = false;
881
+
882
+ try {
883
+ await service.addPools({
884
+ latestKeystone: restrictedKeystone,
885
+ masterSecret: aliceSecret,
886
+ newPools: [newPool],
887
+ metaspace: mockMetaspace,
888
+ space: mockSpace as any,
889
+ });
890
+ } catch (e: any) {
891
+ errorCaught = true;
892
+ // Optional: Check error message
893
+ // iReckon(sir, e.message).includes("No local pool found with 'manage'");
894
+ }
895
+
896
+ iReckon(sir, errorCaught).asTo('permission denied').isGonnaBeTrue();
897
+ });
898
+
899
+ await ifWeMight(sir, 'fails on ID collision', async () => {
900
+ // Try to add "pool_bob" again (it was added in Happy Path)
901
+ const duplicatePool = await createForeignPool("pool_bob");
902
+
903
+ let errorCaught = false;
904
+ try {
905
+ await service.addPools({
906
+ latestKeystone: aliceKeystone, // This already has pool_bob
907
+ masterSecret: aliceSecret,
908
+ newPools: [duplicatePool],
909
+ metaspace: mockMetaspace,
910
+ space: mockSpace as any,
911
+ });
912
+ } catch (e: any) {
913
+ errorCaught = true;
914
+ iReckon(sir, e.message).includes("collision");
915
+ }
916
+
917
+ iReckon(sir, errorCaught).asTo('collision detected').isGonnaBeTrue();
918
+ });
919
+ });
920
+ });
921
+
922
+ // ===========================================================================
923
+ // SUITE F: DEEP INSPECTION (Granularity & Serialization)
924
+ // ===========================================================================
925
+
926
+ await respecfully(sir, 'Suite F: Deep Inspection', async () => {
927
+
928
+ const service = new KeystoneService_V1();
929
+ const aliceSecret = "Alice_Deep_Inspect";
930
+ const poolId = "granularity_pool";
931
+
932
+ let mockSpace: MockIbGibSpace;
933
+ let mockMetaspace: any;
934
+ let genesisKeystone: KeystoneIbGib_V1;
935
+ let signedKeystone: KeystoneIbGib_V1;
936
+ let hybridConfig: KeystonePoolConfig_HashV1;
937
+
938
+ firstOfAll(sir, async () => {
939
+ mockSpace = new MockIbGibSpace();
940
+ mockMetaspace = new MockMetaspaceService(mockSpace);
941
+
942
+ const salt = (await getUUID()).substring(0, 16);
943
+ hybridConfig = createStandardPoolConfig({
944
+ id: poolId,
945
+ salt,
946
+ // 2 FIFO + 2 Random = 4 Total per sign
947
+ sequential: 2, random: 2, targetBinding: 0,
948
+ size: 20, // Small enough to track, large enough to be random
949
+ }) as KeystonePoolConfig_HashV1;
950
+
951
+ genesisKeystone = await service.genesis({
952
+ masterSecret: aliceSecret,
953
+ configs: [hybridConfig],
954
+ metaspace: mockMetaspace,
955
+ space: mockSpace as any,
956
+ });
957
+ });
958
+
959
+ await respecfully(sir, 'Proof Granularity & Math', async () => {
960
+
961
+ await ifWeMight(sir, 'generates exactly the expected number of solutions', async () => {
962
+ signedKeystone = await service.sign({
963
+ latestKeystone: genesisKeystone,
964
+ masterSecret: aliceSecret,
965
+ claim: { verb: "post", target: "data^gib" },
966
+ metaspace: mockMetaspace,
967
+ space: mockSpace as any,
968
+ });
969
+
970
+ const proofs = signedKeystone.data!.proofs;
971
+ iReckon(sir, proofs.length).asTo('proof count').willEqual(1);
972
+
973
+ const solutions = proofs[0].solutions;
974
+ // 2 Sequential + 2 Random = 4
975
+ iReckon(sir, solutions.length).asTo('solution count').willEqual(4);
976
+ });
977
+
978
+ await ifWeMight(sir, 'verifies the math manually (White-box Crypto Check)', async () => {
979
+ const proof = signedKeystone.data!.proofs[0];
980
+ const poolSnapshot = genesisKeystone.data!.challengePools.find(p => p.id === poolId)!;
981
+
982
+ // We iterate every solution in the proof and MANUALLY verify the hash relationship
983
+ // bypassing the Service's validation logic to ensure the raw math holds up.
984
+
985
+ for (const solution of proof.solutions) {
986
+ // 1. Find the challenge in the *Previous* frame (Genesis)
987
+ const challenge = poolSnapshot.challenges[solution.challengeId];
988
+
989
+ if (!challenge) {
990
+ throw new Error(`Test Failure: Solution references ID ${solution.challengeId} which was not in Genesis pool.`);
991
+ }
992
+
993
+ // 2. Re-implement HashReveal V1 verification logic locally in the test
994
+ // Hash(Salt + Value + Salt)
995
+ // Note: rounds=1 in standard config
996
+ const indexSalt = solution.challengeId;
997
+ const calculatedHash = await hash({
998
+ s: `${indexSalt}${solution.value}${indexSalt}`,
999
+ algorithm: 'SHA-256'
1000
+ });
1001
+
1002
+ // 3. Assert
1003
+ iReckon(sir, calculatedHash).asTo(`Manual hash verification for ${solution.challengeId}`).willEqual(challenge.hash);
1004
+ }
1005
+ });
1006
+
1007
+ await ifWeMight(sir, 'verifies FIFO logic (Deterministic Selection)', async () => {
1008
+ const proof = signedKeystone.data!.proofs[0];
1009
+ const poolSnapshot = genesisKeystone.data!.challengePools.find(p => p.id === poolId)!;
1010
+
1011
+ // The first N keys in the pool should be the FIFO targets.
1012
+ // Assumption: Object.keys returns insertion order (Standard in modern JS engines)
1013
+ const allIds = Object.keys(poolSnapshot.challenges);
1014
+ const expectedFifoIds = allIds.slice(0, 2);
1015
+
1016
+ const solvedIds = proof.solutions.map(s => s.challengeId);
1017
+
1018
+ // Check that our solution list *includes* the expected FIFO IDs
1019
+ const hasFirst = solvedIds.includes(expectedFifoIds[0]);
1020
+ const hasSecond = solvedIds.includes(expectedFifoIds[1]);
1021
+
1022
+ iReckon(sir, hasFirst).asTo(`Solution includes 1st FIFO ID (${expectedFifoIds[0]})`).isGonnaBeTrue();
1023
+ iReckon(sir, hasSecond).asTo(`Solution includes 2nd FIFO ID (${expectedFifoIds[1]})`).isGonnaBeTrue();
1024
+ });
1025
+
1026
+ await ifWeMight(sir, 'verifies Next-Gen Hash-Based Target Binding Selection', async () => {
1027
+ const bindingConfig = createStandardPoolConfig({
1028
+ id: "binding_pool",
1029
+ salt: "binding_salt",
1030
+ sequential: 0,
1031
+ random: 0,
1032
+ targetBinding: 3,
1033
+ size: 20
1034
+ }) as KeystonePoolConfig_HashV1;
1035
+
1036
+ const tempGenesis = await service.genesis({
1037
+ masterSecret: aliceSecret,
1038
+ configs: [bindingConfig],
1039
+ metaspace: mockMetaspace,
1040
+ space: mockSpace as any,
1041
+ });
1042
+
1043
+ // Evolve using the binding pool
1044
+ const evolved = await service.sign({
1045
+ latestKeystone: tempGenesis,
1046
+ masterSecret: aliceSecret,
1047
+ poolId: "binding_pool",
1048
+ claim: {
1049
+ verb: "sign",
1050
+ target: "some_target_address^gib"
1051
+ },
1052
+ metaspace: mockMetaspace,
1053
+ space: mockSpace as any,
1054
+ });
1055
+
1056
+ const proof = evolved.data!.proofs[0];
1057
+ iReckon(sir, proof.solutions.length).asTo('proof solutions count').willEqual(3);
1058
+
1059
+ // Now, let's verify that the selection is perfectly deterministic.
1060
+ // If we run selectChallengeIds manually with the same pool and target, it must return the same IDs.
1061
+ const poolSnapshot = tempGenesis.data!.challengePools.find(p => p.id === "binding_pool")!;
1062
+ const selectedIds = await selectChallengeIds({
1063
+ pool: poolSnapshot,
1064
+ targetAddr: "some_target_address^gib"
1065
+ });
1066
+
1067
+ const proofIds = proof.solutions.map(s => s.challengeId);
1068
+ iReckon(sir, selectedIds.length).asTo('selected IDs count').willEqual(3);
1069
+ for (const id of selectedIds) {
1070
+ iReckon(sir, proofIds.includes(id)).asTo(`proof includes selected ID ${id}`).isGonnaBeTrue();
1071
+ }
1072
+ });
1073
+
1074
+ await ifWeMight(sir, 'fails validation if total requested challenges >= size', async () => {
1075
+ const invalidConfig = createStandardPoolConfig({
1076
+ id: "invalid_pool",
1077
+ salt: "invalid_salt",
1078
+ sequential: 5,
1079
+ random: 5,
1080
+ targetBinding: 6,
1081
+ size: 15 // total requested is 5+5+6 = 16 >= 15
1082
+ });
1083
+
1084
+ const errors = await validateChallengePool({ pool: { id: "invalid_pool", config: invalidConfig, challenges: {} } });
1085
+ iReckon(sir, errors.length > 0).asTo('errors length is positive').isGonnaBeTrue();
1086
+ const hasCorrectError = errors.some(e => e.includes("Total requested challenges"));
1087
+ iReckon(sir, hasCorrectError).asTo('validation error content').isGonnaBeTrue();
1088
+ });
1089
+ });
1090
+
1091
+ await respecfully(sir, 'DTO & Serialization', async () => {
1092
+
1093
+ await ifWeMight(sir, 'survives a clone/JSON-cycle without corruption', async () => {
1094
+ // 1. Create a DTO (simulate network transmission/storage)
1095
+ // 'clone' does a JSON stringify/parse under the hood (usually) or structured clone.
1096
+ const dto = clone(signedKeystone);
1097
+
1098
+ // 2. Structural checks
1099
+ iReckon(sir, dto).asTo('dto exists').isGonnaBeTruthy();
1100
+ iReckon(sir, dto.data).asTo('dto data').isGonnaBeTruthy();
1101
+ iReckon(sir, dto.data!.proofs).asTo('dto proofs').isGonnaBeTruthy();
1102
+
1103
+ // 3. Functional check: Can the service validate this DTO?
1104
+ // This ensures no prototypes or hidden properties were lost that the service depends on.
1105
+ const errors = await service.validate({
1106
+ prevIbGib: genesisKeystone,
1107
+ currentIbGib: dto, // Passing the DTO, not the original object
1108
+ });
1109
+
1110
+ iReckon(sir, errors.length).asTo('DTO validation errors').willEqual(0);
1111
+ });
1112
+
1113
+ await ifWeMight(sir, 'ensures data contains no functions or circular refs', async () => {
1114
+ // A crude but effective test: ensure JSON.stringify doesn't throw
1115
+ // and the result is equal to the object (if we parsed it back).
1116
+
1117
+ const jsonStr = JSON.stringify(signedKeystone);
1118
+ const parsed = JSON.parse(jsonStr);
1119
+
1120
+ // Compare specific deep fields
1121
+ const originalSolution = signedKeystone.data!.proofs[0].solutions[0].value;
1122
+ const parsedSolution = parsed.data.proofs[0].solutions[0].value;
1123
+
1124
+ iReckon(sir, parsedSolution).asTo('deep property survives stringify').willEqual(originalSolution);
1125
+
1126
+ // Ensure no extra properties were lost
1127
+ // FIX: JSON.stringify removes keys with 'undefined' values.
1128
+ // We must filter the original keys to match this behavior for a fair comparison.
1129
+ const origKeys = Object.keys(signedKeystone.data!)
1130
+ .filter(k => (signedKeystone.data as any)[k] !== undefined);
1131
+
1132
+ const parsedKeys = Object.keys(parsed.data);
1133
+ iReckon(sir, parsedKeys.length).asTo('key count matches').willEqual(origKeys.length);
1134
+ });
1135
+
1136
+ });
1137
+
1138
+ await respecfully(sir, 'KeystoneProfileBuilder and Modular Schemas', async () => {
1139
+
1140
+ await ifWeMight(sir, 'compiles configs successfully with medium profile', async () => {
1141
+ const builder = KeystoneProfileBuilder.buildKeystone('medium')
1142
+ .withUsername('alice')
1143
+ .withEmail('alice@example.com')
1144
+ .withDescription('Alice test keystone')
1145
+ .withDetails({ extraInfo: 'abc' });
1146
+
1147
+ const configs = await builder.compileConfigs();
1148
+ iReckon(sir, configs.length).asTo('number of pools').willEqual(5);
1149
+
1150
+ // Verify unique salt derivation per pool
1151
+ const salts = configs.map(c => c.salt);
1152
+ const uniqueSalts = new Set(salts);
1153
+ iReckon(sir, uniqueSalts.size).asTo('unique salts count').willEqual(5);
1154
+
1155
+ // Verify frameDetails unification
1156
+ const details = builder.getFrameDetails();
1157
+ iReckon(sir, details.username).asTo('username').willEqual('alice');
1158
+ iReckon(sir, details.email).asTo('email').willEqual('alice@example.com');
1159
+ iReckon(sir, details.description).asTo('description').willEqual('Alice test keystone');
1160
+ iReckon(sir, details.extraInfo).asTo('extraInfo').willEqual('abc');
1161
+ });
1162
+
1163
+ await ifWeMight(sir, 'compiles configs successfully with domain profile (omitting connect)', async () => {
1164
+ const builder = KeystoneProfileBuilder.buildKeystone('domain')
1165
+ .withUsername('alice')
1166
+ .withEmail('alice@example.com')
1167
+ .withDescription('Alice domain keystone');
1168
+
1169
+ const configs = await builder.compileConfigs();
1170
+ iReckon(sir, configs.length).asTo('number of pools').willEqual(4);
1171
+
1172
+ const connectPool = configs.find(c => c.id === 'connect');
1173
+ iReckon(sir, connectPool).asTo('connect pool omitted').isGonnaBeUndefined();
1174
+ });
1175
+
1176
+ await ifWeMight(sir, 'supports customized overrides', async () => {
1177
+ const builder = KeystoneProfileBuilder.buildKeystone('test')
1178
+ .customizePool('sync', {
1179
+ behavior: {
1180
+ size: 15,
1181
+ targetBindingCount: 4
1182
+ }
1183
+ });
1184
+
1185
+ const configs = await builder.compileConfigs();
1186
+ const syncPool = configs.find(c => c.id === 'sync')!;
1187
+ iReckon(sir, syncPool.behavior.size).asTo('customized size').willEqual(15);
1188
+ iReckon(sir, syncPool.behavior.targetBindingCount).asTo('customized target binding').willEqual(4);
1189
+ });
1190
+
1191
+ });
1192
+
1193
+ await respecfully(sir, 'Keystone Metadata Validation', async () => {
1194
+
1195
+ await ifWeMight(sir, 'validates correct username and description', async () => {
1196
+ const service = new KeystoneService_V1();
1197
+ const space = new MockIbGibSpace();
1198
+ const metaspace = new MockMetaspaceService(space);
1199
+
1200
+ const builder = KeystoneProfileBuilder.buildKeystone('test')
1201
+ .withUsername('alice_123.test')
1202
+ .withDescription('Valid description: yes, it is!')
1203
+ .withDetails({ client: 'respec' });
1204
+
1205
+ const configs = await builder.compileConfigs();
1206
+ const frameDetails = builder.getFrameDetails();
1207
+
1208
+ // Should succeed without error
1209
+ const keystoneIbGib = await service.genesis({
1210
+ masterSecret: 'mysecret',
1211
+ configs,
1212
+ metaspace: metaspace as any,
1213
+ space: space as any,
1214
+ frameDetails
1215
+ });
1216
+
1217
+ const errors = await service.validateGenesisKeystone({ keystoneIbGib });
1218
+ iReckon(sir, errors.length).asTo('errors count').willEqual(0);
1219
+ });
1220
+
1221
+ await ifWeMight(sir, 'fails validation for invalid username length or character', async () => {
1222
+ const service = new KeystoneService_V1();
1223
+ const space = new MockIbGibSpace();
1224
+ const metaspace = new MockMetaspaceService(space);
1225
+
1226
+ const builder = KeystoneProfileBuilder.buildKeystone('test')
1227
+ .withUsername('invalid_user_name_that_is_way_too_long_for_the_sixty_three_char_limit_and_will_fail_regex_check')
1228
+ .withDetails({ client: 'respec' });
1229
+
1230
+ const configs = await builder.compileConfigs();
1231
+ const frameDetails = builder.getFrameDetails();
1232
+
1233
+ const keystoneIbGib = await service.genesis({
1234
+ masterSecret: 'mysecret',
1235
+ configs,
1236
+ metaspace: metaspace as any,
1237
+ space: space as any,
1238
+ frameDetails
1239
+ });
1240
+
1241
+ const errors = await service.validateGenesisKeystone({ keystoneIbGib });
1242
+ iReckon(sir, errors.length).asTo('errors count').willEqual(1);
1243
+ iReckon(sir, errors[0]).includes('invalid username');
1244
+ });
1245
+
1246
+ await ifWeMight(sir, 'fails validation for invalid description characters', async () => {
1247
+ const service = new KeystoneService_V1();
1248
+ const space = new MockIbGibSpace();
1249
+ const metaspace = new MockMetaspaceService(space);
1250
+
1251
+ const builder = KeystoneProfileBuilder.buildKeystone('test')
1252
+ .withUsername('alice')
1253
+ .withDescription('Invalid desc with weird emoji 🚀')
1254
+ .withDetails({ client: 'respec' });
1255
+
1256
+ const configs = await builder.compileConfigs();
1257
+ const frameDetails = builder.getFrameDetails();
1258
+
1259
+ const keystoneIbGib = await service.genesis({
1260
+ masterSecret: 'mysecret',
1261
+ configs,
1262
+ metaspace: metaspace as any,
1263
+ space: space as any,
1264
+ frameDetails
1265
+ });
1266
+
1267
+ const errors = await service.validateGenesisKeystone({ keystoneIbGib });
1268
+ iReckon(sir, errors.length).asTo('errors count').willEqual(1);
1269
+ iReckon(sir, errors[0]).includes('invalid description');
1270
+ });
1271
+
1272
+ });
1273
+ });
1274
+
1275
+
1276
+ // ===========================================================================
1277
+ // SUITE E: DELEGATION (Register/Unregister)
1278
+ // ===========================================================================
1279
+
1280
+ await respecfully(sir, 'Suite E: Delegation (Register/Unregister)', async () => {
1281
+
1282
+ const service = new KeystoneService_V1();
1283
+ const parentSecret = "ParentMasterSecret_123";
1284
+ const delegateSecret = "DelegateMasterSecret_456";
1285
+
1286
+ let mockSpace: MockIbGibSpace;
1287
+ let mockMetaspace: any;
1288
+
1289
+ let parentKeystone: KeystoneIbGib_V1;
1290
+ let delegateKeystone: KeystoneIbGib_V1;
1291
+
1292
+ firstOfEach(sir, async () => {
1293
+ mockSpace = new MockIbGibSpace();
1294
+ mockMetaspace = new MockMetaspaceService(mockSpace);
1295
+
1296
+ const salt = (await getUUID()).substring(0, 16);
1297
+ const defaultConfig = createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt });
1298
+ const manageConfig = createStandardPoolConfig({ id: POOL_ID_MANAGE, salt: salt + "_manage" });
1299
+ manageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE];
1300
+
1301
+ // 1. Create Parent Keystone (with manage pool)
1302
+ parentKeystone = await service.genesis({
1303
+ masterSecret: parentSecret,
1304
+ configs: [defaultConfig, manageConfig],
1305
+ metaspace: mockMetaspace,
1306
+ space: mockSpace as any,
1307
+ });
1308
+
1309
+ // 2. Create Delegate Keystone
1310
+ const delegateConfig = createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt: salt + "_delegate" });
1311
+ delegateKeystone = await service.genesis({
1312
+ masterSecret: delegateSecret,
1313
+ configs: [delegateConfig],
1314
+ metaspace: mockMetaspace,
1315
+ space: mockSpace as any,
1316
+ });
1317
+ });
1318
+
1319
+ await ifWeMight(sir, 'registers a delegate keystone and evolves parent using manage pool', async () => {
1320
+ // Register the delegate
1321
+ const evolvedParent = await service.registerDelegate({
1322
+ parentKeystone,
1323
+ delegateKeystone,
1324
+ masterSecret: parentSecret,
1325
+ metaspace: mockMetaspace,
1326
+ space: mockSpace as any,
1327
+ allowedVerbs: [KEYSTONE_VERB_SYNC],
1328
+ });
1329
+
1330
+ iReckon(sir, evolvedParent).asTo('evolved parent exists').isGonnaBeTruthy();
1331
+ iReckon(sir, evolvedParent.data?.delegates).asTo('delegates map exists').isGonnaBeTruthy();
1332
+
1333
+ const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1334
+ if (!delegateTjpAddr) { throw new Error(`(UNEXPECTED) delegateTjpAddr falsy? (E: 312e986ce4b2ed6c084c03e8f45fa826)`); }
1335
+ const delegateInfo = evolvedParent.data?.delegates?.[delegateTjpAddr];
1336
+ iReckon(sir, delegateInfo).asTo('delegate info registered').isGonnaBeTruthy();
1337
+ iReckon(sir, delegateInfo?.delegateTjpAddr).asTo('delegate tjp matches').willEqual(delegateTjpAddr);
1338
+ });
1339
+
1340
+ await ifWeMight(sir, 'gets correct delegate status via parent TJP address', async () => {
1341
+ const parentTjpAddr = getTjpAddr({ ibGib: parentKeystone });
1342
+ if (!parentTjpAddr) { throw new Error(`(UNEXPECTED) parentTjpAddr falsy? (E: b7ce2835ccd951d8c99257328be3b826)`); }
1343
+ const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1344
+ if (!delegateTjpAddr) { throw new Error(`(UNEXPECTED) delegateTjpAddr falsy? (E: 3e4878ea19dd8034e827466a8bf09526)`); }
1345
+
1346
+ // Before registration
1347
+ const statusBefore = await service.getDelegateStatus({
1348
+ parentTjpAddr: parentTjpAddr,
1349
+ delegateTjpAddr: delegateTjpAddr,
1350
+ metaspace: mockMetaspace,
1351
+ space: mockSpace as any,
1352
+ });
1353
+ iReckon(sir, statusBefore.registered).asTo('initially unregistered').isGonnaBeFalse();
1354
+
1355
+ // Register
1356
+ const evolvedParent = await service.registerDelegate({
1357
+ parentKeystone,
1358
+ delegateKeystone,
1359
+ masterSecret: parentSecret,
1360
+ metaspace: mockMetaspace,
1361
+ space: mockSpace as any,
1362
+ allowedVerbs: [KEYSTONE_VERB_SYNC],
1363
+ });
1364
+
1365
+ // After registration
1366
+ const statusAfter = await service.getDelegateStatus({
1367
+ parentTjpAddr: parentTjpAddr,
1368
+ delegateTjpAddr: delegateTjpAddr,
1369
+ metaspace: mockMetaspace,
1370
+ space: mockSpace as any,
1371
+ });
1372
+ iReckon(sir, statusAfter.registered).asTo('registered status').isGonnaBeTrue();
1373
+ iReckon(sir, statusAfter.delegateInfo?.delegateTjpAddr).asTo('status tjp matches').willEqual(delegateTjpAddr);
1374
+ });
1375
+
1376
+ await ifWeMight(sir, 'unregisters a registered delegate keystone', async () => {
1377
+ // Register first
1378
+ const evolvedParent = await service.registerDelegate({
1379
+ parentKeystone,
1380
+ delegateKeystone,
1381
+ masterSecret: parentSecret,
1382
+ metaspace: mockMetaspace,
1383
+ space: mockSpace as any,
1384
+ allowedVerbs: [KEYSTONE_VERB_SYNC],
1385
+ });
1386
+
1387
+ const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1388
+ if (!delegateTjpAddr) { throw new Error(`(UNEXPECTED) delegateTjpAddr falsy? (E: 486b486a8c984a52b8d2b22418c20d26)`); }
1389
+
1390
+ // Unregister
1391
+ const finalParent = await service.unregisterDelegate({
1392
+ parentKeystone: evolvedParent,
1393
+ delegateTjpAddr,
1394
+ masterSecret: parentSecret,
1395
+ metaspace: mockMetaspace,
1396
+ space: mockSpace as any,
1397
+ });
1398
+
1399
+ iReckon(sir, finalParent).asTo('final evolved parent exists').isGonnaBeTruthy();
1400
+ const info = finalParent.data?.delegates?.[delegateTjpAddr];
1401
+ iReckon(sir, info).asTo('delegate info removed').isGonnaBeUndefined();
1402
+ });
1403
+
1404
+ await ifWeMight(sir, 'throws if parent does not have a manage pool', async () => {
1405
+ // Create a parent WITHOUT a manage pool
1406
+ const salt = (await getUUID()).substring(0, 16);
1407
+ const defaultConfig = createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt });
1408
+ const restrictedParent = await service.genesis({
1409
+ masterSecret: parentSecret,
1410
+ configs: [defaultConfig],
1411
+ metaspace: mockMetaspace,
1412
+ space: mockSpace as any,
1413
+ });
1414
+
1415
+ let errorCaught = false;
1416
+ try {
1417
+ await service.registerDelegate({
1418
+ parentKeystone: restrictedParent,
1419
+ delegateKeystone,
1420
+ masterSecret: parentSecret,
1421
+ metaspace: mockMetaspace,
1422
+ space: mockSpace as any,
1423
+ allowedVerbs: [KEYSTONE_VERB_SYNC],
1424
+ });
1425
+ } catch (e: any) {
1426
+ errorCaught = true;
1427
+ iReckon(sir, e.message).includes('Manage pool is required');
1428
+ }
1429
+ iReckon(sir, errorCaught).asTo('delegation rejected').isGonnaBeTrue();
1430
+ });
1431
+ });
1432
+
1433
+ await respecfully(sir, 'Suite G: Delegate & IB Validation', async () => {
1434
+ const service = new KeystoneService_V1();
1435
+ const parentSecret = "ParentMasterSecret_SuiteG";
1436
+ const delegateSecret = "DelegateMasterSecret_SuiteG";
1437
+
1438
+ let mockSpace: MockIbGibSpace;
1439
+ let mockMetaspace: any;
1440
+
1441
+ let parentKeystone: KeystoneIbGib_V1;
1442
+ let delegateKeystone: KeystoneIbGib_V1;
1443
+
1444
+ firstOfEach(sir, async () => {
1445
+ mockSpace = new MockIbGibSpace();
1446
+ mockMetaspace = new MockMetaspaceService(mockSpace);
1447
+
1448
+ const salt1 = (await getUUID()).substring(0, 16);
1449
+ const salt2 = (await getUUID()).substring(0, 16);
1450
+
1451
+ const manageConfig = createStandardPoolConfig({ id: POOL_ID_MANAGE, salt: salt2 });
1452
+ manageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE];
1453
+
1454
+ const configs = [
1455
+ createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt: salt1 }),
1456
+ manageConfig
1457
+ ];
1458
+
1459
+ parentKeystone = await service.genesis({
1460
+ masterSecret: parentSecret,
1461
+ configs,
1462
+ metaspace: mockMetaspace,
1463
+ space: mockSpace as any,
1464
+ });
1465
+
1466
+ delegateKeystone = await service.genesis({
1467
+ masterSecret: delegateSecret,
1468
+ configs: [createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt: salt1 })],
1469
+ metaspace: mockMetaspace,
1470
+ space: mockSpace as any,
1471
+ });
1472
+ });
1473
+
1474
+ await ifWeMight(sir, 'validateKeystoneIb returns true for valid keystone ib and false for others', async () => {
1475
+ iReckon(sir, await validateKeystoneIb({ ib: 'keystone' })).isGonnaBeTrue();
1476
+ iReckon(sir, await validateKeystoneIb({ ib: 'keystone user info' })).isGonnaBeTrue();
1477
+ iReckon(sir, await validateKeystoneIb({ ib: 'invalidAtom' })).isGonnaBeFalse();
1478
+ iReckon(sir, await validateKeystoneIb({ ib: 'not_keystone sub_atom' })).isGonnaBeFalse();
1479
+ });
1480
+
1481
+ await ifWeMight(sir, 'validateGenesisKeystone fails validation if ib is invalid', async () => {
1482
+ const invalidGenesis = {
1483
+ ...parentKeystone,
1484
+ ib: 'not_a_keystone^' + parentKeystone.gib,
1485
+ };
1486
+ const errors = await validateGenesisKeystone({ keystoneIbGib: invalidGenesis });
1487
+ iReckon(sir, errors.length > 0).isGonnaBeTrue();
1488
+ iReckon(sir, errors[0]).includes('invalid keystone ib');
1489
+ });
1490
+
1491
+ await ifWeMight(sir, 'validateKeystoneTransition passes for valid delegate registration', async () => {
1492
+ const evolvedParent = await service.registerDelegate({
1493
+ parentKeystone,
1494
+ delegateKeystone,
1495
+ masterSecret: parentSecret,
1496
+ metaspace: mockMetaspace,
1497
+ space: mockSpace as any,
1498
+ allowedVerbs: [KEYSTONE_VERB_SYNC],
1499
+ });
1500
+
1501
+ const errors = await validateKeystoneTransition({
1502
+ currentIbGib: evolvedParent,
1503
+ prevIbGib: parentKeystone,
1504
+ });
1505
+ iReckon(sir, errors.length).willEqual(0);
1506
+ });
1507
+
1508
+ await ifWeMight(sir, 'validateKeystoneTransition fails if delegates map is mutated without manage proof', async () => {
1509
+ const evolvedParent = await service.registerDelegate({
1510
+ parentKeystone,
1511
+ delegateKeystone,
1512
+ masterSecret: parentSecret,
1513
+ metaspace: mockMetaspace,
1514
+ space: mockSpace as any,
1515
+ allowedVerbs: [KEYSTONE_VERB_SYNC],
1516
+ });
1517
+
1518
+ const tamperedParent = JSON.parse(JSON.stringify(evolvedParent)) as KeystoneIbGib_V1;
1519
+
1520
+ // Remove the manage verb proof by converting it to sign
1521
+ for (const proof of tamperedParent.data.proofs) {
1522
+ if (proof.claim) {
1523
+ proof.claim.verb = 'sign';
1524
+ }
1525
+ }
1526
+
1527
+ const errors = await validateKeystoneTransition({
1528
+ currentIbGib: tamperedParent,
1529
+ prevIbGib: parentKeystone,
1530
+ });
1531
+ iReckon(sir, errors.length > 0).isGonnaBeTrue();
1532
+ iReckon(sir, errors.some(e => e.includes('Policy Violation: Delegates map was mutated'))).isGonnaBeTrue();
1533
+ });
1534
+
1535
+ await ifWeMight(sir, 'validateKeystoneTransition fails if delegate key does not match delegateTjpAddr', async () => {
1536
+ const evolvedParent = await service.registerDelegate({
1537
+ parentKeystone,
1538
+ delegateKeystone,
1539
+ masterSecret: parentSecret,
1540
+ metaspace: mockMetaspace,
1541
+ space: mockSpace as any,
1542
+ allowedVerbs: [KEYSTONE_VERB_SYNC],
1543
+ });
1544
+
1545
+ const tamperedParent = JSON.parse(JSON.stringify(evolvedParent)) as KeystoneIbGib_V1;
1546
+ const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1547
+ if (!delegateTjpAddr) { throw new Error(`delegateTjpAddr falsy?`); }
1548
+
1549
+ const info = tamperedParent.data.delegates![delegateTjpAddr];
1550
+ delete tamperedParent.data.delegates![delegateTjpAddr];
1551
+ tamperedParent.data.delegates!['mismatched_key'] = info;
1552
+
1553
+ const errors = await validateKeystoneTransition({
1554
+ currentIbGib: tamperedParent,
1555
+ prevIbGib: parentKeystone,
1556
+ });
1557
+ iReckon(sir, errors.length > 0).isGonnaBeTrue();
1558
+ iReckon(sir, errors.some(e => e.includes('does not match delegateTjpAddr'))).isGonnaBeTrue();
1559
+ });
1560
+
1561
+ await ifWeMight(sir, 'validateKeystoneTransition fails if delegate addresses have invalid keystone ib', async () => {
1562
+ const evolvedParent = await service.registerDelegate({
1563
+ parentKeystone,
1564
+ delegateKeystone,
1565
+ masterSecret: parentSecret,
1566
+ metaspace: mockMetaspace,
1567
+ space: mockSpace as any,
1568
+ allowedVerbs: [KEYSTONE_VERB_SYNC],
1569
+ });
1570
+
1571
+ const tamperedParent = JSON.parse(JSON.stringify(evolvedParent)) as KeystoneIbGib_V1;
1572
+ const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1573
+ if (!delegateTjpAddr) { throw new Error(`delegateTjpAddr falsy?`); }
1574
+
1575
+ tamperedParent.data.delegates![delegateTjpAddr].delegateAddr = 'invalid_ib^12345';
1576
+ const errors = await validateKeystoneTransition({
1577
+ currentIbGib: tamperedParent,
1578
+ prevIbGib: parentKeystone,
1579
+ });
1580
+ iReckon(sir, errors.length > 0).isGonnaBeTrue();
1581
+ iReckon(sir, errors.some(e => e.includes('not a valid keystone address'))).isGonnaBeTrue();
1582
+ });
1583
+
1584
+ await ifWeMight(sir, 'validateKeystoneTransition fails if thisAddr is not in the parent timeline history', async () => {
1585
+ const evolvedParent = await service.registerDelegate({
1586
+ parentKeystone,
1587
+ delegateKeystone,
1588
+ masterSecret: parentSecret,
1589
+ metaspace: mockMetaspace,
1590
+ space: mockSpace as any,
1591
+ allowedVerbs: [KEYSTONE_VERB_SYNC],
1592
+ });
1593
+
1594
+ const tamperedParent = JSON.parse(JSON.stringify(evolvedParent)) as KeystoneIbGib_V1;
1595
+ const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1596
+ if (!delegateTjpAddr) { throw new Error(`delegateTjpAddr falsy?`); }
1597
+
1598
+ tamperedParent.data.delegates![delegateTjpAddr].thisAddr = 'keystone^randomgib';
1599
+
1600
+ const errors = await validateKeystoneTransition({
1601
+ currentIbGib: tamperedParent,
1602
+ prevIbGib: parentKeystone,
1603
+ });
1604
+ iReckon(sir, errors.length > 0).isGonnaBeTrue();
1605
+ iReckon(sir, errors.some(e => e.includes('not a valid historical address in the parent keystone timeline'))).isGonnaBeTrue();
1606
+ });
1607
+ });
1608
+
1609
+ // ===========================================================================
1610
+ // SUITE G: COMBINED POOLS & PASSWORD ROTATION
1611
+ // ===========================================================================
1612
+
1613
+ await respecfully(sir, 'Suite G: Combined Pools & Password Rotation', async () => {
1614
+
1615
+ const service = new KeystoneService_V1();
1616
+ const userSecret = "UserMasterSecret_123";
1617
+ const custodianSecret = "CustodianSecret_456";
1618
+
1619
+ let mockSpace: MockIbGibSpace;
1620
+ let mockMetaspace: any;
1621
+
1622
+ firstOfEach(sir, async () => {
1623
+ mockSpace = new MockIbGibSpace();
1624
+ mockMetaspace = new MockMetaspaceService(mockSpace);
1625
+ });
1626
+
1627
+ await ifWeMight(sir, 'revokes a keystone using a separate revocation pool', async () => {
1628
+ const stdSalt = "std_salt";
1629
+ const revokeSalt = "revoke_salt";
1630
+ const stdConfig = createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt: stdSalt });
1631
+ const revokeConfig = createStandardPoolConfig({ id: POOL_ID_REVOKE, salt: revokeSalt });
1632
+ revokeConfig.allowedVerbs = [KEYSTONE_VERB_REVOKE];
1633
+ revokeConfig.behavior.replenish = KeystoneReplenishStrategy.deleteAll;
1634
+
1635
+ const keystone = await service.genesis({
1636
+ masterSecret: userSecret,
1637
+ configs: [stdConfig, revokeConfig],
1638
+ metaspace: mockMetaspace,
1639
+ space: mockSpace as any,
1640
+ });
1641
+
1642
+ const revoked = await service.revoke({
1643
+ latestKeystone: keystone,
1644
+ masterSecret: userSecret,
1645
+ metaspace: mockMetaspace,
1646
+ space: mockSpace as any,
1647
+ });
1648
+
1649
+ iReckon(sir, revoked.data?.revocationInfo).asTo('revocationInfo present').isGonnaBeTruthy();
1650
+ const revokePool = revoked.data?.challengePools.find(p => p.id === POOL_ID_REVOKE)!;
1651
+ iReckon(sir, Object.keys(revokePool.challenges).length).asTo('revoke pool depleted').willEqual(0);
1652
+ });
1653
+
1654
+ await ifWeMight(sir, 'revokes a keystone using a combined manage/revoke pool and empties it', async () => {
1655
+ const salt = "combined_salt";
1656
+ const manageConfig = createStandardPoolConfig({ id: POOL_ID_MANAGE, salt });
1657
+ manageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
1658
+
1659
+ const keystone = await service.genesis({
1660
+ masterSecret: userSecret,
1661
+ configs: [manageConfig],
1662
+ metaspace: mockMetaspace,
1663
+ space: mockSpace as any,
1664
+ });
1665
+
1666
+ const revoked = await service.revoke({
1667
+ latestKeystone: keystone,
1668
+ masterSecret: userSecret,
1669
+ metaspace: mockMetaspace,
1670
+ space: mockSpace as any,
1671
+ });
1672
+
1673
+ iReckon(sir, revoked.data?.revocationInfo).asTo('revocationInfo present').isGonnaBeTruthy();
1674
+ const managePool = revoked.data?.challengePools.find(p => p.id === POOL_ID_MANAGE)!;
1675
+ iReckon(sir, Object.keys(managePool.challenges).length).asTo('combined manage pool depleted').willEqual(0);
1676
+ });
1677
+
1678
+ await ifWeMight(sir, 'rotates user password successfully when signed by the user manage pool', async () => {
1679
+ const salt = "manage_salt";
1680
+ const manageConfig = createStandardPoolConfig({ id: POOL_ID_MANAGE, salt });
1681
+ manageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
1682
+
1683
+ const keystone = await service.genesis({
1684
+ masterSecret: userSecret,
1685
+ configs: [manageConfig],
1686
+ metaspace: mockMetaspace,
1687
+ space: mockSpace as any,
1688
+ });
1689
+
1690
+ const newSecret = "NewUserSecret_999";
1691
+ const rotated = await service.changePassword({
1692
+ latestKeystone: keystone,
1693
+ newMasterSecret: newSecret,
1694
+ signingSecret: userSecret,
1695
+ signingPoolId: POOL_ID_MANAGE,
1696
+ metaspace: mockMetaspace,
1697
+ space: mockSpace as any,
1698
+ });
1699
+
1700
+ iReckon(sir, rotated).isGonnaBeTruthy();
1701
+
1702
+ // 1. Try to sign using the new secret (should succeed)
1703
+ const claim = { verb: KEYSTONE_VERB_MANAGE, target: "test_target" };
1704
+ const signedNew = await service.sign({
1705
+ latestKeystone: rotated,
1706
+ masterSecret: newSecret,
1707
+ claim,
1708
+ poolId: POOL_ID_MANAGE,
1709
+ metaspace: mockMetaspace,
1710
+ space: mockSpace as any,
1711
+ });
1712
+ iReckon(sir, signedNew).isGonnaBeTruthy();
1713
+
1714
+ // 2. Try to sign using the old secret (should fail)
1715
+ let errorCaught = false;
1716
+ try {
1717
+ await service.sign({
1718
+ latestKeystone: rotated,
1719
+ masterSecret: userSecret,
1720
+ claim,
1721
+ poolId: POOL_ID_MANAGE,
1722
+ metaspace: mockMetaspace,
1723
+ space: mockSpace as any,
1724
+ });
1725
+ } catch {
1726
+ errorCaught = true;
1727
+ }
1728
+ iReckon(sir, errorCaught).asTo('old secret signing rejected').isGonnaBeTrue();
1729
+ });
1730
+
1731
+ await ifWeMight(sir, 'recovers user password successfully when signed by the custodian manage pool', async () => {
1732
+ const userSalt = "user_salt";
1733
+ const custodianSalt = "custodian_salt";
1734
+
1735
+ const userManageConfig = createStandardPoolConfig({ id: POOL_ID_MANAGE, salt: userSalt });
1736
+ userManageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
1737
+
1738
+ const custodianManageConfig = createStandardPoolConfig({ id: POOL_ID_CUSTODIAN_MANAGE, salt: custodianSalt });
1739
+ custodianManageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
1740
+
1741
+ // We simulate constructing the custodian pool "offline" by the server
1742
+ const strategy = KeystoneStrategyFactory.create({ config: custodianManageConfig });
1743
+ const poolSecret = await strategy.derivePoolSecret({ masterSecret: custodianSecret });
1744
+ const challenges: { [id: string]: any } = {};
1745
+ for (let i = 0; i < custodianManageConfig.behavior.size; i++) {
1746
+ const raw = await hash({ s: `${custodianManageConfig.salt}${Date.now()}${i}` });
1747
+ const challengeId = raw.substring(0, 16);
1748
+ const solution = await strategy.generateSolution({ poolSecret, poolId: custodianManageConfig.id, challengeId });
1749
+ challenges[challengeId] = await strategy.generateChallenge({ solution });
1750
+ }
1751
+ const custodianPool: KeystoneChallengePool = {
1752
+ id: POOL_ID_CUSTODIAN_MANAGE,
1753
+ config: custodianManageConfig,
1754
+ challenges,
1755
+ isForeign: true
1756
+ };
1757
+
1758
+ const keystone = await service.genesis({
1759
+ masterSecret: userSecret,
1760
+ configs: [userManageConfig],
1761
+ metaspace: mockMetaspace,
1762
+ space: mockSpace as any,
1763
+ });
1764
+
1765
+ // Add the custodian pool to the keystone
1766
+ const keystoneWithCustodian = await service.addPools({
1767
+ latestKeystone: keystone,
1768
+ masterSecret: userSecret,
1769
+ newPools: [custodianPool],
1770
+ metaspace: mockMetaspace,
1771
+ space: mockSpace as any,
1772
+ });
1773
+
1774
+ // The user forgets their secret. Recover using custodianSecret!
1775
+ const recoveredSecret = "RecoveredUserSecret_777";
1776
+ const recoveredKeystone = await service.changePassword({
1777
+ latestKeystone: keystoneWithCustodian,
1778
+ newMasterSecret: recoveredSecret,
1779
+ signingSecret: custodianSecret,
1780
+ signingPoolId: POOL_ID_CUSTODIAN_MANAGE,
1781
+ metaspace: mockMetaspace,
1782
+ space: mockSpace as any,
1783
+ });
1784
+
1785
+ iReckon(sir, recoveredKeystone).isGonnaBeTruthy();
1786
+
1787
+ // Verify we can sign with recovered secret
1788
+ const claim = { verb: KEYSTONE_VERB_MANAGE, target: "test_target" };
1789
+ const signedNew = await service.sign({
1790
+ latestKeystone: recoveredKeystone,
1791
+ masterSecret: recoveredSecret,
1792
+ claim,
1793
+ poolId: POOL_ID_MANAGE,
1794
+ metaspace: mockMetaspace,
1795
+ space: mockSpace as any,
1796
+ });
1797
+ iReckon(sir, signedNew).isGonnaBeTruthy();
1798
+ });
1799
+
1800
+ await ifWeMight(sir, 'rotates custodian manage pool successfully', async () => {
1801
+ const userSalt = "user_salt";
1802
+ const custodianSalt = "custodian_salt";
1803
+
1804
+ const userManageConfig = createStandardPoolConfig({ id: POOL_ID_MANAGE, salt: userSalt });
1805
+ userManageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
1806
+
1807
+ const custodianManageConfig = createStandardPoolConfig({ id: POOL_ID_CUSTODIAN_MANAGE, salt: custodianSalt });
1808
+ custodianManageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
1809
+
1810
+ // Custodian Pool genesis
1811
+ const strategy = KeystoneStrategyFactory.create({ config: custodianManageConfig });
1812
+ const poolSecret = await strategy.derivePoolSecret({ masterSecret: custodianSecret });
1813
+ const challenges: { [id: string]: any } = {};
1814
+ for (let i = 0; i < custodianManageConfig.behavior.size; i++) {
1815
+ const raw = await hash({ s: `${custodianManageConfig.salt}${Date.now()}${i}` });
1816
+ const challengeId = raw.substring(0, 16);
1817
+ const solution = await strategy.generateSolution({ poolSecret, poolId: custodianManageConfig.id, challengeId });
1818
+ challenges[challengeId] = await strategy.generateChallenge({ solution });
1819
+ }
1820
+ const custodianPool: KeystoneChallengePool = {
1821
+ id: POOL_ID_CUSTODIAN_MANAGE,
1822
+ config: custodianManageConfig,
1823
+ challenges,
1824
+ isForeign: true
1825
+ };
1826
+
1827
+ const keystone = await service.genesis({
1828
+ masterSecret: userSecret,
1829
+ configs: [userManageConfig],
1830
+ metaspace: mockMetaspace,
1831
+ space: mockSpace as any,
1832
+ });
1833
+
1834
+ const keystoneWithCustodian = await service.addPools({
1835
+ latestKeystone: keystone,
1836
+ masterSecret: userSecret,
1837
+ newPools: [custodianPool],
1838
+ metaspace: mockMetaspace,
1839
+ space: mockSpace as any,
1840
+ });
1841
+
1842
+ // Rotate custodian credentials to new secret
1843
+ const newCustodianSecret = "NewCustodianSecret_888";
1844
+ const newCustodianConfig = createStandardPoolConfig({ id: POOL_ID_CUSTODIAN_MANAGE, salt: "new_custodian_salt" });
1845
+ newCustodianConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
1846
+
1847
+ const newStrategy = KeystoneStrategyFactory.create({ config: newCustodianConfig });
1848
+ const newPoolSecret = await newStrategy.derivePoolSecret({ masterSecret: newCustodianSecret });
1849
+ const newChallenges: { [id: string]: any } = {};
1850
+ for (let i = 0; i < newCustodianConfig.behavior.size; i++) {
1851
+ const raw = await hash({ s: `${newCustodianConfig.salt}${Date.now()}${i}` });
1852
+ const challengeId = raw.substring(0, 16);
1853
+ const solution = await newStrategy.generateSolution({ poolSecret: newPoolSecret, poolId: newCustodianConfig.id, challengeId });
1854
+ newChallenges[challengeId] = await newStrategy.generateChallenge({ solution });
1855
+ }
1856
+ const newCustodianPool: KeystoneChallengePool = {
1857
+ id: POOL_ID_CUSTODIAN_MANAGE,
1858
+ config: newCustodianConfig,
1859
+ challenges: newChallenges,
1860
+ isForeign: true
1861
+ };
1862
+
1863
+ // Rotate signed by user manage pool
1864
+ const rotated = await service.replacePool({
1865
+ latestKeystone: keystoneWithCustodian,
1866
+ newPool: newCustodianPool,
1867
+ signingSecret: userSecret,
1868
+ signingPoolId: POOL_ID_MANAGE,
1869
+ metaspace: mockMetaspace,
1870
+ space: mockSpace as any,
1871
+ });
1872
+
1873
+ iReckon(sir, rotated).isGonnaBeTruthy();
1874
+
1875
+ // Verify we can sign with new custodian secret
1876
+ const claim = { verb: KEYSTONE_VERB_MANAGE, target: "test_target" };
1877
+ const signedNew = await service.sign({
1878
+ latestKeystone: rotated,
1879
+ masterSecret: newCustodianSecret,
1880
+ claim,
1881
+ poolId: POOL_ID_CUSTODIAN_MANAGE,
399
1882
  metaspace: mockMetaspace,
400
1883
  space: mockSpace as any,
401
1884
  });
1885
+ iReckon(sir, signedNew).isGonnaBeTruthy();
402
1886
  });
403
1887
 
404
- await respecfully(sir, 'Wrong Secret (Forgery)', async () => {
405
- await ifWeMight(sir, 'prevents creation of forged frames', async () => {
406
- const claim: Partial<KeystoneClaim> = { target: "comment 123^gib", verb: "post" };
1888
+ await ifWeMight(sir, 'rotates all non-foreign pools during changePassword by default', async () => {
1889
+ const userSalt = "user_salt";
1890
+ const custodianSalt = "custodian_salt";
1891
+ const secondarySalt = "secondary_salt";
407
1892
 
408
- let errorCaught = false;
409
- let errorMsg = "";
1893
+ const userManageConfig = createStandardPoolConfig({ id: POOL_ID_MANAGE, salt: userSalt });
1894
+ userManageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
410
1895
 
411
- try {
412
- // Eve tries to sign Alice's keystone.
413
- // This MUST fail because sign() calls evolve(), which calls validate().
414
- await service.sign({
415
- latestKeystone: genesisKeystone,
416
- masterSecret: eveSecret,
417
- claim,
418
- poolId: POOL_ID_DEFAULT,
419
- metaspace: mockMetaspace,
420
- space: mockSpace as any,
421
- });
422
- } catch (e: any) {
423
- errorCaught = true;
424
- errorMsg = e.message;
425
- }
1896
+ // Another native/non-foreign pool
1897
+ const secondaryNativeConfig = createStandardPoolConfig({ id: "secondary-native", salt: secondarySalt });
1898
+ secondaryNativeConfig.allowedVerbs = [KEYSTONE_VERB_SYNC];
426
1899
 
427
- iReckon(sir, errorCaught).asTo('service rejected forgery').isGonnaBeTrue();
428
- // Verify it was a crypto error, not something else
429
- iReckon(sir, errorMsg).asTo('error mentions crypto violation').includes('Crypto Violation');
430
- });
431
- });
432
-
433
- await respecfully(sir, 'Policy Violation (Restricted Verbs)', async () => {
434
- await ifWeMight(sir, 'throws error if signing forbidden verb with restricted pool', async () => {
435
- // Create a specific restricted pool config manually
436
- const restrictedPoolId = "read_only_pool";
437
- const restrictedConfig = createStandardPoolConfig({
438
- id: restrictedPoolId,
439
- salt: restrictedPoolId,
440
- });
441
- // Manually restrict it (since Builder defaults to undefined/allow-all)
442
- restrictedConfig.allowedVerbs = ['read'];
443
-
444
- const restrictedGenesis = await service.genesis({
445
- masterSecret: aliceSecret,
446
- configs: [restrictedConfig],
447
- metaspace: mockMetaspace,
448
- space: mockSpace as any,
449
- });
450
-
451
- // Try to sign "write" using "read_only_pool"
452
- const claim: Partial<KeystoneClaim> = { target: "data^gib", verb: "write" };
453
-
454
- let errorCaught = false;
455
- try {
456
- await service.sign({
457
- latestKeystone: restrictedGenesis,
458
- masterSecret: aliceSecret,
459
- claim,
460
- poolId: restrictedPoolId, // Force use of restricted pool
461
- metaspace: mockMetaspace,
462
- space: mockSpace as any,
463
- });
464
- } catch (e) {
465
- errorCaught = true;
466
- // Optional: Check error message contains "not authorized"
467
- }
468
-
469
- iReckon(sir, errorCaught).asTo('policy enforced').isGonnaBeTrue();
470
- });
471
- });
472
- });
473
-
474
- // ===========================================================================
475
- // SUITE D: REVOCATION
476
- // ===========================================================================
477
-
478
- await respecfully(sir, 'Suite D: Revocation', async () => {
479
-
480
- const service = new KeystoneService_V1();
481
- const masterSecret = "AliceSecret_RevokeTest";
482
-
483
- let mockSpace: MockIbGibSpace;
484
- let mockMetaspace: any;
485
- let genesisKeystone: KeystoneIbGib_V1;
486
-
487
- firstOfAll(sir, async () => {
488
- mockSpace = new MockIbGibSpace();
489
- mockMetaspace = new MockMetaspaceService(mockSpace);
490
-
491
- // Setup Identity WITH a Revocation Pool
492
- const stdSalt = (await getUUID()).substring(0, 16);
493
- const revokeSalt = (await getUUID()).substring(0, 16);
494
- const stdConfig = createStandardPoolConfig({
495
- id: POOL_ID_DEFAULT,
496
- salt: stdSalt,
497
- });
498
- const revokeConfig = createRevocationPoolConfig({
499
- id: POOL_ID_REVOKE,
500
- salt: revokeSalt,
501
- }); // Special Config
502
-
503
- genesisKeystone = await service.genesis({
504
- masterSecret,
505
- configs: [stdConfig, revokeConfig],
506
- metaspace: mockMetaspace,
507
- space: mockSpace as any,
508
- });
509
- });
510
-
511
- await respecfully(sir, 'Revoke Lifecycle', async () => {
512
- let revokedKeystone: KeystoneIbGib_V1;
513
-
514
- await ifWeMight(sir, 'successfully creates a revocation frame', async () => {
515
- revokedKeystone = await service.revoke({
516
- latestKeystone: genesisKeystone,
517
- masterSecret,
518
- reason: "Key compromised",
519
- metaspace: mockMetaspace,
520
- space: mockSpace as any,
521
- });
522
-
523
- iReckon(sir, revokedKeystone).isGonnaBeTruthy();
524
-
525
- // Check Data
526
- const data = revokedKeystone.data!;
527
- iReckon(sir, data.revocationInfo).asTo('revocation info present').isGonnaBeTruthy();
528
- iReckon(sir, data.revocationInfo!.reason).willEqual("Key compromised");
529
- iReckon(sir, data.revocationInfo!.proof.claim.verb).willEqual(KEYSTONE_VERB_REVOKE);
530
- });
531
-
532
- await ifWeMight(sir, 'validates the revocation frame', async () => {
533
- const errors = await service.validate({
534
- prevIbGib: genesisKeystone,
535
- currentIbGib: revokedKeystone!,
536
- // metaspace: mockMetaspace,
537
- // space: mockSpace as any,
538
- });
539
-
540
- iReckon(sir, errors.length).asTo('no validation errors').willEqual(0);
541
- });
542
-
543
- await ifWeMight(sir, 'consumed the revocation pool (Scorched Earth)', async () => {
544
- const data = revokedKeystone!.data!;
545
- const revokePool = data.challengePools.find(p => p.id === POOL_ID_REVOKE);
546
-
547
- // The pool should exist...
548
- iReckon(sir, revokePool).isGonnaBeTruthy();
549
-
550
- // Should be empty (0 challenges)
551
- const remaining = Object.keys(revokePool!.challenges);
552
- iReckon(sir, remaining.length).asTo('pool depleted').willEqual(0);
553
- });
554
- });
555
- });
556
-
557
- // ===========================================================================
558
- // SUITE E: STRUCTURAL EVOLUTION (addPools)
559
- // ===========================================================================
560
-
561
- await respecfully(sir, 'Suite E: Structural Evolution (addPools)', async () => {
562
-
563
- const service = new KeystoneService_V1();
564
- const aliceSecret = "Alice_Master_Key";
565
- const bobSecret = "Bob_Foreign_Key";
566
-
567
- let mockSpace: MockIbGibSpace;
568
- let mockMetaspace: any;
569
- let aliceKeystone: KeystoneIbGib_V1;
570
-
571
- // Helper to generate a "Foreign" pool (e.g. from Bob)
572
- const createForeignPool = async (id: string, verbs: string[] = []): Promise<KeystoneChallengePool> => {
573
- const salt = (await getUUID()).substring(0, 16);
574
- const config = createStandardPoolConfig({ id, salt });
575
- config.allowedVerbs = verbs;
576
-
577
- // We use the factory manually here to simulate Bob doing this offline
578
- const strategy = KeystoneStrategyFactory.create({ config });
579
- const poolSecret = await strategy.derivePoolSecret({ masterSecret: bobSecret });
580
- const challenges: { [id: string]: any } = {};
581
-
582
- for (let i = 0; i < 10; i++) {
583
- // Manually replicate ID gen for test
584
- const raw = await hash({ s: `${config.salt}${Date.now()}${i}` });
585
- const challengeId = raw.substring(0, 16);
586
-
587
- const solution = await strategy.generateSolution({
588
- poolSecret, poolId: config.salt, challengeId,
589
- });
590
- const challenge = await strategy.generateChallenge({ solution });
591
- challenges[challengeId] = challenge;
592
- }
593
-
594
- return {
595
- id,
596
- config,
597
- challenges,
598
- isForeign: true,
599
- metadata: { owner: 'Bob' }
600
- };
601
- };
602
-
603
- firstOfAll(sir, async () => {
604
- mockSpace = new MockIbGibSpace();
605
- mockMetaspace = new MockMetaspaceService(mockSpace);
606
-
607
- // Alice Genesis: Standard pool (allows all verbs, including 'manage')
608
- const salt = (await getUUID()).substring(0, 16);
609
- const config = createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt });
610
- aliceKeystone = await service.genesis({
611
- masterSecret: aliceSecret,
612
- configs: [config],
613
- metaspace: mockMetaspace,
614
- space: mockSpace as any,
615
- });
616
- });
617
-
618
- await respecfully(sir, 'Happy Path', async () => {
619
- await ifWeMight(sir, 'authorizes and adds a foreign pool', async () => {
620
- const bobPool = await createForeignPool("pool_bob", ["post"]);
621
-
622
- const updatedKeystone = await service.addPools({
623
- latestKeystone: aliceKeystone,
624
- masterSecret: aliceSecret,
625
- newPools: [bobPool],
626
- metaspace: mockMetaspace,
627
- space: mockSpace as any,
628
- });
629
-
630
- // 1. Verify new state
631
- iReckon(sir, updatedKeystone).isGonnaBeTruthy();
632
- const pools = updatedKeystone.data!.challengePools;
633
- iReckon(sir, pools.length).asTo('pool count increased').willEqual(2);
634
-
635
- const foundBob = pools.find(p => p.id === "pool_bob");
636
- iReckon(sir, foundBob).asTo('bob pool exists').isGonnaBeTruthy();
637
- iReckon(sir, foundBob!.isForeign).asTo('isForeign flag').isGonnaBeTrue();
638
-
639
- // 2. Verify Proof
640
- const proof = updatedKeystone.data!.proofs[0];
641
- iReckon(sir, proof.claim.verb).asTo('proof verb').willEqual("manage");
642
- // Alice signed this using HER pool (default), not Bob's
643
- iReckon(sir, proof.solutions[0].poolId).willEqual(POOL_ID_DEFAULT);
644
-
645
- // 3. Verify Validity
646
- const errors = await service.validate({
647
- prevIbGib: aliceKeystone,
648
- currentIbGib: updatedKeystone,
649
- });
650
- iReckon(sir, errors.length).asTo('validation passed').willEqual(0);
651
-
652
- // Update local ref for next tests
653
- aliceKeystone = updatedKeystone;
654
- });
655
- });
656
-
657
- await respecfully(sir, 'Permissions & Logic', async () => {
658
- await ifWeMight(sir, 'fails if no pool allows "manage" verb', async () => {
659
- // 1. Create a restricted keystone
660
- let id = "read_only";
661
- const restrictedConfig = createStandardPoolConfig({ id, salt: id });
662
- restrictedConfig.allowedVerbs = ['read']; // No 'manage'
663
-
664
- const restrictedKeystone = await service.genesis({
665
- masterSecret: aliceSecret,
666
- configs: [restrictedConfig],
667
- metaspace: mockMetaspace,
668
- space: mockSpace as any,
669
- });
670
-
671
- const newPool = await createForeignPool("pool_test");
672
- let errorCaught = false;
673
-
674
- try {
675
- await service.addPools({
676
- latestKeystone: restrictedKeystone,
677
- masterSecret: aliceSecret,
678
- newPools: [newPool],
679
- metaspace: mockMetaspace,
680
- space: mockSpace as any,
681
- });
682
- } catch (e: any) {
683
- errorCaught = true;
684
- // Should fail in resolveTargetPool or addPools logic
685
- // console.log("Caught expected error:", e.message);
686
- }
687
-
688
- iReckon(sir, errorCaught).asTo('permission denied').isGonnaBeTrue();
689
- });
690
-
691
- await ifWeMight(sir, 'fails on ID collision', async () => {
692
- // Try to add "pool_bob" again (it was added in Happy Path)
693
- const duplicatePool = await createForeignPool("pool_bob");
694
-
695
- let errorCaught = false;
696
- try {
697
- await service.addPools({
698
- latestKeystone: aliceKeystone, // This already has pool_bob
699
- masterSecret: aliceSecret,
700
- newPools: [duplicatePool],
701
- metaspace: mockMetaspace,
702
- space: mockSpace as any,
703
- });
704
- } catch (e: any) {
705
- errorCaught = true;
706
- iReckon(sir, e.message).includes("ID collision");
707
- }
1900
+ // A custodian/foreign pool
1901
+ const custodianManageConfig = createStandardPoolConfig({ id: POOL_ID_CUSTODIAN_MANAGE, salt: custodianSalt });
1902
+ custodianManageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
708
1903
 
709
- iReckon(sir, errorCaught).asTo('collision detected').isGonnaBeTrue();
710
- });
711
- });
712
- });
713
-
714
- // ===========================================================================
715
- // SUITE E: STRUCTURAL EVOLUTION (addPools)
716
- // ===========================================================================
717
-
718
- await respecfully(sir, 'Suite E: Structural Evolution (addPools)', async () => {
719
-
720
- const service = new KeystoneService_V1();
721
- const aliceSecret = "Alice_Master_Key";
722
- const bobSecret = "Bob_Foreign_Key";
723
-
724
- let mockSpace: MockIbGibSpace;
725
- let mockMetaspace: any;
726
- let aliceKeystone: KeystoneIbGib_V1;
727
-
728
- // Helper to simulate Bob creating a pool "offline" to give to Alice
729
- const createForeignPool = async (id: string, verbs: string[] = []): Promise<KeystoneChallengePool> => {
730
- const salt = (await getUUID()).substring(0, 16);
731
- const config = createStandardPoolConfig({ id, salt });
732
- config.allowedVerbs = verbs;
733
-
734
- // We use the factory manually here to simulate Bob doing this on his own machine
735
- const strategy = KeystoneStrategyFactory.create({ config });
736
- const poolSecret = await strategy.derivePoolSecret({ masterSecret: bobSecret });
1904
+ // Custodian Pool genesis
1905
+ const strategy = KeystoneStrategyFactory.create({ config: custodianManageConfig });
1906
+ const poolSecret = await strategy.derivePoolSecret({ masterSecret: custodianSecret });
737
1907
  const challenges: { [id: string]: any } = {};
738
-
739
- // Generate a small set of challenges
740
- for (let i = 0; i < 10; i++) {
741
- const raw = await hash({ s: `${config.salt}${Date.now()}${i}` });
1908
+ for (let i = 0; i < custodianManageConfig.behavior.size; i++) {
1909
+ const raw = await hash({ s: `${custodianManageConfig.salt}${Date.now()}${i}` });
742
1910
  const challengeId = raw.substring(0, 16);
743
-
744
- const solution = await strategy.generateSolution({
745
- poolSecret, poolId: config.salt, challengeId,
746
- });
747
- const challenge = await strategy.generateChallenge({ solution });
748
- challenges[challengeId] = challenge;
1911
+ const solution = await strategy.generateSolution({ poolSecret, poolId: custodianManageConfig.id, challengeId });
1912
+ challenges[challengeId] = await strategy.generateChallenge({ solution });
749
1913
  }
750
-
751
- return {
752
- id,
753
- config,
1914
+ const custodianPool: KeystoneChallengePool = {
1915
+ id: POOL_ID_CUSTODIAN_MANAGE,
1916
+ config: custodianManageConfig,
754
1917
  challenges,
755
- isForeign: true,
756
- metadata: { owner: 'Bob', role: 'Delegate' }
1918
+ isForeign: true
757
1919
  };
758
- };
759
-
760
- firstOfAll(sir, async () => {
761
- mockSpace = new MockIbGibSpace();
762
- mockMetaspace = new MockMetaspaceService(mockSpace);
763
-
764
- // Alice Genesis: Standard pool (allows all verbs, including 'manage')
765
- const salt = (await getUUID()).substring(0, 16);
766
- const config = createStandardPoolConfig({
767
- id: POOL_ID_DEFAULT,
768
- salt,
769
- });
770
- aliceKeystone = await service.genesis({
771
- masterSecret: aliceSecret,
772
- configs: [config],
773
- metaspace: mockMetaspace,
774
- space: mockSpace as any,
775
- });
776
- });
777
-
778
- await respecfully(sir, 'Happy Path', async () => {
779
- await ifWeMight(sir, 'authorizes and adds a foreign pool', async () => {
780
- const bobPool = await createForeignPool("pool_bob", ["post"]);
781
-
782
- const updatedKeystone = await service.addPools({
783
- latestKeystone: aliceKeystone,
784
- masterSecret: aliceSecret,
785
- newPools: [bobPool],
786
- metaspace: mockMetaspace,
787
- space: mockSpace as any,
788
- });
789
-
790
- // 1. Verify new state
791
- iReckon(sir, updatedKeystone).isGonnaBeTruthy();
792
- const pools = updatedKeystone.data!.challengePools;
793
- iReckon(sir, pools.length).asTo('pool count increased').willEqual(2);
794
-
795
- const foundBob = pools.find(p => p.id === "pool_bob");
796
- iReckon(sir, foundBob).asTo('bob pool exists').isGonnaBeTruthy();
797
- iReckon(sir, foundBob!.isForeign).asTo('isForeign flag').isGonnaBeTrue();
798
-
799
- // 2. Verify Proof
800
- const proof = updatedKeystone.data!.proofs[0];
801
- iReckon(sir, proof.claim.verb).asTo('proof verb').willEqual(KEYSTONE_VERB_MANAGE);
802
- // Alice signed this using HER pool (default), not Bob's
803
- iReckon(sir, proof.solutions[0].poolId).willEqual(POOL_ID_DEFAULT);
804
1920
 
805
- // 3. Verify Validity
806
- const errors = await service.validate({
807
- prevIbGib: aliceKeystone,
808
- currentIbGib: updatedKeystone,
809
- });
810
- iReckon(sir, errors.length).asTo('validation passed').willEqual(0);
811
-
812
- // Update local ref for next tests
813
- aliceKeystone = updatedKeystone;
814
- });
815
- });
816
-
817
- await respecfully(sir, 'Permissions & Logic', async () => {
818
- await ifWeMight(sir, 'fails if no pool allows "manage" verb', async () => {
819
- // 1. Create a restricted keystone (read-only)
820
- let id = "read_only";
821
- const restrictedConfig = createStandardPoolConfig({ id, salt: id });
822
- restrictedConfig.allowedVerbs = ['read']; // No 'manage'
823
-
824
- const restrictedKeystone = await service.genesis({
825
- masterSecret: aliceSecret,
826
- configs: [restrictedConfig],
827
- metaspace: mockMetaspace,
828
- space: mockSpace as any,
829
- });
830
-
831
- const newPool = await createForeignPool("pool_test");
832
- let errorCaught = false;
833
-
834
- try {
835
- await service.addPools({
836
- latestKeystone: restrictedKeystone,
837
- masterSecret: aliceSecret,
838
- newPools: [newPool],
839
- metaspace: mockMetaspace,
840
- space: mockSpace as any,
841
- });
842
- } catch (e: any) {
843
- errorCaught = true;
844
- // Optional: Check error message
845
- // iReckon(sir, e.message).includes("No local pool found with 'manage'");
846
- }
847
-
848
- iReckon(sir, errorCaught).asTo('permission denied').isGonnaBeTrue();
849
- });
850
-
851
- await ifWeMight(sir, 'fails on ID collision', async () => {
852
- // Try to add "pool_bob" again (it was added in Happy Path)
853
- const duplicatePool = await createForeignPool("pool_bob");
854
-
855
- let errorCaught = false;
856
- try {
857
- await service.addPools({
858
- latestKeystone: aliceKeystone, // This already has pool_bob
859
- masterSecret: aliceSecret,
860
- newPools: [duplicatePool],
861
- metaspace: mockMetaspace,
862
- space: mockSpace as any,
863
- });
864
- } catch (e: any) {
865
- errorCaught = true;
866
- iReckon(sir, e.message).includes("collision");
867
- }
868
-
869
- iReckon(sir, errorCaught).asTo('collision detected').isGonnaBeTrue();
870
- });
871
- });
872
- });
873
-
874
- // ===========================================================================
875
- // SUITE F: DEEP INSPECTION (Granularity & Serialization)
876
- // ===========================================================================
877
-
878
- await respecfully(sir, 'Suite F: Deep Inspection', async () => {
879
-
880
- const service = new KeystoneService_V1();
881
- const aliceSecret = "Alice_Deep_Inspect";
882
- const poolId = "granularity_pool";
883
-
884
- let mockSpace: MockIbGibSpace;
885
- let mockMetaspace: any;
886
- let genesisKeystone: KeystoneIbGib_V1;
887
- let signedKeystone: KeystoneIbGib_V1;
888
- let hybridConfig: KeystonePoolConfig_HashV1;
889
-
890
- firstOfAll(sir, async () => {
891
- mockSpace = new MockIbGibSpace();
892
- mockMetaspace = new MockMetaspaceService(mockSpace);
893
-
894
- const salt = (await getUUID()).substring(0, 16);
895
- hybridConfig = createStandardPoolConfig({
896
- id: poolId,
897
- salt,
898
- // 2 FIFO + 2 Random = 4 Total per sign
899
- sequential: 2, random: 2, targetBinding: 0,
900
- size: 20, // Small enough to track, large enough to be random
901
- }) as KeystonePoolConfig_HashV1;
902
-
903
- genesisKeystone = await service.genesis({
904
- masterSecret: aliceSecret,
905
- configs: [hybridConfig],
1921
+ const keystone = await service.genesis({
1922
+ masterSecret: userSecret,
1923
+ configs: [userManageConfig, secondaryNativeConfig],
906
1924
  metaspace: mockMetaspace,
907
1925
  space: mockSpace as any,
908
1926
  });
909
- });
910
-
911
- await respecfully(sir, 'Proof Granularity & Math', async () => {
912
-
913
- await ifWeMight(sir, 'generates exactly the expected number of solutions', async () => {
914
- signedKeystone = await service.sign({
915
- latestKeystone: genesisKeystone,
916
- masterSecret: aliceSecret,
917
- claim: { verb: "post", target: "data^gib" },
918
- metaspace: mockMetaspace,
919
- space: mockSpace as any,
920
- });
921
-
922
- const proofs = signedKeystone.data!.proofs;
923
- iReckon(sir, proofs.length).asTo('proof count').willEqual(1);
924
-
925
- const solutions = proofs[0].solutions;
926
- // 2 Sequential + 2 Random = 4
927
- iReckon(sir, solutions.length).asTo('solution count').willEqual(4);
928
- });
929
-
930
- await ifWeMight(sir, 'verifies the math manually (White-box Crypto Check)', async () => {
931
- const proof = signedKeystone.data!.proofs[0];
932
- const poolSnapshot = genesisKeystone.data!.challengePools.find(p => p.id === poolId)!;
933
-
934
- // We iterate every solution in the proof and MANUALLY verify the hash relationship
935
- // bypassing the Service's validation logic to ensure the raw math holds up.
936
-
937
- for (const solution of proof.solutions) {
938
- // 1. Find the challenge in the *Previous* frame (Genesis)
939
- const challenge = poolSnapshot.challenges[solution.challengeId];
940
-
941
- if (!challenge) {
942
- throw new Error(`Test Failure: Solution references ID ${solution.challengeId} which was not in Genesis pool.`);
943
- }
944
-
945
- // 2. Re-implement HashReveal V1 verification logic locally in the test
946
- // Hash(Salt + Value + Salt)
947
- // Note: rounds=1 in standard config
948
- const indexSalt = solution.challengeId;
949
- const calculatedHash = await hash({
950
- s: `${indexSalt}${solution.value}${indexSalt}`,
951
- algorithm: 'SHA-256'
952
- });
953
-
954
- // 3. Assert
955
- iReckon(sir, calculatedHash).asTo(`Manual hash verification for ${solution.challengeId}`).willEqual(challenge.hash);
956
- }
957
- });
958
-
959
- await ifWeMight(sir, 'verifies FIFO logic (Deterministic Selection)', async () => {
960
- const proof = signedKeystone.data!.proofs[0];
961
- const poolSnapshot = genesisKeystone.data!.challengePools.find(p => p.id === poolId)!;
962
-
963
- // The first N keys in the pool should be the FIFO targets.
964
- // Assumption: Object.keys returns insertion order (Standard in modern JS engines)
965
- const allIds = Object.keys(poolSnapshot.challenges);
966
- const expectedFifoIds = allIds.slice(0, 2);
967
-
968
- const solvedIds = proof.solutions.map(s => s.challengeId);
969
-
970
- // Check that our solution list *includes* the expected FIFO IDs
971
- const hasFirst = solvedIds.includes(expectedFifoIds[0]);
972
- const hasSecond = solvedIds.includes(expectedFifoIds[1]);
973
-
974
- iReckon(sir, hasFirst).asTo(`Solution includes 1st FIFO ID (${expectedFifoIds[0]})`).isGonnaBeTrue();
975
- iReckon(sir, hasSecond).asTo(`Solution includes 2nd FIFO ID (${expectedFifoIds[1]})`).isGonnaBeTrue();
976
- });
977
-
978
- await ifWeMight(sir, 'verifies Next-Gen Hash-Based Target Binding Selection', async () => {
979
- const bindingConfig = createStandardPoolConfig({
980
- id: "binding_pool",
981
- salt: "binding_salt",
982
- sequential: 0,
983
- random: 0,
984
- targetBinding: 3,
985
- size: 20
986
- }) as KeystonePoolConfig_HashV1;
987
-
988
- const tempGenesis = await service.genesis({
989
- masterSecret: aliceSecret,
990
- configs: [bindingConfig],
991
- metaspace: mockMetaspace,
992
- space: mockSpace as any,
993
- });
994
-
995
- // Evolve using the binding pool
996
- const evolved = await service.sign({
997
- latestKeystone: tempGenesis,
998
- masterSecret: aliceSecret,
999
- poolId: "binding_pool",
1000
- claim: {
1001
- verb: "sign",
1002
- target: "some_target_address^gib"
1003
- },
1004
- metaspace: mockMetaspace,
1005
- space: mockSpace as any,
1006
- });
1007
-
1008
- const proof = evolved.data!.proofs[0];
1009
- iReckon(sir, proof.solutions.length).asTo('proof solutions count').willEqual(3);
1010
-
1011
- // Now, let's verify that the selection is perfectly deterministic.
1012
- // If we run selectChallengeIds manually with the same pool and target, it must return the same IDs.
1013
- const poolSnapshot = tempGenesis.data!.challengePools.find(p => p.id === "binding_pool")!;
1014
- const selectedIds = await selectChallengeIds({
1015
- pool: poolSnapshot,
1016
- targetAddr: "some_target_address^gib"
1017
- });
1018
-
1019
- const proofIds = proof.solutions.map(s => s.challengeId);
1020
- iReckon(sir, selectedIds.length).asTo('selected IDs count').willEqual(3);
1021
- for (const id of selectedIds) {
1022
- iReckon(sir, proofIds.includes(id)).asTo(`proof includes selected ID ${id}`).isGonnaBeTrue();
1023
- }
1024
- });
1025
-
1026
- await ifWeMight(sir, 'fails validation if total requested challenges >= size', async () => {
1027
- const invalidConfig = createStandardPoolConfig({
1028
- id: "invalid_pool",
1029
- salt: "invalid_salt",
1030
- sequential: 5,
1031
- random: 5,
1032
- targetBinding: 6,
1033
- size: 15 // total requested is 5+5+6 = 16 >= 15
1034
- });
1035
-
1036
- const errors = await validateChallengePool({ pool: { id: "invalid_pool", config: invalidConfig, challenges: {} } });
1037
- iReckon(sir, errors.length > 0).asTo('errors length is positive').isGonnaBeTrue();
1038
- const hasCorrectError = errors.some(e => e.includes("Total requested challenges"));
1039
- iReckon(sir, hasCorrectError).asTo('validation error content').isGonnaBeTrue();
1040
- });
1041
- });
1042
-
1043
- await respecfully(sir, 'DTO & Serialization', async () => {
1044
-
1045
- await ifWeMight(sir, 'survives a clone/JSON-cycle without corruption', async () => {
1046
- // 1. Create a DTO (simulate network transmission/storage)
1047
- // 'clone' does a JSON stringify/parse under the hood (usually) or structured clone.
1048
- const dto = clone(signedKeystone);
1049
-
1050
- // 2. Structural checks
1051
- iReckon(sir, dto).asTo('dto exists').isGonnaBeTruthy();
1052
- iReckon(sir, dto.data).asTo('dto data').isGonnaBeTruthy();
1053
- iReckon(sir, dto.data!.proofs).asTo('dto proofs').isGonnaBeTruthy();
1054
-
1055
- // 3. Functional check: Can the service validate this DTO?
1056
- // This ensures no prototypes or hidden properties were lost that the service depends on.
1057
- const errors = await service.validate({
1058
- prevIbGib: genesisKeystone,
1059
- currentIbGib: dto, // Passing the DTO, not the original object
1060
- });
1061
-
1062
- iReckon(sir, errors.length).asTo('DTO validation errors').willEqual(0);
1063
- });
1064
-
1065
- await ifWeMight(sir, 'ensures data contains no functions or circular refs', async () => {
1066
- // A crude but effective test: ensure JSON.stringify doesn't throw
1067
- // and the result is equal to the object (if we parsed it back).
1068
-
1069
- const jsonStr = JSON.stringify(signedKeystone);
1070
- const parsed = JSON.parse(jsonStr);
1071
-
1072
- // Compare specific deep fields
1073
- const originalSolution = signedKeystone.data!.proofs[0].solutions[0].value;
1074
- const parsedSolution = parsed.data.proofs[0].solutions[0].value;
1075
-
1076
- iReckon(sir, parsedSolution).asTo('deep property survives stringify').willEqual(originalSolution);
1077
-
1078
- // Ensure no extra properties were lost
1079
- // FIX: JSON.stringify removes keys with 'undefined' values.
1080
- // We must filter the original keys to match this behavior for a fair comparison.
1081
- const origKeys = Object.keys(signedKeystone.data!)
1082
- .filter(k => (signedKeystone.data as any)[k] !== undefined);
1083
-
1084
- const parsedKeys = Object.keys(parsed.data);
1085
- iReckon(sir, parsedKeys.length).asTo('key count matches').willEqual(origKeys.length);
1086
- });
1087
-
1088
- });
1089
-
1090
- await respecfully(sir, 'KeystoneProfileBuilder and Modular Schemas', async () => {
1091
-
1092
- await ifWeMight(sir, 'compiles configs successfully with medium profile', async () => {
1093
- const builder = KeystoneProfileBuilder.buildKeystone('medium')
1094
- .withUsername('alice')
1095
- .withEmail('alice@example.com')
1096
- .withDescription('Alice test keystone')
1097
- .withDetails({ extraInfo: 'abc' });
1098
-
1099
- const configs = await builder.compileConfigs();
1100
- iReckon(sir, configs.length).asTo('number of pools').willEqual(5);
1101
-
1102
- // Verify unique salt derivation per pool
1103
- const salts = configs.map(c => c.salt);
1104
- const uniqueSalts = new Set(salts);
1105
- iReckon(sir, uniqueSalts.size).asTo('unique salts count').willEqual(5);
1106
-
1107
- // Verify frameDetails unification
1108
- const details = builder.getFrameDetails();
1109
- iReckon(sir, details.username).asTo('username').willEqual('alice');
1110
- iReckon(sir, details.email).asTo('email').willEqual('alice@example.com');
1111
- iReckon(sir, details.description).asTo('description').willEqual('Alice test keystone');
1112
- iReckon(sir, details.extraInfo).asTo('extraInfo').willEqual('abc');
1113
- });
1114
-
1115
- await ifWeMight(sir, 'supports customized overrides', async () => {
1116
- const builder = KeystoneProfileBuilder.buildKeystone('test')
1117
- .customizePool('sync', {
1118
- behavior: {
1119
- size: 15,
1120
- targetBindingCount: 4
1121
- }
1122
- });
1123
-
1124
- const configs = await builder.compileConfigs();
1125
- const syncPool = configs.find(c => c.id === 'sync')!;
1126
- iReckon(sir, syncPool.behavior.size).asTo('customized size').willEqual(15);
1127
- iReckon(sir, syncPool.behavior.targetBindingCount).asTo('customized target binding').willEqual(4);
1128
- });
1129
-
1130
- });
1131
-
1132
- await respecfully(sir, 'Keystone Metadata Validation', async () => {
1133
-
1134
- await ifWeMight(sir, 'validates correct username and description', async () => {
1135
- const service = new KeystoneService_V1();
1136
- const space = new MockIbGibSpace();
1137
- const metaspace = new MockMetaspaceService(space);
1138
-
1139
- const builder = KeystoneProfileBuilder.buildKeystone('test')
1140
- .withUsername('alice_123.test')
1141
- .withDescription('Valid description: yes, it is!')
1142
- .withDetails({ client: 'respec' });
1143
-
1144
- const configs = await builder.compileConfigs();
1145
- const frameDetails = builder.getFrameDetails();
1146
-
1147
- // Should succeed without error
1148
- const keystoneIbGib = await service.genesis({
1149
- masterSecret: 'mysecret',
1150
- configs,
1151
- metaspace: metaspace as any,
1152
- space: space as any,
1153
- frameDetails
1154
- });
1155
-
1156
- const errors = await service.validateGenesisKeystone({ keystoneIbGib });
1157
- iReckon(sir, errors.length).asTo('errors count').willEqual(0);
1158
- });
1159
-
1160
- await ifWeMight(sir, 'fails validation for invalid username length or character', async () => {
1161
- const service = new KeystoneService_V1();
1162
- const space = new MockIbGibSpace();
1163
- const metaspace = new MockMetaspaceService(space);
1164
-
1165
- const builder = KeystoneProfileBuilder.buildKeystone('test')
1166
- .withUsername('invalid_user_name_that_is_way_too_long_for_the_sixty_three_char_limit_and_will_fail_regex_check')
1167
- .withDetails({ client: 'respec' });
1168
-
1169
- const configs = await builder.compileConfigs();
1170
- const frameDetails = builder.getFrameDetails();
1171
-
1172
- const keystoneIbGib = await service.genesis({
1173
- masterSecret: 'mysecret',
1174
- configs,
1175
- metaspace: metaspace as any,
1176
- space: space as any,
1177
- frameDetails
1178
- });
1179
-
1180
- const errors = await service.validateGenesisKeystone({ keystoneIbGib });
1181
- iReckon(sir, errors.length).asTo('errors count').willEqual(1);
1182
- iReckon(sir, errors[0]).includes('invalid username');
1183
- });
1184
-
1185
- await ifWeMight(sir, 'fails validation for invalid description characters', async () => {
1186
- const service = new KeystoneService_V1();
1187
- const space = new MockIbGibSpace();
1188
- const metaspace = new MockMetaspaceService(space);
1189
-
1190
- const builder = KeystoneProfileBuilder.buildKeystone('test')
1191
- .withUsername('alice')
1192
- .withDescription('Invalid desc with weird emoji 🚀')
1193
- .withDetails({ client: 'respec' });
1194
-
1195
- const configs = await builder.compileConfigs();
1196
- const frameDetails = builder.getFrameDetails();
1197
-
1198
- const keystoneIbGib = await service.genesis({
1199
- masterSecret: 'mysecret',
1200
- configs,
1201
- metaspace: metaspace as any,
1202
- space: space as any,
1203
- frameDetails
1204
- });
1205
-
1206
- const errors = await service.validateGenesisKeystone({ keystoneIbGib });
1207
- iReckon(sir, errors.length).asTo('errors count').willEqual(1);
1208
- iReckon(sir, errors[0]).includes('invalid description');
1209
- });
1210
1927
 
1211
- });
1212
- });
1213
-
1214
-
1215
- // ===========================================================================
1216
- // SUITE E: DELEGATION (Register/Unregister)
1217
- // ===========================================================================
1218
-
1219
- await respecfully(sir, 'Suite E: Delegation (Register/Unregister)', async () => {
1220
-
1221
- const service = new KeystoneService_V1();
1222
- const parentSecret = "ParentMasterSecret_123";
1223
- const delegateSecret = "DelegateMasterSecret_456";
1224
-
1225
- let mockSpace: MockIbGibSpace;
1226
- let mockMetaspace: any;
1227
-
1228
- let parentKeystone: KeystoneIbGib_V1;
1229
- let delegateKeystone: KeystoneIbGib_V1;
1230
-
1231
- firstOfEach(sir, async () => {
1232
- mockSpace = new MockIbGibSpace();
1233
- mockMetaspace = new MockMetaspaceService(mockSpace);
1234
-
1235
- const salt = (await getUUID()).substring(0, 16);
1236
- const defaultConfig = createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt });
1237
- const manageConfig = createStandardPoolConfig({ id: POOL_ID_MANAGE, salt: salt + "_manage" });
1238
- manageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE];
1239
-
1240
- // 1. Create Parent Keystone (with manage pool)
1241
- parentKeystone = await service.genesis({
1242
- masterSecret: parentSecret,
1243
- configs: [defaultConfig, manageConfig],
1244
- metaspace: mockMetaspace,
1245
- space: mockSpace as any,
1246
- });
1247
-
1248
- // 2. Create Delegate Keystone
1249
- const delegateConfig = createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt: salt + "_delegate" });
1250
- delegateKeystone = await service.genesis({
1251
- masterSecret: delegateSecret,
1252
- configs: [delegateConfig],
1928
+ const keystoneWithCustodian = await service.addPools({
1929
+ latestKeystone: keystone,
1930
+ masterSecret: userSecret,
1931
+ newPools: [custodianPool],
1253
1932
  metaspace: mockMetaspace,
1254
1933
  space: mockSpace as any,
1255
1934
  });
1256
- });
1257
1935
 
1258
- await ifWeMight(sir, 'registers a delegate keystone and evolves parent using manage pool', async () => {
1259
- // Register the delegate
1260
- const evolvedParent = await service.registerDelegate({
1261
- parentKeystone,
1262
- delegateKeystone,
1263
- masterSecret: parentSecret,
1936
+ // Rotate passphrase/password
1937
+ const newPassphrase = "SuperNewSecretPassphrase_999";
1938
+ const rotated = await service.changePassword({
1939
+ latestKeystone: keystoneWithCustodian,
1940
+ newMasterSecret: newPassphrase,
1941
+ signingSecret: userSecret,
1942
+ signingPoolId: POOL_ID_MANAGE,
1264
1943
  metaspace: mockMetaspace,
1265
1944
  space: mockSpace as any,
1266
1945
  });
1267
1946
 
1268
- iReckon(sir, evolvedParent).asTo('evolved parent exists').isGonnaBeTruthy();
1269
- iReckon(sir, evolvedParent.data?.delegates).asTo('delegates map exists').isGonnaBeTruthy();
1270
-
1271
- const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1272
- if (!delegateTjpAddr) { throw new Error(`(UNEXPECTED) delegateTjpAddr falsy? (E: 312e986ce4b2ed6c084c03e8f45fa826)`); }
1273
- const delegateInfo = evolvedParent.data?.delegates?.[delegateTjpAddr];
1274
- iReckon(sir, delegateInfo).asTo('delegate info registered').isGonnaBeTruthy();
1275
- iReckon(sir, delegateInfo?.delegateTjpAddr).asTo('delegate tjp matches').willEqual(delegateTjpAddr);
1276
- });
1947
+ iReckon(sir, rotated).isGonnaBeTruthy();
1277
1948
 
1278
- await ifWeMight(sir, 'gets correct delegate status via parent TJP address', async () => {
1279
- const parentTjpAddr = getTjpAddr({ ibGib: parentKeystone });
1280
- if (!parentTjpAddr) { throw new Error(`(UNEXPECTED) parentTjpAddr falsy? (E: b7ce2835ccd951d8c99257328be3b826)`); }
1281
- const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1282
- if (!delegateTjpAddr) { throw new Error(`(UNEXPECTED) delegateTjpAddr falsy? (E: 3e4878ea19dd8034e827466a8bf09526)`); }
1949
+ const data = rotated.data!;
1950
+ const rotatedManage = data.challengePools.find(p => p.id === POOL_ID_MANAGE)!;
1951
+ const rotatedSecondary = data.challengePools.find(p => p.id === "secondary-native")!;
1952
+ const rotatedCustodian = data.challengePools.find(p => p.id === POOL_ID_CUSTODIAN_MANAGE)!;
1283
1953
 
1284
- // Before registration
1285
- const statusBefore = await service.getDelegateStatus({
1286
- parentTjpAddr: parentTjpAddr,
1287
- delegateTjpAddr: delegateTjpAddr,
1288
- metaspace: mockMetaspace,
1289
- space: mockSpace as any,
1290
- });
1291
- iReckon(sir, statusBefore.registered).asTo('initially unregistered').isGonnaBeFalse();
1954
+ // Verify native pools rotated (salt changed)
1955
+ iReckon(sir, rotatedManage.config.salt).not.willEqual(userSalt);
1956
+ iReckon(sir, rotatedSecondary.config.salt).not.willEqual(secondarySalt);
1292
1957
 
1293
- // Register
1294
- const evolvedParent = await service.registerDelegate({
1295
- parentKeystone,
1296
- delegateKeystone,
1297
- masterSecret: parentSecret,
1298
- metaspace: mockMetaspace,
1299
- space: mockSpace as any,
1300
- });
1958
+ // Verify foreign pool was not modified (salt identical)
1959
+ iReckon(sir, rotatedCustodian.config.salt).willEqual(custodianSalt);
1301
1960
 
1302
- // After registration
1303
- const statusAfter = await service.getDelegateStatus({
1304
- parentTjpAddr: parentTjpAddr,
1305
- delegateTjpAddr: delegateTjpAddr,
1306
- metaspace: mockMetaspace,
1307
- space: mockSpace as any,
1961
+ // Verify we can validate transition
1962
+ const errors = await service.validate({
1963
+ prevIbGib: keystoneWithCustodian,
1964
+ currentIbGib: rotated
1308
1965
  });
1309
- iReckon(sir, statusAfter.registered).asTo('registered status').isGonnaBeTrue();
1310
- iReckon(sir, statusAfter.delegateInfo?.delegateTjpAddr).asTo('status tjp matches').willEqual(delegateTjpAddr);
1966
+ iReckon(sir, errors.length).willEqual(0);
1311
1967
  });
1312
1968
 
1313
- await ifWeMight(sir, 'unregisters a registered delegate keystone', async () => {
1314
- // Register first
1315
- const evolvedParent = await service.registerDelegate({
1316
- parentKeystone,
1317
- delegateKeystone,
1318
- masterSecret: parentSecret,
1319
- metaspace: mockMetaspace,
1320
- space: mockSpace as any,
1321
- });
1322
-
1323
- const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1324
- if (!delegateTjpAddr) { throw new Error(`(UNEXPECTED) delegateTjpAddr falsy? (E: 486b486a8c984a52b8d2b22418c20d26)`); }
1325
-
1326
- // Unregister
1327
- const finalParent = await service.unregisterDelegate({
1328
- parentKeystone: evolvedParent,
1329
- delegateTjpAddr,
1330
- masterSecret: parentSecret,
1331
- metaspace: mockMetaspace,
1332
- space: mockSpace as any,
1333
- });
1334
-
1335
- iReckon(sir, finalParent).asTo('final evolved parent exists').isGonnaBeTruthy();
1336
- const info = finalParent.data?.delegates?.[delegateTjpAddr];
1337
- iReckon(sir, info).asTo('delegate info removed').isGonnaBeUndefined();
1338
- });
1969
+ await ifWeMight(sir, 'fails validation if password rotation details or constraints are violated', async () => {
1970
+ // Construct invalid change-password transition
1971
+ const userManageConfig = createStandardPoolConfig({ id: POOL_ID_MANAGE, salt: "salt1" });
1972
+ userManageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
1339
1973
 
1340
- await ifWeMight(sir, 'throws if parent does not have a manage pool', async () => {
1341
- // Create a parent WITHOUT a manage pool
1342
- const salt = (await getUUID()).substring(0, 16);
1343
- const defaultConfig = createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt });
1344
- const restrictedParent = await service.genesis({
1345
- masterSecret: parentSecret,
1346
- configs: [defaultConfig],
1347
- metaspace: mockMetaspace,
1348
- space: mockSpace as any,
1349
- });
1974
+ const custodianManageConfig = createStandardPoolConfig({ id: POOL_ID_CUSTODIAN_MANAGE, salt: "salt2" });
1975
+ custodianManageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE];
1350
1976
 
1351
- let errorCaught = false;
1352
- try {
1353
- await service.registerDelegate({
1354
- parentKeystone: restrictedParent,
1355
- delegateKeystone,
1356
- masterSecret: parentSecret,
1357
- metaspace: mockMetaspace,
1358
- space: mockSpace as any,
1359
- });
1360
- } catch (e: any) {
1361
- errorCaught = true;
1362
- iReckon(sir, e.message).includes('Manage pool is required');
1977
+ // Custodian Pool genesis
1978
+ const strategy = KeystoneStrategyFactory.create({ config: custodianManageConfig });
1979
+ const poolSecret = await strategy.derivePoolSecret({ masterSecret: custodianSecret });
1980
+ const challenges: { [id: string]: any } = {};
1981
+ for (let i = 0; i < custodianManageConfig.behavior.size; i++) {
1982
+ const raw = await hash({ s: `${custodianManageConfig.salt}${Date.now()}${i}` });
1983
+ const challengeId = raw.substring(0, 16);
1984
+ const solution = await strategy.generateSolution({ poolSecret, poolId: custodianManageConfig.id, challengeId });
1985
+ challenges[challengeId] = await strategy.generateChallenge({ solution });
1363
1986
  }
1364
- iReckon(sir, errorCaught).asTo('delegation rejected').isGonnaBeTrue();
1365
- });
1366
- });
1367
-
1368
- await respecfully(sir, 'Suite G: Delegate & IB Validation', async () => {
1369
- const service = new KeystoneService_V1();
1370
- const parentSecret = "ParentMasterSecret_SuiteG";
1371
- const delegateSecret = "DelegateMasterSecret_SuiteG";
1372
-
1373
- let mockSpace: MockIbGibSpace;
1374
- let mockMetaspace: any;
1375
-
1376
- let parentKeystone: KeystoneIbGib_V1;
1377
- let delegateKeystone: KeystoneIbGib_V1;
1378
-
1379
- firstOfEach(sir, async () => {
1380
- mockSpace = new MockIbGibSpace();
1381
- mockMetaspace = new MockMetaspaceService(mockSpace);
1382
-
1383
- const salt1 = (await getUUID()).substring(0, 16);
1384
- const salt2 = (await getUUID()).substring(0, 16);
1385
-
1386
- const manageConfig = createStandardPoolConfig({ id: POOL_ID_MANAGE, salt: salt2 });
1387
- manageConfig.allowedVerbs = [KEYSTONE_VERB_MANAGE];
1388
-
1389
- const configs = [
1390
- createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt: salt1 }),
1391
- manageConfig
1392
- ];
1393
-
1394
- parentKeystone = await service.genesis({
1395
- masterSecret: parentSecret,
1396
- configs,
1397
- metaspace: mockMetaspace,
1398
- space: mockSpace as any,
1399
- });
1400
-
1401
- delegateKeystone = await service.genesis({
1402
- masterSecret: delegateSecret,
1403
- configs: [createStandardPoolConfig({ id: POOL_ID_DEFAULT, salt: salt1 })],
1404
- metaspace: mockMetaspace,
1405
- space: mockSpace as any,
1406
- });
1407
- });
1408
-
1409
- await ifWeMight(sir, 'validateKeystoneIb returns true for valid keystone ib and false for others', async () => {
1410
- iReckon(sir, await validateKeystoneIb({ ib: 'keystone' })).isGonnaBeTrue();
1411
- iReckon(sir, await validateKeystoneIb({ ib: 'keystone user info' })).isGonnaBeTrue();
1412
- iReckon(sir, await validateKeystoneIb({ ib: 'invalidAtom' })).isGonnaBeFalse();
1413
- iReckon(sir, await validateKeystoneIb({ ib: 'not_keystone sub_atom' })).isGonnaBeFalse();
1414
- });
1415
-
1416
- await ifWeMight(sir, 'validateGenesisKeystone fails validation if ib is invalid', async () => {
1417
- const invalidGenesis = {
1418
- ...parentKeystone,
1419
- ib: 'not_a_keystone^' + parentKeystone.gib,
1987
+ const custodianPool: KeystoneChallengePool = {
1988
+ id: POOL_ID_CUSTODIAN_MANAGE,
1989
+ config: custodianManageConfig,
1990
+ challenges,
1991
+ isForeign: true
1420
1992
  };
1421
- const errors = await validateGenesisKeystone({ keystoneIbGib: invalidGenesis });
1422
- iReckon(sir, errors.length > 0).isGonnaBeTrue();
1423
- iReckon(sir, errors[0]).includes('invalid keystone ib');
1424
- });
1425
-
1426
- await ifWeMight(sir, 'validateKeystoneTransition passes for valid delegate registration', async () => {
1427
- const evolvedParent = await service.registerDelegate({
1428
- parentKeystone,
1429
- delegateKeystone,
1430
- masterSecret: parentSecret,
1431
- metaspace: mockMetaspace,
1432
- space: mockSpace as any,
1433
- });
1434
-
1435
- const errors = await validateKeystoneTransition({
1436
- currentIbGib: evolvedParent,
1437
- prevIbGib: parentKeystone,
1438
- });
1439
- iReckon(sir, errors.length).willEqual(0);
1440
- });
1441
1993
 
1442
- await ifWeMight(sir, 'validateKeystoneTransition fails if delegates map is mutated without manage proof', async () => {
1443
- const evolvedParent = await service.registerDelegate({
1444
- parentKeystone,
1445
- delegateKeystone,
1446
- masterSecret: parentSecret,
1994
+ const keystone = await service.genesis({
1995
+ masterSecret: userSecret,
1996
+ configs: [userManageConfig],
1447
1997
  metaspace: mockMetaspace,
1448
1998
  space: mockSpace as any,
1449
1999
  });
1450
2000
 
1451
- const tamperedParent = JSON.parse(JSON.stringify(evolvedParent)) as KeystoneIbGib_V1;
1452
-
1453
- // Remove the manage verb proof by converting it to sign
1454
- for (const proof of tamperedParent.data.proofs) {
1455
- if (proof.claim) {
1456
- proof.claim.verb = 'sign';
1457
- }
1458
- }
1459
-
1460
- const errors = await validateKeystoneTransition({
1461
- currentIbGib: tamperedParent,
1462
- prevIbGib: parentKeystone,
1463
- });
1464
- iReckon(sir, errors.length > 0).isGonnaBeTrue();
1465
- iReckon(sir, errors.some(e => e.includes('Policy Violation: Delegates map was mutated'))).isGonnaBeTrue();
1466
- });
1467
-
1468
- await ifWeMight(sir, 'validateKeystoneTransition fails if delegate key does not match delegateTjpAddr', async () => {
1469
- const evolvedParent = await service.registerDelegate({
1470
- parentKeystone,
1471
- delegateKeystone,
1472
- masterSecret: parentSecret,
2001
+ const keystoneWithCustodian = await service.addPools({
2002
+ latestKeystone: keystone,
2003
+ masterSecret: userSecret,
2004
+ newPools: [custodianPool],
1473
2005
  metaspace: mockMetaspace,
1474
2006
  space: mockSpace as any,
1475
2007
  });
1476
2008
 
1477
- const tamperedParent = JSON.parse(JSON.stringify(evolvedParent)) as KeystoneIbGib_V1;
1478
- const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1479
- if (!delegateTjpAddr) { throw new Error(`delegateTjpAddr falsy?`); }
1480
-
1481
- const info = tamperedParent.data.delegates![delegateTjpAddr];
1482
- delete tamperedParent.data.delegates![delegateTjpAddr];
1483
- tamperedParent.data.delegates!['mismatched_key'] = info;
1484
-
1485
- const errors = await validateKeystoneTransition({
1486
- currentIbGib: tamperedParent,
1487
- prevIbGib: parentKeystone,
2009
+ // Create an invalid frame manually where a foreign pool is rotated during change-password
2010
+ const badRotatedPool = await rotatePoolChallenges({
2011
+ prevPool: custodianPool,
2012
+ newMasterSecret: "bad_secret"
1488
2013
  });
1489
- iReckon(sir, errors.length > 0).isGonnaBeTrue();
1490
- iReckon(sir, errors.some(e => e.includes('does not match delegateTjpAddr'))).isGonnaBeTrue();
1491
- });
1492
2014
 
1493
- await ifWeMight(sir, 'validateKeystoneTransition fails if delegate addresses have invalid keystone ib', async () => {
1494
- const evolvedParent = await service.registerDelegate({
1495
- parentKeystone,
1496
- delegateKeystone,
1497
- masterSecret: parentSecret,
2015
+ const evolved = await service.changePassword({
2016
+ latestKeystone: keystoneWithCustodian,
2017
+ newMasterSecret: "new_pass",
2018
+ signingSecret: userSecret,
2019
+ signingPoolId: POOL_ID_MANAGE,
1498
2020
  metaspace: mockMetaspace,
1499
2021
  space: mockSpace as any,
1500
2022
  });
1501
2023
 
1502
- const tamperedParent = JSON.parse(JSON.stringify(evolvedParent)) as KeystoneIbGib_V1;
1503
- const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1504
- if (!delegateTjpAddr) { throw new Error(`delegateTjpAddr falsy?`); }
1505
-
1506
- tamperedParent.data.delegates![delegateTjpAddr].delegateAddr = 'invalid_ib^12345';
2024
+ // Inject the foreign pool rotation manually to simulate an attacker
2025
+ const attackerData = {
2026
+ ...evolved.data!,
2027
+ challengePools: evolved.data!.challengePools.map(p => p.id === POOL_ID_CUSTODIAN_MANAGE ? badRotatedPool : p)
2028
+ };
2029
+ // Update details claim to say we rotated custodian-manage
2030
+ attackerData.proofs[0].claim.details = {
2031
+ type: KeystoneClaimType.change_password,
2032
+ info: { change: [POOL_ID_MANAGE, POOL_ID_CUSTODIAN_MANAGE] } as ClaimDetails_ChangePassword
2033
+ };
1507
2034
 
1508
- const errors = await validateKeystoneTransition({
1509
- currentIbGib: tamperedParent,
1510
- prevIbGib: parentKeystone,
1511
- });
1512
- iReckon(sir, errors.length > 0).isGonnaBeTrue();
1513
- iReckon(sir, errors.some(e => e.includes('not a valid keystone address'))).isGonnaBeTrue();
1514
- });
2035
+ const attackerKeystone = {
2036
+ ...evolved,
2037
+ data: attackerData
2038
+ };
1515
2039
 
1516
- await ifWeMight(sir, 'validateKeystoneTransition fails if thisAddr is not in the parent timeline history', async () => {
1517
- const evolvedParent = await service.registerDelegate({
1518
- parentKeystone,
1519
- delegateKeystone,
1520
- masterSecret: parentSecret,
1521
- metaspace: mockMetaspace,
1522
- space: mockSpace as any,
2040
+ const errors = await service.validate({
2041
+ prevIbGib: keystoneWithCustodian,
2042
+ currentIbGib: attackerKeystone
1523
2043
  });
1524
2044
 
1525
- const tamperedParent = JSON.parse(JSON.stringify(evolvedParent)) as KeystoneIbGib_V1;
1526
- const delegateTjpAddr = getTjpAddr({ ibGib: delegateKeystone });
1527
- if (!delegateTjpAddr) { throw new Error(`delegateTjpAddr falsy?`); }
1528
-
1529
- tamperedParent.data.delegates![delegateTjpAddr].thisAddr = 'keystone^randomgib';
1530
-
1531
- const errors = await validateKeystoneTransition({
1532
- currentIbGib: tamperedParent,
1533
- prevIbGib: parentKeystone,
1534
- });
1535
2045
  iReckon(sir, errors.length > 0).isGonnaBeTrue();
1536
- iReckon(sir, errors.some(e => e.includes('not a valid historical address in the parent keystone timeline'))).isGonnaBeTrue();
2046
+ const hasForeignViolation = errors.some(e => e.includes("Security Violation") && e.includes("foreign pool"));
2047
+ iReckon(sir, hasForeignViolation).isGonnaBeTrue();
1537
2048
  });
1538
- });
2049
+ });