mnlib

mnlib is a Go library for gonnect ecosystem that resolves mesh-oriented DNS names.

It is meant for naming schemes where the authoritative DNS server can be derived from the name itself. Instead of sending DNS queries through the host OS resolver, mnlib sends them through a caller-provided gonnect.Network.

Supported Naming Schemes

mnlib currently understands these name formats:

Scheme	What it does	Reference
.meshname	Uses the second-level label as a Meshname authority address and resolves the full name via DNS on that node	meshname
.meship	Decodes the left label directly into an IPv6 address without doing DNS	meshname
.pk.ygg	Derives a Yggdrasil IPv6 address directly from an Ed25519 public key encoded in the label	yggstack
.ygg	Uses a Yggdrasil/YggNS authority label and resolves the full name via DNS on that node	YggNS, yggstack

For .ygg, these authority-label formats are supported:

• straight hex form
• base32 form
• dashed YggNS form

Supported Domain Examples

Examples of names accepted by the resolver:

• svc.aiag7sesed2aaxgcgbnevruwpy.meshname
• aiag7sesed2aaxgcgbnevruwpy.meship
• svc.d40d4a7153cf288ea28f1865f6cfe95143a478b5c8c9e7cb002a0633d10a53eb.pk.ygg
• svc.020212a900e54474d47382be16ac9381.ygg
• svc.2aijksahfir2ni44cxylkze4b.ygg
• svc.202-12a9-e5-4474-d473-82be-16ac-9381.ygg

The left-hand side can contain regular host or service labels. mnlib derives the authoritative node from the suffix and then asks that node for records such as A, AAAA, TXT, MX, NS, SRV, PTR, and CNAME.

Usage With gonnect/native

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/asciimoth/gonnect/native"
	"github.com/asciimoth/mnlib"
)

func main() {
	ctx := context.Background()

	// Use the host network stack as the transport for mesh DNS exchanges.
	network := native.Config{}.Build()

	resolver := mnlib.NewResolver(network)

	// Optional: use the native resolver for names outside mnlib's mesh schemes.
	resolver.Fallback = network

	addrs, err := resolver.LookupHost(ctx, "svc.aiag7sesed2aaxgcgbnevruwpy.meshname")
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(addrs)
}

If Fallback is not set, unsupported names are rejected instead of being sent to the system resolver.

License

Files in this repository are distributed under the CC0 license.

To the extent possible under law, ASCIIMoth has waived all copyright and related or neighboring rights to mnlib.