peerbit 5.3.5 → 5.3.7

package/dist/src/bootstrap-recovery.d.ts

@@ -0,0 +1,79 @@
+import type { Multiaddr } from "@multiformats/multiaddr";
+/**
+ * Automatic bootstrap recovery is opt-in so creating a Peerbit client keeps
+ * its existing no-network-side-effect behavior unless an application asks for
+ * recovery explicitly.
+ */
+export type BootstrapRecoveryOptions = {
+    /** Set to false to leave recovery disabled. Defaults to true for an options object. */
+    enabled?: boolean;
+    /**
+     * Fixed bootstrap targets. When omitted, every recovery attempt resolves the
+     * current public bootstrap list, including its canonical fallback source.
+     */
+    addresses?: Array<string | Multiaddr>;
+    /**
+     * Delay after the first failed attempt. Defaults to 1 second; maximum is
+     * 2,147,483,647 ms.
+     */
+    initialDelayMs?: number;
+    /**
+     * Maximum retry delay, including jitter. Defaults to 60 seconds; maximum is
+     * 2,147,483,647 ms.
+     */
+    maxDelayMs?: number;
+    /** Exponential multiplier applied after each failed attempt. Defaults to 2. */
+    backoffFactor?: number;
+    /** Symmetric jitter ratio in the inclusive range 0..1. Defaults to 0.2. */
+    jitter?: number;
+    /**
+     * Minimum time between attempts and reconnects. Defaults to 1 second;
+     * maximum is 2,147,483,647 ms.
+     */
+    cooldownMs?: number;
+};
+export type BootstrapRecoveryEventTarget = {
+    addEventListener(type: string, listener: EventListener): void;
+    removeEventListener(type: string, listener: EventListener): void;
+};
+export type BootstrapRecoveryRuntime = {
+    bootstrap(signal: AbortSignal): Promise<unknown>;
+    connectionEvents: BootstrapRecoveryEventTarget;
+    onlineEvents?: BootstrapRecoveryEventTarget;
+    isConnected(): boolean;
+    isOnline?: () => boolean;
+    now?: () => number;
+    random?: () => number;
+    onError?: (error: unknown) => void;
+};
+/** Validate policy configuration before an owning client acquires resources. */
+export declare const validateBootstrapRecoveryOptions: (options: BootstrapRecoveryOptions) => void;
+/** Internal lifecycle controller, exported from its source module for tests. */
+export declare class BootstrapRecoveryController {
+    private readonly runtime;
+    private readonly options;
+    private readonly now;
+    private readonly random;
+    private running;
+    private timer?;
+    private timerDueAt?;
+    private inFlight?;
+    private attemptAbort?;
+    private consecutiveFailures;
+    private lastAttemptAt;
+    private retryNotBefore;
+    private readonly onConnectionOpen;
+    private readonly onConnectionClose;
+    private readonly onOnline;
+    constructor(runtime: BootstrapRecoveryRuntime, options?: BootstrapRecoveryOptions);
+    get started(): boolean;
+    start(): void;
+    stop(): Promise<void>;
+    private markConnected;
+    private requestRecovery;
+    private clearTimer;
+    private schedule;
+    private runAttempt;
+    private scheduleRetry;
+}
+//# sourceMappingURL=bootstrap-recovery.d.ts.map

package/dist/src/bootstrap-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-recovery.d.ts","sourceRoot":"","sources":["../../src/bootstrap-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACtC,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAUF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9D,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,gBAAgB,EAAE,4BAA4B,CAAC;IAC/C,YAAY,CAAC,EAAE,4BAA4B,CAAC;IAC5C,WAAW,IAAI,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC,CAAC;AAmEF,gFAAgF;AAChF,eAAO,MAAM,gCAAgC,GAC5C,SAAS,wBAAwB,KAC/B,IAKF,CAAC;AAEF,gFAAgF;AAChF,qBAAa,2BAA2B;IA8BtC,OAAO,CAAC,QAAQ,CAAC,OAAO;IA7BzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,YAAY,CAAC,CAAkB;IACvC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,cAAc,CAA4B;IAElD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAM/B;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAEhC;IAEF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAEvB;gBAGgB,OAAO,EAAE,wBAAwB,EAClD,OAAO,GAAE,wBAA6B;IAOvC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,KAAK,IAAI,IAAI;IAoBb,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBrB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,UAAU;IAmDlB,OAAO,CAAC,aAAa;CA0BrB"}

package/dist/src/bootstrap-recovery.js

@@ -0,0 +1,216 @@
+const DEFAULT_OPTIONS = {
+    initialDelayMs: 1_000,
+    maxDelayMs: 60_000,
+    backoffFactor: 2,
+    jitter: 0.2,
+    cooldownMs: 1_000,
+};
+const MAX_TIMER_DELAY_MS = 2_147_483_647;
+const finiteNumber = (name, value, minimum) => {
+    if (!Number.isFinite(value) || value < minimum) {
+        throw new Error(`${name} must be a finite number >= ${minimum}`);
+    }
+    return value;
+};
+const timerDelay = (name, value, minimum) => {
+    const delay = finiteNumber(name, value, minimum);
+    if (delay > MAX_TIMER_DELAY_MS) {
+        throw new Error(`${name} must be <= ${MAX_TIMER_DELAY_MS}`);
+    }
+    return delay;
+};
+const normalizeOptions = (options) => {
+    const initialDelayMs = timerDelay("bootstrapRecovery.initialDelayMs", options.initialDelayMs ?? DEFAULT_OPTIONS.initialDelayMs, 1);
+    const maxDelayMs = timerDelay("bootstrapRecovery.maxDelayMs", options.maxDelayMs ?? DEFAULT_OPTIONS.maxDelayMs, initialDelayMs);
+    const backoffFactor = finiteNumber("bootstrapRecovery.backoffFactor", options.backoffFactor ?? DEFAULT_OPTIONS.backoffFactor, 1);
+    const jitter = finiteNumber("bootstrapRecovery.jitter", options.jitter ?? DEFAULT_OPTIONS.jitter, 0);
+    if (jitter > 1) {
+        throw new Error("bootstrapRecovery.jitter must be <= 1");
+    }
+    const cooldownMs = timerDelay("bootstrapRecovery.cooldownMs", options.cooldownMs ?? DEFAULT_OPTIONS.cooldownMs, 0);
+    return {
+        initialDelayMs,
+        maxDelayMs,
+        backoffFactor,
+        jitter,
+        cooldownMs,
+    };
+};
+/** Validate policy configuration before an owning client acquires resources. */
+export const validateBootstrapRecoveryOptions = (options) => {
+    if (options.addresses?.length === 0) {
+        throw new Error("bootstrapRecovery.addresses must not be empty");
+    }
+    normalizeOptions(options);
+};
+/** Internal lifecycle controller, exported from its source module for tests. */
+export class BootstrapRecoveryController {
+    runtime;
+    options;
+    now;
+    random;
+    running = false;
+    timer;
+    timerDueAt;
+    inFlight;
+    attemptAbort;
+    consecutiveFailures = 0;
+    lastAttemptAt = Number.NEGATIVE_INFINITY;
+    retryNotBefore = Number.NEGATIVE_INFINITY;
+    onConnectionOpen = () => {
+        // A bootstrap attempt emits this event from inside its own successful dial.
+        // Let that attempt finish all Peerbit bootstrap side effects before treating
+        // the recovery as complete.
+        if (this.inFlight)
+            return;
+        this.markConnected();
+    };
+    onConnectionClose = () => {
+        this.requestRecovery(false);
+    };
+    onOnline = () => {
+        this.requestRecovery(true);
+    };
+    constructor(runtime, options = {}) {
+        this.runtime = runtime;
+        this.options = normalizeOptions(options);
+        this.now = runtime.now ?? Date.now;
+        this.random = runtime.random ?? Math.random;
+    }
+    get started() {
+        return this.running;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.runtime.connectionEvents.addEventListener("connection:open", this.onConnectionOpen);
+        this.runtime.connectionEvents.addEventListener("connection:close", this.onConnectionClose);
+        this.runtime.onlineEvents?.addEventListener("online", this.onOnline);
+        if (this.runtime.isConnected()) {
+            this.markConnected();
+        }
+        else {
+            this.schedule(0, false);
+        }
+    }
+    stop() {
+        if (this.running) {
+            this.running = false;
+            this.runtime.connectionEvents.removeEventListener("connection:open", this.onConnectionOpen);
+            this.runtime.connectionEvents.removeEventListener("connection:close", this.onConnectionClose);
+            this.runtime.onlineEvents?.removeEventListener("online", this.onOnline);
+            this.clearTimer();
+            this.attemptAbort?.abort(new Error("Bootstrap recovery stopped"));
+            this.attemptAbort = undefined;
+        }
+        return this.inFlight ?? Promise.resolve();
+    }
+    markConnected() {
+        if (!this.running)
+            return;
+        this.consecutiveFailures = 0;
+        this.retryNotBefore = Number.NEGATIVE_INFINITY;
+        this.lastAttemptAt = this.now();
+        this.clearTimer();
+    }
+    requestRecovery(urgent) {
+        if (!this.running || this.runtime.isConnected() || this.inFlight)
+            return;
+        const now = this.now();
+        const cooldownRemaining = Math.max(0, this.lastAttemptAt + this.options.cooldownMs - now);
+        const retryRemaining = Math.max(0, this.retryNotBefore - now);
+        this.schedule(Math.max(cooldownRemaining, retryRemaining), urgent);
+    }
+    clearTimer() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+        }
+        this.timer = undefined;
+        this.timerDueAt = undefined;
+    }
+    schedule(delayMs, replaceIfEarlier) {
+        if (!this.running)
+            return;
+        const delay = Math.max(0, delayMs);
+        const dueAt = this.now() + delay;
+        if (this.timer) {
+            if (!replaceIfEarlier || (this.timerDueAt ?? dueAt) <= dueAt) {
+                return;
+            }
+            this.clearTimer();
+        }
+        this.timerDueAt = dueAt;
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            this.timerDueAt = undefined;
+            this.runAttempt();
+        }, delay);
+        this.timer.unref?.();
+    }
+    runAttempt() {
+        if (!this.running || this.runtime.isConnected()) {
+            if (this.runtime.isConnected())
+                this.markConnected();
+            return;
+        }
+        if (this.runtime.isOnline?.() === false) {
+            // Browser online events bring this forward immediately; the bounded timer
+            // remains as a safety net for missed or unreliable environment signals.
+            this.schedule(this.options.maxDelayMs, false);
+            return;
+        }
+        const cooldownRemaining = Math.max(0, this.lastAttemptAt + this.options.cooldownMs - this.now());
+        if (cooldownRemaining > 0) {
+            this.schedule(cooldownRemaining, false);
+            return;
+        }
+        if (this.inFlight)
+            return;
+        this.lastAttemptAt = this.now();
+        const controller = new AbortController();
+        this.attemptAbort = controller;
+        const attempt = Promise.resolve().then(async () => {
+            await this.runtime.bootstrap(controller.signal);
+        });
+        const flight = attempt
+            .catch((error) => {
+            if (this.running && !controller.signal.aborted) {
+                this.runtime.onError?.(error);
+            }
+        })
+            .finally(() => {
+            if (this.inFlight !== flight)
+                return;
+            this.inFlight = undefined;
+            if (this.attemptAbort === controller) {
+                this.attemptAbort = undefined;
+            }
+            if (!this.running)
+                return;
+            if (this.runtime.isConnected()) {
+                this.markConnected();
+                return;
+            }
+            // A bootstrap call that returns after its connection has already closed is
+            // still a recovery failure and must remain on the bounded retry path.
+            this.scheduleRetry();
+        });
+        this.inFlight = flight;
+    }
+    scheduleRetry() {
+        const exponent = Math.min(this.consecutiveFailures, 52);
+        const baseDelay = Math.min(this.options.maxDelayMs, this.options.initialDelayMs *
+            Math.pow(this.options.backoffFactor, exponent));
+        this.consecutiveFailures += 1;
+        const random = Math.max(0, Math.min(1, this.random()));
+        const jitterMultiplier = 1 + (random * 2 - 1) * this.options.jitter;
+        const retryDelay = Math.max(1, Math.min(this.options.maxDelayMs, Math.round(baseDelay * jitterMultiplier)));
+        const now = this.now();
+        const cooldownRemaining = Math.max(0, this.lastAttemptAt + this.options.cooldownMs - now);
+        const delay = Math.max(retryDelay, cooldownRemaining);
+        this.retryNotBefore = now + delay;
+        this.schedule(delay, false);
+    }
+}
+//# sourceMappingURL=bootstrap-recovery.js.map

package/dist/src/bootstrap-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-recovery.js","sourceRoot":"","sources":["../../src/bootstrap-recovery.ts"],"names":[],"mappings":"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"}

package/dist/src/bootstrap.d.ts

@@ -1,4 +1,7 @@
 import { type Multiaddr } from "@multiformats/multiaddr";
-export declare const resolveBootstrapAddresses: (v?: string) => Promise<string[]>;
+export type ResolveBootstrapAddressesOptions = {
+    signal?: AbortSignal;
+};
+export declare const resolveBootstrapAddresses: (v?: string, options?: ResolveBootstrapAddressesOptions) => Promise<string[]>;
 export declare const getBootstrapPeerId: (address: string | Multiaddr) => string | undefined;
 //# sourceMappingURL=bootstrap.d.ts.map

package/dist/src/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,yBAAyB,CAAC;AAEpE,eAAO,MAAM,yBAAyB,GACrC,IAAG,MAAY,KACb,OAAO,CAAC,MAAM,EAAE,CAWlB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC9B,SAAS,MAAM,GAAG,SAAS,KACzB,MAAM,GAAG,SAQX,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,yBAAyB,CAAC;AA2PpE,MAAM,MAAM,gCAAgC,GAAG;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACrC,IAAG,MAAY,EACf,UAAS,gCAAqC,KAC5C,OAAO,CAAC,MAAM,EAAE,CA0BlB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC9B,SAAS,MAAM,GAAG,SAAS,KACzB,MAAM,GAAG,SAaX,CAAC"}

package/dist/src/bootstrap.js

@@ -1,15 +1,209 @@
 import { multiaddr } from "@multiformats/multiaddr";
-export const resolveBootstrapAddresses = async (v = "5") => {
-    // Bootstrap addresses for network
-    return (await (await fetch(`https://bootstrap.peerbit.org/bootstrap${v ? "-" + v : ""}.env`)).text())
-        .split(/\r?\n/)
-        .filter((x) => x.length > 0);
+import { Circuit, DNSADDR, TCP, WebRTC, WebSockets, WebSocketsSecure, } from "@multiformats/multiaddr-matcher";
+const BOOTSTRAP_LIST_FETCH_TIMEOUT_MS = 10_000;
+const MAX_BOOTSTRAP_LIST_BYTES = 64 * 1024;
+const MAX_BOOTSTRAP_LIST_LINES = 512;
+const MAX_BOOTSTRAP_ADDRESS_COUNT = 256;
+const hasRemoteEndpoint = (address) => !address
+    .getComponents()
+    .some((component) => (component.name === "tcp" && component.value === "0") ||
+    (component.name === "ip4" && component.value === "0.0.0.0") ||
+    (component.name === "ip6" && component.value === "::"));
+const hasDatagramTransport = (address) => address
+    .getComponents()
+    .some((component) => ["udp", "quic", "quic-v1", "webtransport", "webrtc-direct"].includes(component.name));
+const isWebSocketTarget = (address) => !hasDatagramTransport(address) && WebSockets.exactMatch(address);
+const isSecureWebSocketTarget = (address) => !hasDatagramTransport(address) && WebSocketsSecure.exactMatch(address);
+const hasDefaultDirectPrefix = (address) => !hasDatagramTransport(address) &&
+    (DNSADDR.matches(address) ||
+        TCP.matches(address) ||
+        WebSockets.matches(address) ||
+        WebSocketsSecure.matches(address));
+const hasBrowserSafeDirectPrefix = (address) => !hasDatagramTransport(address) &&
+    (DNSADDR.matches(address) || WebSocketsSecure.matches(address));
+const hasCircuitPeerIds = (address) => {
+    const components = address.getComponents();
+    const circuitIndex = components.findIndex((component) => component.name === "p2p-circuit");
+    return (circuitIndex >= 0 &&
+        components
+            .slice(0, circuitIndex)
+            .some((component) => component.name === "p2p") &&
+        components
+            .slice(circuitIndex + 1)
+            .some((component) => component.name === "p2p"));
+};
+const classifyBootstrapAddress = (address) => {
+    if (!hasRemoteEndpoint(address)) {
+        return { supported: false, crossRuntime: false };
+    }
+    const direct = DNSADDR.exactMatch(address) ||
+        TCP.exactMatch(address) ||
+        isWebSocketTarget(address) ||
+        isSecureWebSocketTarget(address);
+    const circuit = hasCircuitPeerIds(address) &&
+        Circuit.exactMatch(address) &&
+        hasDefaultDirectPrefix(address);
+    const webRTC = hasCircuitPeerIds(address) &&
+        WebRTC.exactMatch(address) &&
+        hasBrowserSafeDirectPrefix(address);
+    const crossRuntime = DNSADDR.exactMatch(address) ||
+        isSecureWebSocketTarget(address) ||
+        (circuit && hasBrowserSafeDirectPrefix(address));
+    return { supported: direct || circuit || webRTC, crossRuntime };
+};
+const getBootstrapListSources = (v) => {
+    const file = `bootstrap${v ? "-" + encodeURIComponent(v) : ""}.env`;
+    return [
+        `https://bootstrap.peerbit.org/${file}`,
+        `https://raw.githubusercontent.com/dao-xyz/peerbit-bootstrap/master/${file}`,
+    ];
+};
+const parseBootstrapAddresses = (value) => {
+    const lines = value.split(/\r?\n/);
+    if (lines.length > MAX_BOOTSTRAP_LIST_LINES) {
+        throw new Error(`Bootstrap list has too many lines (${lines.length} > ${MAX_BOOTSTRAP_LIST_LINES})`);
+    }
+    const addresses = lines
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith("#"));
+    if (addresses.length === 0) {
+        throw new Error("Bootstrap list is empty");
+    }
+    if (addresses.length > MAX_BOOTSTRAP_ADDRESS_COUNT) {
+        throw new Error(`Bootstrap list has too many addresses (${addresses.length} > ${MAX_BOOTSTRAP_ADDRESS_COUNT})`);
+    }
+    const canonicalAddresses = [];
+    let hasCrossRuntimeAddress = false;
+    for (const address of addresses) {
+        let parsed;
+        try {
+            parsed = multiaddr(address);
+        }
+        catch {
+            continue;
+        }
+        const classification = classifyBootstrapAddress(parsed);
+        if (!classification.supported) {
+            continue;
+        }
+        hasCrossRuntimeAddress ||= classification.crossRuntime;
+        canonicalAddresses.push(parsed.toString());
+    }
+    if (canonicalAddresses.length === 0) {
+        throw new Error("Bootstrap list has no supported dial targets");
+    }
+    if (!hasCrossRuntimeAddress) {
+        throw new Error("Bootstrap list has no browser-safe cross-runtime dial target");
+    }
+    return [...new Set(canonicalAddresses)];
+};
+const readBootstrapList = async (response) => {
+    const declaredLength = response.headers.get("content-length");
+    if (declaredLength != null) {
+        if (!/^\d+$/.test(declaredLength)) {
+            throw new Error(`Invalid bootstrap list Content-Length: ${declaredLength}`);
+        }
+        const length = Number(declaredLength);
+        if (!Number.isSafeInteger(length) || length > MAX_BOOTSTRAP_LIST_BYTES) {
+            throw new Error(`Bootstrap list is too large (${declaredLength} > ${MAX_BOOTSTRAP_LIST_BYTES} bytes)`);
+        }
+    }
+    if (!response.body) {
+        return "";
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    let bytesRead = 0;
+    let value = "";
+    let completed = false;
+    try {
+        while (true) {
+            const chunk = await reader.read();
+            if (chunk.done) {
+                break;
+            }
+            bytesRead += chunk.value.byteLength;
+            if (bytesRead > MAX_BOOTSTRAP_LIST_BYTES) {
+                throw new Error(`Bootstrap list is too large (${bytesRead} > ${MAX_BOOTSTRAP_LIST_BYTES} bytes)`);
+            }
+            value += decoder.decode(chunk.value, { stream: true });
+        }
+        value += decoder.decode();
+        completed = true;
+        return value;
+    }
+    finally {
+        if (!completed) {
+            await reader
+                .cancel("Bootstrap list read did not complete")
+                .catch(() => { });
+        }
+        reader.releaseLock();
+    }
+};
+const abortReason = (signal) => signal.reason ?? new Error("Bootstrap address resolution aborted");
+const fetchBootstrapAddresses = async (source, externalSignal) => {
+    const controller = new AbortController();
+    const onExternalAbort = () => controller.abort(abortReason(externalSignal));
+    if (externalSignal?.aborted) {
+        onExternalAbort();
+    }
+    else {
+        externalSignal?.addEventListener("abort", onExternalAbort, { once: true });
+    }
+    const timeout = setTimeout(() => {
+        controller.abort(new Error(`Timed out fetching bootstrap list after ${BOOTSTRAP_LIST_FETCH_TIMEOUT_MS} ms`));
+    }, BOOTSTRAP_LIST_FETCH_TIMEOUT_MS);
+    let response;
+    try {
+        response = await fetch(source, { signal: controller.signal });
+        if (!response.ok) {
+            throw new Error(`Bootstrap list returned HTTP ${response.status}${response.statusText ? ` ${response.statusText}` : ""}`);
+        }
+        return parseBootstrapAddresses(await readBootstrapList(response));
+    }
+    catch (error) {
+        if (response?.body && !response.body.locked) {
+            await response.body.cancel(error).catch(() => { });
+        }
+        if (!controller.signal.aborted) {
+            controller.abort(error);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+        externalSignal?.removeEventListener("abort", onExternalAbort);
+    }
+};
+export const resolveBootstrapAddresses = async (v = "5", options = {}) => {
+    const failures = [];
+    for (const source of getBootstrapListSources(v)) {
+        if (options.signal?.aborted) {
+            throw abortReason(options.signal);
+        }
+        try {
+            return await fetchBootstrapAddresses(source, options.signal);
+        }
+        catch (error) {
+            if (options.signal?.aborted) {
+                throw abortReason(options.signal);
+            }
+            failures.push(new Error(`Failed to load bootstrap addresses from ${source}: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+    throw new AggregateError(failures, `Failed to resolve bootstrap addresses for network version ${v || "default"}`);
 };
 export const getBootstrapPeerId = (address) => {
     try {
         const parsed = typeof address === "string" ? multiaddr(address) : address;
-        return parsed.getComponents().find((component) => component.name === "p2p")
-            ?.value;
+        const components = parsed.getComponents();
+        for (let index = components.length - 1; index >= 0; index--) {
+            if (components[index].name === "p2p") {
+                return components[index].value;
+            }
+        }
+        return undefined;
     }
     catch {
         return undefined;

package/dist/src/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAC7C,IAAY,GAAG,EACK,EAAE;IACtB,kCAAkC;IAClC,OAAO,CACN,MAAM,CACL,MAAM,KAAK,CACV,0CAA0C,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAChE,CACD,CAAC,IAAI,EAAE,CACR;SACC,KAAK,CAAC,OAAO,CAAC;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,OAA2B,EACN,EAAE;IACvB,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1E,OAAO,MAAM,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC;YAC1E,EAAE,KAAK,CAAC;IACV,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACN,OAAO,EACP,OAAO,EACP,GAAG,EACH,MAAM,EACN,UAAU,EACV,gBAAgB,GAChB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AAC/C,MAAM,wBAAwB,GAAG,EAAE,GAAG,IAAI,CAAC;AAC3C,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAExC,MAAM,iBAAiB,GAAG,CAAC,OAAkB,EAAW,EAAE,CACzD,CAAC,OAAO;KACN,aAAa,EAAE;KACf,IAAI,CACJ,CAAC,SAAS,EAAE,EAAE,CACb,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,IAAI,SAAS,CAAC,KAAK,KAAK,GAAG,CAAC;IACrD,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC;IAC3D,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,IAAI,SAAS,CAAC,KAAK,KAAK,IAAI,CAAC,CACvD,CAAC;AAEJ,MAAM,oBAAoB,GAAG,CAAC,OAAkB,EAAW,EAAE,CAC5D,OAAO;KACL,aAAa,EAAE;KACf,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CACnB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,QAAQ,CACnE,SAAS,CAAC,IAAI,CACd,CACD,CAAC;AAEJ,MAAM,iBAAiB,GAAG,CAAC,OAAkB,EAAW,EAAE,CACzD,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAElE,MAAM,uBAAuB,GAAG,CAAC,OAAkB,EAAW,EAAE,CAC/D,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAExE,MAAM,sBAAsB,GAAG,CAAC,OAAkB,EAAW,EAAE,CAC9D,CAAC,oBAAoB,CAAC,OAAO,CAAC;IAC9B,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;QACpB,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3B,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAErC,MAAM,0BAA0B,GAAG,CAAC,OAAkB,EAAW,EAAE,CAClE,CAAC,oBAAoB,CAAC,OAAO,CAAC;IAC9B,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAEjE,MAAM,iBAAiB,GAAG,CAAC,OAAkB,EAAW,EAAE;IACzD,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAC3C,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CACxC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,aAAa,CAC/C,CAAC;IACF,OAAO,CACN,YAAY,IAAI,CAAC;QACjB,UAAU;aACR,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;aACtB,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC;QAC/C,UAAU;aACR,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC;aACvB,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,CAC/C,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAChC,OAAkB,EAC8B,EAAE;IAClD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QAC3B,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;QACvB,iBAAiB,CAAC,OAAO,CAAC;QAC1B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,GACZ,iBAAiB,CAAC,OAAO,CAAC;QAC1B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QAC3B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,MAAM,GACX,iBAAiB,CAAC,OAAO,CAAC;QAC1B,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;QAC1B,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,YAAY,GACjB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QAC3B,uBAAuB,CAAC,OAAO,CAAC;QAChC,CAAC,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;IAElD,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,OAAO,IAAI,MAAM,EAAE,YAAY,EAAE,CAAC;AACjE,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,CAAS,EAAY,EAAE;IACvD,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpE,OAAO;QACN,iCAAiC,IAAI,EAAE;QACvC,sEAAsE,IAAI,EAAE;KAC5E,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,KAAa,EAAY,EAAE;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,GAAG,wBAAwB,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACd,sCAAsC,KAAK,CAAC,MAAM,MAAM,wBAAwB,GAAG,CACnF,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,KAAK;SACrB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,2BAA2B,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACd,0CAA0C,SAAS,CAAC,MAAM,MAAM,2BAA2B,GAAG,CAC9F,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,IAAI,sBAAsB,GAAG,KAAK,CAAC;IACnC,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,MAAiB,CAAC;QACtB,IAAI,CAAC;YACJ,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACR,SAAS;QACV,CAAC;QACD,MAAM,cAAc,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;YAC/B,SAAS;QACV,CAAC;QACD,sBAAsB,KAAK,cAAc,CAAC,YAAY,CAAC;QACvD,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACd,8DAA8D,CAC9D,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,KAAK,EAAE,QAAkB,EAAmB,EAAE;IACvE,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9D,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACd,0CAA0C,cAAc,EAAE,CAC1D,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,wBAAwB,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CACd,gCAAgC,cAAc,MAAM,wBAAwB,SAAS,CACrF,CAAC;QACH,CAAC;IACF,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,CAAC;QACJ,OAAO,IAAI,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM;YACP,CAAC;YACD,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;YACpC,IAAI,SAAS,GAAG,wBAAwB,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CACd,gCAAgC,SAAS,MAAM,wBAAwB,SAAS,CAChF,CAAC;YACH,CAAC;YACD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,SAAS,GAAG,IAAI,CAAC;QACjB,OAAO,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACV,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,MAAM,MAAM;iBACV,MAAM,CAAC,sCAAsC,CAAC;iBAC9C,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,MAAM,CAAC,WAAW,EAAE,CAAC;IACtB,CAAC;AACF,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,MAAmB,EAAW,EAAE,CACpD,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAEpE,MAAM,uBAAuB,GAAG,KAAK,EACpC,MAAc,EACd,cAA4B,EACR,EAAE;IACtB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,cAAe,CAAC,CAAC,CAAC;IAC7E,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;QAC7B,eAAe,EAAE,CAAC;IACnB,CAAC;SAAM,CAAC;QACP,cAAc,EAAE,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;QAC/B,UAAU,CAAC,KAAK,CACf,IAAI,KAAK,CACR,2CAA2C,+BAA+B,KAAK,CAC/E,CACD,CAAC;IACH,CAAC,EAAE,+BAA+B,CAAC,CAAC;IAEpC,IAAI,QAA8B,CAAC;IACnC,IAAI,CAAC;QACJ,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACd,gCAAgC,QAAQ,CAAC,MAAM,GAC9C,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EACnD,EAAE,CACF,CAAC;QACH,CAAC;QACD,OAAO,uBAAuB,CAAC,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7C,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAChC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;YAAS,CAAC;QACV,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,cAAc,EAAE,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAC/D,CAAC;AACF,CAAC,CAAC;AAMF,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAC7C,IAAY,GAAG,EACf,UAA4C,EAAE,EAC1B,EAAE;IACtB,MAAM,QAAQ,GAAY,EAAE,CAAC;IAC7B,KAAK,MAAM,MAAM,IAAI,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC7B,MAAM,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC;YACJ,OAAO,MAAM,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC7B,MAAM,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;YACD,QAAQ,CAAC,IAAI,CACZ,IAAI,KAAK,CACR,2CAA2C,MAAM,KAChD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACtD,EAAE,CACF,CACD,CAAC;QACH,CAAC;IACF,CAAC;IAED,MAAM,IAAI,cAAc,CACvB,QAAQ,EACR,6DAA6D,CAAC,IAAI,SAAS,EAAE,CAC7E,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,OAA2B,EACN,EAAE;IACvB,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1C,KAAK,IAAI,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YAC7D,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACtC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;YAChC,CAAC;QACF,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC,CAAC"}

package/dist/src/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./peer.js";
 export * from "./bootstrap.js";
+export type { BootstrapRecoveryOptions } from "./bootstrap-recovery.js";
 export { createLibp2pExtended, type Libp2pExtendServices, type Libp2pExtended, type Libp2pCreateOptions, type Libp2pCreateOptionsWithServices, } from "./libp2p.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACN,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,+BAA+B,GACpC,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EACN,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,+BAA+B,GACpC,MAAM,aAAa,CAAC"}

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACN,oBAAoB,GAKpB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EACN,oBAAoB,GAKpB,MAAM,aAAa,CAAC"}

package/dist/src/peer.d.ts

@@ -6,6 +6,7 @@ import type { Indices } from "@peerbit/indexer-interface";
 import { type Address, type ExtractArgs, type OpenOptions, type Program, type ProgramClient, ProgramHandler } from "@peerbit/program";
 import { FanoutChannel, type FanoutTreeChannelOptions, type FanoutTreeJoinOptions } from "@peerbit/pubsub";
 import type { RustCoreStream } from "@peerbit/stream";
+import { type BootstrapRecoveryOptions } from "./bootstrap-recovery.js";
 import { type Libp2pExtended, type PartialLibp2pCreateOptions } from "./libp2p.js";
 export declare const logger: import("@libp2p/interface").Logger;
 export type OptionalCreateOptions = {
@@ -124,6 +125,12 @@ export type CreateInstanceOptions = (SimpleLibp2pOptions | Libp2pOptions) & {
     indexer?: (directory?: string) => Promise<Indices> | Indices;
     storage?: StorageCreateOptions;
     network?: NativeNetworkCreateOptions;
+    /**
+     * Opt-in automatic bootstrap recovery. `true` uses bounded defaults; an
+     * options object customizes retry policy or fixed targets. It is disabled by
+     * default to avoid unexpected network access from `Peerbit.create()`.
+     */
+    bootstrapRecovery?: boolean | BootstrapRecoveryOptions;
 } & OptionalCreateOptions;
 export type DialReadiness = "connection" | "services" | "services-and-fanout";
 export type DialOptions = {
@@ -140,6 +147,10 @@ export type BootstrapResult = {
     connectedPeerIds: string[];
     failures: BootstrapFailure[];
 };
+export type BootstrapDialOptions = {
+    dialTimeoutMs?: number;
+    signal?: AbortSignal;
+};
 export declare class Peerbit implements ProgramClient {
     _libp2p: Libp2pExtended;
     directory?: string;
@@ -147,6 +158,11 @@ export declare class Peerbit implements ProgramClient {
     private _indexer;
     private _libp2pExternal?;
     private _nativeNetwork?;
+    private _bootstrapRecoveryOptions?;
+    private _bootstrapRecovery?;
+    private _bootstrapRecoveryGeneration;
+    private _bootstrapRecoveryTransition;
+    private _bootstrapRecoveryPaused;
     /**
      * Native shared-log defaults advertised to programs opened on this
      * client; read by `@peerbit/shared-log` (`SharedLogNativeDefaults`).
@@ -170,9 +186,16 @@ export declare class Peerbit implements ProgramClient {
      */
     dial(address: string | Multiaddr | Multiaddr[] | ProgramClient, options?: DialOptions): Promise<boolean>;
     hangUp(address: PeerId | PublicSignKey | string | Multiaddr): Promise<void>;
+    get bootstrapRecoveryEnabled(): boolean;
+    /** Enable automatic recovery and schedule an immediate attempt if disconnected. */
+    enableBootstrapRecovery(options?: BootstrapRecoveryOptions): void;
+    /** Disable recovery, remove environment listeners, and abort its active dial. */
+    disableBootstrapRecovery(): void;
+    private transitionBootstrapRecovery;
+    private startBootstrapRecovery;
     start(): Promise<void>;
     stop(): Promise<void>;
-    bootstrap(addresses?: string[] | Multiaddr[]): Promise<BootstrapResult>;
+    bootstrap(addresses?: Array<string | Multiaddr>, options?: BootstrapDialOptions): Promise<BootstrapResult>;
     /**
      * Default behaviour of a store is only to accept heads that are forks (new roots) with some probability
      * and to replicate heads (and updates) which is requested by another peer