mirror of
https://github.com/fluencelabs/js-multiaddr-to-uri
synced 2024-12-12 19:45:44 +00:00
adda9366c1
This makes multiaddrs ending with `/tcp/8080` to default to HTTP unless an explicit assumeHttp: false is passed. We also skip default ports for HTTP and HTTPS in the URL. Motivation: https://github.com/ipfs/js-ipfs/pull/2358#issue-307463029 License: MIT Signed-off-by: Marcin Rataj <lidel@lidel.org>
46 lines
1.4 KiB
Markdown
46 lines
1.4 KiB
Markdown
# multiaddr-to-uri
|
|
|
|
[](https://travis-ci.org/tableflip/multiaddr-to-uri) [](https://david-dm.org/tableflip/multiaddr-to-uri) [](https://standardjs.com)
|
|
|
|
|
|
> Convert a Multiaddr to a URI /dnsaddr/ipfs.io/http -> http://ipfs.io
|
|
|
|
## Install
|
|
|
|
```sh
|
|
npm install multiaddr-to-uri
|
|
```
|
|
|
|
## Usage
|
|
|
|
```js
|
|
const toUri = require('multiaddr-to-uri')
|
|
|
|
console.log(toUri('/dnsaddr/protocol.ai/https'))
|
|
// -> https://protocol.ai
|
|
|
|
console.log(toUri('/ip4/127.0.0.1/tcp/8080'))
|
|
// -> http://127.0.0.1:8080
|
|
|
|
console.log(toUri('/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
|
|
|
|
## Contribute
|
|
|
|
Feel free to dive in! [Open an issue](https://github.com/tableflip/multiaddr-to-uri/issues/new) or submit PRs.
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE) © Alan Shaw
|