madns

package module

v0.2.3 Latest Latest Go to latest Published: Jun 9, 2018 License: MIT Imports: 6 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/dms3-mft/go-multiaddr-dns

Links

Open Source Insights

README ¶

go-multiaddr-dns

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

> 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:

> 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

# TOOD -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

Documentation ¶

Index ¶

Variables
func Matches(maddr ma.Multiaddr) bool
func Resolve(ctx context.Context, maddr ma.Multiaddr) ([]ma.Multiaddr, error)
type MockBackend
- func (r *MockBackend) LookupIPAddr(ctx context.Context, name string) ([]net.IPAddr, error)
- func (r *MockBackend) LookupTXT(ctx context.Context, name string) ([]string, error)
type Resolver
- func (r *Resolver) Resolve(ctx context.Context, maddr ma.Multiaddr) ([]ma.Multiaddr, error)

Constants ¶

This section is empty.

Variables ¶

View Source

var DefaultResolver = &Resolver{Backend: net.DefaultResolver}

View Source

var Dns4Protocol = ma.Protocol{
	Code:       54,
	Size:       ma.LengthPrefixedVarSize,
	Name:       "dns4",
	VCode:      ma.CodeToVarint(54),
	Transcoder: DnsTranscoder,
}

View Source

var Dns6Protocol = ma.Protocol{
	Code:       55,
	Size:       ma.LengthPrefixedVarSize,
	Name:       "dns6",
	VCode:      ma.CodeToVarint(55),
	Transcoder: DnsTranscoder,
}

View Source

var DnsTranscoder = ma.NewTranscoderFromFunctions(dnsStB, dnsBtS)

View Source

var DnsaddrProtocol = ma.Protocol{
	Code:       56,
	Size:       ma.LengthPrefixedVarSize,
	Name:       "dnsaddr",
	VCode:      ma.CodeToVarint(56),
	Transcoder: DnsTranscoder,
}

View Source

var ResolvableProtocols = []ma.Protocol{DnsaddrProtocol, Dns4Protocol, Dns6Protocol}

Functions ¶

func Matches ¶ added in v0.2.0

func Matches(maddr ma.Multiaddr) bool

func Resolve ¶

func Resolve(ctx context.Context, maddr ma.Multiaddr) ([]ma.Multiaddr, error)

Types ¶

type MockBackend ¶ added in v0.1.1

type MockBackend struct {
	IP  map[string][]net.IPAddr
	TXT map[string][]string
}

func (*MockBackend) LookupIPAddr ¶ added in v0.1.1

func (r *MockBackend) LookupIPAddr(ctx context.Context, name string) ([]net.IPAddr, error)

func (*MockBackend) LookupTXT ¶ added in v0.1.1

func (r *MockBackend) LookupTXT(ctx context.Context, name string) ([]string, error)

type Resolver ¶

type Resolver struct {
	Backend backend
}

func (*Resolver) Resolve ¶

func (r *Resolver) Resolve(ctx context.Context, maddr ma.Multiaddr) ([]ma.Multiaddr, error)

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
madns

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL