mirror of
https://github.com/ethereum/go-ethereum.git
synced 2026-06-19 21:31:37 +00:00
05a9e91898
This PR implements a new version of the abigen utility (v2) which exists
along with the pre-existing v1 version.
Abigen is a utility command provided by go-ethereum that, given a
solidity contract ABI definition, will generate Go code to transact/call
the contract methods, converting the method parameters/results and
structures defined in the contract into corresponding Go types. This is
useful for preventing the need to write custom boilerplate code for
contract interactions.
Methods in the generated bindings perform encoding between Go types and
Solidity ABI-encoded packed bytecode, as well as some action (e.g.
`eth_call` or creating and submitting a transaction). This limits the
flexibility of how the generated bindings can be used, and prevents
easily adding new functionality, as it will make the generated bindings
larger for each feature added.
Abigen v2 was conceived of by the observation that the only
functionality that generated Go bindings ought to perform is conversion
between Go types and ABI-encoded packed data. Go-ethereum already
provides various APIs which in conjunction with conversion methods
generated in v2 bindings can cover all functionality currently provided
by v1, and facilitate all other previously-desired use-cases.
To generate contract bindings using abigen v2, invoke the `abigen`
command with the `--v2` flag. The functionality of all other flags is
preserved between the v2 and v1 versions.
The execution of `abigen --v2` generates Go code containing methods
which convert between Go types and corresponding ABI-encoded data
expected by the contract. For each input-accepting contract method and
the constructor, a "packing" method is generated in the binding which
converts from Go types to the corresponding packed solidity expected by
the contract. If a method returns output, an "unpacking" method is
generated to convert this output from ABI-encoded data to the
corresponding Go types.
For contracts which emit events, an unpacking method is defined for each
event to unpack the corresponding raw log to the Go type that it
represents.
Likewise, where custom errors are defined by contracts, an unpack method
is generated to unpack raw error data into a Go type.
For a smooth user-experience, abigen v2 comes with a number of utility
functions to be used in conjunction with the generated bindings for
performing common contract interaction use-cases. These include:
* filtering for historical logs of a given topic
* watching the chain for emission of logs with a given topic
* contract deployment methods
* Call/Transact methods
https://geth.ethereum.org will be updated to include a new tutorial page
for abigen v2 with full code examples. The page currently exists in a
PR: https://github.com/ethereum/go-ethereum/pull/31390 .
There are also extensive examples of interactions with contract bindings
in [test
cases](cc855c7ede/accounts/abi/bind/v2/lib_test.go)
provided with this PR.
---------
Co-authored-by: jwasinger <j-wasinger@hotmail.com>
Co-authored-by: Sina Mahmoodi <itz.s1na@gmail.com>
Co-authored-by: Felix Lange <fjl@twurst.com>
95 lines
4 KiB
Modula-2
95 lines
4 KiB
Modula-2
module github.com/XinFinOrg/XDPoSChain
|
|
|
|
go 1.23
|
|
|
|
require (
|
|
github.com/VictoriaMetrics/fastcache v1.12.2
|
|
github.com/btcsuite/btcd v0.0.0-20171128150713-2e60448ffcc6
|
|
github.com/cespare/cp v1.1.1
|
|
github.com/davecgh/go-spew v1.1.1
|
|
github.com/docker/docker v1.4.2-0.20180625184442-8e610b2b55bf
|
|
github.com/fatih/color v1.13.0
|
|
github.com/globalsign/mgo v0.0.0-20181015135952-eeefdecb41b8
|
|
github.com/golang/snappy v0.0.5-0.20220116011046-fa5810519dcb
|
|
github.com/gorilla/websocket v1.4.2
|
|
github.com/holiman/uint256 v1.3.2
|
|
github.com/huin/goupnp v1.3.0
|
|
github.com/jackpal/go-nat-pmp v1.0.2
|
|
github.com/julienschmidt/httprouter v1.3.0
|
|
github.com/mattn/go-colorable v0.1.13
|
|
github.com/naoina/toml v0.1.2-0.20170918210437-9fafd6967416
|
|
github.com/olekukonko/tablewriter v0.0.5
|
|
github.com/peterh/liner v1.1.1-0.20190123174540-a2c9a5303de7
|
|
github.com/pkg/errors v0.9.1
|
|
github.com/prometheus/prometheus v1.7.2-0.20170814170113-3101606756c5
|
|
github.com/rs/cors v1.7.0
|
|
github.com/stretchr/testify v1.8.4
|
|
github.com/syndtr/goleveldb v1.0.1-0.20210819022825-2ae1ddf74ef7
|
|
golang.org/x/crypto v0.29.0
|
|
golang.org/x/sync v0.9.0
|
|
golang.org/x/sys v0.27.0
|
|
golang.org/x/tools v0.21.1-0.20240508182429-e35e4ccd0d2d
|
|
gopkg.in/olebedev/go-duktape.v3 v3.0.0-20200619000410-60c24ae608a6
|
|
)
|
|
|
|
require (
|
|
github.com/Microsoft/go-winio v0.6.2
|
|
github.com/consensys/gnark-crypto v0.10.0
|
|
github.com/deckarep/golang-set/v2 v2.7.0
|
|
github.com/decred/dcrd/dcrec/secp256k1/v4 v4.0.1
|
|
github.com/dop251/goja v0.0.0-20230605162241-28ee0ee714f3
|
|
github.com/fjl/gencodec v0.0.0-20230517082657-f9840df7b83e
|
|
github.com/fsnotify/fsnotify v1.8.0
|
|
github.com/gballet/go-libpcsclite v0.0.0-20191108122812-4678299bea08
|
|
github.com/go-yaml/yaml v2.1.0+incompatible
|
|
github.com/golang-jwt/jwt/v4 v4.5.2
|
|
github.com/google/gofuzz v1.2.0
|
|
github.com/google/uuid v1.6.0
|
|
github.com/influxdata/influxdb-client-go/v2 v2.4.0
|
|
github.com/influxdata/influxdb1-client v0.0.0-20220302092344-a9ab5670611c
|
|
github.com/karalabe/hid v1.0.1-0.20240306101548-573246063e52
|
|
github.com/kevinburke/go-bindata v3.23.0+incompatible
|
|
github.com/kylelemons/godebug v1.1.0
|
|
github.com/mattn/go-isatty v0.0.17
|
|
github.com/protolambda/bls12-381-util v0.0.0-20220416220906-d8552aa452c7
|
|
github.com/shirou/gopsutil v3.21.4-0.20210419000835-c7a38de76ee5+incompatible
|
|
github.com/status-im/keycard-go v0.3.3
|
|
github.com/urfave/cli/v2 v2.27.5
|
|
golang.org/x/exp v0.0.0-20230626212559-97b1e661b5df
|
|
golang.org/x/text v0.20.0
|
|
google.golang.org/protobuf v1.31.0
|
|
gopkg.in/natefinch/lumberjack.v2 v2.2.1
|
|
)
|
|
|
|
require (
|
|
github.com/StackExchange/wmi v1.2.1 // indirect
|
|
github.com/bits-and-blooms/bitset v1.5.0 // indirect
|
|
github.com/cespare/xxhash/v2 v2.3.0 // indirect
|
|
github.com/consensys/bavard v0.1.13 // indirect
|
|
github.com/cpuguy83/go-md2man/v2 v2.0.5 // indirect
|
|
github.com/deepmap/oapi-codegen v1.6.0 // indirect
|
|
github.com/dlclark/regexp2 v1.10.0 // indirect
|
|
github.com/garslo/gogen v0.0.0-20170306192744-1d203ffc1f61 // indirect
|
|
github.com/go-ole/go-ole v1.2.5 // indirect
|
|
github.com/go-sourcemap/sourcemap v2.1.3+incompatible // indirect
|
|
github.com/google/pprof v0.0.0-20230207041349-798e818bf904 // indirect
|
|
github.com/influxdata/line-protocol v0.0.0-20200327222509-2487e7298839 // indirect
|
|
github.com/kilic/bls12-381 v0.1.0 // indirect
|
|
github.com/kr/pretty v0.3.1 // indirect
|
|
github.com/mattn/go-runewidth v0.0.13 // indirect
|
|
github.com/mmcloughlin/addchain v0.4.0 // indirect
|
|
github.com/naoina/go-stringutil v0.1.0 // indirect
|
|
github.com/pmezard/go-difflib v1.0.0 // indirect
|
|
github.com/rivo/uniseg v0.2.0 // indirect
|
|
github.com/russross/blackfriday/v2 v2.1.0 // indirect
|
|
github.com/tklauser/go-sysconf v0.3.14 // indirect
|
|
github.com/tklauser/numcpus v0.8.0 // indirect
|
|
github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1 // indirect
|
|
golang.org/x/mod v0.17.0 // indirect
|
|
golang.org/x/net v0.25.0 // indirect
|
|
golang.org/x/term v0.26.0 // indirect
|
|
gopkg.in/yaml.v2 v2.4.0 // indirect
|
|
gopkg.in/yaml.v3 v3.0.1 // indirect
|
|
gotest.tools v2.2.0+incompatible // indirect
|
|
rsc.io/tmplfunc v0.0.3 // indirect
|
|
)
|