b628d72766
This changes the CI / release builds to use the latest Go version. It also upgrades golangci-lint to a newer version compatible with Go 1.19. In Go 1.19, godoc has gained official support for links and lists. The syntax for code blocks in doc comments has changed and now requires a leading tab character. gofmt adapts comments to the new syntax automatically, so there are a lot of comment re-formatting changes in this PR. We need to apply the new format in order to pass the CI lint stage with Go 1.19. With the linter upgrade, I have decided to disable 'gosec' - it produces too many false-positive warnings. The 'deadcode' and 'varcheck' linters have also been removed because golangci-lint warns about them being unmaintained. 'unused' provides similar coverage and we already have it enabled, so we don't lose much with this change.
104 lines
3.0 KiB
Go
104 lines
3.0 KiB
Go
// Copyright 2017 The go-ethereum Authors
|
|
// This file is part of the go-ethereum library.
|
|
//
|
|
// The go-ethereum library is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU Lesser General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// The go-ethereum library is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public License
|
|
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
package accounts
|
|
|
|
import (
|
|
"encoding/json"
|
|
"errors"
|
|
"fmt"
|
|
"strings"
|
|
)
|
|
|
|
// URL represents the canonical identification URL of a wallet or account.
|
|
//
|
|
// It is a simplified version of url.URL, with the important limitations (which
|
|
// are considered features here) that it contains value-copyable components only,
|
|
// as well as that it doesn't do any URL encoding/decoding of special characters.
|
|
//
|
|
// The former is important to allow an account to be copied without leaving live
|
|
// references to the original version, whereas the latter is important to ensure
|
|
// one single canonical form opposed to many allowed ones by the RFC 3986 spec.
|
|
//
|
|
// As such, these URLs should not be used outside of the scope of an Ethereum
|
|
// wallet or account.
|
|
type URL struct {
|
|
Scheme string // Protocol scheme to identify a capable account backend
|
|
Path string // Path for the backend to identify a unique entity
|
|
}
|
|
|
|
// parseURL converts a user supplied URL into the accounts specific structure.
|
|
func parseURL(url string) (URL, error) {
|
|
parts := strings.Split(url, "://")
|
|
if len(parts) != 2 || parts[0] == "" {
|
|
return URL{}, errors.New("protocol scheme missing")
|
|
}
|
|
return URL{
|
|
Scheme: parts[0],
|
|
Path: parts[1],
|
|
}, nil
|
|
}
|
|
|
|
// String implements the stringer interface.
|
|
func (u URL) String() string {
|
|
if u.Scheme != "" {
|
|
return fmt.Sprintf("%s://%s", u.Scheme, u.Path)
|
|
}
|
|
return u.Path
|
|
}
|
|
|
|
// TerminalString implements the log.TerminalStringer interface.
|
|
func (u URL) TerminalString() string {
|
|
url := u.String()
|
|
if len(url) > 32 {
|
|
return url[:31] + ".."
|
|
}
|
|
return url
|
|
}
|
|
|
|
// MarshalJSON implements the json.Marshaller interface.
|
|
func (u URL) MarshalJSON() ([]byte, error) {
|
|
return json.Marshal(u.String())
|
|
}
|
|
|
|
// UnmarshalJSON parses url.
|
|
func (u *URL) UnmarshalJSON(input []byte) error {
|
|
var textURL string
|
|
err := json.Unmarshal(input, &textURL)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
url, err := parseURL(textURL)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
u.Scheme = url.Scheme
|
|
u.Path = url.Path
|
|
return nil
|
|
}
|
|
|
|
// Cmp compares x and y and returns:
|
|
//
|
|
// -1 if x < y
|
|
// 0 if x == y
|
|
// +1 if x > y
|
|
func (u URL) Cmp(url URL) int {
|
|
if u.Scheme == url.Scheme {
|
|
return strings.Compare(u.Path, url.Path)
|
|
}
|
|
return strings.Compare(u.Scheme, url.Scheme)
|
|
}
|