https://github.com/metachris/go-ethutils

Go helpers for working with Ethereum.
https://github.com/metachris/go-ethutils

ethereum geth golang golang-library golang-package

Last synced: 26 days ago
JSON representation

Go helpers for working with Ethereum.

• Host: GitHub
• URL: https://github.com/metachris/go-ethutils
• Owner: metachris
• License: mit
• Created: 2021-06-02T10:55:29.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2022-11-28T18:42:33.000Z (almost 2 years ago)
• Last Synced: 2024-06-21T00:12:13.869Z (5 months ago)
• Topics: ethereum, geth, golang, golang-library, golang-package
• Language: Go
• Homepage:
• Size: 89.8 KB
• Stars: 20
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## Go Ethereum Utilities

Helpers for working with Ethereum:

**Links**

* Go Docs: https://pkg.go.dev/github.com/metachris/go-ethutils

* Example usage: https://github.com/metachris/flashbots

**Contents**

* [utils/getblocks.go](https://github.com/metachris/go-ethutils/blob/master/utils/getblocks.go) - fast block ingress pipeline

* [blockswithtx](https://github.com/metachris/go-ethutils/blob/master/blockswithtx) - fast, concurrent block+receipts downloading pipeline (use a geth IPC connection)

* [smartcontracts](https://github.com/metachris/go-ethutils/blob/master/smartcontracts) - detect types of smart contracts, get contract details (eg. erc20, 721 properties, etc.)

* [addresslookup](https://github.com/metachris/go-ethutils/blob/master/addresslookup) - get information of an address, either from JSON or from the blockchain

* [addressdetail](https://github.com/metachris/go-ethutils/blob/master/addressdetail) - helper for smart contracts and addresses

* [utils/eth.go](https://github.com/metachris/go-ethutils/blob/master/utils/eth.go) - finding first block at or after a certain UTC timestamp

* [utils/blockrangefinder.go](https://github.com/metachris/go-ethutils/blob/master/utils/blockrangefinder.go) - find a block range based on date, timespans or blocks

* [utils/various.go](https://github.com/metachris/go-ethutils/blob/master/utils/various.go) - various utilities

**Feedback**

* Reach out to [twitter.com/metachris](https://twitter.com/metachris)

---

## BlockWithTxReceipts

`blockswithtx` is used for concurrently fetching blocks and tx-receipts from a geth node.

Benchmarks - running on the same machine as the geth node:

```

# IPC connection with concurrency 1, 5, 10, 15

ipc+1x:  Processed 17773 transactions in 29.671 seconds (599.01 tx/sec)

ipc+5x:  Processed 17773 transactions in 7.453 seconds (2384.59 tx/sec)

ipc+10x: Processed 17773 transactions in 5.403 seconds (3289.71 tx/sec)

ipc+15x: Processed 17773 transactions in 4.631 seconds (3837.83 tx/sec)

# WebSocket connection with concurrency 1, 5, 10, 15

ws+1x:  Processed 17773 transactions in 29.784 seconds (596.74 tx/sec)

ws+5x:  Processed 17773 transactions in 8.380 seconds (2120.87 tx/sec)

ws+10x: Processed 17773 transactions in 5.763 seconds (3084.00 tx/sec)

ws+15x: Processed 17773 transactions in 4.842 seconds (3670.32 tx/sec)

# HTTP connection with concurrency 1, 5, 10, 15

http+1x:  Processed 17773 transactions in 33.829 seconds (525.39 tx/sec)

http+5x:  Processed 17773 transactions in 8.828 seconds (2013.30 tx/sec)

http+10x: Processed 17773 transactions in 5.814 seconds (3056.90 tx/sec)

http+15x: Processed 17773 transactions in 5.510 seconds (3225.56 tx/sec)

```

Over the network I could only get ~200 tx/sec.

Example code: cmd/benchmark-blockswithtx/main.go