2016-09-05 19:07:57 +03:00
|
|
|
// Copyright 2016 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/>.
|
|
|
|
|
|
|
|
// Contains all the wrappers from the common package.
|
|
|
|
|
|
|
|
package geth
|
|
|
|
|
|
|
|
import (
|
|
|
|
"encoding/hex"
|
|
|
|
"errors"
|
|
|
|
"fmt"
|
|
|
|
"strings"
|
|
|
|
|
|
|
|
"github.com/ethereum/go-ethereum/common"
|
2019-06-27 11:48:13 +03:00
|
|
|
"github.com/ethereum/go-ethereum/common/hexutil"
|
2016-09-05 19:07:57 +03:00
|
|
|
)
|
|
|
|
|
|
|
|
// Hash represents the 32 byte Keccak256 hash of arbitrary data.
|
|
|
|
type Hash struct {
|
|
|
|
hash common.Hash
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewHashFromBytes converts a slice of bytes to a hash value.
|
2016-12-08 15:09:26 +03:00
|
|
|
func NewHashFromBytes(binary []byte) (hash *Hash, _ error) {
|
2016-09-05 19:07:57 +03:00
|
|
|
h := new(Hash)
|
2017-07-17 15:25:46 +03:00
|
|
|
if err := h.SetBytes(common.CopyBytes(binary)); err != nil {
|
2016-09-05 19:07:57 +03:00
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return h, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewHashFromHex converts a hex string to a hash value.
|
2016-12-08 15:09:26 +03:00
|
|
|
func NewHashFromHex(hex string) (hash *Hash, _ error) {
|
2016-09-05 19:07:57 +03:00
|
|
|
h := new(Hash)
|
2016-12-08 15:09:26 +03:00
|
|
|
if err := h.SetHex(hex); err != nil {
|
2016-09-05 19:07:57 +03:00
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return h, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetBytes sets the specified slice of bytes as the hash value.
|
|
|
|
func (h *Hash) SetBytes(hash []byte) error {
|
|
|
|
if length := len(hash); length != common.HashLength {
|
|
|
|
return fmt.Errorf("invalid hash length: %v != %v", length, common.HashLength)
|
|
|
|
}
|
|
|
|
copy(h.hash[:], hash)
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetBytes retrieves the byte representation of the hash.
|
|
|
|
func (h *Hash) GetBytes() []byte {
|
|
|
|
return h.hash[:]
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetHex sets the specified hex string as the hash value.
|
|
|
|
func (h *Hash) SetHex(hash string) error {
|
|
|
|
hash = strings.ToLower(hash)
|
|
|
|
if len(hash) >= 2 && hash[:2] == "0x" {
|
|
|
|
hash = hash[2:]
|
|
|
|
}
|
|
|
|
if length := len(hash); length != 2*common.HashLength {
|
|
|
|
return fmt.Errorf("invalid hash hex length: %v != %v", length, 2*common.HashLength)
|
|
|
|
}
|
|
|
|
bin, err := hex.DecodeString(hash)
|
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
copy(h.hash[:], bin)
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetHex retrieves the hex string representation of the hash.
|
|
|
|
func (h *Hash) GetHex() string {
|
|
|
|
return h.hash.Hex()
|
|
|
|
}
|
|
|
|
|
|
|
|
// Hashes represents a slice of hashes.
|
|
|
|
type Hashes struct{ hashes []common.Hash }
|
|
|
|
|
2017-05-23 12:16:25 +03:00
|
|
|
// NewHashes creates a slice of uninitialized Hashes.
|
|
|
|
func NewHashes(size int) *Hashes {
|
|
|
|
return &Hashes{
|
|
|
|
hashes: make([]common.Hash, size),
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewHashesEmpty creates an empty slice of Hashes values.
|
|
|
|
func NewHashesEmpty() *Hashes {
|
|
|
|
return NewHashes(0)
|
|
|
|
}
|
|
|
|
|
2016-09-05 19:07:57 +03:00
|
|
|
// Size returns the number of hashes in the slice.
|
|
|
|
func (h *Hashes) Size() int {
|
|
|
|
return len(h.hashes)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Get returns the hash at the given index from the slice.
|
2016-12-08 15:09:26 +03:00
|
|
|
func (h *Hashes) Get(index int) (hash *Hash, _ error) {
|
2016-09-05 19:07:57 +03:00
|
|
|
if index < 0 || index >= len(h.hashes) {
|
|
|
|
return nil, errors.New("index out of bounds")
|
|
|
|
}
|
|
|
|
return &Hash{h.hashes[index]}, nil
|
|
|
|
}
|
|
|
|
|
2017-05-23 12:16:25 +03:00
|
|
|
// Set sets the Hash at the given index in the slice.
|
|
|
|
func (h *Hashes) Set(index int, hash *Hash) error {
|
|
|
|
if index < 0 || index >= len(h.hashes) {
|
|
|
|
return errors.New("index out of bounds")
|
|
|
|
}
|
|
|
|
h.hashes[index] = hash.hash
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// Append adds a new Hash element to the end of the slice.
|
|
|
|
func (h *Hashes) Append(hash *Hash) {
|
|
|
|
h.hashes = append(h.hashes, hash.hash)
|
|
|
|
}
|
|
|
|
|
2016-09-05 19:07:57 +03:00
|
|
|
// Address represents the 20 byte address of an Ethereum account.
|
|
|
|
type Address struct {
|
|
|
|
address common.Address
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewAddressFromBytes converts a slice of bytes to a hash value.
|
2016-12-08 15:09:26 +03:00
|
|
|
func NewAddressFromBytes(binary []byte) (address *Address, _ error) {
|
2016-09-05 19:07:57 +03:00
|
|
|
a := new(Address)
|
2017-07-17 15:25:46 +03:00
|
|
|
if err := a.SetBytes(common.CopyBytes(binary)); err != nil {
|
2016-09-05 19:07:57 +03:00
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return a, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewAddressFromHex converts a hex string to a address value.
|
2016-12-08 15:09:26 +03:00
|
|
|
func NewAddressFromHex(hex string) (address *Address, _ error) {
|
2016-09-05 19:07:57 +03:00
|
|
|
a := new(Address)
|
2016-12-08 15:09:26 +03:00
|
|
|
if err := a.SetHex(hex); err != nil {
|
2016-09-05 19:07:57 +03:00
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return a, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetBytes sets the specified slice of bytes as the address value.
|
|
|
|
func (a *Address) SetBytes(address []byte) error {
|
|
|
|
if length := len(address); length != common.AddressLength {
|
|
|
|
return fmt.Errorf("invalid address length: %v != %v", length, common.AddressLength)
|
|
|
|
}
|
|
|
|
copy(a.address[:], address)
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetBytes retrieves the byte representation of the address.
|
|
|
|
func (a *Address) GetBytes() []byte {
|
|
|
|
return a.address[:]
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetHex sets the specified hex string as the address value.
|
|
|
|
func (a *Address) SetHex(address string) error {
|
|
|
|
address = strings.ToLower(address)
|
|
|
|
if len(address) >= 2 && address[:2] == "0x" {
|
|
|
|
address = address[2:]
|
|
|
|
}
|
|
|
|
if length := len(address); length != 2*common.AddressLength {
|
|
|
|
return fmt.Errorf("invalid address hex length: %v != %v", length, 2*common.AddressLength)
|
|
|
|
}
|
|
|
|
bin, err := hex.DecodeString(address)
|
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
copy(a.address[:], bin)
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetHex retrieves the hex string representation of the address.
|
|
|
|
func (a *Address) GetHex() string {
|
|
|
|
return a.address.Hex()
|
|
|
|
}
|
|
|
|
|
|
|
|
// Addresses represents a slice of addresses.
|
|
|
|
type Addresses struct{ addresses []common.Address }
|
|
|
|
|
2017-05-23 12:16:25 +03:00
|
|
|
// NewAddresses creates a slice of uninitialized addresses.
|
|
|
|
func NewAddresses(size int) *Addresses {
|
|
|
|
return &Addresses{
|
|
|
|
addresses: make([]common.Address, size),
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewAddressesEmpty creates an empty slice of Addresses values.
|
|
|
|
func NewAddressesEmpty() *Addresses {
|
|
|
|
return NewAddresses(0)
|
|
|
|
}
|
|
|
|
|
2016-09-05 19:07:57 +03:00
|
|
|
// Size returns the number of addresses in the slice.
|
|
|
|
func (a *Addresses) Size() int {
|
|
|
|
return len(a.addresses)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Get returns the address at the given index from the slice.
|
2016-12-08 15:09:26 +03:00
|
|
|
func (a *Addresses) Get(index int) (address *Address, _ error) {
|
2016-09-05 19:07:57 +03:00
|
|
|
if index < 0 || index >= len(a.addresses) {
|
|
|
|
return nil, errors.New("index out of bounds")
|
|
|
|
}
|
|
|
|
return &Address{a.addresses[index]}, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// Set sets the address at the given index in the slice.
|
|
|
|
func (a *Addresses) Set(index int, address *Address) error {
|
|
|
|
if index < 0 || index >= len(a.addresses) {
|
|
|
|
return errors.New("index out of bounds")
|
|
|
|
}
|
|
|
|
a.addresses[index] = address.address
|
|
|
|
return nil
|
|
|
|
}
|
2017-05-23 12:16:25 +03:00
|
|
|
|
|
|
|
// Append adds a new address element to the end of the slice.
|
|
|
|
func (a *Addresses) Append(address *Address) {
|
|
|
|
a.addresses = append(a.addresses, address.address)
|
|
|
|
}
|
2019-06-27 11:48:13 +03:00
|
|
|
|
|
|
|
// EncodeToHex encodes b as a hex string with 0x prefix.
|
|
|
|
func EncodeToHex(b []byte) string {
|
|
|
|
return hexutil.Encode(b)
|
|
|
|
}
|
|
|
|
|
|
|
|
// DecodeFromHex decodes a hex string with 0x prefix.
|
|
|
|
func DecodeFromHex(s string) ([]byte, error) {
|
|
|
|
return hexutil.Decode(s)
|
|
|
|
}
|