abi

Documentation

Index

• Constants
• func GetPackingTypes(args []Argument) []interface{}
• func Pack(argSpec []Argument, args ...interface{}) ([]byte, error)
• func PackIntoStruct(argSpec []Argument, st interface{}) ([]byte, error)
• func Packer(abiData, funcName string, args ...string) ([]byte, error)
• func ReadAbiFormulateCall(abiSpecBytes []byte, funcName string, args []string) ([]byte, error)
• func ReadAbiFormulateCallFile(abiLocation, binPath, funcName string, args []string) ([]byte, error)
• func Unpack(argSpec []Argument, data []byte, args ...interface{}) error
• func UnpackIntoStruct(argSpec []Argument, data []byte, st interface{}) error
• type AbiSpec
  • func ReadAbiSpec(specBytes []byte) (*AbiSpec, error)
  • func ReadAbiSpecFile(filename string) (*AbiSpec, error)
  • func (abiSpec *AbiSpec) Pack(fname string, args ...interface{}) ([]byte, error)
• type AbiSpecJSON
• type Argument
  • func EVMTypeFromReflect(v reflect.Type) Argument
• type ArgumentJSON
• type EVMAddress
  • func (e EVMAddress) GetSignature() string
• type EVMBool
  • func (e EVMBool) GetSignature() string
• type EVMBytes
  • func (e EVMBytes) GetSignature() string
• type EVMFixed
  • func (e EVMFixed) GetSignature() string
• type EVMInt
  • func (e EVMInt) GetSignature() string
• type EVMString
  • func (e EVMString) GetSignature() string
• type EVMType
• type EVMUint
  • func (e EVMUint) GetSignature() string
• type Event
• type FunctionID
  • func GetFunctionID(signature string) (id FunctionID)
  • func (fs FunctionID) Bytes() []byte
• type FunctionSpec
  • func SpecFromFunctionReflect(fname string, v reflect.Value, skipIn, skipOut int) *FunctionSpec
  • func SpecFromStructReflect(fname string, args reflect.Type, rets reflect.Type) *FunctionSpec
  • func (functionSpec *FunctionSpec) SetFunctionID(functionName string)
• type Variable
  • func ReadAndDecodeContractReturn(abiLocation, binPath, funcName string, resultRaw []byte) ([]*Variable, error)
  • func Unpacker(abiData, name string, data []byte) ([]*Variable, error)

Constants

const ElementSize = 32

EVM Solidity calls and return values are packed into pieces of 32 bytes, including a bool (wasting 255 out of 256 bits)

const FunctionIDSize = 4

Functions

func GetPackingTypes

func GetPackingTypes(args []Argument) []interface{}

func Pack

func Pack(argSpec []Argument, args ...interface{}) ([]byte, error)

func PackIntoStruct

func PackIntoStruct(argSpec []Argument, st interface{}) ([]byte, error)

func Packer

func Packer(abiData, funcName string, args ...string) ([]byte, error)

Convenience Packing Functions

func ReadAbiFormulateCall

func ReadAbiFormulateCall(abiSpecBytes []byte, funcName string, args []string) ([]byte, error)

func ReadAbiFormulateCallFile

func ReadAbiFormulateCallFile(abiLocation, binPath, funcName string, args []string) ([]byte, error)

func Unpack

func Unpack(argSpec []Argument, data []byte, args ...interface{}) error

func UnpackIntoStruct

func UnpackIntoStruct(argSpec []Argument, data []byte, st interface{}) error

Types

type AbiSpec

type AbiSpec struct {
	Constructor FunctionSpec
	Fallback    FunctionSpec
	Functions   map[string]FunctionSpec
	Events      map[string]Event
}

func ReadAbiSpec

func ReadAbiSpec(specBytes []byte) (*AbiSpec, error)

func ReadAbiSpecFile

func ReadAbiSpecFile(filename string) (*AbiSpec, error)

func (*AbiSpec) Pack

func (abiSpec *AbiSpec) Pack(fname string, args ...interface{}) ([]byte, error)

type AbiSpecJSON

type AbiSpecJSON struct {
	Name            string
	Type            string
	Inputs          []ArgumentJSON
	Outputs         []ArgumentJSON
	Constant        bool
	Payable         bool
	StateMutability string
	Anonymous       bool
}

type Argument

type Argument struct {
	Name        string
	EVM         EVMType
	IsArray     bool
	Indexed     bool
	ArrayLength uint64
}

func EVMTypeFromReflect

func EVMTypeFromReflect(v reflect.Type) Argument

type ArgumentJSON

type ArgumentJSON struct {
	Name       string
	Type       string
	Components []ArgumentJSON
	Indexed    bool
}

type EVMAddress

type EVMAddress struct {
}

func (EVMAddress) GetSignature

func (e EVMAddress) GetSignature() string

type EVMBool

type EVMBool struct {
}

func (EVMBool) GetSignature

func (e EVMBool) GetSignature() string

type EVMBytes

type EVMBytes struct {
	M uint64
}

func (EVMBytes) GetSignature

func (e EVMBytes) GetSignature() string

type EVMFixed

type EVMFixed struct {
	N, M uint64
	// contains filtered or unexported fields
}

func (EVMFixed) GetSignature

func (e EVMFixed) GetSignature() string

type EVMInt

type EVMInt struct {
	M uint64
}

func (EVMInt) GetSignature

func (e EVMInt) GetSignature() string

type EVMString

type EVMString struct {
}

func (EVMString) GetSignature

func (e EVMString) GetSignature() string

type EVMType

type EVMType interface {
	GetSignature() string
	// contains filtered or unexported methods
}

type EVMUint

type EVMUint struct {
	M uint64
}

func (EVMUint) GetSignature

func (e EVMUint) GetSignature() string

type Event

type Event struct {
	Inputs    []Argument
	Anonymous bool
}

type FunctionID

type FunctionID [FunctionIDSize]byte

func GetFunctionID

func GetFunctionID(signature string) (id FunctionID)

func (FunctionID) Bytes

func (fs FunctionID) Bytes() []byte

type FunctionSpec

type FunctionSpec struct {
	FunctionID FunctionID
	Inputs     []Argument
	Outputs    []Argument
}

func SpecFromFunctionReflect

func SpecFromFunctionReflect(fname string, v reflect.Value, skipIn, skipOut int) *FunctionSpec

func SpecFromStructReflect

func SpecFromStructReflect(fname string, args reflect.Type, rets reflect.Type) *FunctionSpec

SpecFromStructReflect generates a FunctionSpec where the arguments and return values are described a struct. Both args and rets should be set to the return value of reflect.TypeOf() with the respective struct as an argument.

func (*FunctionSpec) SetFunctionID

func (functionSpec *FunctionSpec) SetFunctionID(functionName string)

type Variable

type Variable struct {
	Name  string
	Value string
}

func ReadAndDecodeContractReturn

func ReadAndDecodeContractReturn(abiLocation, binPath, funcName string, resultRaw []byte) ([]*Variable, error)

func Unpacker

func Unpacker(abiData, name string, data []byte) ([]*Variable, error)