UNPKG

@multiformats/multiaddr-to-uri

Version:
36 lines 1.24 kB
/** * @packageDocumentation * * This module allows easy conversion of Multiaddrs to string URIs. * * @example Converting multiaddrs to string URIs * * ```js * import { multiaddrToUri } from '@multiformats/multiaddr-to-uri' * * console.log(multiaddrToUri('/dnsaddr/protocol.ai/https')) * // -> https://protocol.ai * * console.log(multiaddrToUri('/ip4/127.0.0.1/tcp/8080')) * // -> http://127.0.0.1:8080 * * console.log(multiaddrToUri('/ip4/127.0.0.1/tcp/8080', { assumeHttp: false })) * // -> tcp://127.0.0.1:8080 * ``` * * Note: * * - When `/tcp` is the last (terminating) protocol HTTP is assumed by default (implicit `assumeHttp: true`) * - this means produced URIs will start with `http://` instead of `tcp://` * - passing `{ assumeHttp: false }` disables this behavior * - Might be lossy - e.g. a DNSv6 multiaddr * - Can throw if the passed multiaddr: * - is not a valid multiaddr * - is not supported as a URI e.g. circuit */ import type { Multiaddr } from '@multiformats/multiaddr'; export interface MultiaddrToUriOpts { assumeHttp?: boolean; } export declare function multiaddrToUri(input: Multiaddr | string | Uint8Array, opts?: MultiaddrToUriOpts): string; //# sourceMappingURL=index.d.ts.map