@entros/verify 0.1.1 → 0.3.0

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.
@@ -0,0 +1,897 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/agent-permit.ts
21
+ var agent_permit_exports = {};
22
+ __export(agent_permit_exports, {
23
+ AGENT_PERMIT_LIMITS: () => AGENT_PERMIT_LIMITS,
24
+ AGENT_PERMIT_NETWORK: () => AGENT_PERMIT_NETWORK,
25
+ AGENT_PERMIT_NOTICE_LINE: () => AGENT_PERMIT_NOTICE_LINE,
26
+ AGENT_PERMIT_PRESENTATION_LINE: () => AGENT_PERMIT_PRESENTATION_LINE,
27
+ AGENT_PERMIT_VERSION_LINE: () => AGENT_PERMIT_VERSION_LINE,
28
+ AgentPermitValidationError: () => AgentPermitValidationError,
29
+ agentPermitId: () => agentPermitId,
30
+ createAgentPermitRequest: () => createAgentPermitRequest,
31
+ encodeAgentPermitApproval: () => encodeAgentPermitApproval,
32
+ encodeAgentPermitFragment: () => encodeAgentPermitFragment,
33
+ encodeAgentPermitSettlement: () => encodeAgentPermitSettlement,
34
+ evaluateAgentPermit: () => evaluateAgentPermit,
35
+ isAgentPermitAudience: () => isAgentPermitAudience,
36
+ isAgentStateEvidence: () => isAgentStateEvidence,
37
+ normalizeAgentPermitRequest: () => normalizeAgentPermitRequest,
38
+ parseAgentPermitApproval: () => parseAgentPermitApproval,
39
+ parseAgentPermitFragment: () => parseAgentPermitFragment,
40
+ parseAgentPermitMessage: () => parseAgentPermitMessage,
41
+ parseAgentPermitSettlement: () => parseAgentPermitSettlement,
42
+ precheckAgentPermit: () => precheckAgentPermit,
43
+ renderAgentPermitMessage: () => renderAgentPermitMessage,
44
+ renderAgentPermitPresentation: () => renderAgentPermitPresentation,
45
+ verifyAgentPermitSignatures: () => verifyAgentPermitSignatures
46
+ });
47
+ module.exports = __toCommonJS(agent_permit_exports);
48
+ var import_ed25519 = require("@noble/curves/ed25519");
49
+ var import_sha2 = require("@noble/hashes/sha2");
50
+
51
+ // src/base58.ts
52
+ var ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
53
+ function base58Encode(bytes) {
54
+ let number = 0n;
55
+ for (const byte of bytes) number = number << 8n | BigInt(byte);
56
+ let text = "";
57
+ while (number > 0n) {
58
+ text = ALPHABET[Number(number % 58n)] + text;
59
+ number /= 58n;
60
+ }
61
+ let zeros = 0;
62
+ while (zeros < bytes.length && bytes[zeros] === 0) zeros++;
63
+ return "1".repeat(zeros) + text;
64
+ }
65
+ function base58Decode(text) {
66
+ if (text.length === 0) return null;
67
+ let number = 0n;
68
+ for (const character of text) {
69
+ const digit = ALPHABET.indexOf(character);
70
+ if (digit < 0) return null;
71
+ number = number * 58n + BigInt(digit);
72
+ }
73
+ const body = [];
74
+ while (number > 0n) {
75
+ body.unshift(Number(number & 0xffn));
76
+ number >>= 8n;
77
+ }
78
+ let zeros = 0;
79
+ while (zeros < text.length && text[zeros] === "1") zeros++;
80
+ return Uint8Array.from([...new Array(zeros).fill(0), ...body]);
81
+ }
82
+ function canonicalKeyBytes(text) {
83
+ if (text.length < 32 || text.length > 44) return null;
84
+ const bytes = base58Decode(text);
85
+ if (!bytes || bytes.length !== 32 || base58Encode(bytes) !== text) return null;
86
+ return bytes;
87
+ }
88
+
89
+ // src/policy.ts
90
+ var POLICY_NETWORK = Object.freeze({
91
+ genesisHash: "EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG",
92
+ programIds: Object.freeze({
93
+ anchor: "GZYwTp2ozeuRA5Gof9vs4ya961aANcJBdUzB7LN6q4b2",
94
+ verifier: "4F97jNoxQzT2qRbkWpW3ztC3Nz2TtKj3rnKG8ExgnrfV",
95
+ registry: "6VBs3zr9KrfFPGd6j7aGBPQWwZa5tajVfA7HN6MMV9VW",
96
+ sas: "22zoJMtdu4tQc2PzL74ZUT7FrwgB1Udec8DdW4yw4BdG",
97
+ credential: "AMBtabCgRFwGLjoZ21Z2LhSKJ6c47NckxUkMogJ3Lpuw",
98
+ schema: "5LNc7syFW7USPLveVLcNcjjY1xqS7QTXVjHZ7CQCbAMQ"
99
+ })
100
+ });
101
+ var PolicyValidationError = class extends Error {
102
+ constructor(reason) {
103
+ super(`Invalid verification policy: ${reason}`);
104
+ this.reason = reason;
105
+ this.name = "PolicyValidationError";
106
+ }
107
+ };
108
+ function record(value) {
109
+ return typeof value === "object" && value !== null && !Array.isArray(value);
110
+ }
111
+ function exactKeys(value, keys) {
112
+ return Object.keys(value).length === keys.length && keys.every((key) => Object.prototype.hasOwnProperty.call(value, key));
113
+ }
114
+ function integer(value, minimum = 0, maximum = Number.MAX_SAFE_INTEGER) {
115
+ return typeof value === "number" && Number.isSafeInteger(value) && value >= minimum && value <= maximum;
116
+ }
117
+ var REQUEST_KEYS = [
118
+ "id",
119
+ "version",
120
+ "minTrustScore",
121
+ "maxVerificationAgeSeconds",
122
+ "maxEvaluationAgeSeconds",
123
+ "requiredAssurance",
124
+ "uniquenessRequirement",
125
+ "requireAttestation",
126
+ "cluster"
127
+ ];
128
+ function normalizePolicyRequest(input, legacyMinTrustScore) {
129
+ if (legacyMinTrustScore !== void 0 && !integer(legacyMinTrustScore, 0, 1e4)) {
130
+ throw new PolicyValidationError("unsupported_policy");
131
+ }
132
+ const value = input === void 0 ? {
133
+ id: "entros-verify-default",
134
+ version: 1,
135
+ minTrustScore: legacyMinTrustScore ?? 0,
136
+ maxVerificationAgeSeconds: 86400,
137
+ requiredAssurance: "browser_unattested",
138
+ uniquenessRequirement: "allow_unmeasured",
139
+ cluster: "devnet"
140
+ } : input;
141
+ if (!record(value) || Object.keys(value).some(
142
+ (key) => !REQUEST_KEYS.includes(key)
143
+ )) {
144
+ throw new PolicyValidationError("unsupported_policy");
145
+ }
146
+ if (value.requiredAssurance !== "browser_unattested")
147
+ throw new PolicyValidationError("unsupported_assurance");
148
+ if (value.uniquenessRequirement !== "allow_unmeasured")
149
+ throw new PolicyValidationError("unsupported_uniqueness");
150
+ if (typeof value.id !== "string" || !/^[A-Za-z0-9_-]{1,64}$/.test(value.id) || value.version !== 1 || !integer(value.minTrustScore, 0, 1e4) || !integer(value.maxVerificationAgeSeconds, 1, 31536e3) || !integer(
151
+ value.maxEvaluationAgeSeconds === void 0 ? 90 : value.maxEvaluationAgeSeconds,
152
+ 1,
153
+ 90
154
+ ) || value.requireAttestation !== void 0 && typeof value.requireAttestation !== "boolean" || value.cluster !== "devnet" || legacyMinTrustScore !== void 0 && value.minTrustScore !== legacyMinTrustScore) {
155
+ throw new PolicyValidationError("unsupported_policy");
156
+ }
157
+ return {
158
+ id: value.id,
159
+ version: 1,
160
+ minTrustScore: value.minTrustScore,
161
+ maxVerificationAgeSeconds: value.maxVerificationAgeSeconds,
162
+ maxEvaluationAgeSeconds: value.maxEvaluationAgeSeconds ?? 90,
163
+ requiredAssurance: "browser_unattested",
164
+ uniquenessRequirement: "allow_unmeasured",
165
+ requireAttestation: value.requireAttestation === true,
166
+ cluster: "devnet"
167
+ };
168
+ }
169
+ function encodePolicyRequest(request) {
170
+ return JSON.stringify(normalizePolicyRequest(request));
171
+ }
172
+ var BASE58 = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
173
+ function base58Bytes(value, expected) {
174
+ if (typeof value !== "string" || value.length < 1 || value.length > expected * 2)
175
+ return false;
176
+ let number = 0n;
177
+ for (const character of value) {
178
+ const digit = BASE58.indexOf(character);
179
+ if (digit < 0) return false;
180
+ number = number * 58n + BigInt(digit);
181
+ }
182
+ let bytes = 0;
183
+ while (number > 0n) {
184
+ bytes++;
185
+ number >>= 8n;
186
+ }
187
+ let zeros = 0;
188
+ while (value[zeros] === "1") zeros++;
189
+ return bytes + zeros === expected;
190
+ }
191
+ function commitment(value) {
192
+ return typeof value === "string" && /^[0-9a-f]{64}$/.test(value) && !/^0+$/.test(value);
193
+ }
194
+ function isPolicyAttestation(value) {
195
+ if (!record(value)) return false;
196
+ if (value.status === "present") {
197
+ return exactKeys(value, ["status", "address", "readContextSlot", "expiresAt"]) && base58Bytes(value.address, 32) && integer(value.readContextSlot) && (value.expiresAt === null || integer(value.expiresAt, 1));
198
+ }
199
+ return exactKeys(value, ["status"]) && ["missing", "invalid", "unavailable"].includes(String(value.status));
200
+ }
201
+ function isPolicyEvidence(value) {
202
+ if (!record(value) || !exactKeys(value, [
203
+ "cluster",
204
+ "genesisHash",
205
+ "programIds",
206
+ "assuranceTier",
207
+ "uniquenessStatus",
208
+ "readContextSlot",
209
+ "identity",
210
+ "transaction",
211
+ "attestation"
212
+ ]))
213
+ return false;
214
+ if (value.cluster !== "devnet" || value.genesisHash !== POLICY_NETWORK.genesisHash || value.assuranceTier !== "browser_unattested" || value.uniquenessStatus !== "unmeasured" || !integer(value.readContextSlot))
215
+ return false;
216
+ const programs = value.programIds;
217
+ if (!record(programs) || !exactKeys(programs, Object.keys(POLICY_NETWORK.programIds)) || Object.entries(POLICY_NETWORK.programIds).some(
218
+ ([key, id]) => programs[key] !== id
219
+ ))
220
+ return false;
221
+ const identity = value.identity;
222
+ const transaction = value.transaction;
223
+ if (!record(identity) || !exactKeys(identity, [
224
+ "walletPubkey",
225
+ "identityPda",
226
+ "creationTimestamp",
227
+ "lastVerificationTimestamp",
228
+ "verificationCount",
229
+ "trustScore",
230
+ "currentCommitment",
231
+ "projectionVersion",
232
+ "lastResetTimestamp",
233
+ "lastRebaselineTimestamp",
234
+ "mint"
235
+ ]) || !base58Bytes(identity.walletPubkey, 32) || !base58Bytes(identity.identityPda, 32) || !base58Bytes(identity.mint, 32) || !integer(identity.creationTimestamp, 1) || !integer(identity.lastVerificationTimestamp, identity.creationTimestamp) || !integer(identity.verificationCount, 0, 4294967295) || !integer(identity.trustScore, 0, 1e4) || !commitment(identity.currentCommitment) || !integer(identity.projectionVersion, 0, 2) || !integer(identity.lastResetTimestamp) || !integer(identity.lastRebaselineTimestamp))
236
+ return false;
237
+ if (!record(transaction) || !exactKeys(transaction, [
238
+ "signature",
239
+ "slot",
240
+ "blockTime",
241
+ "commitment",
242
+ "kind"
243
+ ]) || !base58Bytes(transaction.signature, 64) || !integer(transaction.slot) || !integer(transaction.blockTime, identity.creationTimestamp) || !commitment(transaction.commitment) || !["mint", "update", "rebaseline"].includes(String(transaction.kind)))
244
+ return false;
245
+ return isPolicyAttestation(value.attestation);
246
+ }
247
+ function evaluatePolicy(request, observation, nowSeconds) {
248
+ const requirements = normalizePolicyRequest(request);
249
+ if (!integer(nowSeconds, 1) || nowSeconds > Number.MAX_SAFE_INTEGER - 31536e3)
250
+ throw new PolicyValidationError("invalid_evidence");
251
+ const base = {
252
+ policyId: requirements.id,
253
+ policyVersion: 1,
254
+ requirements,
255
+ evaluatedAt: nowSeconds,
256
+ expiresAt: nowSeconds,
257
+ evidenceTimestamp: null,
258
+ evaluatedAgeSeconds: null
259
+ };
260
+ if (record(observation) && observation.status === "unavailable")
261
+ return {
262
+ ...base,
263
+ decision: "unavailable",
264
+ reason: "state_unavailable",
265
+ evidence: null
266
+ };
267
+ if (!record(observation) || observation.status !== "available" || !isPolicyEvidence(observation.evidence)) {
268
+ return {
269
+ ...base,
270
+ decision: "deny",
271
+ reason: "invalid_evidence",
272
+ evidence: null
273
+ };
274
+ }
275
+ const evidence = observation.evidence;
276
+ const { identity, transaction, attestation } = evidence;
277
+ const deny = (reason) => ({ ...base, decision: "deny", reason, evidence });
278
+ const freshMint = transaction.kind === "mint" && identity.verificationCount === 0 && identity.trustScore === 0 && identity.creationTimestamp === transaction.blockTime && identity.lastVerificationTimestamp === transaction.blockTime && identity.lastResetTimestamp === 0 && identity.lastRebaselineTimestamp === 0;
279
+ if (identity.verificationCount === 0 && !freshMint || identity.currentCommitment !== transaction.commitment || identity.lastResetTimestamp >= transaction.blockTime || identity.lastResetTimestamp > identity.lastVerificationTimestamp || identity.lastRebaselineTimestamp > identity.lastVerificationTimestamp || identity.lastRebaselineTimestamp > transaction.blockTime || identity.lastVerificationTimestamp > nowSeconds || transaction.blockTime > nowSeconds || evidence.readContextSlot < transaction.slot || attestation.status === "invalid" || attestation.status === "present" && (attestation.readContextSlot < transaction.slot || attestation.expiresAt !== null && attestation.expiresAt <= nowSeconds)) {
280
+ return deny("invalid_evidence");
281
+ }
282
+ base.evidenceTimestamp = Math.min(
283
+ identity.lastVerificationTimestamp,
284
+ transaction.blockTime
285
+ );
286
+ base.evaluatedAgeSeconds = nowSeconds - base.evidenceTimestamp;
287
+ base.expiresAt = Math.min(
288
+ base.evidenceTimestamp + requirements.maxVerificationAgeSeconds,
289
+ nowSeconds + requirements.maxEvaluationAgeSeconds
290
+ );
291
+ if (requirements.requireAttestation && attestation.status === "present" && attestation.expiresAt !== null)
292
+ base.expiresAt = Math.min(base.expiresAt, attestation.expiresAt);
293
+ if (identity.trustScore < requirements.minTrustScore)
294
+ return deny("score_below_minimum");
295
+ if (nowSeconds >= base.expiresAt) return deny("verification_stale");
296
+ if (requirements.requireAttestation && attestation.status === "missing")
297
+ return deny("attestation_required");
298
+ if (requirements.requireAttestation && attestation.status === "unavailable")
299
+ return {
300
+ ...base,
301
+ decision: "unavailable",
302
+ reason: "state_unavailable",
303
+ evidence
304
+ };
305
+ return { ...base, decision: "allow", reason: "accepted", evidence };
306
+ }
307
+
308
+ // src/agent-permit.ts
309
+ var AGENT_PERMIT_VERSION_LINE = "Entros-Agent-Permit-v1";
310
+ var AGENT_PERMIT_NOTICE_LINE = "Sign only to let this agent perform the action below. This is not a transaction.";
311
+ var AGENT_PERMIT_PRESENTATION_LINE = "Entros-Agent-Permit-Presentation-v1";
312
+ var AGENT_PERMIT_NETWORK = Object.freeze({
313
+ cluster: "devnet",
314
+ genesisHash: POLICY_NETWORK.genesisHash,
315
+ entrosAnchorProgram: POLICY_NETWORK.programIds.anchor,
316
+ agentRegistryProgram: "8oo4J9tBB3Hna1jRQ3rWvJjojqM5DYTDJo5cejUuJy3C",
317
+ agentCollection: "6CTyGPcn8dMwKEqgtvx2XCpkGUd7uqCVK6937RSM5bhA",
318
+ coreProgram: "CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d"
319
+ });
320
+ var AGENT_PERMIT_LIMITS = Object.freeze({
321
+ minLifetimeSeconds: 30,
322
+ maxLifetimeSeconds: 900,
323
+ clockSkewSeconds: 30,
324
+ maxAudienceLength: 200,
325
+ maxLabelLength: 96,
326
+ // 2000-01-01T00:00:00Z to 9999-12-31T23:59:59Z. `toISOString` writes six-digit years past 9999.
327
+ minTimeSeconds: 946684800,
328
+ maxTimeSeconds: 253402300799
329
+ });
330
+ var AgentPermitValidationError = class extends Error {
331
+ constructor(field) {
332
+ super(`Invalid agent permit: ${field}`);
333
+ this.field = field;
334
+ this.name = "AgentPermitValidationError";
335
+ }
336
+ };
337
+ var FIELD_KEYS = [
338
+ "agent",
339
+ "agent_wallet",
340
+ "operator",
341
+ "audience",
342
+ "action",
343
+ "action_sha256",
344
+ "policy",
345
+ "cluster",
346
+ "genesis",
347
+ "entros_anchor",
348
+ "agent_registry",
349
+ "agent_collection",
350
+ "issued_at",
351
+ "expires_at",
352
+ "nonce"
353
+ ];
354
+ var REQUEST_KEYS2 = [
355
+ "version",
356
+ "agent",
357
+ "agentWallet",
358
+ "operator",
359
+ "audience",
360
+ "action",
361
+ "policy",
362
+ "cluster",
363
+ "genesisHash",
364
+ "entrosAnchorProgram",
365
+ "agentRegistryProgram",
366
+ "agentCollection",
367
+ "issuedAt",
368
+ "expiresAt",
369
+ "nonce"
370
+ ];
371
+ var HEX64 = /^[0-9a-f]{64}$/;
372
+ var HEX128 = /^[0-9a-f]{128}$/;
373
+ var TIME = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})Z$/;
374
+ var LABEL = "(?:[a-z0-9]|[a-z0-9][a-z0-9-]{0,61}[a-z0-9])";
375
+ var FINAL = "(?:[a-z]|[a-z][a-z0-9-]{0,61}[a-z0-9])";
376
+ var PORT = "(?::([1-9][0-9]{0,4}))?";
377
+ var PATH = "(/(?:[A-Za-z0-9._~-]+(?:/[A-Za-z0-9._~-]+)*/?)?)";
378
+ var HTTPS_AUDIENCE = new RegExp(
379
+ `^https://((?:${LABEL}\\.)+${FINAL})${PORT}${PATH}$`
380
+ );
381
+ var LOOPBACK_AUDIENCE = new RegExp(`^http://(127\\.0\\.0\\.1)${PORT}${PATH}$`);
382
+ var MAX_POLICY_LENGTH = 512;
383
+ var encoder = new TextEncoder();
384
+ function record2(value) {
385
+ return typeof value === "object" && value !== null && !Array.isArray(value);
386
+ }
387
+ function exactKeys2(value, keys) {
388
+ return Object.keys(value).length === keys.length && keys.every((key) => Object.prototype.hasOwnProperty.call(value, key));
389
+ }
390
+ function integer2(value, minimum, maximum) {
391
+ return typeof value === "number" && Number.isSafeInteger(value) && value >= minimum && value <= maximum;
392
+ }
393
+ function hexToBytes(value) {
394
+ const bytes = new Uint8Array(value.length / 2);
395
+ for (let index = 0; index < bytes.length; index++) {
396
+ bytes[index] = Number.parseInt(value.slice(index * 2, index * 2 + 2), 16);
397
+ }
398
+ return bytes;
399
+ }
400
+ function bytesToHex(bytes) {
401
+ return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
402
+ }
403
+ function printable(value) {
404
+ for (let index = 0; index < value.length; index++) {
405
+ const code = value.charCodeAt(index);
406
+ if (code < 32 || code > 126) return false;
407
+ }
408
+ return true;
409
+ }
410
+ function digestHex(value) {
411
+ return typeof value === "string" && HEX64.test(value) && !/^0+$/.test(value);
412
+ }
413
+ function strictPublicKey(bytes) {
414
+ try {
415
+ return !import_ed25519.ed25519.Point.fromBytes(bytes, false).isSmallOrder();
416
+ } catch {
417
+ return false;
418
+ }
419
+ }
420
+ function signingKey(value) {
421
+ if (typeof value !== "string") return false;
422
+ const bytes = canonicalKeyBytes(value);
423
+ return bytes !== null && strictPublicKey(bytes);
424
+ }
425
+ function address(value) {
426
+ return typeof value === "string" && canonicalKeyBytes(value) !== null;
427
+ }
428
+ function isAgentPermitAudience(value) {
429
+ if (typeof value !== "string" || value.length > AGENT_PERMIT_LIMITS.maxAudienceLength)
430
+ return false;
431
+ const https = HTTPS_AUDIENCE.exec(value);
432
+ const match = https ?? LOOPBACK_AUDIENCE.exec(value);
433
+ if (!match) return false;
434
+ const [, host, port, path] = match;
435
+ if (host === void 0 || path === void 0) return false;
436
+ if (host.split(".").some((label) => label.length >= 4 && label[2] === "-" && label[3] === "-"))
437
+ return false;
438
+ if (port !== void 0) {
439
+ const number = Number(port);
440
+ if (number > 65535 || number === (https ? 443 : 80)) return false;
441
+ }
442
+ return path.split("/").every((segment) => segment !== "." && segment !== "..");
443
+ }
444
+ function actionLabel(value) {
445
+ return typeof value === "string" && value.length >= 1 && value.length <= AGENT_PERMIT_LIMITS.maxLabelLength && printable(value) && value === value.trim();
446
+ }
447
+ function unixSeconds(value) {
448
+ return integer2(
449
+ value,
450
+ AGENT_PERMIT_LIMITS.minTimeSeconds,
451
+ AGENT_PERMIT_LIMITS.maxTimeSeconds
452
+ );
453
+ }
454
+ function formatTime(seconds) {
455
+ return new Date(seconds * 1e3).toISOString().replace(".000Z", "Z");
456
+ }
457
+ function parseTime(value) {
458
+ if (!TIME.test(value)) return null;
459
+ const milliseconds = Date.parse(value);
460
+ if (!Number.isFinite(milliseconds) || milliseconds % 1e3 !== 0) return null;
461
+ const seconds = milliseconds / 1e3;
462
+ return unixSeconds(seconds) && formatTime(seconds) === value ? seconds : null;
463
+ }
464
+ function policyRequest(value) {
465
+ try {
466
+ const policy = normalizePolicyRequest(value);
467
+ return encodePolicyRequest(policy) === JSON.stringify(value) ? policy : null;
468
+ } catch {
469
+ return null;
470
+ }
471
+ }
472
+ function normalizeAgentPermitRequest(value) {
473
+ if (!record2(value) || !exactKeys2(value, REQUEST_KEYS2))
474
+ throw new AgentPermitValidationError("request");
475
+ const {
476
+ version,
477
+ agent,
478
+ agentWallet,
479
+ operator,
480
+ audience,
481
+ action,
482
+ issuedAt,
483
+ expiresAt,
484
+ nonce
485
+ } = value;
486
+ if (version !== 1) throw new AgentPermitValidationError("version");
487
+ if (!address(agent)) throw new AgentPermitValidationError("agent");
488
+ if (!signingKey(agentWallet)) throw new AgentPermitValidationError("agentWallet");
489
+ if (!signingKey(operator)) throw new AgentPermitValidationError("operator");
490
+ if (!isAgentPermitAudience(audience)) throw new AgentPermitValidationError("audience");
491
+ if (!record2(action) || !exactKeys2(action, ["label", "sha256"]) || !actionLabel(action.label) || !digestHex(action.sha256))
492
+ throw new AgentPermitValidationError("action");
493
+ const policy = policyRequest(value.policy);
494
+ if (!policy) throw new AgentPermitValidationError("policy");
495
+ if (value.cluster !== AGENT_PERMIT_NETWORK.cluster || value.genesisHash !== AGENT_PERMIT_NETWORK.genesisHash || value.entrosAnchorProgram !== AGENT_PERMIT_NETWORK.entrosAnchorProgram || value.agentRegistryProgram !== AGENT_PERMIT_NETWORK.agentRegistryProgram || value.agentCollection !== AGENT_PERMIT_NETWORK.agentCollection)
496
+ throw new AgentPermitValidationError("deployment");
497
+ if (!unixSeconds(issuedAt) || !unixSeconds(expiresAt))
498
+ throw new AgentPermitValidationError("time");
499
+ const lifetime = expiresAt - issuedAt;
500
+ if (lifetime < AGENT_PERMIT_LIMITS.minLifetimeSeconds || lifetime > AGENT_PERMIT_LIMITS.maxLifetimeSeconds)
501
+ throw new AgentPermitValidationError("lifetime");
502
+ if (!digestHex(nonce)) throw new AgentPermitValidationError("nonce");
503
+ return {
504
+ version: 1,
505
+ agent,
506
+ agentWallet,
507
+ operator,
508
+ audience,
509
+ action: { label: action.label, sha256: action.sha256 },
510
+ policy,
511
+ cluster: AGENT_PERMIT_NETWORK.cluster,
512
+ genesisHash: AGENT_PERMIT_NETWORK.genesisHash,
513
+ entrosAnchorProgram: AGENT_PERMIT_NETWORK.entrosAnchorProgram,
514
+ agentRegistryProgram: AGENT_PERMIT_NETWORK.agentRegistryProgram,
515
+ agentCollection: AGENT_PERMIT_NETWORK.agentCollection,
516
+ issuedAt,
517
+ expiresAt,
518
+ nonce
519
+ };
520
+ }
521
+ function randomNonce() {
522
+ const cryptoApi = globalThis.crypto;
523
+ if (!cryptoApi || typeof cryptoApi.getRandomValues !== "function")
524
+ throw new AgentPermitValidationError("nonce");
525
+ const bytes = new Uint8Array(32);
526
+ cryptoApi.getRandomValues(bytes);
527
+ return bytesToHex(bytes);
528
+ }
529
+ function createAgentPermitRequest(input) {
530
+ if (!integer2(input.lifetimeSeconds, 1, AGENT_PERMIT_LIMITS.maxLifetimeSeconds))
531
+ throw new AgentPermitValidationError("lifetime");
532
+ return normalizeAgentPermitRequest({
533
+ version: 1,
534
+ agent: input.agent,
535
+ agentWallet: input.agentWallet,
536
+ operator: input.operator,
537
+ audience: input.audience,
538
+ action: { label: input.action.label, sha256: input.action.sha256 },
539
+ policy: normalizePolicyRequest(input.policy),
540
+ cluster: AGENT_PERMIT_NETWORK.cluster,
541
+ genesisHash: AGENT_PERMIT_NETWORK.genesisHash,
542
+ entrosAnchorProgram: AGENT_PERMIT_NETWORK.entrosAnchorProgram,
543
+ agentRegistryProgram: AGENT_PERMIT_NETWORK.agentRegistryProgram,
544
+ agentCollection: AGENT_PERMIT_NETWORK.agentCollection,
545
+ issuedAt: input.issuedAt,
546
+ expiresAt: input.issuedAt + input.lifetimeSeconds,
547
+ nonce: input.nonce ?? randomNonce()
548
+ });
549
+ }
550
+ function renderNormalized(value) {
551
+ const fields = [
552
+ value.agent,
553
+ value.agentWallet,
554
+ value.operator,
555
+ value.audience,
556
+ value.action.label,
557
+ value.action.sha256,
558
+ encodePolicyRequest(value.policy),
559
+ value.cluster,
560
+ value.genesisHash,
561
+ value.entrosAnchorProgram,
562
+ value.agentRegistryProgram,
563
+ value.agentCollection,
564
+ formatTime(value.issuedAt),
565
+ formatTime(value.expiresAt),
566
+ value.nonce
567
+ ];
568
+ return [
569
+ AGENT_PERMIT_VERSION_LINE,
570
+ AGENT_PERMIT_NOTICE_LINE,
571
+ ...FIELD_KEYS.map((key, index) => `${key}:${fields[index]}`)
572
+ ].join("\n");
573
+ }
574
+ function permitIdOf(message) {
575
+ return bytesToHex((0, import_sha2.sha256)(encoder.encode(message)));
576
+ }
577
+ function renderAgentPermitMessage(request) {
578
+ return renderNormalized(normalizeAgentPermitRequest(request));
579
+ }
580
+ function parseAgentPermitMessage(text) {
581
+ if (typeof text !== "string" || text.length > 4096)
582
+ throw new AgentPermitValidationError("message");
583
+ for (let index = 0; index < text.length; index++) {
584
+ const code = text.charCodeAt(index);
585
+ if (code !== 10 && (code < 32 || code > 126))
586
+ throw new AgentPermitValidationError("message");
587
+ }
588
+ const lines = text.split("\n");
589
+ if (lines.length !== FIELD_KEYS.length + 2 || lines[0] !== AGENT_PERMIT_VERSION_LINE || lines[1] !== AGENT_PERMIT_NOTICE_LINE)
590
+ throw new AgentPermitValidationError("message");
591
+ const values = /* @__PURE__ */ new Map();
592
+ FIELD_KEYS.forEach((key, index) => {
593
+ const line = lines[index + 2] ?? "";
594
+ if (!line.startsWith(`${key}:`))
595
+ throw new AgentPermitValidationError(key);
596
+ values.set(key, line.slice(key.length + 1));
597
+ });
598
+ const field = (key) => values.get(key) ?? "";
599
+ const policyText = field("policy");
600
+ if (policyText.length > MAX_POLICY_LENGTH)
601
+ throw new AgentPermitValidationError("policy");
602
+ let policy;
603
+ try {
604
+ policy = JSON.parse(policyText);
605
+ } catch {
606
+ throw new AgentPermitValidationError("policy");
607
+ }
608
+ const issuedAt = parseTime(field("issued_at"));
609
+ const expiresAt = parseTime(field("expires_at"));
610
+ if (issuedAt === null || expiresAt === null)
611
+ throw new AgentPermitValidationError("time");
612
+ const request = normalizeAgentPermitRequest({
613
+ version: 1,
614
+ agent: field("agent"),
615
+ agentWallet: field("agent_wallet"),
616
+ operator: field("operator"),
617
+ audience: field("audience"),
618
+ action: { label: field("action"), sha256: field("action_sha256") },
619
+ policy,
620
+ cluster: field("cluster"),
621
+ genesisHash: field("genesis"),
622
+ entrosAnchorProgram: field("entros_anchor"),
623
+ agentRegistryProgram: field("agent_registry"),
624
+ agentCollection: field("agent_collection"),
625
+ issuedAt,
626
+ expiresAt,
627
+ nonce: field("nonce")
628
+ });
629
+ if (renderNormalized(request) !== text)
630
+ throw new AgentPermitValidationError("message");
631
+ return request;
632
+ }
633
+ function agentPermitId(request) {
634
+ return permitIdOf(renderAgentPermitMessage(request));
635
+ }
636
+ function renderAgentPermitPresentation(permitId) {
637
+ if (!HEX64.test(permitId)) throw new AgentPermitValidationError("permitId");
638
+ return `${AGENT_PERMIT_PRESENTATION_LINE}
639
+ permit:${permitId}`;
640
+ }
641
+ function strictVerify(signature, message, publicKey) {
642
+ if (typeof signature !== "string" || !HEX128.test(signature)) return false;
643
+ const key = canonicalKeyBytes(publicKey);
644
+ if (!key) return false;
645
+ try {
646
+ return import_ed25519.ed25519.verify(hexToBytes(signature), message, key, { zip215: false });
647
+ } catch {
648
+ return false;
649
+ }
650
+ }
651
+ function verifyNormalized(value, signatures) {
652
+ const message = renderNormalized(value);
653
+ const permitId = permitIdOf(message);
654
+ return {
655
+ permitId,
656
+ operator: strictVerify(
657
+ signatures.operatorSignature,
658
+ encoder.encode(message),
659
+ value.operator
660
+ ),
661
+ presentation: strictVerify(
662
+ signatures.presentationSignature,
663
+ encoder.encode(renderAgentPermitPresentation(permitId)),
664
+ value.agentWallet
665
+ )
666
+ };
667
+ }
668
+ function verifyAgentPermitSignatures(request, signatures) {
669
+ const { operator, presentation } = verifyNormalized(
670
+ normalizeAgentPermitRequest(request),
671
+ signatures
672
+ );
673
+ return { operator, presentation };
674
+ }
675
+ function settlementClock(nowSeconds) {
676
+ if (!integer2(nowSeconds, 1, AGENT_PERMIT_LIMITS.maxTimeSeconds))
677
+ throw new AgentPermitValidationError("clock");
678
+ return nowSeconds;
679
+ }
680
+ function precheckAgentPermit(input) {
681
+ const now = settlementClock(input.nowSeconds);
682
+ let request;
683
+ try {
684
+ request = normalizeAgentPermitRequest(input.request);
685
+ } catch {
686
+ return { ok: false, reason: "invalid_permit", request: null, permitId: null };
687
+ }
688
+ const signatures = verifyNormalized(request, input);
689
+ const { permitId } = signatures;
690
+ if (request.issuedAt > now + AGENT_PERMIT_LIMITS.clockSkewSeconds)
691
+ return { ok: false, reason: "invalid_permit", request, permitId };
692
+ if (now >= request.expiresAt)
693
+ return { ok: false, reason: "permit_expired", request, permitId };
694
+ if (!signatures.operator)
695
+ return { ok: false, reason: "invalid_signature", request, permitId };
696
+ if (!signatures.presentation)
697
+ return { ok: false, reason: "invalid_presentation", request, permitId };
698
+ return { ok: true, request, permitId };
699
+ }
700
+ function isAgentStateEvidence(value) {
701
+ if (!record2(value) || !exactKeys2(value, [
702
+ "cluster",
703
+ "genesisHash",
704
+ "coreProgram",
705
+ "agentRegistryProgram",
706
+ "agentCollection",
707
+ "agent",
708
+ "agentAccount",
709
+ "owner",
710
+ "cachedOwner",
711
+ "agentWallet",
712
+ "agentWalletStatus",
713
+ "readContextSlot"
714
+ ]))
715
+ return false;
716
+ if (value.cluster !== AGENT_PERMIT_NETWORK.cluster || value.genesisHash !== AGENT_PERMIT_NETWORK.genesisHash || value.coreProgram !== AGENT_PERMIT_NETWORK.coreProgram || value.agentRegistryProgram !== AGENT_PERMIT_NETWORK.agentRegistryProgram || value.agentCollection !== AGENT_PERMIT_NETWORK.agentCollection || !address(value.agent) || !address(value.agentAccount) || !address(value.owner) || !address(value.cachedOwner) || value.agentWallet !== null && !address(value.agentWallet) || !integer2(value.readContextSlot, 0, Number.MAX_SAFE_INTEGER))
717
+ return false;
718
+ const expected = value.cachedOwner !== value.owner ? "stale" : value.agentWallet === null ? "unbound" : "bound";
719
+ return value.agentWalletStatus === expected;
720
+ }
721
+ function agentStateReason(reason) {
722
+ return reason === "wrong_cluster" || reason === "agent_missing" || reason === "agent_unregistered" ? reason : "agent_invalid";
723
+ }
724
+ function evaluateAgentPermit(input) {
725
+ const now = settlementClock(input.nowSeconds);
726
+ const precheck = precheckAgentPermit(input);
727
+ const base = {
728
+ permitId: precheck.permitId,
729
+ request: precheck.request,
730
+ evaluatedAt: now,
731
+ expiresAt: precheck.request?.expiresAt ?? null,
732
+ agentState: null,
733
+ policy: null
734
+ };
735
+ const deny = (reason) => ({
736
+ ...base,
737
+ decision: "deny",
738
+ reason
739
+ });
740
+ if (!precheck.ok) return deny(precheck.reason);
741
+ const { request } = precheck;
742
+ const state = input.agentState;
743
+ if (!record2(state)) return deny("agent_invalid");
744
+ if (state.status === "unavailable")
745
+ return { ...base, decision: "unavailable", reason: "agent_unavailable" };
746
+ if (state.status !== "available") return deny(agentStateReason(state.reason));
747
+ if (!isAgentStateEvidence(state.evidence) || state.evidence.agent !== request.agent)
748
+ return deny("agent_invalid");
749
+ const evidence = state.evidence;
750
+ base.agentState = evidence;
751
+ if (evidence.owner !== request.operator) return deny("owner_changed");
752
+ if (evidence.agentWalletStatus === "stale") return deny("agent_wallet_stale");
753
+ if (evidence.agentWalletStatus === "unbound") return deny("agent_wallet_unbound");
754
+ if (evidence.agentWallet !== request.agentWallet)
755
+ return deny("agent_wallet_changed");
756
+ let policy;
757
+ try {
758
+ policy = evaluatePolicy(request.policy, input.operatorEvidence, now);
759
+ } catch {
760
+ return deny("invalid_evidence");
761
+ }
762
+ base.policy = policy;
763
+ if (policy.decision === "unavailable")
764
+ return { ...base, decision: "unavailable", reason: "state_unavailable" };
765
+ if (policy.decision === "deny") {
766
+ const reason = policy.reason;
767
+ return deny(
768
+ reason === "score_below_minimum" || reason === "verification_stale" || reason === "attestation_required" ? reason : "invalid_evidence"
769
+ );
770
+ }
771
+ if (policy.evidence.identity.walletPubkey !== request.operator)
772
+ return deny("invalid_evidence");
773
+ base.expiresAt = Math.min(request.expiresAt, policy.expiresAt);
774
+ if (now >= base.expiresAt) return deny("permit_expired");
775
+ return { ...base, decision: "allow", reason: "accepted" };
776
+ }
777
+ function transactionSignature(value) {
778
+ if (typeof value !== "string" || value.length < 64 || value.length > 88)
779
+ return false;
780
+ const bytes = base58Decode(value);
781
+ return bytes !== null && bytes.length === 64 && base58Encode(bytes) === value;
782
+ }
783
+ function jsonRecord(input) {
784
+ let value = input;
785
+ if (typeof input === "string") {
786
+ if (input.length > 1024) return null;
787
+ try {
788
+ value = JSON.parse(input);
789
+ } catch {
790
+ return null;
791
+ }
792
+ }
793
+ return record2(value) ? value : null;
794
+ }
795
+ function encodeAgentPermitApproval(approval) {
796
+ const value = parseAgentPermitApproval({ version: 1, ...approval });
797
+ if (!value) throw new AgentPermitValidationError("approval");
798
+ return JSON.stringify({
799
+ version: 1,
800
+ permitId: value.permitId,
801
+ operatorSignature: value.operatorSignature,
802
+ verifiedTransaction: value.verifiedTransaction
803
+ });
804
+ }
805
+ function parseAgentPermitApproval(input) {
806
+ const value = jsonRecord(input);
807
+ if (!value || !exactKeys2(value, ["version", "permitId", "operatorSignature", "verifiedTransaction"]) || value.version !== 1 || typeof value.permitId !== "string" || !HEX64.test(value.permitId) || typeof value.operatorSignature !== "string" || !HEX128.test(value.operatorSignature) || !transactionSignature(value.verifiedTransaction))
808
+ return null;
809
+ return {
810
+ version: 1,
811
+ permitId: value.permitId,
812
+ operatorSignature: value.operatorSignature,
813
+ verifiedTransaction: value.verifiedTransaction
814
+ };
815
+ }
816
+ function encodeAgentPermitSettlement(bundle) {
817
+ const value = parseAgentPermitSettlement({ version: 1, ...bundle });
818
+ if (!value) throw new AgentPermitValidationError("settlement");
819
+ return JSON.stringify({
820
+ version: 1,
821
+ nonce: value.nonce,
822
+ operatorSignature: value.operatorSignature,
823
+ presentationSignature: value.presentationSignature,
824
+ verifiedTransaction: value.verifiedTransaction
825
+ });
826
+ }
827
+ function parseAgentPermitSettlement(input) {
828
+ const value = jsonRecord(input);
829
+ if (!value || !exactKeys2(value, [
830
+ "version",
831
+ "nonce",
832
+ "operatorSignature",
833
+ "presentationSignature",
834
+ "verifiedTransaction"
835
+ ]) || value.version !== 1 || !digestHex(value.nonce) || typeof value.operatorSignature !== "string" || !HEX128.test(value.operatorSignature) || typeof value.presentationSignature !== "string" || !HEX128.test(value.presentationSignature) || !transactionSignature(value.verifiedTransaction))
836
+ return null;
837
+ return {
838
+ version: 1,
839
+ nonce: value.nonce,
840
+ operatorSignature: value.operatorSignature,
841
+ presentationSignature: value.presentationSignature,
842
+ verifiedTransaction: value.verifiedTransaction
843
+ };
844
+ }
845
+ function base64UrlEncode(text) {
846
+ return btoa(text).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
847
+ }
848
+ function base64UrlDecode(value) {
849
+ if (!/^[A-Za-z0-9_-]*$/.test(value) || value.length % 4 === 1) return null;
850
+ try {
851
+ const padded = value.replace(/-/g, "+").replace(/_/g, "/");
852
+ return atob(padded + "=".repeat((4 - padded.length % 4) % 4));
853
+ } catch {
854
+ return null;
855
+ }
856
+ }
857
+ function encodeAgentPermitFragment(request) {
858
+ return `request=${base64UrlEncode(renderAgentPermitMessage(request))}`;
859
+ }
860
+ function parseAgentPermitFragment(fragment) {
861
+ const body = fragment.startsWith("#") ? fragment.slice(1) : fragment;
862
+ if (!body.startsWith("request=") || body.length > 8192) return null;
863
+ const message = base64UrlDecode(body.slice("request=".length));
864
+ if (message === null) return null;
865
+ try {
866
+ return { request: parseAgentPermitMessage(message), message };
867
+ } catch {
868
+ return null;
869
+ }
870
+ }
871
+ // Annotate the CommonJS export names for ESM import in node:
872
+ 0 && (module.exports = {
873
+ AGENT_PERMIT_LIMITS,
874
+ AGENT_PERMIT_NETWORK,
875
+ AGENT_PERMIT_NOTICE_LINE,
876
+ AGENT_PERMIT_PRESENTATION_LINE,
877
+ AGENT_PERMIT_VERSION_LINE,
878
+ AgentPermitValidationError,
879
+ agentPermitId,
880
+ createAgentPermitRequest,
881
+ encodeAgentPermitApproval,
882
+ encodeAgentPermitFragment,
883
+ encodeAgentPermitSettlement,
884
+ evaluateAgentPermit,
885
+ isAgentPermitAudience,
886
+ isAgentStateEvidence,
887
+ normalizeAgentPermitRequest,
888
+ parseAgentPermitApproval,
889
+ parseAgentPermitFragment,
890
+ parseAgentPermitMessage,
891
+ parseAgentPermitSettlement,
892
+ precheckAgentPermit,
893
+ renderAgentPermitMessage,
894
+ renderAgentPermitPresentation,
895
+ verifyAgentPermitSignatures
896
+ });
897
+ //# sourceMappingURL=agent-permit.js.map