@ocap/chain-node 1.32.1 → 1.32.3

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,192 @@
1
+ //#region src/did-tls.d.ts
2
+ /**
3
+ * Zero-CA X.509v3 DID-TLS certificate issuer, strict bounded ASN.1 DER parser,
4
+ * and fail-closed peer verifier (`@ocap/chain-node`, #2025).
5
+ *
6
+ * Wire-compatible 1:1 with `arc` DID-TLS (`OID 1.3.101.112` Ed25519 and
7
+ * `OID 1.3.6.1.4.1.59489.1.1` P-256 `DIDBindingProof` Cloudflare mTLS bridge).
8
+ * Uses `node:crypto` + `@arcblock/did` with zero `openssl` CLI subprocesses.
9
+ */
10
+ /** Hard upper bound on accepted DER certificate size (16 KiB). */
11
+ declare const MAX_CERT_BYTES = 16384;
12
+ declare const MAX_DID_TLS_CERT_BYTES = 16384;
13
+ /** Hard upper bound on PEM string input length before base64 decoding. */
14
+ declare const MAX_DID_TLS_PEM_CHARS = 32768;
15
+ /** Hard upper bound on DID length inside X.509 Subject/Issuer/SAN. */
16
+ declare const MAX_DID_TLS_DID_LENGTH = 512;
17
+ /** Private Enterprise Number extension OID for ARC DID-TLS P-256 binding proof. */
18
+ declare const DID_TLS_BINDING_PROOF_OID = "1.3.6.1.4.1.59489.1.1";
19
+ /** Domain separation tag for Ed25519 DID-TLS P-256 binding signatures. */
20
+ declare const DID_TLS_BINDING_DOMAIN = "ARC-DID-TLS-BINDING-V1";
21
+ /** HKDF-SHA256 salt for deterministic P-256 key derivation from a 32-byte DID seed. */
22
+ declare const DID_TLS_P256_HKDF_SALT = "arc-did-tls-p256-salt-v1";
23
+ /** HKDF-SHA256 info prefix for deterministic P-256 key derivation. */
24
+ declare const DID_TLS_P256_HKDF_INFO_PREFIX = "arc-did-tls-p256-key-v1:";
25
+ /** Default clock skew tolerance in seconds for certificate validity checks. */
26
+ declare const DEFAULT_DID_TLS_CLOCK_SKEW_SECONDS = 60;
27
+ type DidTlsWireAlgorithm = 'ed25519' | 'p256';
28
+ type DidTlsRole = 'server' | 'client' | 'dual' | 'ca';
29
+ type DidTlsEndpointRole = 'server' | 'client';
30
+ type DidTlsRejectReason = 'malformed-cert' | 'oversized-cert' | 'unsupported-version' | 'unsupported-algorithm' | 'unsupported-critical-extension' | 'duplicate-extension' | 'invalid-did' | 'subject-did-mismatch' | 'no-trust-policy' | 'untrusted-issuer' | 'subject-not-allowed' | 'issuer-key-mismatch' | 'missing-did-binding-proof' | 'invalid-did-binding-proof' | 'invalid-signature' | 'cert-not-yet-valid' | 'cert-expired' | 'ca-cert-as-leaf' | 'invalid-key-usage' | 'role-mismatch' | 'host-mismatch';
31
+ interface IssueDidTlsCertificateOptions {
32
+ /** Subject W3C DID (`CN=<subjectDid>` and `SAN URI=<subjectDid>`). Bare OCAP DIDs are canonicalized to `did:abt:...`. */
33
+ subjectDid?: string;
34
+ /** 32-byte Ed25519 seed or 64-byte TweetNaCl secret key (`Uint8Array`, hex, or `z...` Base58btc). */
35
+ subjectSeed: Uint8Array | string;
36
+ /** Issuer W3C DID (defaults to `subjectDid` for self-issued certificates). */
37
+ issuerDid?: string;
38
+ /** Issuer Ed25519 seed/secretKey (defaults to `subjectSeed` when self-issued). */
39
+ issuerSeed?: Uint8Array | string;
40
+ /** TLS wire key/signature algorithm (`'ed25519'` default, or `'p256'` Cloudflare mTLS bridge). */
41
+ wireAlgorithm?: DidTlsWireAlgorithm;
42
+ /** Certificate role (`'dual'` default, `'server'`, `'client'`, or `'ca'`). */
43
+ role?: DidTlsRole;
44
+ /** Additional DNS SubjectAltName entries (exact hostnames or leftmost `*.domain.tld`). */
45
+ dnsNames?: readonly string[];
46
+ /** Additional IPv4 / IPv6 SubjectAltName entries. */
47
+ ipAddresses?: readonly string[];
48
+ /** Validity start timestamp (truncated to whole seconds; defaults to current UTC second). */
49
+ notBefore?: Date;
50
+ /** Explicit validity end timestamp (overrides `validityDays`). */
51
+ notAfter?: Date;
52
+ /** Validity duration in days (`1..3650`, default `365`) when `notAfter` is omitted. */
53
+ validityDays?: number;
54
+ /** Optional explicit positive serial number (`1..20` bytes) for deterministic fixtures. */
55
+ serialNumber?: Uint8Array;
56
+ }
57
+ interface IssuedDidTlsCertificate {
58
+ certificatePem: string;
59
+ certificateDer: Uint8Array;
60
+ privateKeyPem: string;
61
+ privateKeyPkcs8Der: Uint8Array;
62
+ subjectDid: string;
63
+ issuerDid: string;
64
+ subjectEd25519PublicKey: Uint8Array;
65
+ subjectEd25519PublicKeyHex: string;
66
+ issuerEd25519PublicKey: Uint8Array;
67
+ issuerEd25519PublicKeyHex: string;
68
+ spkiSha256Hex: string;
69
+ wireAlgorithm: DidTlsWireAlgorithm;
70
+ role: DidTlsRole;
71
+ dnsNames: string[];
72
+ ipAddresses: string[];
73
+ notBefore: Date;
74
+ notAfter: Date;
75
+ serialNumberHex: string;
76
+ }
77
+ interface DidTlsKeyUsageFlags {
78
+ digitalSignature: boolean;
79
+ keyCertSign: boolean;
80
+ cRLSign: boolean;
81
+ }
82
+ interface ParsedDidBindingProof {
83
+ version: number;
84
+ issuerDid: string;
85
+ issuerEd25519PublicKey: Uint8Array;
86
+ issuerTlsSpkiDer: Uint8Array;
87
+ extensionsDigest: Uint8Array;
88
+ signature: Uint8Array;
89
+ }
90
+ interface ParsedDidTlsCertificate {
91
+ version: number;
92
+ serialNumberHex: string;
93
+ wireAlgorithm: DidTlsWireAlgorithm;
94
+ issuerDid: string;
95
+ subjectDid: string;
96
+ notBefore: Date;
97
+ notAfter: Date;
98
+ tbsDer: Uint8Array;
99
+ spkiDer: Uint8Array;
100
+ subjectPublicKeyRaw: Uint8Array;
101
+ signatureValue: Uint8Array;
102
+ isCA: boolean;
103
+ pathLenConstraint?: number;
104
+ keyUsage: DidTlsKeyUsageFlags;
105
+ roles: DidTlsEndpointRole[];
106
+ uriSans: string[];
107
+ dnsNames: string[];
108
+ ipAddresses: string[];
109
+ subjectKeyIdentifierHex?: string;
110
+ authorityKeyIdentifierHex?: string;
111
+ coreExtensionsDer: Uint8Array;
112
+ didBindingProof?: ParsedDidBindingProof;
113
+ }
114
+ type DidTlsAllowedIssuerPinsInput = ReadonlyMap<string, Uint8Array | string> | Readonly<Record<string, Uint8Array | string>> | ReadonlyArray<Uint8Array | string> | ReadonlySet<string>;
115
+ interface DidTlsPeerVerifyPolicy {
116
+ /**
117
+ * Fail-closed pinned 32-byte Ed25519 issuer public keys.
118
+ * Accepts:
119
+ * - `Map<issuerDid, pubkey>` / `Record<issuerDid, pubkey>`
120
+ * - Array/Set of `<pubkey>` (`Uint8Array(32)`, hex, `0x` hex, `z...` multibase/base58) or `<issuerDid>=<pubkey>`
121
+ */
122
+ allowedIssuerPublicKeys?: DidTlsAllowedIssuerPinsInput;
123
+ /** Optional self-issued peer DID -> 32-byte Ed25519 public key map. */
124
+ allowedSubjectPublicKeys?: ReadonlyMap<string, Uint8Array | string>;
125
+ /** Optional subject DID allowlist restricting which subjects an issuer may certify. */
126
+ allowedSubjectDids?: Iterable<string>;
127
+ /** Expected TLS endpoint role (`'client'` default for server mTLS peer check, or `'server'`). */
128
+ expectedRole?: DidTlsEndpointRole;
129
+ /** Expected DNS hostname or IPv4/IPv6 literal matched against SANs. */
130
+ expectedHost?: string;
131
+ /** Reference timestamp for validity check (defaults to `Date.now()`). */
132
+ now?: Date | number;
133
+ /** Allowed clock skew in seconds (defaults to `60`). */
134
+ clockSkewSeconds?: number;
135
+ }
136
+ type DidTlsTrustPolicy = DidTlsPeerVerifyPolicy;
137
+ type DidTlsVerificationResult = {
138
+ ok: true;
139
+ subjectDid: string;
140
+ issuerDid: string;
141
+ issuerPublicKeyHex: string;
142
+ spkiSha256Hex: string;
143
+ wireAlgorithm: DidTlsWireAlgorithm;
144
+ roles: DidTlsEndpointRole[];
145
+ dnsNames: string[];
146
+ ipAddresses: string[];
147
+ notBefore: Date;
148
+ notAfter: Date;
149
+ } | {
150
+ ok: false;
151
+ reason: DidTlsRejectReason;
152
+ detail: string;
153
+ };
154
+ declare function didTlsBytesToHex(bytes: Uint8Array): string;
155
+ declare function didTlsHexToBytes(input: string, expectedLength?: number): Uint8Array;
156
+ declare function isValidW3cDidSyntax(value: unknown): value is string;
157
+ /**
158
+ * Normalize either a bare OCAP DID (`z1...`) or a W3C DID (`did:abt:z1...`, `did:spaces:z1...`, `did:arc:...`)
159
+ * into its canonical W3C DID string (`did:...`).
160
+ */
161
+ declare function canonicalizeTlsDid(rawDid: string, fieldName?: string): string;
162
+ /**
163
+ * Extract a validated 32-byte Ed25519 secret seed from a 32-byte seed or 64-byte OCAP/TweetNaCl
164
+ * Ed25519 secret key (`Uint8Array`, `0x`/bare hex, or `z...` Base58btc).
165
+ * Never echoes key material in error messages.
166
+ */
167
+ declare function extractEd25519SeedFromSecretKey(secretKey: Uint8Array | string, label?: string): Uint8Array;
168
+ /**
169
+ * Decode a pinned 32-byte Ed25519 public key from `Uint8Array(32)`, 64-char hex (`0x` optional),
170
+ * `did:key:z6Mk...`, multibase `z6Mk...` (`0xed 0x01` + 32 bytes), or OCAP `z...` Base58btc (32 bytes).
171
+ */
172
+ declare function decodeEd25519PublicKeyPin(input: Uint8Array | string, label?: string): Uint8Array;
173
+ /**
174
+ * Derive the 32-byte Ed25519 public key from a 32-byte seed (or 64-byte Ed25519 secret key).
175
+ */
176
+ declare function deriveEd25519PublicKeyFromSeed(seed: Uint8Array | string): Uint8Array;
177
+ /**
178
+ * Deterministically derive an ECDSA P-256 keypair from a 32-byte Ed25519 DID seed
179
+ * and canonical W3C DID string via HKDF-SHA256 with rejection sampling over `[1, n-1]`.
180
+ */
181
+ declare function deriveDidTlsP256KeyPair(seed: Uint8Array | string, did: string): {
182
+ privateKeyScalar: Uint8Array;
183
+ publicKeyUncompressed: Uint8Array;
184
+ spkiDer: Uint8Array;
185
+ pkcs8Der: Uint8Array;
186
+ };
187
+ declare function issueDidTlsCertificate(options: IssueDidTlsCertificateOptions): IssuedDidTlsCertificate;
188
+ declare function parseDidTlsCertificate(certDerOrPem: Uint8Array | Buffer | string): ParsedDidTlsCertificate;
189
+ declare function verifyDidTlsCertificate(certDerOrPem: Uint8Array | Buffer | string, policy: DidTlsPeerVerifyPolicy): DidTlsVerificationResult;
190
+ declare function verifyDidTlsPeerCertificate(certDerOrPem: Uint8Array | Buffer | string, policy: DidTlsPeerVerifyPolicy): DidTlsVerificationResult;
191
+ //#endregion
192
+ export { DEFAULT_DID_TLS_CLOCK_SKEW_SECONDS, DID_TLS_BINDING_DOMAIN, DID_TLS_BINDING_PROOF_OID, DID_TLS_P256_HKDF_INFO_PREFIX, DID_TLS_P256_HKDF_SALT, DidTlsAllowedIssuerPinsInput, DidTlsEndpointRole, DidTlsKeyUsageFlags, DidTlsPeerVerifyPolicy, DidTlsRejectReason, DidTlsRole, DidTlsTrustPolicy, DidTlsVerificationResult, DidTlsWireAlgorithm, IssueDidTlsCertificateOptions, IssuedDidTlsCertificate, MAX_CERT_BYTES, MAX_DID_TLS_CERT_BYTES, MAX_DID_TLS_DID_LENGTH, MAX_DID_TLS_PEM_CHARS, ParsedDidBindingProof, ParsedDidTlsCertificate, canonicalizeTlsDid, decodeEd25519PublicKeyPin, deriveDidTlsP256KeyPair, deriveEd25519PublicKeyFromSeed, didTlsBytesToHex, didTlsHexToBytes, extractEd25519SeedFromSecretKey, isValidW3cDidSyntax, issueDidTlsCertificate, parseDidTlsCertificate, verifyDidTlsCertificate, verifyDidTlsPeerCertificate };
package/lib/env.cjs CHANGED
@@ -1,5 +1,11 @@
1
1
  const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
2
+ const require_did_tls = require('./did-tls.cjs');
3
+ const require_mesh_egress = require('./mesh-egress.cjs');
2
4
  let _ocap_util_lib_error = require("@ocap/util/lib/error");
5
+ let node_fs = require("node:fs");
6
+ node_fs = require_rolldown_runtime.__toESM(node_fs);
7
+ let node_path = require("node:path");
8
+ node_path = require_rolldown_runtime.__toESM(node_path);
3
9
  let _arcblock_ledger_core = require("@arcblock/ledger-core");
4
10
  let _arcblock_ledger_sqlite = require("@arcblock/ledger-sqlite");
5
11
 
@@ -83,6 +89,7 @@ function roleConfigFromEnv(env, options) {
83
89
  if (!env || typeof env !== "object") throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", "roleConfigFromEnv requires an explicit env record");
84
90
  const resolved = (0, _arcblock_ledger_core.resolveNodeRoleConfig)(env);
85
91
  const allowPrivatePeers = parseBoolEnv(env.ALLOW_PRIVATE_PEER_URLS);
92
+ const meshEgress = require_mesh_egress.parseMeshEgressUrl(env.ARC_MESH_EGRESS_URL, "ARC_MESH_EGRESS_URL");
86
93
  const explicitOrEnvSigner = resolveSignerFromEnvRecord(env, options?.signer);
87
94
  if (resolved.role === "validator") {
88
95
  if (!explicitOrEnvSigner) throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", "Validator role requires options.signer or explicit CHAIN_CONSENSUS_SK + CHAIN_CONSENSUS_PROPOSER in env");
@@ -99,6 +106,7 @@ function roleConfigFromEnv(env, options) {
99
106
  allowPublicConsensusBind: resolved.allowPublicConsensusBind,
100
107
  writePolicy: resolved.writePolicy,
101
108
  allowPrivatePeers,
109
+ ...meshEgress ? { meshEgressUrl: meshEgress.normalizedUrl } : {},
102
110
  retentionMode: resolved.retentionMode,
103
111
  hotWindowEntries: resolved.hotWindowEntries,
104
112
  hotWindowCheckpoints: resolved.hotWindowCheckpoints,
@@ -135,11 +143,16 @@ function roleConfigFromEnv(env, options) {
135
143
  clusterPeerUrls: resolved.clusterPeerUrls,
136
144
  snapshotBaseUrl: resolved.snapshotBaseUrl,
137
145
  ...snapshotPrefix ? { snapshotPrefix } : {},
146
+ ...resolved.bootstrapSource ? { bootstrapSource: resolved.bootstrapSource } : {},
147
+ ...resolved.da ? { da: resolved.da } : {},
148
+ ...resolved.daCrossCheck ? { daCrossCheck: resolved.daCrossCheck } : {},
149
+ ...resolved.daCrossCheckIncomplete ? { daCrossCheckIncomplete: resolved.daCrossCheckIncomplete } : {},
138
150
  trustedProposer: resolved.trustedProposer,
139
151
  trustedProposerPublicKey: resolved.trustedProposerPublicKey,
140
152
  ...resolved.hotstuffValidators.length > 0 ? { hotstuffValidators: resolved.hotstuffValidators } : {},
141
153
  ...resolved.hotstuffQuorumThreshold !== void 0 ? { hotstuffQuorumThreshold: resolved.hotstuffQuorumThreshold } : {},
142
154
  allowPrivatePeers,
155
+ ...meshEgress ? { meshEgressUrl: meshEgress.normalizedUrl } : {},
143
156
  disallowKeylessCascadedUpstream,
144
157
  allowUnauthenticatedBootstrap: resolved.allowUnauthenticatedBootstrap,
145
158
  syncMode: resolved.syncMode,
@@ -171,6 +184,120 @@ function leaseConfigFromEnv(env) {
171
184
  startupWaitMs: parsed.startupWaitMs
172
185
  };
173
186
  }
187
+ function parseOptionalStrictBool(raw, label) {
188
+ const norm = (raw ?? "").trim().toLowerCase();
189
+ if (!norm) return void 0;
190
+ if (norm === "1" || norm === "true") return true;
191
+ if (norm === "0" || norm === "false") return false;
192
+ throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", `Invalid ${label}="${raw}": expected 1/true or 0/false`);
193
+ }
194
+ function parseCsvEnvList(raw) {
195
+ if (!raw) return [];
196
+ return raw.split(",").map((s) => s.trim()).filter(Boolean);
197
+ }
198
+ const DARWIN_OS_ROOT_SYMLINKS = new Set([
199
+ "/var",
200
+ "/tmp",
201
+ "/etc"
202
+ ]);
203
+ /**
204
+ * Walk every existing path component from filesystem root down to `resolvedPath` via `lstatSync`
205
+ * and refuse any symlinked directory or leaf (exempting only macOS depth-1 OS symlinks `/var`, `/tmp`, `/etc`).
206
+ */
207
+ function assertNoSymlinkAncestors(resolvedPath, label) {
208
+ const parsed = node_path.default.parse(resolvedPath);
209
+ const parts = resolvedPath.slice(parsed.root.length).split(node_path.default.sep).filter(Boolean);
210
+ let cur = parsed.root;
211
+ for (let i = 0; i < parts.length; i++) {
212
+ cur = node_path.default.join(cur, parts[i]);
213
+ let st;
214
+ try {
215
+ st = node_fs.default.lstatSync(cur);
216
+ } catch (err) {
217
+ if (err?.code === "ENOENT") break;
218
+ throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", `Cannot stat path component for ${label} (${cur}): ${err?.code || "EIO"}`);
219
+ }
220
+ if (st.isSymbolicLink()) {
221
+ if (process.platform === "darwin" && i === 0 && DARWIN_OS_ROOT_SYMLINKS.has(cur)) continue;
222
+ throw new _ocap_util_lib_error.CustomError("SECURITY_VIOLATION", `Refusing symlinked path component in ${label}: ${cur}`);
223
+ }
224
+ }
225
+ }
226
+ function assertNonSymlinkRegularFilePath(rawPath, label) {
227
+ const resolved = node_path.default.resolve(rawPath.trim());
228
+ assertNoSymlinkAncestors(resolved, label);
229
+ let stat;
230
+ try {
231
+ stat = node_fs.default.lstatSync(resolved);
232
+ } catch (err) {
233
+ throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", `${label} file does not exist or cannot be stat'd (${resolved}): ${err?.code || "ENOENT"}`);
234
+ }
235
+ if (stat.isSymbolicLink()) throw new _ocap_util_lib_error.CustomError("SECURITY_VIOLATION", `Refusing symlinked ${label} file: ${resolved}`);
236
+ if (!stat.isFile()) throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", `${label} must point to a regular file: ${resolved}`);
237
+ return resolved;
238
+ }
239
+ /**
240
+ * Pure environment-to-`ARC_MESH_EGRESS_URL` parser (`@ocap/chain-node`, #2025).
241
+ * Reads ONLY the explicitly supplied `env` dictionary.
242
+ */
243
+ function meshEgressUrlFromEnv(env) {
244
+ if (!env || typeof env !== "object") throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", "meshEgressUrlFromEnv requires an explicit env record");
245
+ return require_mesh_egress.parseMeshEgressUrl(env.ARC_MESH_EGRESS_URL, "ARC_MESH_EGRESS_URL")?.normalizedUrl;
246
+ }
247
+ /**
248
+ * Pure environment-to-DID-TLS/mTLS listener parser (`@ocap/chain-node`, #2025).
249
+ * Reads ONLY the explicitly supplied `env` dictionary — zero implicit `process.env` reads.
250
+ */
251
+ function tlsConfigFromEnv(env) {
252
+ if (!env || typeof env !== "object") throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", "tlsConfigFromEnv requires an explicit env record");
253
+ const enabled = parseOptionalStrictBool(env.RPC_TLS_ENABLED, "RPC_TLS_ENABLED");
254
+ if (!enabled) return enabled === false ? { enabled: false } : void 0;
255
+ const rawWire = (env.RPC_TLS_WIRE_ALGORITHM ?? "").trim().toLowerCase();
256
+ let wireAlgorithm = "p256";
257
+ if (rawWire) {
258
+ if (rawWire !== "ed25519" && rawWire !== "p256") throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", `Unsupported RPC_TLS_WIRE_ALGORITHM="${env.RPC_TLS_WIRE_ALGORITHM}": expected ed25519 or p256`);
259
+ wireAlgorithm = rawWire;
260
+ }
261
+ const requireClientCert = parseOptionalStrictBool(env.RPC_TLS_REQUIRE_CLIENT_CERT, "RPC_TLS_REQUIRE_CLIENT_CERT") ?? true;
262
+ const rawIssuerPins = parseCsvEnvList(env.RPC_TLS_ALLOWED_ISSUER_PKS);
263
+ for (const item of rawIssuerPins) try {
264
+ if (item.includes("=")) {
265
+ const eq = item.indexOf("=");
266
+ require_did_tls.canonicalizeTlsDid(item.slice(0, eq), "RPC_TLS_ALLOWED_ISSUER_PKS DID");
267
+ require_did_tls.decodeEd25519PublicKeyPin(item.slice(eq + 1), "RPC_TLS_ALLOWED_ISSUER_PKS pubkey");
268
+ } else require_did_tls.decodeEd25519PublicKeyPin(item, "RPC_TLS_ALLOWED_ISSUER_PKS pubkey");
269
+ } catch (err) {
270
+ throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", `Invalid entry in RPC_TLS_ALLOWED_ISSUER_PKS: ${err instanceof Error ? err.message : String(err)}`);
271
+ }
272
+ if (requireClientCert && rawIssuerPins.length === 0) throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", "RPC_TLS_ENABLED=1 with RPC_TLS_REQUIRE_CLIENT_CERT=true requires at least one pinned Ed25519 key in RPC_TLS_ALLOWED_ISSUER_PKS");
273
+ const rawClientDids = parseCsvEnvList(env.RPC_TLS_ALLOWED_CLIENT_DIDS);
274
+ const allowedClientDids = [];
275
+ for (const did of rawClientDids) try {
276
+ allowedClientDids.push(require_did_tls.canonicalizeTlsDid(did, "RPC_TLS_ALLOWED_CLIENT_DIDS"));
277
+ } catch (err) {
278
+ throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", `Invalid DID in RPC_TLS_ALLOWED_CLIENT_DIDS: ${err instanceof Error ? err.message : String(err)}`);
279
+ }
280
+ const sanDnsNames = parseCsvEnvList(env.RPC_TLS_SAN_DNS);
281
+ const sanIpAddresses = parseCsvEnvList(env.RPC_TLS_SAN_IPS);
282
+ const rawCertFile = (env.RPC_TLS_CERT_FILE ?? "").trim();
283
+ const rawKeyFile = (env.RPC_TLS_KEY_FILE ?? "").trim();
284
+ if (Boolean(rawCertFile) !== Boolean(rawKeyFile)) throw new _ocap_util_lib_error.CustomError("INVALID_CONFIG", "RPC_TLS_CERT_FILE and RPC_TLS_KEY_FILE must both be set together when overriding DID-TLS credentials");
285
+ const certFile = rawCertFile ? assertNonSymlinkRegularFilePath(rawCertFile, "RPC_TLS_CERT_FILE") : void 0;
286
+ const keyFile = rawKeyFile ? assertNonSymlinkRegularFilePath(rawKeyFile, "RPC_TLS_KEY_FILE") : void 0;
287
+ const chainSk = (env.CHAIN_SK ?? "").trim() || void 0;
288
+ return {
289
+ enabled: true,
290
+ wireAlgorithm,
291
+ requireClientCert,
292
+ allowedIssuerPublicKeys: rawIssuerPins,
293
+ ...allowedClientDids.length > 0 ? { allowedClientDids } : {},
294
+ ...sanDnsNames.length > 0 ? { sanDnsNames } : {},
295
+ ...sanIpAddresses.length > 0 ? { sanIpAddresses } : {},
296
+ ...certFile ? { certFile } : {},
297
+ ...keyFile ? { keyFile } : {},
298
+ ...chainSk ? { identitySecretKey: chainSk } : {}
299
+ };
300
+ }
174
301
  /**
175
302
  * Install idempotent `SIGTERM` / `SIGINT` graceful shutdown handlers for a running chain node.
176
303
  * Returns a cleanup callback that removes the signal listeners.
@@ -216,6 +343,9 @@ function installProcessSignalHandlers(node, options) {
216
343
  }
217
344
 
218
345
  //#endregion
346
+ exports.assertNoSymlinkAncestors = assertNoSymlinkAncestors;
219
347
  exports.installProcessSignalHandlers = installProcessSignalHandlers;
220
348
  exports.leaseConfigFromEnv = leaseConfigFromEnv;
221
- exports.roleConfigFromEnv = roleConfigFromEnv;
349
+ exports.meshEgressUrlFromEnv = meshEgressUrlFromEnv;
350
+ exports.roleConfigFromEnv = roleConfigFromEnv;
351
+ exports.tlsConfigFromEnv = tlsConfigFromEnv;
package/lib/env.d.cts CHANGED
@@ -1,4 +1,4 @@
1
- import { ChainNodeRoleConfig, ILedgerLeaseOptions, RunningChainNode, ValidatorSignerConfig } from "./types.cjs";
1
+ import { ChainHttpTlsConfig, ChainNodeRoleConfig, ILedgerLeaseOptions, RunningChainNode, ValidatorSignerConfig } from "./types.cjs";
2
2
 
3
3
  //#region src/env.d.ts
4
4
 
@@ -16,6 +16,21 @@ declare function roleConfigFromEnv(env: Record<string, string | undefined>, opti
16
16
  * Reads ONLY the explicitly supplied `env` dictionary — zero implicit `process.env` reads.
17
17
  */
18
18
  declare function leaseConfigFromEnv(env: Record<string, string | undefined>): ILedgerLeaseOptions | false;
19
+ /**
20
+ * Walk every existing path component from filesystem root down to `resolvedPath` via `lstatSync`
21
+ * and refuse any symlinked directory or leaf (exempting only macOS depth-1 OS symlinks `/var`, `/tmp`, `/etc`).
22
+ */
23
+ declare function assertNoSymlinkAncestors(resolvedPath: string, label: string): void;
24
+ /**
25
+ * Pure environment-to-`ARC_MESH_EGRESS_URL` parser (`@ocap/chain-node`, #2025).
26
+ * Reads ONLY the explicitly supplied `env` dictionary.
27
+ */
28
+ declare function meshEgressUrlFromEnv(env: Record<string, string | undefined>): string | undefined;
29
+ /**
30
+ * Pure environment-to-DID-TLS/mTLS listener parser (`@ocap/chain-node`, #2025).
31
+ * Reads ONLY the explicitly supplied `env` dictionary — zero implicit `process.env` reads.
32
+ */
33
+ declare function tlsConfigFromEnv(env: Record<string, string | undefined>): ChainHttpTlsConfig | undefined;
19
34
  interface InstallProcessSignalHandlersOptions {
20
35
  timeoutMs?: number;
21
36
  signals?: NodeJS.Signals[];
@@ -29,4 +44,4 @@ interface InstallProcessSignalHandlersOptions {
29
44
  */
30
45
  declare function installProcessSignalHandlers(node: Pick<RunningChainNode, 'stop'>, options?: InstallProcessSignalHandlersOptions): () => void;
31
46
  //#endregion
32
- export { InstallProcessSignalHandlersOptions, installProcessSignalHandlers, leaseConfigFromEnv, roleConfigFromEnv };
47
+ export { InstallProcessSignalHandlersOptions, assertNoSymlinkAncestors, installProcessSignalHandlers, leaseConfigFromEnv, meshEgressUrlFromEnv, roleConfigFromEnv, tlsConfigFromEnv };
@@ -31,16 +31,24 @@ function mergeTransactionOverlay(base, overlay) {
31
31
  * variables from env (e.g. CHAIN_TX_BRIDGE_ENABLED): the stored row is not rewritten on a ledger-anchored leader
32
32
  * restart, so it still holds the values of the last genesis/config write.
33
33
  */
34
- function rehydrateFollowerChainConfig(storedChain, profileChainConfig) {
34
+ function rehydrateFollowerChainConfig(storedChain, profileChainConfig, extraReservedSymbols) {
35
35
  const storedChainPartial = storedChain;
36
36
  const storedChainId = typeof storedChainPartial.chainId === "string" ? storedChainPartial.chainId.trim() : "";
37
37
  const baseSymbol = storedChainPartial.token?.symbol || "TBA";
38
- const reservedSymbols = Array.from(new Set([baseSymbol, ...storedChainPartial.reservedSymbols ?? []].map((s) => String(s || "").trim().toUpperCase()).filter(Boolean)));
38
+ const reservedSymbols = Array.from(new Set([
39
+ baseSymbol,
40
+ ...storedChainPartial.reservedSymbols ?? [],
41
+ ...profileChainConfig?.reservedSymbols ?? [],
42
+ ...extraReservedSymbols ?? []
43
+ ].map((s) => String(s || "").trim().toUpperCase()).filter(Boolean)));
39
44
  const transactionOverlay = isPlainRecord(profileChainConfig?.transaction) ? profileChainConfig.transaction : void 0;
45
+ const storedTransaction = isPlainRecord(storedChainPartial.transaction) ? { ...storedChainPartial.transaction } : storedChainPartial.transaction;
46
+ if (isPlainRecord(storedTransaction)) delete storedTransaction.maxTxSize;
47
+ const transaction = transactionOverlay ? mergeTransactionOverlay(storedTransaction, transactionOverlay) : storedTransaction;
40
48
  return _ocap_config.create({
41
49
  ...storedChain,
42
50
  ...storedChainId ? { chainId: storedChainId } : {},
43
- ...transactionOverlay ? { transaction: mergeTransactionOverlay(storedChainPartial.transaction, transactionOverlay) } : {},
51
+ ...transaction !== void 0 ? { transaction } : {},
44
52
  reservedSymbols
45
53
  });
46
54
  }
@@ -54,10 +62,29 @@ function toResolverConfig(config) {
54
62
  if (tokenItx) validated.token.address = tokenItx.address;
55
63
  return validated;
56
64
  }
65
+ /**
66
+ * First ledger sequence whose orphan entries (finalized, no stateCommitHash, no statedb tx row) the chain's leader
67
+ * indexed. Leaders index the orphans they produce since 1.31.1 (#1387); before that they never did, and a follower
68
+ * index must hold exactly what the leader's holds (#1875). Values read from the leaders' indexdb: the first orphan
69
+ * with an index row, every earlier one without (beta: last unindexed 437972; main: last unindexed 832519). A chain
70
+ * started on 1.31.1+ indexed all of them.
71
+ */
72
+ const ORPHAN_INDEX_FROM_SEQUENCE = Object.freeze({
73
+ beta: 437983,
74
+ "xenon-2020-01-15": 832598
75
+ });
76
+ function orphanIndexFromSequence(chainId, override) {
77
+ if (override !== void 0) {
78
+ if (!Number.isSafeInteger(override) || override < 1) throw new Error(`orphanIndexFromSequence must be a positive integer, got ${String(override)}`);
79
+ return override;
80
+ }
81
+ return Object.hasOwn(ORPHAN_INDEX_FROM_SEQUENCE, chainId) ? ORPHAN_INDEX_FROM_SEQUENCE[chainId] ?? 1 : 1;
82
+ }
57
83
 
58
84
  //#endregion
59
85
  exports.isCompleteChainConfig = isCompleteChainConfig;
60
86
  exports.isPlainRecord = isPlainRecord;
61
87
  exports.mergeTransactionOverlay = mergeTransactionOverlay;
88
+ exports.orphanIndexFromSequence = orphanIndexFromSequence;
62
89
  exports.rehydrateFollowerChainConfig = rehydrateFollowerChainConfig;
63
90
  exports.toResolverConfig = toResolverConfig;
@@ -15,11 +15,12 @@ declare function mergeTransactionOverlay(base: unknown, overlay: unknown): unkno
15
15
  * variables from env (e.g. CHAIN_TX_BRIDGE_ENABLED): the stored row is not rewritten on a ledger-anchored leader
16
16
  * restart, so it still holds the values of the last genesis/config write.
17
17
  */
18
- declare function rehydrateFollowerChainConfig(storedChain: unknown, profileChainConfig?: Partial<IChainConfig>): IChainConfig;
18
+ declare function rehydrateFollowerChainConfig(storedChain: unknown, profileChainConfig?: Partial<IChainConfig>, extraReservedSymbols?: readonly string[]): IChainConfig;
19
19
  /**
20
20
  * The config a resolver actually runs with (`OCAPResolver` constructor): validated, with `token.address` set to the
21
21
  * genesis token address. This is what the leader's `getConfig` returns and what the follower's replayer reads.
22
22
  */
23
23
  declare function toResolverConfig(config: IChainConfig): IChainConfig;
24
+ declare function orphanIndexFromSequence(chainId: string, override?: number): number;
24
25
  //#endregion
25
- export { isCompleteChainConfig, isPlainRecord, mergeTransactionOverlay, rehydrateFollowerChainConfig, toResolverConfig };
26
+ export { isCompleteChainConfig, isPlainRecord, mergeTransactionOverlay, orphanIndexFromSequence, rehydrateFollowerChainConfig, toResolverConfig };
package/lib/index.cjs CHANGED
@@ -1,4 +1,6 @@
1
1
  const require_config_consistency = require('./config-consistency.cjs');
2
+ const require_did_tls = require('./did-tls.cjs');
3
+ const require_mesh_egress = require('./mesh-egress.cjs');
2
4
  const require_env = require('./env.cjs');
3
5
  const require_follower_config = require('./follower-config.cjs');
4
6
  const require_start_chain_node = require('./start-chain-node.cjs');
@@ -7,18 +9,41 @@ const require_standalone_env = require('./standalone-env.cjs');
7
9
  exports.BLOCKLET_ENV_CHAIN_FALLBACKS = require_standalone_env.BLOCKLET_ENV_CHAIN_FALLBACKS;
8
10
  exports.CONSENSUS_CONFIG_KEYS = require_config_consistency.CONSENSUS_CONFIG_KEYS;
9
11
  exports.DEFAULT_CONFIG_CHECK_TIMEOUT_SECONDS = require_standalone_env.DEFAULT_CONFIG_CHECK_TIMEOUT_SECONDS;
12
+ exports.DEFAULT_DID_TLS_CLOCK_SKEW_SECONDS = require_did_tls.DEFAULT_DID_TLS_CLOCK_SKEW_SECONDS;
10
13
  exports.DEFAULT_FUTURE_TIMESTAMP_SKEW_SECONDS = require_standalone_env.DEFAULT_FUTURE_TIMESTAMP_SKEW_SECONDS;
14
+ exports.DID_TLS_BINDING_DOMAIN = require_did_tls.DID_TLS_BINDING_DOMAIN;
15
+ exports.DID_TLS_BINDING_PROOF_OID = require_did_tls.DID_TLS_BINDING_PROOF_OID;
16
+ exports.DID_TLS_P256_HKDF_INFO_PREFIX = require_did_tls.DID_TLS_P256_HKDF_INFO_PREFIX;
17
+ exports.DID_TLS_P256_HKDF_SALT = require_did_tls.DID_TLS_P256_HKDF_SALT;
18
+ exports.MAX_CERT_BYTES = require_did_tls.MAX_CERT_BYTES;
19
+ exports.MAX_DID_TLS_CERT_BYTES = require_did_tls.MAX_DID_TLS_CERT_BYTES;
20
+ exports.MAX_DID_TLS_DID_LENGTH = require_did_tls.MAX_DID_TLS_DID_LENGTH;
21
+ exports.MAX_DID_TLS_PEM_CHARS = require_did_tls.MAX_DID_TLS_PEM_CHARS;
11
22
  exports.STANDALONE_ENV_MARKERS = require_standalone_env.STANDALONE_ENV_MARKERS;
12
23
  exports.TRANSACTION_SWITCH_ENV = require_standalone_env.TRANSACTION_SWITCH_ENV;
24
+ exports.assertNoSymlinkAncestors = require_env.assertNoSymlinkAncestors;
25
+ exports.canonicalizeTlsDid = require_did_tls.canonicalizeTlsDid;
26
+ exports.createChainNodePeerFetchGuard = require_mesh_egress.createChainNodePeerFetchGuard;
27
+ exports.decodeEd25519PublicKeyPin = require_did_tls.decodeEd25519PublicKeyPin;
28
+ exports.deriveDidTlsP256KeyPair = require_did_tls.deriveDidTlsP256KeyPair;
29
+ exports.deriveEd25519PublicKeyFromSeed = require_did_tls.deriveEd25519PublicKeyFromSeed;
30
+ exports.didTlsBytesToHex = require_did_tls.didTlsBytesToHex;
31
+ exports.didTlsHexToBytes = require_did_tls.didTlsHexToBytes;
13
32
  exports.diffConsensusConfig = require_config_consistency.diffConsensusConfig;
33
+ exports.extractEd25519SeedFromSecretKey = require_did_tls.extractEd25519SeedFromSecretKey;
14
34
  exports.fetchUpstreamChainConfig = require_config_consistency.fetchUpstreamChainConfig;
15
35
  exports.findBlockletEnvLeftovers = require_standalone_env.findBlockletEnvLeftovers;
16
36
  exports.formatBlockletEnvLeftoversWarning = require_standalone_env.formatBlockletEnvLeftoversWarning;
17
37
  exports.formatConfigDifferences = require_config_consistency.formatConfigDifferences;
18
38
  exports.installProcessSignalHandlers = require_env.installProcessSignalHandlers;
19
39
  exports.isCompleteChainConfig = require_follower_config.isCompleteChainConfig;
40
+ exports.isValidW3cDidSyntax = require_did_tls.isValidW3cDidSyntax;
41
+ exports.issueDidTlsCertificate = require_did_tls.issueDidTlsCertificate;
20
42
  exports.leaseConfigFromEnv = require_env.leaseConfigFromEnv;
43
+ exports.meshEgressUrlFromEnv = require_env.meshEgressUrlFromEnv;
21
44
  exports.normalizeConsensusConfig = require_config_consistency.normalizeConsensusConfig;
45
+ exports.parseDidTlsCertificate = require_did_tls.parseDidTlsCertificate;
46
+ exports.parseMeshEgressUrl = require_mesh_egress.parseMeshEgressUrl;
22
47
  exports.parseNonNegativeNumberEnv = require_standalone_env.parseNonNegativeNumberEnv;
23
48
  exports.rehydrateFollowerChainConfig = require_follower_config.rehydrateFollowerChainConfig;
24
49
  exports.resolveConfigCheckModeFromEnv = require_standalone_env.resolveConfigCheckModeFromEnv;
@@ -28,5 +53,9 @@ exports.resolveTransactionSwitchesFromEnv = require_standalone_env.resolveTransa
28
53
  exports.resolveTrustedSubject = require_standalone_env.resolveTrustedSubject;
29
54
  exports.roleConfigFromEnv = require_env.roleConfigFromEnv;
30
55
  exports.startChainNode = require_start_chain_node.startChainNode;
56
+ exports.tlsConfigFromEnv = require_env.tlsConfigFromEnv;
31
57
  exports.toResolverConfig = require_follower_config.toResolverConfig;
32
- exports.verifyFollowerConfigAgainstUpstream = require_config_consistency.verifyFollowerConfigAgainstUpstream;
58
+ exports.verifyDidTlsCertificate = require_did_tls.verifyDidTlsCertificate;
59
+ exports.verifyDidTlsPeerCertificate = require_did_tls.verifyDidTlsPeerCertificate;
60
+ exports.verifyFollowerConfigAgainstUpstream = require_config_consistency.verifyFollowerConfigAgainstUpstream;
61
+ exports.writeFileDurably = require_start_chain_node.writeFileDurably;
package/lib/index.d.cts CHANGED
@@ -1,7 +1,9 @@
1
1
  import { BLOCKLET_ENV_CHAIN_FALLBACKS, BlockletEnvLeftovers, DEFAULT_CONFIG_CHECK_TIMEOUT_SECONDS, DEFAULT_FUTURE_TIMESTAMP_SKEW_SECONDS, FutureTimestampGuardConfig, STANDALONE_ENV_MARKERS, TChainConfigCheckMode, TRANSACTION_SWITCH_ENV, TransactionSwitches, findBlockletEnvLeftovers, formatBlockletEnvLeftoversWarning, parseNonNegativeNumberEnv, resolveConfigCheckModeFromEnv, resolveConfigCheckTimeoutMsFromEnv, resolveFutureTimestampGuardFromEnv, resolveTransactionSwitchesFromEnv, resolveTrustedSubject } from "./standalone-env.cjs";
2
2
  import { CONSENSUS_CONFIG_KEYS, ConfigDifference, VerifyFollowerConfigOptions, VerifyFollowerConfigResult, diffConsensusConfig, fetchUpstreamChainConfig, formatConfigDifferences, normalizeConsensusConfig, verifyFollowerConfigAgainstUpstream } from "./config-consistency.cjs";
3
- import { ChainAppHookContext, ChainNodeHandle, ChainNodeProfile, ChainNodeRoleConfig, ChainNodeSegmentPublisher, ChainNodeSignerConfig, ChainNodeTestHooks, ChainNodeTestHooksInput, ChainProfile, ChainProfileBase, FollowerRoleConfig, FollowerSyncTestController, FollowerUpstreamInterceptorContext, HotStuffValidatorRoleConfig, ILedgerHealthStatus, ILedgerLeaseOptions, PublicKeyOnlyValidatorSignerConfig, RunningChainNode, StartChainNodeOptions, TNodeRetentionMode, TrustedAccountConfig, ValidatorRoleConfig, ValidatorSignerConfig } from "./types.cjs";
4
- import { InstallProcessSignalHandlersOptions, installProcessSignalHandlers, leaseConfigFromEnv, roleConfigFromEnv } from "./env.cjs";
3
+ import { DEFAULT_DID_TLS_CLOCK_SKEW_SECONDS, DID_TLS_BINDING_DOMAIN, DID_TLS_BINDING_PROOF_OID, DID_TLS_P256_HKDF_INFO_PREFIX, DID_TLS_P256_HKDF_SALT, DidTlsAllowedIssuerPinsInput, DidTlsEndpointRole, DidTlsKeyUsageFlags, DidTlsPeerVerifyPolicy, DidTlsRejectReason, DidTlsRole, DidTlsTrustPolicy, DidTlsVerificationResult, DidTlsWireAlgorithm, IssueDidTlsCertificateOptions, IssuedDidTlsCertificate, MAX_CERT_BYTES, MAX_DID_TLS_CERT_BYTES, MAX_DID_TLS_DID_LENGTH, MAX_DID_TLS_PEM_CHARS, ParsedDidBindingProof, ParsedDidTlsCertificate, canonicalizeTlsDid, decodeEd25519PublicKeyPin, deriveDidTlsP256KeyPair, deriveEd25519PublicKeyFromSeed, didTlsBytesToHex, didTlsHexToBytes, extractEd25519SeedFromSecretKey, isValidW3cDidSyntax, issueDidTlsCertificate, parseDidTlsCertificate, verifyDidTlsCertificate, verifyDidTlsPeerCertificate } from "./did-tls.cjs";
4
+ import { ChainAppHookContext, ChainHttpTlsConfig, ChainNodeHandle, ChainNodeProfile, ChainNodeRoleConfig, ChainNodeSegmentPublisher, ChainNodeSignerConfig, ChainNodeTestHooks, ChainNodeTestHooksInput, ChainProfile, ChainProfileBase, FollowerRoleConfig, FollowerSyncTestController, FollowerUpstreamInterceptorContext, HotStuffValidatorRoleConfig, ILedgerHealthStatus, ILedgerLeaseOptions, PublicKeyOnlyValidatorSignerConfig, ReloadedTlsCredentialsInfo, RunningChainNode, StartChainNodeOptions, TNodeRetentionMode, TrustedAccountConfig, ValidatorRoleConfig, ValidatorSignerConfig } from "./types.cjs";
5
+ import { InstallProcessSignalHandlersOptions, assertNoSymlinkAncestors, installProcessSignalHandlers, leaseConfigFromEnv, meshEgressUrlFromEnv, roleConfigFromEnv, tlsConfigFromEnv } from "./env.cjs";
5
6
  import { isCompleteChainConfig, rehydrateFollowerChainConfig, toResolverConfig } from "./follower-config.cjs";
6
- import { startChainNode } from "./start-chain-node.cjs";
7
- export { BLOCKLET_ENV_CHAIN_FALLBACKS, type BlockletEnvLeftovers, CONSENSUS_CONFIG_KEYS, type ChainAppHookContext, type ChainNodeHandle, type ChainNodeProfile, type ChainNodeRoleConfig, type ChainNodeSegmentPublisher, type ChainNodeSignerConfig, type ChainNodeTestHooks, type ChainNodeTestHooksInput, type ChainProfile, type ChainProfileBase, type ConfigDifference, DEFAULT_CONFIG_CHECK_TIMEOUT_SECONDS, DEFAULT_FUTURE_TIMESTAMP_SKEW_SECONDS, type FollowerRoleConfig, type FollowerSyncTestController, type FollowerUpstreamInterceptorContext, type FutureTimestampGuardConfig, type HotStuffValidatorRoleConfig, type ILedgerHealthStatus, type ILedgerLeaseOptions, type InstallProcessSignalHandlersOptions, type PublicKeyOnlyValidatorSignerConfig, type RunningChainNode, STANDALONE_ENV_MARKERS, type StartChainNodeOptions, type TChainConfigCheckMode, type TNodeRetentionMode, TRANSACTION_SWITCH_ENV, type TransactionSwitches, type TrustedAccountConfig, type ValidatorRoleConfig, type ValidatorSignerConfig, type VerifyFollowerConfigOptions, type VerifyFollowerConfigResult, diffConsensusConfig, fetchUpstreamChainConfig, findBlockletEnvLeftovers, formatBlockletEnvLeftoversWarning, formatConfigDifferences, installProcessSignalHandlers, isCompleteChainConfig, leaseConfigFromEnv, normalizeConsensusConfig, parseNonNegativeNumberEnv, rehydrateFollowerChainConfig, resolveConfigCheckModeFromEnv, resolveConfigCheckTimeoutMsFromEnv, resolveFutureTimestampGuardFromEnv, resolveTransactionSwitchesFromEnv, resolveTrustedSubject, roleConfigFromEnv, startChainNode, toResolverConfig, verifyFollowerConfigAgainstUpstream };
7
+ import { startChainNode, writeFileDurably } from "./start-chain-node.cjs";
8
+ import { ValidatedMeshEgress, createChainNodePeerFetchGuard, parseMeshEgressUrl } from "./mesh-egress.cjs";
9
+ export { BLOCKLET_ENV_CHAIN_FALLBACKS, type BlockletEnvLeftovers, CONSENSUS_CONFIG_KEYS, type ChainAppHookContext, type ChainHttpTlsConfig, type ChainNodeHandle, type ChainNodeProfile, type ChainNodeRoleConfig, type ChainNodeSegmentPublisher, type ChainNodeSignerConfig, type ChainNodeTestHooks, type ChainNodeTestHooksInput, type ChainProfile, type ChainProfileBase, type ConfigDifference, DEFAULT_CONFIG_CHECK_TIMEOUT_SECONDS, DEFAULT_DID_TLS_CLOCK_SKEW_SECONDS, DEFAULT_FUTURE_TIMESTAMP_SKEW_SECONDS, DID_TLS_BINDING_DOMAIN, DID_TLS_BINDING_PROOF_OID, DID_TLS_P256_HKDF_INFO_PREFIX, DID_TLS_P256_HKDF_SALT, type DidTlsAllowedIssuerPinsInput, type DidTlsEndpointRole, type DidTlsKeyUsageFlags, type DidTlsPeerVerifyPolicy, type DidTlsRejectReason, type DidTlsRole, type DidTlsTrustPolicy, type DidTlsVerificationResult, type DidTlsWireAlgorithm, type FollowerRoleConfig, type FollowerSyncTestController, type FollowerUpstreamInterceptorContext, type FutureTimestampGuardConfig, type HotStuffValidatorRoleConfig, type ILedgerHealthStatus, type ILedgerLeaseOptions, type InstallProcessSignalHandlersOptions, type IssueDidTlsCertificateOptions, type IssuedDidTlsCertificate, MAX_CERT_BYTES, MAX_DID_TLS_CERT_BYTES, MAX_DID_TLS_DID_LENGTH, MAX_DID_TLS_PEM_CHARS, type ParsedDidBindingProof, type ParsedDidTlsCertificate, type PublicKeyOnlyValidatorSignerConfig, type ReloadedTlsCredentialsInfo, type RunningChainNode, STANDALONE_ENV_MARKERS, type StartChainNodeOptions, type TChainConfigCheckMode, type TNodeRetentionMode, TRANSACTION_SWITCH_ENV, type TransactionSwitches, type TrustedAccountConfig, type ValidatedMeshEgress, type ValidatorRoleConfig, type ValidatorSignerConfig, type VerifyFollowerConfigOptions, type VerifyFollowerConfigResult, assertNoSymlinkAncestors, canonicalizeTlsDid, createChainNodePeerFetchGuard, decodeEd25519PublicKeyPin, deriveDidTlsP256KeyPair, deriveEd25519PublicKeyFromSeed, didTlsBytesToHex, didTlsHexToBytes, diffConsensusConfig, extractEd25519SeedFromSecretKey, fetchUpstreamChainConfig, findBlockletEnvLeftovers, formatBlockletEnvLeftoversWarning, formatConfigDifferences, installProcessSignalHandlers, isCompleteChainConfig, isValidW3cDidSyntax, issueDidTlsCertificate, leaseConfigFromEnv, meshEgressUrlFromEnv, normalizeConsensusConfig, parseDidTlsCertificate, parseMeshEgressUrl, parseNonNegativeNumberEnv, rehydrateFollowerChainConfig, resolveConfigCheckModeFromEnv, resolveConfigCheckTimeoutMsFromEnv, resolveFutureTimestampGuardFromEnv, resolveTransactionSwitchesFromEnv, resolveTrustedSubject, roleConfigFromEnv, startChainNode, tlsConfigFromEnv, toResolverConfig, verifyDidTlsCertificate, verifyDidTlsPeerCertificate, verifyFollowerConfigAgainstUpstream, writeFileDurably };