@statewalker/httpeers-libp2p 0.3.1 → 0.3.2

package/dist/hub-link.d.ts

@@ -21,8 +21,27 @@ import { type RelaySupervisor } from "./reservation.js";
  * connection it already holds to the hub.
  */
 export declare function hubRoute(hubPeerId: string, peerId: string): string;
-/** How many times `dialWebRTC` tries a WebRTC upgrade before giving up. */
+/** How many times `dialWebRTC` tries a WebRTC upgrade under node-datachannel before giving up. */
 export declare const WEBRTC_UPGRADE_ATTEMPTS = 3;
+/**
+ * How many attempts `dialWebRTC` makes by default: one where WebRTC is the
+ * runtime's own (a browser), `WEBRTC_UPGRADE_ATTEMPTS` elsewhere (Node, with
+ * node-datachannel). Read at each call, not at import.
+ *
+ * WHY ONE IN A BROWSER. The retry exists for a node-datachannel race (below),
+ * which a browser's WebRTC does not have. There, a path that cannot come up
+ * (symmetric NAT, UDP blocked) fails every attempt alike, each after libp2p's
+ * per-address dial timeout (6 s in libp2p 3), and the caller's relay fallback
+ * waits for all of them: measured in Chromium with UDP blocked, a Guest's join
+ * took 18 s, all of it in three timed-out upgrades, and 6 s with one.
+ *
+ * THE TEST IS THE GLOBAL, NOT THE IMPLEMENTATION libp2p PICKS (it picks by the
+ * package's `browser` field). Under Node they agree unless a process installs a
+ * global RTCPeerConnection (e.g. node-datachannel's polyfill assigned to
+ * `globalThis`): libp2p still runs node-datachannel there, and this would
+ * drop its retry. Pass `attempts` explicitly in such a process.
+ */
+export declare function defaultWebRTCAttempts(): number;
 /**
  * Dial a `/webrtc` address, trying the upgrade again when it fails.
  *
@@ -37,7 +56,8 @@ export declare const WEBRTC_UPGRADE_ATTEMPTS = 3;
  * load. Each attempt is an independent race, so one retry nearly always
  * succeeds. Fixed upstream by libdatachannel 0235225 ("start DTLS after
  * remote description"); drop the retry once node-datachannel ships it.
- * Browsers implement WebRTC themselves and are not affected.
+ * Browsers implement WebRTC themselves and are not affected, so they get one
+ * attempt (`defaultWebRTCAttempts`).
  *
  * A WebRTC path that cannot come up fails every attempt, and the caller's
  * fallback (the relay circuit) runs as before.

package/dist/hub-link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hub-link.d.ts","sourceRoot":"","sources":["../src/hub-link.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,kBAAkB,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,EAC/B,QAAQ,GAAE,MAAgC,GACzC,OAAO,CAAC,UAAU,CAAC,CAUrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhG;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,gBAAgB,GAChB,cAAc,GACd,UAAU,GACV,WAAW,GACX,OAAO,CAAC;AAEZ,uHAAuH;AACvH,qBAAa,mBAAoB,SAAQ,KAAK;IAE1C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,oHAAoH;IACpH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAC9B,QAAQ,CAAC,OAAO,EAAE,qBAAqB;IAJzC,YACW,SAAS,EAAE,MAAM;IAC1B,oHAAoH;IAC3G,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,EAAE,qBAAqB,EACvC,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,EAI5B;CACF;AA2ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAenF;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/E;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,GAAG,eAAe,CAY1F"}
+{"version":3,"file":"hub-link.d.ts","sourceRoot":"","sources":["../src/hub-link.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,kBAAkB,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,EAC/B,QAAQ,GAAE,MAAgC,GACzC,OAAO,CAAC,UAAU,CAAC,CAUrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhG;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,gBAAgB,GAChB,cAAc,GACd,UAAU,GACV,WAAW,GACX,OAAO,CAAC;AAEZ,uHAAuH;AACvH,qBAAa,mBAAoB,SAAQ,KAAK;IAE1C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,oHAAoH;IACpH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAC9B,QAAQ,CAAC,OAAO,EAAE,qBAAqB;IAJzC,YACW,SAAS,EAAE,MAAM;IAC1B,oHAAoH;IAC3G,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,EAAE,qBAAqB,EACvC,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,EAI5B;CACF;AA2ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAenF;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/E;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,GAAG,eAAe,CAY1F"}

package/dist/hub-link.js

@@ -24,8 +24,31 @@ import { superviseRelay } from "./reservation.js";
 export function hubRoute(hubPeerId, peerId) {
     return `/p2p/${hubPeerId}/p2p-circuit/webrtc/p2p/${peerId}`;
 }
-/** How many times `dialWebRTC` tries a WebRTC upgrade before giving up. */
+/** How many times `dialWebRTC` tries a WebRTC upgrade under node-datachannel before giving up. */
 export const WEBRTC_UPGRADE_ATTEMPTS = 3;
+/**
+ * How many attempts `dialWebRTC` makes by default: one where WebRTC is the
+ * runtime's own (a browser), `WEBRTC_UPGRADE_ATTEMPTS` elsewhere (Node, with
+ * node-datachannel). Read at each call, not at import.
+ *
+ * WHY ONE IN A BROWSER. The retry exists for a node-datachannel race (below),
+ * which a browser's WebRTC does not have. There, a path that cannot come up
+ * (symmetric NAT, UDP blocked) fails every attempt alike, each after libp2p's
+ * per-address dial timeout (6 s in libp2p 3), and the caller's relay fallback
+ * waits for all of them: measured in Chromium with UDP blocked, a Guest's join
+ * took 18 s, all of it in three timed-out upgrades, and 6 s with one.
+ *
+ * THE TEST IS THE GLOBAL, NOT THE IMPLEMENTATION libp2p PICKS (it picks by the
+ * package's `browser` field). Under Node they agree unless a process installs a
+ * global RTCPeerConnection (e.g. node-datachannel's polyfill assigned to
+ * `globalThis`): libp2p still runs node-datachannel there, and this would
+ * drop its retry. Pass `attempts` explicitly in such a process.
+ */
+export function defaultWebRTCAttempts() {
+    return typeof globalThis.RTCPeerConnection === "function"
+        ? 1
+        : WEBRTC_UPGRADE_ATTEMPTS;
+}
 /**
  * Dial a `/webrtc` address, trying the upgrade again when it fails.
  *
@@ -40,12 +63,13 @@ export const WEBRTC_UPGRADE_ATTEMPTS = 3;
  * load. Each attempt is an independent race, so one retry nearly always
  * succeeds. Fixed upstream by libdatachannel 0235225 ("start DTLS after
  * remote description"); drop the retry once node-datachannel ships it.
- * Browsers implement WebRTC themselves and are not affected.
+ * Browsers implement WebRTC themselves and are not affected, so they get one
+ * attempt (`defaultWebRTCAttempts`).
  *
  * A WebRTC path that cannot come up fails every attempt, and the caller's
  * fallback (the relay circuit) runs as before.
  */
-export async function dialWebRTC(node, target, attempts = WEBRTC_UPGRADE_ATTEMPTS) {
+export async function dialWebRTC(node, target, attempts = defaultWebRTCAttempts()) {
     let lastError;
     for (let attempt = 1; attempt <= attempts; attempt++) {
         try {

package/dist/index.d.ts

@@ -16,7 +16,7 @@
  */
 export { createDuplexMounts, DUPLEX_PROTOCOL, type DuplexContext, type DuplexHandler, type DuplexMounts, NO_MOUNT, type OpenDuplexInit, openDuplex, type PeerDuplex, type ServeDuplexInit, serveDuplex, } from "./duplex.js";
 export { decodeHopAnswer, HOP_RESERVE_TIMEOUT_MS, HOP_STATUS_NAMES, HOP_STATUS_OK, type HopAnswer, RelayNotConnectedError, type RelayReservationGrant, RelayReservationRefusedError, requestRelayReservation, } from "./hop-reserve.js";
-export { dialWebRTC, HubReservationError, type HubReservationRefusal, hubRoute, leaveRelay, reachHub, reachHubRelayed, reserveOnHub, type SuperviseHubReservationInit, superviseHubReservation, WEBRTC_UPGRADE_ATTEMPTS, } from "./hub-link.js";
+export { defaultWebRTCAttempts, dialWebRTC, HubReservationError, type HubReservationRefusal, hubRoute, leaveRelay, reachHub, reachHubRelayed, reserveOnHub, type SuperviseHubReservationInit, superviseHubReservation, WEBRTC_UPGRADE_ATTEMPTS, } from "./hub-link.js";
 export { HUB_MAX_RESERVATIONS, type HubRelayComponents, type HubRelayServiceInit, hubRelayService, type IsMember, membershipGater, releaseReservation, } from "./hub-relay.js";
 export { type BytesStore, decodeKey, encodeKey, type GenerateKeyInit, generateKey, type IdentityStore, type IdentityStoreInit, identityStore, peerIdOf, type SignerLike, signerOf, } from "./identity.js";
 export type { CallOnLimitedConnection } from "./link.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,QAAQ,EACR,KAAK,cAAc,EACnB,UAAU,EACV,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,KAAK,SAAS,EACd,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,KAAK,2BAA2B,EAChC,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,eAAe,EACf,KAAK,QAAQ,EACb,eAAe,EACf,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,UAAU,EACf,SAAS,EACT,SAAS,EACT,KAAK,eAAe,EACpB,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,aAAa,EACb,QAAQ,EACR,KAAK,UAAU,EACf,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,EACZ,2BAA2B,EAC3B,SAAS,EACT,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,4BAA4B,EAC5B,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,KAAK,kBAAkB,EACvB,cAAc,EACd,KAAK,6BAA6B,EAClC,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,UAAU,EACV,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,QAAQ,EACR,KAAK,kBAAkB,EACvB,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,QAAQ,EACR,KAAK,cAAc,EACnB,UAAU,EACV,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,KAAK,SAAS,EACd,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,KAAK,2BAA2B,EAChC,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,eAAe,EACf,KAAK,QAAQ,EACb,eAAe,EACf,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,UAAU,EACf,SAAS,EACT,SAAS,EACT,KAAK,eAAe,EACpB,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,aAAa,EACb,QAAQ,EACR,KAAK,UAAU,EACf,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,EACZ,2BAA2B,EAC3B,SAAS,EACT,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,4BAA4B,EAC5B,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,KAAK,kBAAkB,EACvB,cAAc,EACd,KAAK,6BAA6B,EAClC,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,UAAU,EACV,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,QAAQ,EACR,KAAK,kBAAkB,EACvB,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -16,7 +16,7 @@
  */
 export { createDuplexMounts, DUPLEX_PROTOCOL, NO_MOUNT, openDuplex, serveDuplex, } from "./duplex.js";
 export { decodeHopAnswer, HOP_RESERVE_TIMEOUT_MS, HOP_STATUS_NAMES, HOP_STATUS_OK, RelayNotConnectedError, RelayReservationRefusedError, requestRelayReservation, } from "./hop-reserve.js";
-export { dialWebRTC, HubReservationError, hubRoute, leaveRelay, reachHub, reachHubRelayed, reserveOnHub, superviseHubReservation, WEBRTC_UPGRADE_ATTEMPTS, } from "./hub-link.js";
+export { defaultWebRTCAttempts, dialWebRTC, HubReservationError, hubRoute, leaveRelay, reachHub, reachHubRelayed, reserveOnHub, superviseHubReservation, WEBRTC_UPGRADE_ATTEMPTS, } from "./hub-link.js";
 export { HUB_MAX_RESERVATIONS, hubRelayService, membershipGater, releaseReservation, } from "./hub-relay.js";
 export { decodeKey, encodeKey, generateKey, identityStore, peerIdOf, signerOf, } from "./identity.js";
 export { lastPeerIdOf } from "./multiaddr-parts.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statewalker/httpeers-libp2p",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "type": "module",
   "description": "The transport: nodes, identity, and servePeer — the one place in the extraction that knows what libp2p is.",
   "bugs": {
@@ -54,8 +54,8 @@
     "@statewalker/webrun-streams": "^0.2.3",
     "@statewalker/webrun-streams-libp2p": "^0.1.6",
     "libp2p": "^3.5.1",
-    "@statewalker/httpeers-core": "^0.1.3",
-    "@statewalker/httpeers-bridge": "^0.2.1"
+    "@statewalker/httpeers-bridge": "^0.2.1",
+    "@statewalker/httpeers-core": "^0.1.3"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.15",

package/src/hub-link.ts

@@ -28,9 +28,33 @@ export function hubRoute(hubPeerId: string, peerId: string): string {
   return `/p2p/${hubPeerId}/p2p-circuit/webrtc/p2p/${peerId}`;
 }
 
-/** How many times `dialWebRTC` tries a WebRTC upgrade before giving up. */
+/** How many times `dialWebRTC` tries a WebRTC upgrade under node-datachannel before giving up. */
 export const WEBRTC_UPGRADE_ATTEMPTS = 3;
 
+/**
+ * How many attempts `dialWebRTC` makes by default: one where WebRTC is the
+ * runtime's own (a browser), `WEBRTC_UPGRADE_ATTEMPTS` elsewhere (Node, with
+ * node-datachannel). Read at each call, not at import.
+ *
+ * WHY ONE IN A BROWSER. The retry exists for a node-datachannel race (below),
+ * which a browser's WebRTC does not have. There, a path that cannot come up
+ * (symmetric NAT, UDP blocked) fails every attempt alike, each after libp2p's
+ * per-address dial timeout (6 s in libp2p 3), and the caller's relay fallback
+ * waits for all of them: measured in Chromium with UDP blocked, a Guest's join
+ * took 18 s, all of it in three timed-out upgrades, and 6 s with one.
+ *
+ * THE TEST IS THE GLOBAL, NOT THE IMPLEMENTATION libp2p PICKS (it picks by the
+ * package's `browser` field). Under Node they agree unless a process installs a
+ * global RTCPeerConnection (e.g. node-datachannel's polyfill assigned to
+ * `globalThis`): libp2p still runs node-datachannel there, and this would
+ * drop its retry. Pass `attempts` explicitly in such a process.
+ */
+export function defaultWebRTCAttempts(): number {
+  return typeof (globalThis as { RTCPeerConnection?: unknown }).RTCPeerConnection === "function"
+    ? 1
+    : WEBRTC_UPGRADE_ATTEMPTS;
+}
+
 /**
  * Dial a `/webrtc` address, trying the upgrade again when it fails.
  *
@@ -45,7 +69,8 @@ export const WEBRTC_UPGRADE_ATTEMPTS = 3;
  * load. Each attempt is an independent race, so one retry nearly always
  * succeeds. Fixed upstream by libdatachannel 0235225 ("start DTLS after
  * remote description"); drop the retry once node-datachannel ships it.
- * Browsers implement WebRTC themselves and are not affected.
+ * Browsers implement WebRTC themselves and are not affected, so they get one
+ * attempt (`defaultWebRTCAttempts`).
  *
  * A WebRTC path that cannot come up fails every attempt, and the caller's
  * fallback (the relay circuit) runs as before.
@@ -53,7 +78,7 @@ export const WEBRTC_UPGRADE_ATTEMPTS = 3;
 export async function dialWebRTC(
   node: Libp2p,
   target: Multiaddr | Multiaddr[],
-  attempts: number = WEBRTC_UPGRADE_ATTEMPTS,
+  attempts: number = defaultWebRTCAttempts(),
 ): Promise<Connection> {
   let lastError: unknown;
   for (let attempt = 1; attempt <= attempts; attempt++) {

package/src/index.ts

@@ -40,6 +40,7 @@ export {
   requestRelayReservation,
 } from "./hop-reserve.js";
 export {
+  defaultWebRTCAttempts,
   dialWebRTC,
   HubReservationError,
   type HubReservationRefusal,