12 // Magnet link components.
14 InfoHash Hash // Expected in this implementation
15 Trackers []string // "tr" values
16 DisplayName string // "dn" value, if not empty
17 Params url.Values // All other values, such as "x.pe", "as", "xs" etc.
20 const xtPrefix = "urn:btih:"
22 func (m Magnet) String() string {
24 vs := make(url.Values, len(m.Params)+len(m.Trackers)+2)
25 for k, v := range m.Params {
26 vs[k] = append([]string(nil), v...)
29 for _, tr := range m.Trackers {
32 if m.DisplayName != "" {
33 vs.Add("dn", m.DisplayName)
36 // Transmission and Deluge both expect "urn:btih:" to be unescaped. Deluge wants it to be at the
37 // start of the magnet link. The InfoHash field is expected to be BitTorrent in this
41 RawQuery: "xt=" + xtPrefix + m.InfoHash.HexString(),
44 u.RawQuery += "&" + vs.Encode()
49 // Deprecated: Use ParseMagnetUri.
50 var ParseMagnetURI = ParseMagnetUri
52 // ParseMagnetUri parses Magnet-formatted URIs into a Magnet instance
53 func ParseMagnetUri(uri string) (m Magnet, err error) {
54 u, err := url.Parse(uri)
56 err = fmt.Errorf("error parsing uri: %w", err)
59 if u.Scheme != "magnet" {
60 err = fmt.Errorf("unexpected scheme %q", u.Scheme)
65 m.InfoHash, err = parseInfohash(q.Get("xt"))
67 err = fmt.Errorf("error parsing infohash %q: %w", xt, err)
71 m.DisplayName = q.Get("dn")
82 func parseInfohash(xt string) (ih Hash, err error) {
83 if !strings.HasPrefix(xt, xtPrefix) {
84 err = errors.New("bad xt parameter prefix")
87 encoded := xt[len(xtPrefix):]
88 decode := func() func(dst, src []byte) (int, error) {
93 return base32.StdEncoding.Decode
98 err = fmt.Errorf("unhandled xt parameter encoding (encoded length %d)", len(encoded))
101 n, err := decode(ih[:], []byte(encoded))
103 err = fmt.Errorf("error decoding xt: %w", err)
112 func dropFirst(vs url.Values, key string) {