github.com/luckypickle/go-ethereum-vet@v1.14.2/mobile/common.go (about)

     1  // Copyright 2016 The go-ethereum Authors
     2  // This file is part of the go-ethereum library.
     3  //
     4  // The go-ethereum library is free software: you can redistribute it and/or modify
     5  // it under the terms of the GNU Lesser General Public License as published by
     6  // the Free Software Foundation, either version 3 of the License, or
     7  // (at your option) any later version.
     8  //
     9  // The go-ethereum library is distributed in the hope that it will be useful,
    10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
    11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    12  // GNU Lesser General Public License for more details.
    13  //
    14  // You should have received a copy of the GNU Lesser General Public License
    15  // along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
    16  
    17  // Contains all the wrappers from the common package.
    18  
    19  package geth
    20  
    21  import (
    22  	"encoding/hex"
    23  	"errors"
    24  	"fmt"
    25  	"strings"
    26  
    27  	"github.com/luckypickle/go-ethereum-vet/common"
    28  )
    29  
    30  // Hash represents the 32 byte Keccak256 hash of arbitrary data.
    31  type Hash struct {
    32  	hash common.Hash
    33  }
    34  
    35  // NewHashFromBytes converts a slice of bytes to a hash value.
    36  func NewHashFromBytes(binary []byte) (hash *Hash, _ error) {
    37  	h := new(Hash)
    38  	if err := h.SetBytes(common.CopyBytes(binary)); err != nil {
    39  		return nil, err
    40  	}
    41  	return h, nil
    42  }
    43  
    44  // NewHashFromHex converts a hex string to a hash value.
    45  func NewHashFromHex(hex string) (hash *Hash, _ error) {
    46  	h := new(Hash)
    47  	if err := h.SetHex(hex); err != nil {
    48  		return nil, err
    49  	}
    50  	return h, nil
    51  }
    52  
    53  // SetBytes sets the specified slice of bytes as the hash value.
    54  func (h *Hash) SetBytes(hash []byte) error {
    55  	if length := len(hash); length != common.HashLength {
    56  		return fmt.Errorf("invalid hash length: %v != %v", length, common.HashLength)
    57  	}
    58  	copy(h.hash[:], hash)
    59  	return nil
    60  }
    61  
    62  // GetBytes retrieves the byte representation of the hash.
    63  func (h *Hash) GetBytes() []byte {
    64  	return h.hash[:]
    65  }
    66  
    67  // SetHex sets the specified hex string as the hash value.
    68  func (h *Hash) SetHex(hash string) error {
    69  	hash = strings.ToLower(hash)
    70  	if len(hash) >= 2 && hash[:2] == "0x" {
    71  		hash = hash[2:]
    72  	}
    73  	if length := len(hash); length != 2*common.HashLength {
    74  		return fmt.Errorf("invalid hash hex length: %v != %v", length, 2*common.HashLength)
    75  	}
    76  	bin, err := hex.DecodeString(hash)
    77  	if err != nil {
    78  		return err
    79  	}
    80  	copy(h.hash[:], bin)
    81  	return nil
    82  }
    83  
    84  // GetHex retrieves the hex string representation of the hash.
    85  func (h *Hash) GetHex() string {
    86  	return h.hash.Hex()
    87  }
    88  
    89  // Hashes represents a slice of hashes.
    90  type Hashes struct{ hashes []common.Hash }
    91  
    92  // NewHashes creates a slice of uninitialized Hashes.
    93  func NewHashes(size int) *Hashes {
    94  	return &Hashes{
    95  		hashes: make([]common.Hash, size),
    96  	}
    97  }
    98  
    99  // NewHashesEmpty creates an empty slice of Hashes values.
   100  func NewHashesEmpty() *Hashes {
   101  	return NewHashes(0)
   102  }
   103  
   104  // Size returns the number of hashes in the slice.
   105  func (h *Hashes) Size() int {
   106  	return len(h.hashes)
   107  }
   108  
   109  // Get returns the hash at the given index from the slice.
   110  func (h *Hashes) Get(index int) (hash *Hash, _ error) {
   111  	if index < 0 || index >= len(h.hashes) {
   112  		return nil, errors.New("index out of bounds")
   113  	}
   114  	return &Hash{h.hashes[index]}, nil
   115  }
   116  
   117  // Set sets the Hash at the given index in the slice.
   118  func (h *Hashes) Set(index int, hash *Hash) error {
   119  	if index < 0 || index >= len(h.hashes) {
   120  		return errors.New("index out of bounds")
   121  	}
   122  	h.hashes[index] = hash.hash
   123  	return nil
   124  }
   125  
   126  // Append adds a new Hash element to the end of the slice.
   127  func (h *Hashes) Append(hash *Hash) {
   128  	h.hashes = append(h.hashes, hash.hash)
   129  }
   130  
   131  // Address represents the 20 byte address of an Ethereum account.
   132  type Address struct {
   133  	address common.Address
   134  }
   135  
   136  // NewAddressFromBytes converts a slice of bytes to a hash value.
   137  func NewAddressFromBytes(binary []byte) (address *Address, _ error) {
   138  	a := new(Address)
   139  	if err := a.SetBytes(common.CopyBytes(binary)); err != nil {
   140  		return nil, err
   141  	}
   142  	return a, nil
   143  }
   144  
   145  // NewAddressFromHex converts a hex string to a address value.
   146  func NewAddressFromHex(hex string) (address *Address, _ error) {
   147  	a := new(Address)
   148  	if err := a.SetHex(hex); err != nil {
   149  		return nil, err
   150  	}
   151  	return a, nil
   152  }
   153  
   154  // SetBytes sets the specified slice of bytes as the address value.
   155  func (a *Address) SetBytes(address []byte) error {
   156  	if length := len(address); length != common.AddressLength {
   157  		return fmt.Errorf("invalid address length: %v != %v", length, common.AddressLength)
   158  	}
   159  	copy(a.address[:], address)
   160  	return nil
   161  }
   162  
   163  // GetBytes retrieves the byte representation of the address.
   164  func (a *Address) GetBytes() []byte {
   165  	return a.address[:]
   166  }
   167  
   168  // SetHex sets the specified hex string as the address value.
   169  func (a *Address) SetHex(address string) error {
   170  	address = strings.ToLower(address)
   171  	if len(address) >= 2 && address[:2] == "0x" {
   172  		address = address[2:]
   173  	}
   174  	if length := len(address); length != 2*common.AddressLength {
   175  		return fmt.Errorf("invalid address hex length: %v != %v", length, 2*common.AddressLength)
   176  	}
   177  	bin, err := hex.DecodeString(address)
   178  	if err != nil {
   179  		return err
   180  	}
   181  	copy(a.address[:], bin)
   182  	return nil
   183  }
   184  
   185  // GetHex retrieves the hex string representation of the address.
   186  func (a *Address) GetHex() string {
   187  	return a.address.Hex()
   188  }
   189  
   190  // Addresses represents a slice of addresses.
   191  type Addresses struct{ addresses []common.Address }
   192  
   193  // NewAddresses creates a slice of uninitialized addresses.
   194  func NewAddresses(size int) *Addresses {
   195  	return &Addresses{
   196  		addresses: make([]common.Address, size),
   197  	}
   198  }
   199  
   200  // NewAddressesEmpty creates an empty slice of Addresses values.
   201  func NewAddressesEmpty() *Addresses {
   202  	return NewAddresses(0)
   203  }
   204  
   205  // Size returns the number of addresses in the slice.
   206  func (a *Addresses) Size() int {
   207  	return len(a.addresses)
   208  }
   209  
   210  // Get returns the address at the given index from the slice.
   211  func (a *Addresses) Get(index int) (address *Address, _ error) {
   212  	if index < 0 || index >= len(a.addresses) {
   213  		return nil, errors.New("index out of bounds")
   214  	}
   215  	return &Address{a.addresses[index]}, nil
   216  }
   217  
   218  // Set sets the address at the given index in the slice.
   219  func (a *Addresses) Set(index int, address *Address) error {
   220  	if index < 0 || index >= len(a.addresses) {
   221  		return errors.New("index out of bounds")
   222  	}
   223  	a.addresses[index] = address.address
   224  	return nil
   225  }
   226  
   227  // Append adds a new address element to the end of the slice.
   228  func (a *Addresses) Append(address *Address) {
   229  	a.addresses = append(a.addresses, address.address)
   230  }