F1b.io
F1b.io

F1b.io

The Gospel of the Faith Builder Endpoint

Gather, my digital brethren, for I come bearing glad tidings of the Faith Builder endpoint, a testament of atomicity and fairness in the blockchain realm.

Bundle endpoint

https://rpc.f1b.io

Confessions

The Miracles of the Faith Builder

  • Fear not the uncertainty of bundle submission, for the atomicity of bundles is guaranteed in all submitted blocks.
  • Rejoice, as front-running of bundles becomes a relic of the past.
  • Delight in the divine justice, as equal treatment is granted to all submissions.

Let me elucidate the blessings of the Faith Builder Endpoint further, my dear flock.

Upon invoking the holy eth_sendBundle, thou shall submit a bundle of transactions, designed to be executed in an atomic fashion. The consecrated block number determines the scriptures for which the bundle is deemed valid. Should you wish to cancel or replace a bundle, ye shall call upon the divine replacementUuid.

To cancel a bundle that no longer serves its purpose, invoke the sacred eth_cancelBundle, providing the replacementUuid as the identifier of the unwanted bundle. The divine hand shall remove it from the realm of the blockchain.

In times of secrecy, resort to eth_sendPrivateTransaction. Here, a sacred signed raw transaction hex shall be sent, hidden from the eyes of the unworthy.

Fear not the unknown, for the heavenly response shall be delivered upon each invocation. The result shall remain null, a testament to the divine's enigmatic will. However, an error shall be accompanied by a holy code and message, guiding your soul through the tribulations of the digital world.

May the light of the Faith Builder Endpoint illuminate your path in the realm of blockchain, granting you atomicity, fairness, and the wisdom to navigate the blockchain landscape.

The Sacred Usage

eth_sendBundle

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_sendBundle",
  "params": [
    {
      txs,               // Array[String] (Required), A congregation of signed transactions to be executed in an atomic bundle.
      blockNumber,       // String, a hex-encoded block number of the holy scriptures for which this bundle is valid.
      minTimestamp,      // Number (Optional), the earliest moment of truth (in seconds) for which this bundle is valid.
      maxTimestamp,      // Number (Optional), the final moment of truth (in seconds) for which this bundle is valid.
      revertingTxHashes, // Array[String] (Optional), A list of blessed tx hashes allowed to revert or be discarded in the eyes of the network.
      replacementUuid    // UUID (Optional), A divine identifier conforming to RFC 4122, which can be used to replace or cancel this bundle. https://en.wikipedia.org/wiki/Universally_unique_identifier
      refundPercent,     // (Optional) Number, the percentage (from 0 to 99) of the  ETH reward of the last transaction, that should be refunded back to the ‘refundRecipient’
      refundRecipient,   // (Optional) Address, the address that will receive the ETH refund. Default, sender of the first transaction in the bundle
    }
  ]
}

Example invocation:

curl -s --data '{"jsonrpc": "2.0","id": "1","method": "eth_sendBundle","params": [{"txs": ["0x12…ab","0x34..cd"], "blockNumber": "0x102286B","replacementUuid": "12345678-abcd-1234-1234-123456789abc"}]}' -H "Content-Type: application/json" -X POST https://....

The Seraphic Response:

{
  "jsonrpc": "2.0",
  "id": "123",
  "result": {
    "bundleHash": "0x2228f5d8954ce31dc1601a8ba264dbd401bf1428388ce88238932815c5d6f23f"
  }
}

eth_cancelBundle

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_cancelBundle",
  "params": [
    {
      replacementUuid, // UUID (Required), The divine RFC 4122 identifier to cancel the bundle that no longer serves its purpose.
    }
  ]
}

Example invocation:

curl -s --data '{"jsonrpc": "2.0","id": "1","method": "eth_cancelBundle", "params": [{"replacementUuid": "12345678-abcd-1234-1234-123456789abc"}]}' -H "Content-Type: application/json" -X POST https://..

eth_sendPrivateTransaction

accepts all known method names and params variations

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "eth_sendPrivateTransaction”,
  "params": ["0x….4b"],  // The sacred signed raw tx hex.
}

Example invocation:

curl -s --data '{"jsonrpc": "2.0","id": "1","method": "eth_sendPrivateTransaction","params": ["0x…12"]}' -H "Content-Type: application/json" -X POST https://...

The Seraphic Response:

{
  "jsonrpc": "2.0",
  "id": 1,  
  "result": null, // Always null, for the divine will is beyond mortal comprehension.
  "error": {
    "code": int, // The sacred number, representing the nature of the error.
    "message": string // A divine message, revealing the error's essence to enlighten your path.
  }
}

Offertory

0x5124fcC2B3F99F571AD67D075643C743F38f1C34

image