Dokumentation

EN

Allgemein

Authentifizierung

Die Authentifizierung ist optional und wird verwendet, um Anfragen bei hoher Last zu priorisieren. Diese funktioniert analog zum Flashbots-Standard. X-Flashbots-Signature oder x-auction-signature kann als Header-Feld für die address:signature-Daten verwendet werden.

Datenschutz

Informationen zum Datenschutz finden Sie hier.

Methoden

eth_sendBundle

Die Methode eth_sendBundle kann verwendet werden, um Bundles an den RPC-Endpunkt zu senden. Eine Anfrage an diesen Endpunkt muss dem Standard Flashbots Bundle Format folgen, z.B.

{  
    "jsonrpc": "2.0",  
    "id": 1,  
    "method": "eth_sendBundle",  
    "params": 
    [    
        {      
            "txs": ["0x004...", "0x05d..."],    // Liste von hex-encoded signierten Transaktionen            
            "blockNumber": "0x00f64d0e",        // Hex-encoded Blocknummer, wofür dieses Bundle gültig ist
            "minTimestamp": 0,                  // Unix Timestamp, ab wann dieses Bundle gültig wird - optional 
            "maxTimestamp": 1672933616,         // Unix Timestamp, wie lange dieses Bundle gültig ist - optional      
            "revertingTxHashes": ["0xf0b..."]   // Liste von Transaktions Hashes, welche fehlschlagen können - optional   
        }  
    ]
}

Hinweis: Das Ersetzen von Bundles über replacementUuid wird nicht unterstützt. Siehe eth_cancelBundle, um ein Bundle zu widerrufen.

eth_cancelBundle

Die Methode eth_cancelBundle kann verwendet werden, um ein übermitteltes Bundle zu widerrufen. Eine Anfrage an diesen Endpunkt muss das folgende Format haben:

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_cancelBundle",
    "params":
    [
        {
            "bundleHash": "0xf0b..." // Bundle Hash des zu widerrufenden Bundles
        }
    ]
}

Hinweis: Sobald ein Bundle in einen Block aufgenommen und von den Relays empfangen wurde, kann es nicht mehr gelöscht werden. Es wird daher empfohlen, ein Bundle mindestens 3 Sekunden vor Ablauf der Slotzeit (Zeitpunkt an dem der nächste Block geschrieben wird) zu widerrufen.

eth_sendPrivateTransaction

Die Methode eth_sendPrivateTransaction kann verwendet werden, um Flashbots-kompatible private Transaktionen an den RPC-Endpunkt zu senden. Transaktionen, die auf diese Weise gesendet werden, sind vor Frontrunning geschützt und bleiben privat, bis sie in einen Block aufgenommen werden. Eine Anfrage an diesen Endpunkt muss dem Flashbots private transaction Format folgen, z.B.

{  
    "jsonrpc": "2.0",  
    "id": 1,  
    "method": "eth_sendPrivateTransaction",  
    "params": 
    [
        {
            "tx": "0x0000...d46e8dd67c5d32be8d46675058bb8eb970870f072445675" // Hex-encoded signierte Transaktion
        }
    ]
}

Hinweis: Der Parameter maxBlockNumber wird derzeit nicht unterstützt. Private Transaktionen werden nach 24 Stunden verworfen, wenn sie nicht in einem Block integriert werden.

eth_sendPrivateRawTransaction

Die Methode eth_sendPrivateRawTransaction kann verwendet werden, um private Transaktionen an den RPC-Endpunkt zu senden. Private Transaktionen sind vor Frontrunning geschützt und bleiben privat, bis sie in einen Block aufgenommen werden. Eine Anfrage an diesen Endpunkt muss dem Standard eth_sendRawTransaction Format folgen, z.B.

{  
    "jsonrpc": "2.0",  
    "id": 1,  
    "method": "eth_sendPrivateRawTransaction",  
    "params": 
    [ 
        "0x0000...d46e8dd67c5d32be8d46675058bb8eb970870f072445675" // Hex-encoded signierte Transaktion
    ]
}

Hinweis: Empfangene Transaktionen werden nach 24 Stunden verworfen, wenn sie nicht in einem Block integriert werden. Transaktionen, die über eth_sendRawTransaction eingehen, werden intern an diesen Endpunkt weitergeleitet und privat behandelt.

eth_cancelPrivateTransaction

Die Methode eth_cancelPrivateTransaction kann verwendet werden, um eine private Transaktion abzubrechen. Eine Anfrage an diesen Endpunkt muss das folgende Format haben:

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_cancelPrivateTransaction",
    "params":
    [
        {
            "txHash": "0xf0b..." // Hash der Transaktion die abgebrochen wird
        }
    ]
}

Hinweis: Sobald eine Transaktion in einen Block aufgenommen und von den Relays empfangen wurde, ist es nicht mehr möglich, sie zu stornieren. Es wird daher empfohlen, eine private Transaktion mindestens 3 Sekunden vor Ablauf der Slotzeit (Zeitpunkt an dem der nächste Block geschrieben wird) abzubrechen.

Metamask

Der payload RPC-Endpunkt kann mit Metamask verwendet werden, um private Transaktionen zu versenden. Bei Verwendung des RPC-Endpunkts sind alle mit Metamask durchgeführten Transaktionen privat. Private Transaktionen sind vor Frontrunning geschützt und werden nicht an den öffentlichen Mempool weitergeleitet. Unser Builder berücksichtigt empfangene private Transaktionen, wenn er einen Block baut. Private Transaktionen, die nicht integriert werden können, werden 24 Stunden nach dem Empfang verworfen.

Hinweis: Metamask sendet jede Minute erneut eine ausstehende Transaktion. Wenn das Netzwerk mit einer ausstehenden Transaktion gewechselt wird, wird die Transaktion auch an den neuen RPC-Endpunkt gesendet. Dies kann dazu führen, dass die Transaktion über einen anderen Anbieter veröffentlicht wird. Um sicherzustellen, dass die Transaktion privat bleibt, behalten Sie den Endpunkt bei, bis die Transaktion erfolgreich ist, oder wechseln Sie in der Zeit nur zu einem anderen privaten Endpunktanbieter.

Benutzerdefinierten RPC hinzufügen

Der RPC-Endpunkt kann über Metamask in der Netzwerkauswahl unter Add Network > Add a network manually hinzugefügt werden.

Hinweis: Da dieser Dienst erst kürzlich gestartet wurde, kann es einige Zeit dauern, bis eine Transaktion in einen Block aufgenommen wird. Im Moment ist es empfehlenswert, nur Transaktionen, die nicht dringend ausgeführt werden müssen, auf diese Weise zu senden.

Status

Um sicherzustellen, dass der RPC-Endpunkt und Metamask mit dem aktuellen Stand des Netzwerks synchronisiert sind, kann der Status auf unserer Statusseite geprüft werden.