@multiformats/multiaddr-to-uri
Version:
Convert a Multiaddr to a URI
36 lines • 1.24 kB
TypeScript
/**
* @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