Fork of plugeth with any needed changes for statediff plugin
Go to file
2024-03-04 13:42:48 -06:00
.circleci Update go build version 2024-01-05 11:27:27 -06:00
.github Merge commit '8f7eb9ccd' into merge/geth-v1.13.11 2024-01-24 09:31:20 -08:00
accounts core: move genesis alloc types to core/types (#29003) 2024-02-16 19:05:33 +01:00
beacon eth/catalyst,beacon/engine: implement GetClientVersionV1 (#28915) 2024-02-15 12:01:30 +01:00
build tests: update execution spec tests + split statetest exec (#28993) 2024-02-15 13:30:11 +01:00
cmd Merge remote-tracking branch 'origin/feature/etc-plugin-miner' into feature/network-etc-miner 2024-02-28 14:39:02 -08:00
common all: use uint256 in state (#28598) 2024-01-23 14:51:58 +01:00
consensus Merge tag 'v1.13.13' into merge/geth-v1.13.13 2024-02-22 11:19:29 -08:00
console cmd/geth: add support for --dev flag in dumpgenesis (#28463) 2023-11-22 12:08:39 +01:00
core Further changes to enable the shanghai fork as well as redefining the random opcode 2024-02-28 20:37:17 -08:00
crypto internal/ethapi: add support for blobs in eth_fillTransaction (#28839) 2024-02-08 19:53:32 +01:00
docs docs/postmortems: fix outdated link (#28893) 2024-01-29 16:40:57 +01:00
eth Merge tag 'v1.13.14' into merge/geth-v1.13.14 2024-02-27 09:11:02 -08:00
ethclient core: move genesis alloc types to core/types (#29003) 2024-02-16 19:05:33 +01:00
ethdb trie: remove inconsistent trie nodes during sync in path mode (#28595) 2023-12-08 14:28:23 +01:00
ethstats ethstats: prevent panic if head block is not available (#29020) 2024-02-19 07:25:53 +01:00
event event: fix Resubscribe deadlock when unsubscribing after inner sub ends (#28359) 2023-10-22 17:37:56 +02:00
graphql core: move genesis alloc types to core/types (#29003) 2024-02-16 19:05:33 +01:00
internal internal/ethapi: pass blob hashes to gas estimation (#29085) 2024-02-26 11:02:18 +01:00
log p2p, log, rpc: use errors.New to replace fmt.Errorf with no parameters (#29074) 2024-02-26 11:25:35 +02:00
metrics all: fix docstring names (#28923) 2024-02-07 21:10:49 +01:00
miner Merge remote-tracking branch 'origin/feature/etc-plugin-miner' into feature/network-etc-miner 2024-02-28 14:39:02 -08:00
node node, rpc: add configurable HTTP request limit (#28948) 2024-02-07 21:06:38 +01:00
p2p p2p, log, rpc: use errors.New to replace fmt.Errorf with no parameters (#29074) 2024-02-26 11:25:35 +02:00
params Further changes to enable the shanghai fork as well as redefining the random opcode 2024-02-28 20:37:17 -08:00
plugins Merge remote-tracking branch 'origin/feature/etc-plugin-miner' into feature/network-etc-miner 2024-02-28 14:39:02 -08:00
rlp rlp/rlpgen: remove build tag (#28106) 2023-09-14 12:28:40 +02:00
rpc Merge tag 'v1.13.14' into merge/geth-v1.13.14 2024-02-27 09:11:02 -08:00
signer internal/ethapi, signer/core: fix documentation-links (#28979) 2024-02-13 10:14:18 +01:00
swarm swarm: fix outdated link (#26501) 2023-01-16 11:00:55 +01:00
tests core: move genesis alloc types to core/types (#29003) 2024-02-16 19:05:33 +01:00
trie all: remove the dependency from trie to triedb (#28824) 2024-02-13 14:49:53 +01:00
triedb Merge tag 'v1.13.13' into merge/geth-v1.13.13 2024-02-22 11:19:29 -08:00
.dockerignore cmd, internal/build, docker: advertise commit date in unstable build versions (#19522) 2019-05-08 16:44:28 +03:00
.gitattributes .gitattributes: enable solidity highlighting on github (#16425) 2018-04-03 15:21:24 +02:00
.gitignore git: ignore tests/spec-tests folder (#28254) 2023-10-10 10:56:50 +02:00
.gitmodules tests: external evm benchmarks (#24050) 2022-01-28 08:47:19 +01:00
.golangci.yml build: upgrade to golangci-lint v1.55.2 (#28712) 2023-12-20 15:36:10 +01:00
.mailmap AUTHORS: remove one more duplicate entry (#24950) 2022-05-24 21:04:21 +02:00
.travis.yml ci: disable lint on travis (#28706) 2023-12-19 10:35:02 +01:00
appveyor.yml core/state, tests: fix memory leak via fastcache (#28387) 2023-10-20 13:35:49 +02:00
AUTHORS AUTHORS: remove one more duplicate entry (#24950) 2022-05-24 21:04:21 +02:00
circle.yml circleci: enable docker based hive testing 2016-07-15 16:07:34 +03:00
COPYING COYPING: restore the full text text of GPL (#21568) 2020-09-15 08:27:17 +02:00
COPYING.LESSER all: update license information 2015-07-07 14:12:44 +02:00
Dockerfile Merge commit '7371b3817' into merge/geth-v1.13.0 2023-09-12 12:34:24 -07:00
Dockerfile.alltools Dockerfile: update Go to 1.21 (#28538) 2023-11-17 16:48:06 +02:00
go.mod Merge tag 'v1.13.13' into merge/geth-v1.13.13 2024-02-22 11:19:29 -08:00
go.sum Merge tag 'v1.13.13' into merge/geth-v1.13.13 2024-02-22 11:19:29 -08:00
interfaces.go ethereum, ethclient: add blob transaction fields in CallMsg (#28989) 2024-02-15 10:08:46 +01:00
Makefile Makefile: add help target to display available targets (#28845) 2024-02-05 22:48:19 +01:00
oss-fuzz.sh tests/fuzzers: move fuzzers into native packages (#28467) 2023-11-14 14:34:29 +01:00
README.md README.md: fix travis badge (#28889) 2024-01-29 10:58:43 +01:00
SECURITY.md Issue template corrections 2022-03-30 15:06:50 -07:00
slack-post.sh Push binaries to S3 2022-01-11 14:40:43 -06:00

PluGeth

PluGeth is a fork of the Go Ethereum Client (Geth) that implements a plugin architecture, allowing developers to extend Geth's capabilities in a number of different ways using plugins, rather than having to create additional, new forks of Geth.

Documentation can be found here.

Design Goals

The upstream Geth client exists primarily to serve as a client for the Ethereum mainnet, though it also supports a number of popular testnets. Supporting the Ethereum mainnet is a big enough challenge in its own right that the Geth team generally avoids changes to support other networks, or to provide features only a small handful of users would be interested in.

The result is that many projects have forked Geth. Some implement their own consensus protocols or alter the behavior of the EVM to support other networks. Others are designed to extract information from the Ethereum mainnet in ways the standard Geth client does not support.

PluGeth aims to provide a single Geth fork that developers can choose to extend rather than forking the Geth project. Out of the box, PluGeth behaves exactly like upstream Geth, but by installing plugins written in Golang, developers can extend its functionality in a wide variety of way.

Submitting Pull Requests

We are eager to include contributions from the community into the project. We ask that pull requests which include new features to be covered by our test plugin found in: /plugins/test-plugin. The test design and instructions for use are documented there. If further assistance is needed please get in touch with us.

Contact Us

If you're trying to do something that isn't supported by the current plugin system, Reach out to us on Discord and we'll help you figure out how to make it work.

System Requirements

System requirements will vary depending on which network you are connecting to. On the Ethereum mainnet, you should have at least 8 GB RAM, 2 CPUs, and 350 GB of SSD disks.

PluGeth relies on Golang's Plugin implementation, which is only supported on Linux, FreeBSD, and macOS. Windows support is unlikely to be added in the foreseeable future.

Licensing Considerations

The Geth codebase is licensed under the LGPL. By linking with Geth, you have an obligation to enable anyone you provide your plugin binaries to run against their own modified versions of Geth. Because of how Golang plugins work running against updated versions of Geth may require recompiling the plugin.

If you plan to license your plugin under the LGPL or a more permissive license, you should be able to meet these requirements. If you plan to use your plugin privately without distributing it, you should be fine. If you plan to release your plugin without making the source available, you may find yourself in violation of Geth's license unless you can provide a way to relink it against more recent versions of Geth.