https://github.com/multiformats/go-multiaddr-dns

Go library and CLI tool for /dns4, /dns6, /dnsaddr multiaddr resolution
https://github.com/multiformats/go-multiaddr-dns

dns dnsaddr madns multiaddr resolve

Last synced: 2 days ago
JSON representation

Go library and CLI tool for /dns4, /dns6, /dnsaddr multiaddr resolution

• Host: GitHub
• URL: https://github.com/multiformats/go-multiaddr-dns
• Owner: multiformats
• License: mit
• Created: 2017-03-05T02:38:05.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-11-26T14:24:49.000Z (about 1 month ago)
• Last Synced: 2024-12-24T22:05:40.426Z (9 days ago)
• Topics: dns, dnsaddr, madns, multiaddr, resolve
• Language: Go
• Homepage: https://multiformats.io/multiaddr
• Size: 1.09 MB
• Stars: 30
• Watchers: 18
• Forks: 18
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# go-multiaddr-dns

> Resolve /dns4, /dns6, and /dnsaddr multiaddrs.

```sh

> madns /dnsaddr/ipfs.io/ipfs/QmSoLju6m7xTh3DuokvT3886QRYqxAzb1kShaanJgW36yx

/ip4/104.236.151.122/tcp/4001/ipfs/QmSoLju6m7xTh3DuokvT3886QRYqxAzb1kShaanJgW36yx

/ip6/2604:a880:1:20::1d9:6001/tcp/4001/ipfs/QmSoLju6m7xTh3DuokvT3886QRYqxAzb1kShaanJgW36yx

/ip6/fc3d:9a4e:3c96:2fd2:1afa:18fe:8dd2:b602/tcp/4001/ipfs/QmSoLju6m7xTh3DuokvT3886QRYqxAzb1kShaanJgW36yx

/dns4/jupiter.i.ipfs.io/tcp/4001/ipfs/QmSoLju6m7xTh3DuokvT3886QRYqxAzb1kShaanJgW36yx

/dns6/jupiter.i.ipfs.io/tcp/4001/ipfs/QmSoLju6m7xTh3DuokvT3886QRYqxAzb1kShaanJgW36yx

```

In more detail:

```sh

> madns /dns6/example.net

/ip6/2001:db8::a3

/ip6/2001:db8::a4

...

> madns /dns4/example.net/tcp/443/wss

/ip4/192.0.2.1/tcp/443/wss

/ip4/192.0.2.2/tcp/443/wss

# No-op if it's not a dns-ish address.

> madns /ip4/127.0.0.1/tcp/8080

/ip4/127.0.0.1/tcp/8080

# /dnsaddr resolves by looking up TXT records.

> dig +short TXT _dnsaddr.example.net

"dnsaddr=/ip6/2001:db8::a3/tcp/443/wss/ipfs/Qmfoo"

"dnsaddr=/ip6/2001:db8::a4/tcp/443/wss/ipfs/Qmbar"

"dnsaddr=/ip4/192.0.2.1/tcp/443/wss/ipfs/Qmfoo"

"dnsaddr=/ip4/192.0.2.2/tcp/443/wss/ipfs/Qmbar"

...

# /dnsaddr returns addrs which encapsulate whatever /dnsaddr encapsulates too.

> madns example.net/ipfs/Qmfoo

info: changing query to /dnsaddr/example.net/ipfs/Qmfoo

/ip6/2001:db8::a3/tcp/443/wss/ipfs/Qmfoo

/ip4/192.0.2.1/tcp/443/wss/ipfs/Qmfoo

# TODO -p filters by protocol stacks.

> madns -p /ip6/tcp/wss /dnsaddr/example.net

/ip6/2001:db8::a3/tcp/443/wss/ipfs/Qmfoo

/ip6/2001:db8::a4/tcp/443/wss/ipfs/Qmbar

# TODO -c filters by CIDR

> madns -c /ip4/104.236.76.0/ipcidr/24 /dnsaddr/example.net

/ip4/192.0.2.2/tcp/443/wss/ipfs/Qmbar

```