@terminal3/t3n-sdk 4.22.0 → 4.23.1

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.
package/dist/index.d.ts CHANGED
@@ -4197,11 +4197,19 @@ declare function getNodeUrl(baseUrl?: string): string;
4197
4197
  * bundle (which changes over time as peer quotes replicate via
4198
4198
  * Raft), call `fetchDkgAttestation()` \u2014 that path is
4199
4199
  * intentionally uncached.
4200
+ *
4201
+ * Retries up to ENCAPS_KEY_RETRY_DELAYS_MS.length times with
4202
+ * exponential backoff to handle transient node-not-ready windows
4203
+ * (cold startup, rolling deploy). Each attempt is independently
4204
+ * subject to STATUS_FETCH_TIMEOUT_MS. 4xx client errors (bad URL,
4205
+ * auth) are permanent — they propagate immediately without retry.
4206
+ * Concurrent callers share a single in-flight promise so cold-start
4207
+ * traffic doesn't fan out to multiple /status sequences.
4200
4208
  */
4201
4209
  declare function fetchMlKemPublicKey(baseUrl?: string): Promise<string>;
4202
4210
  /**
4203
- * Fetch the DKG attestation bundle from `${nodeUrl}/status`. Never
4204
- * cached \u2014 peer quotes are written to consensus KV asynchronously
4211
+ * Fetch the DKG attestation bundle from `${nodeUrl}/status?attestation=1`.
4212
+ * Never cached \u2014 peer quotes are written to consensus KV asynchronously
4205
4213
  * during cluster bootstrap, so early reads may see a subset of the
4206
4214
  * expected quotes. Caching would pin an incomplete bundle and cause
4207
4215
  * spurious `valid_count < expected_count` failures in
@@ -4212,7 +4220,7 @@ declare function fetchMlKemPublicKey(baseUrl?: string): Promise<string>;
4212
4220
  * signer where attestation is skipped by design).
4213
4221
  */
4214
4222
  declare function fetchDkgAttestation(baseUrl?: string): Promise<DkgAttestation | undefined>;
4215
- /** Clear the cached ML-KEM public keys. Useful in tests. */
4223
+ /** Clear the cached ML-KEM public keys and any in-flight fetch promises. Useful in tests. */
4216
4224
  declare function clearKeyCache(): void;
4217
4225
  /**
4218
4226
  * Return the resolved SDK configuration for the current environment.