https://github.com/metachris/flashbotsrpc

Golang client for Flashbots Relay, mev-geth and standard Ethereum JSON-RPC API endpoints
https://github.com/metachris/flashbotsrpc

flashbots golang rpc

Last synced: 3 days ago
JSON representation

Golang client for Flashbots Relay, mev-geth and standard Ethereum JSON-RPC API endpoints

• Host: GitHub
• URL: https://github.com/metachris/flashbotsrpc
• Owner: metachris
• License: mit
• Created: 2021-08-16T14:23:36.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-08-05T14:45:29.000Z (6 months ago)
• Last Synced: 2025-01-12T04:32:24.376Z (10 days ago)
• Topics: flashbots, golang, rpc
• Language: Go
• Homepage: https://docs.flashbots.net/flashbots-auction/searchers/advanced/rpc-endpoint/
• Size: 46.9 KB
• Stars: 167
• Watchers: 8
• Forks: 55
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Flashbots RPC client

[![Test status](https://github.com/metachris/flashbotsrpc/workflows/Test/badge.svg)](https://github.com/metachris/flashbotsrpc/actions?query=workflow%3A%22Test%22)

Fork of [ethrpc](https://github.com/onrik/ethrpc) with additional [Flashbots RPC methods](https://docs.flashbots.net/flashbots-auction/searchers/advanced/rpc-endpoint):

* `FlashbotsCallBundle` ([`eth_callBundle`](https://docs.flashbots.net/flashbots-auction/searchers/advanced/rpc-endpoint/#eth_callbundle))

* `FlashbotsSendBundle` ([`eth_sendBundle`](https://docs.flashbots.net/flashbots-auction/searchers/advanced/rpc-endpoint/#eth_sendbundle))

* `FlashbotsGetUserStats` ([`flashbots_getUserStats`](https://docs.flashbots.net/flashbots-auction/searchers/advanced/rpc-endpoint/#flashbots_getuserstats))

* `FlashbotsSendPrivateTransaction` (`eth_sendPrivateTransaction`)

* `FlashbotsCancelPrivateTransaction` (`eth_cancelPrivateTransaction`)

* `FlashbotsSimulateBlock`: simulate a full block

## Usage

Add library to your project:

`go get github.com/metachris/flashbotsrpc`

Create a new private key here for testing (you probably want to use an existing one):

```go

privateKey, _ := crypto.GenerateKey()

```

#### Simulate transactions with `eth_callBundle`:

```go

callBundleArgs := flashbotsrpc.FlashbotsCallBundleParam{

    Txs:              []string{"YOUR_RAW_TX"},

    BlockNumber:      fmt.Sprintf("0x%x", 13281018),

    StateBlockNumber: "latest",

}

result, err := rpc.FlashbotsCallBundle(privateKey, callBundleArgs)

if err != nil {

    log.Fatal(err)

}

fmt.Printf("%+v\n", result)

```

#### Get Flashbots user stats:

```go

rpc := flashbotsrpc.New("https://relay.flashbots.net")

result, err := rpc.FlashbotsGetUserStats(privateKey, 13281018)

if err != nil {

    log.Fatal(err)

}

fmt.Printf("%+v\n", result)

```

#### Send a transaction bundle to Flashbots with `eth_sendBundle`:

```go

sendBundleArgs := flashbotsrpc.FlashbotsSendBundleRequest{

    Txs:         []string{"YOUR_RAW_TX"},

    BlockNumber: fmt.Sprintf("0x%x", 13281018),

}

result, err := rpc.FlashbotsSendBundle(privateKey, sendBundleArgs)

if err != nil {

    log.Fatal(err)

}

fmt.Printf("%+v\n", result)

```

#### Send a transaction bundle to a list of Builder endpoints with `eth_sendBundle` (full example [/examples/broadcastbundle]):

```go

urls := []string{

	"https://relay.flashbots.net",

    // Refer to https://www.mev.to/builders for builder endpoints 

}

rpc := flashbotsrpc.NewBuilderBroadcastRPC(urls)

sendBundleArgs := flashbotsrpc.FlashbotsSendBundleRequest{

    Txs:         []string{"YOUR_RAW_TX"},

    BlockNumber: fmt.Sprintf("0x%x", 13281018),

}

results := rpc.BroadcastBundle(privateKey, sendBundleArgs)

for _, result := range results {

    if result.Err != nil {

        log.Fatal(result.Err)

    }

    fmt.Printf("%+v\n", result.BundleResponse)

}

```

#### More examples

You can find example code in the [`/examples/` directory](https://github.com/metachris/flashbotsrpc/tree/master/examples).