@le-space/aleph-bootstrap 0.6.33 → 0.6.34

package/index.d.ts

@@ -87,6 +87,15 @@ interface DiscoverAlephBootstrapOptions {
     browserDialableOnly?: boolean;
     requireDualKeyAttestation?: boolean;
     verifyDualKeyAttestation?: boolean;
+    /**
+     * Restrict discovery to registrations published under this relay profile
+     * (e.g. `"orbitdb-relay"`). Multiple relay implementations register in the
+     * same Aleph channel; without this scope a consumer would pick up relays it
+     * cannot use (an orbitdb app connecting to a `uc-go-peer` relay never gets a
+     * shared circuit → `candidates: 0`). Accepts a single profile or a list.
+     * When omitted, posts of every profile are returned (previous behaviour).
+     */
+    profile?: string | readonly string[];
     fetch?: typeof fetch;
 }
 interface FilterPublicMultiaddrsOptions {
@@ -182,10 +191,15 @@ declare function fetchAlephBootstrapPosts(options?: DiscoverAlephBootstrapOption
 declare function selectCurrentRelayBootstrapPosts(posts: readonly RelayBootstrapPostRecord[], options?: Pick<DiscoverAlephBootstrapOptions, "maxAgeMs"> & {
     now?: number;
 }): RelayBootstrapPostRecord[];
+/**
+ * Keep only posts whose registration profile matches the requested profile(s).
+ * A missing/empty filter is a no-op so existing callers are unaffected.
+ */
+declare function filterRelayBootstrapPostsByProfile(posts: readonly RelayBootstrapPostRecord[], profile?: string | readonly string[]): RelayBootstrapPostRecord[];
 declare function discoverAlephBootstrapMultiaddrs(options?: DiscoverAlephBootstrapOptions): Promise<string[]>;
 declare function createLibp2pAlephBootstrap(options?: DiscoverAlephBootstrapOptions & {
     timeout?: number;
     tagName?: string;
 }): Promise<ReturnType<typeof bootstrap>>;
 
-export { type CreateRelayBootstrapPostOptions, DEFAULT_ALEPH_API_HOST, DEFAULT_ALEPH_BOOTSTRAP_CHANNEL, DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE, DEFAULT_ALEPH_BOOTSTRAP_REF, DEFAULT_BOOTSTRAP_COMPACT_MULTIADDR_LIMIT, DEFAULT_BOOTSTRAP_MAX_AGE_MS, DEFAULT_BOOTSTRAP_MAX_PAGES, DEFAULT_BOOTSTRAP_PAGINATION, type DiscoverAlephBootstrapOptions, type FilterPublicMultiaddrsOptions, RELAY_BOOTSTRAP_SIGNATURE_SCHEME, type RelayBootstrapAuthorizationPayload, type RelayBootstrapAuthorizationRecord, type RelayBootstrapContent, type RelayBootstrapPostContent, type RelayBootstrapPostRecord, type RelayBootstrapProofPayload, type RelayBootstrapProofRecord, type RelayBootstrapProofSigner, type RelayBootstrapTrustMode, type RelayBootstrapVerificationResult, buildRelayBootstrapPostContent, createLibp2pAlephBootstrap, createRelayBootstrapPost, dedupeMultiaddrs, discoverAlephBootstrapMultiaddrs, fetchAlephBootstrapPosts, filterPublicMultiaddrs, isPublicMultiaddr, relayBootstrapMultiaddrsHash, relayBootstrapTrustMode, selectCompactRelayBootstrapMultiaddrs, selectCurrentRelayBootstrapPosts, signRelayBootstrapAuthorization, signRelayBootstrapProof, verifyRelayBootstrapAuthorization, verifyRelayBootstrapDualKeyContent, verifyRelayBootstrapProof };
+export { type CreateRelayBootstrapPostOptions, DEFAULT_ALEPH_API_HOST, DEFAULT_ALEPH_BOOTSTRAP_CHANNEL, DEFAULT_ALEPH_BOOTSTRAP_POST_TYPE, DEFAULT_ALEPH_BOOTSTRAP_REF, DEFAULT_BOOTSTRAP_COMPACT_MULTIADDR_LIMIT, DEFAULT_BOOTSTRAP_MAX_AGE_MS, DEFAULT_BOOTSTRAP_MAX_PAGES, DEFAULT_BOOTSTRAP_PAGINATION, type DiscoverAlephBootstrapOptions, type FilterPublicMultiaddrsOptions, RELAY_BOOTSTRAP_SIGNATURE_SCHEME, type RelayBootstrapAuthorizationPayload, type RelayBootstrapAuthorizationRecord, type RelayBootstrapContent, type RelayBootstrapPostContent, type RelayBootstrapPostRecord, type RelayBootstrapProofPayload, type RelayBootstrapProofRecord, type RelayBootstrapProofSigner, type RelayBootstrapTrustMode, type RelayBootstrapVerificationResult, buildRelayBootstrapPostContent, createLibp2pAlephBootstrap, createRelayBootstrapPost, dedupeMultiaddrs, discoverAlephBootstrapMultiaddrs, fetchAlephBootstrapPosts, filterPublicMultiaddrs, filterRelayBootstrapPostsByProfile, isPublicMultiaddr, relayBootstrapMultiaddrsHash, relayBootstrapTrustMode, selectCompactRelayBootstrapMultiaddrs, selectCurrentRelayBootstrapPosts, signRelayBootstrapAuthorization, signRelayBootstrapProof, verifyRelayBootstrapAuthorization, verifyRelayBootstrapDualKeyContent, verifyRelayBootstrapProof };

package/index.js

@@ -629,6 +629,14 @@ function selectCurrentRelayBootstrapPosts(posts, options = {}) {
     (left, right) => compareRelayBootstrapPostRecency(right, left)
   );
 }
+function filterRelayBootstrapPostsByProfile(posts, profile) {
+  const wanted = (typeof profile === "string" ? [profile] : profile ?? []).map((entry) => entry.trim()).filter(Boolean);
+  if (wanted.length === 0) return [...posts];
+  const allowed = new Set(wanted);
+  return posts.filter(
+    (post) => post.content != null && allowed.has(String(post.content.profile))
+  );
+}
 async function filterTrustedRelayBootstrapPosts(posts, options = {}) {
   const requireDualKeyAttestation = options.requireDualKeyAttestation ?? false;
   const verifyDualKeyAttestation = options.verifyDualKeyAttestation ?? true;
@@ -668,9 +676,12 @@ async function discoverAlephBootstrapMultiaddrs(options = {}) {
       pagination
     });
     collectedPosts.push(...pagePosts);
-    const selectedPosts = selectCurrentRelayBootstrapPosts(collectedPosts, {
-      maxAgeMs: options.maxAgeMs
-    });
+    const selectedPosts = filterRelayBootstrapPostsByProfile(
+      selectCurrentRelayBootstrapPosts(collectedPosts, {
+        maxAgeMs: options.maxAgeMs
+      }),
+      options.profile
+    );
     const trustedPosts = await filterTrustedRelayBootstrapPosts(selectedPosts, {
       requireDualKeyAttestation: options.requireDualKeyAttestation,
       verifyDualKeyAttestation: options.verifyDualKeyAttestation
@@ -727,6 +738,7 @@ export {
   discoverAlephBootstrapMultiaddrs,
   fetchAlephBootstrapPosts,
   filterPublicMultiaddrs,
+  filterRelayBootstrapPostsByProfile,
   isPublicMultiaddr,
   relayBootstrapMultiaddrsHash,
   relayBootstrapTrustMode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/aleph-bootstrap",
-  "version": "0.6.33",
+  "version": "0.6.34",
   "description": "Aleph-backed libp2p bootstrap discovery and relay registration helpers.",
   "license": "MIT",
   "type": "module",