@libp2p/circuit-relay-v2 0.0.0-05b52d69c

package/dist/src/server/index.js

@@ -0,0 +1,313 @@
+import { TypedEventEmitter, setMaxListeners } from '@libp2p/interface/events';
+import { peerIdFromBytes } from '@libp2p/peer-id';
+import { RecordEnvelope } from '@libp2p/peer-record';
+import { multiaddr } from '@multiformats/multiaddr';
+import { pbStream } from 'it-protobuf-stream';
+import pDefer from 'p-defer';
+import { CIRCUIT_PROTO_CODE, DEFAULT_HOP_TIMEOUT, MAX_CONNECTIONS, RELAY_SOURCE_TAG, RELAY_V2_HOP_CODEC, RELAY_V2_STOP_CODEC } from '../constants.js';
+import { HopMessage, Status, StopMessage } from '../pb/index.js';
+import { createLimitedRelay } from '../utils.js';
+import { AdvertService } from './advert-service.js';
+import { ReservationStore } from './reservation-store.js';
+import { ReservationVoucherRecord } from './reservation-voucher.js';
+const isRelayAddr = (ma) => ma.protoCodes().includes(CIRCUIT_PROTO_CODE);
+const defaults = {
+    maxOutboundStopStreams: MAX_CONNECTIONS
+};
+class CircuitRelayServer extends TypedEventEmitter {
+    registrar;
+    peerStore;
+    addressManager;
+    peerId;
+    connectionManager;
+    connectionGater;
+    reservationStore;
+    advertService;
+    started;
+    hopTimeout;
+    shutdownController;
+    maxInboundHopStreams;
+    maxOutboundHopStreams;
+    maxOutboundStopStreams;
+    log;
+    /**
+     * Creates an instance of Relay
+     */
+    constructor(components, init = {}) {
+        super();
+        this.log = components.logger.forComponent('libp2p:circuit-relay:server');
+        this.registrar = components.registrar;
+        this.peerStore = components.peerStore;
+        this.addressManager = components.addressManager;
+        this.peerId = components.peerId;
+        this.connectionManager = components.connectionManager;
+        this.connectionGater = components.connectionGater;
+        this.started = false;
+        this.hopTimeout = init?.hopTimeout ?? DEFAULT_HOP_TIMEOUT;
+        this.shutdownController = new AbortController();
+        this.maxInboundHopStreams = init.maxInboundHopStreams;
+        this.maxOutboundHopStreams = init.maxOutboundHopStreams;
+        this.maxOutboundStopStreams = init.maxOutboundStopStreams ?? defaults.maxOutboundStopStreams;
+        setMaxListeners(Infinity, this.shutdownController.signal);
+        if (init.advertise != null && init.advertise !== false) {
+            this.advertService = new AdvertService(components, init.advertise === true ? undefined : init.advertise);
+            this.advertService.addEventListener('advert:success', () => {
+                this.safeDispatchEvent('relay:advert:success', {});
+            });
+            this.advertService.addEventListener('advert:error', (evt) => {
+                this.safeDispatchEvent('relay:advert:error', { detail: evt.detail });
+            });
+        }
+        this.reservationStore = new ReservationStore(init.reservations);
+    }
+    isStarted() {
+        return this.started;
+    }
+    /**
+     * Start Relay service
+     */
+    async start() {
+        if (this.started) {
+            return;
+        }
+        // Advertise service if HOP enabled and advertising enabled
+        this.advertService?.start();
+        await this.registrar.handle(RELAY_V2_HOP_CODEC, (data) => {
+            void this.onHop(data).catch(err => {
+                this.log.error(err);
+            });
+        }, {
+            maxInboundStreams: this.maxInboundHopStreams,
+            maxOutboundStreams: this.maxOutboundHopStreams,
+            runOnTransientConnection: true
+        });
+        this.reservationStore.start();
+        this.started = true;
+    }
+    /**
+     * Stop Relay service
+     */
+    async stop() {
+        this.advertService?.stop();
+        this.reservationStore.stop();
+        this.shutdownController.abort();
+        await this.registrar.unhandle(RELAY_V2_HOP_CODEC);
+        this.started = false;
+    }
+    async onHop({ connection, stream }) {
+        this.log('received circuit v2 hop protocol stream from %p', connection.remotePeer);
+        const hopTimeoutPromise = pDefer();
+        const timeout = setTimeout(() => {
+            hopTimeoutPromise.reject('timed out');
+        }, this.hopTimeout);
+        const pbstr = pbStream(stream);
+        try {
+            const request = await Promise.race([
+                pbstr.pb(HopMessage).read(),
+                hopTimeoutPromise.promise
+            ]);
+            if (request?.type == null) {
+                throw new Error('request was invalid, could not read from stream');
+            }
+            this.log('received', request.type);
+            await Promise.race([
+                this.handleHopProtocol({
+                    connection,
+                    stream: pbstr,
+                    request
+                }),
+                hopTimeoutPromise.promise
+            ]);
+        }
+        catch (err) {
+            this.log.error('error while handling hop', err);
+            await pbstr.pb(HopMessage).write({
+                type: HopMessage.Type.STATUS,
+                status: Status.MALFORMED_MESSAGE
+            });
+            stream.abort(err);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async handleHopProtocol({ stream, request, connection }) {
+        this.log('received hop message');
+        switch (request.type) {
+            case HopMessage.Type.RESERVE:
+                await this.handleReserve({ stream, request, connection });
+                break;
+            case HopMessage.Type.CONNECT:
+                await this.handleConnect({ stream, request, connection });
+                break;
+            default: {
+                this.log.error('invalid hop request type %s via peer %p', request.type, connection.remotePeer);
+                await stream.pb(HopMessage).write({ type: HopMessage.Type.STATUS, status: Status.UNEXPECTED_MESSAGE });
+            }
+        }
+    }
+    async handleReserve({ stream, request, connection }) {
+        const hopstr = stream.pb(HopMessage);
+        this.log('hop reserve request from %p', connection.remotePeer);
+        if (isRelayAddr(connection.remoteAddr)) {
+            this.log.error('relay reservation over circuit connection denied for peer: %p', connection.remotePeer);
+            await hopstr.write({ type: HopMessage.Type.STATUS, status: Status.PERMISSION_DENIED });
+            return;
+        }
+        if ((await this.connectionGater.denyInboundRelayReservation?.(connection.remotePeer)) === true) {
+            this.log.error('reservation for %p denied by connection gater', connection.remotePeer);
+            await hopstr.write({ type: HopMessage.Type.STATUS, status: Status.PERMISSION_DENIED });
+            return;
+        }
+        const result = this.reservationStore.reserve(connection.remotePeer, connection.remoteAddr);
+        if (result.status !== Status.OK) {
+            await hopstr.write({ type: HopMessage.Type.STATUS, status: result.status });
+            return;
+        }
+        try {
+            // tag relay target peer
+            // result.expire is non-null if `ReservationStore.reserve` returns with status == OK
+            if (result.expire != null) {
+                const ttl = (result.expire * 1000) - Date.now();
+                await this.peerStore.merge(connection.remotePeer, {
+                    tags: {
+                        [RELAY_SOURCE_TAG]: { value: 1, ttl }
+                    }
+                });
+            }
+            await hopstr.write({
+                type: HopMessage.Type.STATUS,
+                status: Status.OK,
+                reservation: await this.makeReservation(connection.remotePeer, BigInt(result.expire ?? 0)),
+                limit: this.reservationStore.get(connection.remotePeer)?.limit
+            });
+            this.log('sent confirmation response to %s', connection.remotePeer);
+        }
+        catch (err) {
+            this.log.error('failed to send confirmation response to %p', connection.remotePeer, err);
+            this.reservationStore.removeReservation(connection.remotePeer);
+        }
+    }
+    async makeReservation(remotePeer, expire) {
+        const addrs = [];
+        for (const relayAddr of this.addressManager.getAddresses()) {
+            if (relayAddr.toString().includes('/p2p-circuit')) {
+                continue;
+            }
+            addrs.push(relayAddr.bytes);
+        }
+        const voucher = await RecordEnvelope.seal(new ReservationVoucherRecord({
+            peer: remotePeer,
+            relay: this.peerId,
+            expiration: Number(expire)
+        }), this.peerId);
+        return {
+            addrs,
+            expire,
+            voucher: voucher.marshal()
+        };
+    }
+    async handleConnect({ stream, request, connection }) {
+        const hopstr = stream.pb(HopMessage);
+        if (isRelayAddr(connection.remoteAddr)) {
+            this.log.error('relay reservation over circuit connection denied for peer: %p', connection.remotePeer);
+            await hopstr.write({ type: HopMessage.Type.STATUS, status: Status.PERMISSION_DENIED });
+            return;
+        }
+        this.log('hop connect request from %p', connection.remotePeer);
+        let dstPeer;
+        try {
+            if (request.peer == null) {
+                this.log.error('no peer info in hop connect request');
+                throw new Error('no peer info in request');
+            }
+            request.peer.addrs.forEach(multiaddr);
+            dstPeer = peerIdFromBytes(request.peer.id);
+        }
+        catch (err) {
+            this.log.error('invalid hop connect request via peer %p %s', connection.remotePeer, err);
+            await hopstr.write({ type: HopMessage.Type.STATUS, status: Status.MALFORMED_MESSAGE });
+            return;
+        }
+        if (!this.reservationStore.hasReservation(dstPeer)) {
+            this.log.error('hop connect denied for destination peer %p not having a reservation for %p with status %s', dstPeer, connection.remotePeer, Status.NO_RESERVATION);
+            await hopstr.write({ type: HopMessage.Type.STATUS, status: Status.NO_RESERVATION });
+            return;
+        }
+        if ((await this.connectionGater.denyOutboundRelayedConnection?.(connection.remotePeer, dstPeer)) === true) {
+            this.log.error('hop connect for %p to %p denied by connection gater', connection.remotePeer, dstPeer);
+            await hopstr.write({ type: HopMessage.Type.STATUS, status: Status.PERMISSION_DENIED });
+            return;
+        }
+        const connections = this.connectionManager.getConnections(dstPeer);
+        if (connections.length === 0) {
+            this.log('hop connect denied for destination peer %p not having a connection for %p as there is no destination connection', dstPeer, connection.remotePeer);
+            await hopstr.write({ type: HopMessage.Type.STATUS, status: Status.NO_RESERVATION });
+            return;
+        }
+        const destinationConnection = connections[0];
+        const destinationStream = await this.stopHop({
+            connection: destinationConnection,
+            request: {
+                type: StopMessage.Type.CONNECT,
+                peer: {
+                    id: connection.remotePeer.toBytes(),
+                    addrs: []
+                }
+            }
+        });
+        if (destinationStream == null) {
+            this.log.error('failed to open stream to destination peer %p', destinationConnection?.remotePeer);
+            await hopstr.write({ type: HopMessage.Type.STATUS, status: Status.CONNECTION_FAILED });
+            return;
+        }
+        await hopstr.write({ type: HopMessage.Type.STATUS, status: Status.OK });
+        const sourceStream = stream.unwrap();
+        this.log('connection from %p to %p established - merging streams', connection.remotePeer, dstPeer);
+        const limit = this.reservationStore.get(dstPeer)?.limit;
+        // Short circuit the two streams to create the relayed connection
+        createLimitedRelay(sourceStream, destinationStream, this.shutdownController.signal, limit, {
+            log: this.log
+        });
+    }
+    /**
+     * Send a STOP request to the target peer that the dialing peer wants to contact
+     */
+    async stopHop({ connection, request }) {
+        this.log('starting circuit relay v2 stop request to %s', connection.remotePeer);
+        const stream = await connection.newStream([RELAY_V2_STOP_CODEC], {
+            maxOutboundStreams: this.maxOutboundStopStreams,
+            runOnTransientConnection: true
+        });
+        const pbstr = pbStream(stream);
+        const stopstr = pbstr.pb(StopMessage);
+        await stopstr.write(request);
+        let response;
+        try {
+            response = await stopstr.read();
+        }
+        catch (err) {
+            this.log.error('error parsing stop message response from %p', connection.remotePeer);
+        }
+        if (response == null) {
+            this.log.error('could not read response from %p', connection.remotePeer);
+            await stream.close();
+            return;
+        }
+        if (response.status === Status.OK) {
+            this.log('stop request to %p was successful', connection.remotePeer);
+            return pbstr.unwrap();
+        }
+        this.log('stop request failed with code %d', response.status);
+        await stream.close();
+    }
+    get reservations() {
+        return this.reservationStore.reservations;
+    }
+}
+export function circuitRelayServer(init = {}) {
+    return (components) => {
+        return new CircuitRelayServer(components, init);
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/server/index.js.map

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

package/dist/src/server/reservation-store.d.ts

@@ -0,0 +1,49 @@
+import { PeerMap } from '@libp2p/peer-collections';
+import { type Limit, Status } from '../pb/index.js';
+import type { RelayReservation } from '../index.js';
+import type { RecursivePartial } from '@libp2p/interface';
+import type { PeerId } from '@libp2p/interface/peer-id';
+import type { Startable } from '@libp2p/interface/startable';
+import type { Multiaddr } from '@multiformats/multiaddr';
+export type ReservationStatus = Status.OK | Status.PERMISSION_DENIED | Status.RESERVATION_REFUSED;
+export interface ReservationStoreInit {
+    maxReservations?: number;
+    reservationClearInterval?: number;
+    applyDefaultLimit?: boolean;
+    /**
+     * reservation ttl, default: 2 hours
+     */
+    reservationTtl?: number;
+    /**
+     * The maximum time a relayed connection can be open for
+     */
+    defaultDurationLimit?: number;
+    /**
+     * The maximum amount of data allowed to be transferred over a relayed connection
+     */
+    defaultDataLimit?: bigint;
+}
+export type ReservationStoreOptions = RecursivePartial<ReservationStoreInit>;
+export declare class ReservationStore implements Startable {
+    readonly reservations: PeerMap<RelayReservation>;
+    private _started;
+    private interval;
+    private readonly maxReservations;
+    private readonly reservationClearInterval;
+    private readonly applyDefaultLimit;
+    private readonly reservationTtl;
+    private readonly defaultDurationLimit;
+    private readonly defaultDataLimit;
+    constructor(options?: ReservationStoreOptions);
+    isStarted(): boolean;
+    start(): void;
+    stop(): void;
+    reserve(peer: PeerId, addr: Multiaddr, limit?: Limit): {
+        status: ReservationStatus;
+        expire?: number;
+    };
+    removeReservation(peer: PeerId): void;
+    hasReservation(dst: PeerId): boolean;
+    get(peer: PeerId): RelayReservation | undefined;
+}
+//# sourceMappingURL=reservation-store.d.ts.map

package/dist/src/server/reservation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservation-store.d.ts","sourceRoot":"","sources":["../../../src/server/reservation-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAElD,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAA;AAEjG,MAAM,WAAW,oBAAoB;IAInC,eAAe,CAAC,EAAE,MAAM,CAAA;IAIxB,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAIjC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,CAAA;AAE5E,qBAAa,gBAAiB,YAAW,SAAS;IAChD,SAAgB,YAAY,4BAAkC;IAC9D,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAQ;IACjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAQ;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;gBAE5B,OAAO,GAAE,uBAA4B;IASlD,SAAS,IAAK,OAAO;IAIrB,KAAK,IAAK,IAAI;IAkBd,IAAI,IAAK,IAAI;IAIb,OAAO,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAkBtG,iBAAiB,CAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAItC,cAAc,CAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAIrC,GAAG,CAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;CAGjD"}

package/dist/src/server/reservation-store.js

@@ -0,0 +1,65 @@
+import { PeerMap } from '@libp2p/peer-collections';
+import { DEFAULT_DATA_LIMIT, DEFAULT_DURATION_LIMIT, DEFAULT_MAX_RESERVATION_CLEAR_INTERVAL, DEFAULT_MAX_RESERVATION_STORE_SIZE, DEFAULT_MAX_RESERVATION_TTL } from '../constants.js';
+import { Status } from '../pb/index.js';
+export class ReservationStore {
+    reservations = new PeerMap();
+    _started = false;
+    interval;
+    maxReservations;
+    reservationClearInterval;
+    applyDefaultLimit;
+    reservationTtl;
+    defaultDurationLimit;
+    defaultDataLimit;
+    constructor(options = {}) {
+        this.maxReservations = options.maxReservations ?? DEFAULT_MAX_RESERVATION_STORE_SIZE;
+        this.reservationClearInterval = options.reservationClearInterval ?? DEFAULT_MAX_RESERVATION_CLEAR_INTERVAL;
+        this.applyDefaultLimit = options.applyDefaultLimit !== false;
+        this.reservationTtl = options.reservationTtl ?? DEFAULT_MAX_RESERVATION_TTL;
+        this.defaultDurationLimit = options.defaultDurationLimit ?? DEFAULT_DURATION_LIMIT;
+        this.defaultDataLimit = options.defaultDataLimit ?? DEFAULT_DATA_LIMIT;
+    }
+    isStarted() {
+        return this._started;
+    }
+    start() {
+        if (this._started) {
+            return;
+        }
+        this._started = true;
+        this.interval = setInterval(() => {
+            const now = (new Date()).getTime();
+            this.reservations.forEach((r, k) => {
+                if (r.expire.getTime() < now) {
+                    this.reservations.delete(k);
+                }
+            });
+        }, this.reservationClearInterval);
+    }
+    stop() {
+        clearInterval(this.interval);
+    }
+    reserve(peer, addr, limit) {
+        if (this.reservations.size >= this.maxReservations && !this.reservations.has(peer)) {
+            return { status: Status.RESERVATION_REFUSED };
+        }
+        const expire = new Date(Date.now() + this.reservationTtl);
+        let checkedLimit;
+        if (this.applyDefaultLimit) {
+            checkedLimit = limit ?? { data: this.defaultDataLimit, duration: this.defaultDurationLimit };
+        }
+        this.reservations.set(peer, { addr, expire, limit: checkedLimit });
+        // return expiry time in seconds
+        return { status: Status.OK, expire: Math.round(expire.getTime() / 1000) };
+    }
+    removeReservation(peer) {
+        this.reservations.delete(peer);
+    }
+    hasReservation(dst) {
+        return this.reservations.has(dst);
+    }
+    get(peer) {
+        return this.reservations.get(peer);
+    }
+}
+//# sourceMappingURL=reservation-store.js.map

package/dist/src/server/reservation-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservation-store.js","sourceRoot":"","sources":["../../../src/server/reservation-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,sCAAsC,EAAE,kCAAkC,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AACrL,OAAO,EAAc,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAsCnD,MAAM,OAAO,gBAAgB;IACX,YAAY,GAAG,IAAI,OAAO,EAAoB,CAAA;IACtD,QAAQ,GAAG,KAAK,CAAA;IAChB,QAAQ,CAAK;IACJ,eAAe,CAAQ;IACvB,wBAAwB,CAAQ;IAChC,iBAAiB,CAAS;IAC1B,cAAc,CAAQ;IACtB,oBAAoB,CAAQ;IAC5B,gBAAgB,CAAQ;IAEzC,YAAa,UAAmC,EAAE;QAChD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,kCAAkC,CAAA;QACpF,IAAI,CAAC,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,IAAI,sCAAsC,CAAA;QAC1G,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,KAAK,KAAK,CAAA;QAC5D,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,2BAA2B,CAAA;QAC3E,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,sBAAsB,CAAA;QAClF,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,kBAAkB,CAAA;IACxE,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,EAAE;YACjB,OAAM;SACP;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC,QAAQ,GAAG,WAAW,CACzB,GAAG,EAAE;YACH,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAA;YAClC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACjC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,EAAE;oBAC5B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;iBAC5B;YACH,CAAC,CAAC,CAAA;QACJ,CAAC,EACD,IAAI,CAAC,wBAAwB,CAC9B,CAAA;IACH,CAAC;IAED,IAAI;QACF,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO,CAAE,IAAY,EAAE,IAAe,EAAE,KAAa;QACnD,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAClF,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,mBAAmB,EAAE,CAAA;SAC9C;QAED,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,CAAA;QACzD,IAAI,YAA+B,CAAA;QAEnC,IAAI,IAAI,CAAC,iBAAiB,EAAE;YAC1B,YAAY,GAAG,KAAK,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,CAAA;SAC7F;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAA;QAElE,gCAAgC;QAChC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,CAAA;IAC3E,CAAC;IAED,iBAAiB,CAAE,IAAY;QAC7B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAED,cAAc,CAAE,GAAW;QACzB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACnC,CAAC;IAED,GAAG,CAAE,IAAY;QACf,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;CACF"}

package/dist/src/server/reservation-voucher.d.ts

@@ -0,0 +1,18 @@
+import type { PeerId } from '@libp2p/interface/peer-id';
+import type { Record } from '@libp2p/interface/record';
+export interface ReservationVoucherOptions {
+    relay: PeerId;
+    peer: PeerId;
+    expiration: number;
+}
+export declare class ReservationVoucherRecord implements Record {
+    readonly domain = "libp2p-relay-rsvp";
+    readonly codec: Uint8Array;
+    private readonly relay;
+    private readonly peer;
+    private readonly expiration;
+    constructor({ relay, peer, expiration }: ReservationVoucherOptions);
+    marshal(): Uint8Array;
+    equals(other: Record): boolean;
+}
+//# sourceMappingURL=reservation-voucher.d.ts.map

package/dist/src/server/reservation-voucher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservation-voucher.d.ts","sourceRoot":"","sources":["../../../src/server/reservation-voucher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAEtD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,wBAAyB,YAAW,MAAM;IACrD,SAAgB,MAAM,uBAAsB;IAC5C,SAAgB,KAAK,aAA+B;IAEpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEtB,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,yBAAyB;IAMnE,OAAO,IAAK,UAAU;IAQtB,MAAM,CAAE,KAAK,EAAE,MAAM,GAAG,OAAO;CAkBhC"}

package/dist/src/server/reservation-voucher.js

@@ -0,0 +1,36 @@
+import { ReservationVoucher } from '../pb/index.js';
+export class ReservationVoucherRecord {
+    domain = 'libp2p-relay-rsvp';
+    codec = new Uint8Array([0x03, 0x02]);
+    relay;
+    peer;
+    expiration;
+    constructor({ relay, peer, expiration }) {
+        this.relay = relay;
+        this.peer = peer;
+        this.expiration = expiration;
+    }
+    marshal() {
+        return ReservationVoucher.encode({
+            relay: this.relay.toBytes(),
+            peer: this.peer.toBytes(),
+            expiration: BigInt(this.expiration)
+        });
+    }
+    equals(other) {
+        if (!(other instanceof ReservationVoucherRecord)) {
+            return false;
+        }
+        if (!this.peer.equals(other.peer)) {
+            return false;
+        }
+        if (!this.relay.equals(other.relay)) {
+            return false;
+        }
+        if (this.expiration !== other.expiration) {
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=reservation-voucher.js.map

package/dist/src/server/reservation-voucher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservation-voucher.js","sourceRoot":"","sources":["../../../src/server/reservation-voucher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAUnD,MAAM,OAAO,wBAAwB;IACnB,MAAM,GAAG,mBAAmB,CAAA;IAC5B,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IAEnC,KAAK,CAAQ;IACb,IAAI,CAAQ;IACZ,UAAU,CAAQ;IAEnC,YAAa,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAA6B;QACjE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED,OAAO;QACL,OAAO,kBAAkB,CAAC,MAAM,CAAC;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACzB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;SACpC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,CAAE,KAAa;QACnB,IAAI,CAAC,CAAC,KAAK,YAAY,wBAAwB,CAAC,EAAE;YAChD,OAAO,KAAK,CAAA;SACb;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;YACjC,OAAO,KAAK,CAAA;SACb;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YACnC,OAAO,KAAK,CAAA;SACb;QAED,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,EAAE;YACxC,OAAO,KAAK,CAAA;SACb;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/src/transport/discovery.d.ts

@@ -0,0 +1,48 @@
+import { TypedEventEmitter } from '@libp2p/interface/events';
+import type { ComponentLogger } from '@libp2p/interface';
+import type { ContentRouting } from '@libp2p/interface/content-routing';
+import type { PeerId } from '@libp2p/interface/peer-id';
+import type { PeerStore } from '@libp2p/interface/peer-store';
+import type { Startable } from '@libp2p/interface/startable';
+import type { ConnectionManager } from '@libp2p/interface-internal/connection-manager';
+import type { Registrar } from '@libp2p/interface-internal/registrar';
+import type { TransportManager } from '@libp2p/interface-internal/transport-manager';
+export interface RelayDiscoveryEvents {
+    'relay:discover': CustomEvent<PeerId>;
+}
+export interface RelayDiscoveryComponents {
+    peerId: PeerId;
+    peerStore: PeerStore;
+    connectionManager: ConnectionManager;
+    transportManager: TransportManager;
+    contentRouting: ContentRouting;
+    registrar: Registrar;
+    logger: ComponentLogger;
+}
+/**
+ * ReservationManager automatically makes a circuit v2 reservation on any connected
+ * peers that support the circuit v2 HOP protocol.
+ */
+export declare class RelayDiscovery extends TypedEventEmitter<RelayDiscoveryEvents> implements Startable {
+    private readonly peerId;
+    private readonly peerStore;
+    private readonly contentRouting;
+    private readonly registrar;
+    private started;
+    private topologyId?;
+    private readonly log;
+    constructor(components: RelayDiscoveryComponents);
+    isStarted(): boolean;
+    start(): Promise<void>;
+    stop(): void;
+    /**
+     * Try to listen on available hop relay connections.
+     * The following order will happen while we do not have enough relays:
+     *
+     * 1. Check the metadata store for known relays, try to listen on the ones we are already connected
+     * 2. Dial and try to listen on the peers we know that support hop but are not connected
+     * 3. Search the network
+     */
+    discover(): Promise<void>;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/src/transport/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/transport/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAM5D,OAAO,KAAK,EAAE,eAAe,EAAU,MAAM,mBAAmB,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAA;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAEpF,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,cAAc,EAAE,cAAc,CAAA;IAC9B,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,eAAe,CAAA;CACxB;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,iBAAiB,CAAC,oBAAoB,CAAE,YAAW,SAAS;IAC9F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAC,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;gBAEf,UAAU,EAAE,wBAAwB;IAWjD,SAAS,IAAK,OAAO;IAIf,KAAK,IAAK,OAAO,CAAC,IAAI,CAAC;IAkB7B,IAAI,IAAK,IAAI;IAQb;;;;;;;OAOG;IACG,QAAQ,IAAK,OAAO,CAAC,IAAI,CAAC;CA8CjC"}