Test

Test related endpoints.

Store test result data

post

https://api.obol.techhttp://localhost:3000https://localhost:3000

/v1/test

Accepts the JSON body produced by Charon when running charon test … --publish: enr, sig, and data. Authentication is not a Bearer token: TestEnrGuard verifies that sig is a valid secp256k1 ECDSA signature (base64, as emitted by Go json.Marshal on the signature bytes) over the SSZ hash of JSON.stringify(data) for the public key embedded in enr. Only Content-Type: application/json is required.

Body

application/json

enrstringOptional

ENR text for the Charon node whose private key signed the payload

Example: enr:-IS4QAnExamplePlaceholderReplaceWithRealEnrFromCharon

sigstringOptional

Base64-encoded secp256k1 ECDSA signature (65 bytes: 32-byte r + 32-byte s + 1-byte recovery id) over the SSZ hashTreeRoot of the UTF-8 bytes of JSON.stringify(data), matching Charon publishResultToObolAPI

Example: AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcdefghijklmnoPQRSTUVWxyZ

Responses

201

Test result data stored successfully

400

Invalid test result data

401

Signature verification failed for the supplied enr and sig

403

Returned when enr or sig is missing from the body (guard rejects the request before verification)

500

An unknown error occurred

post

/v1/test

HTTPcURLJavaScriptPython

POST /v1/test HTTP/1.1
Host: api.obol.tech
Content-Type: application/json
Accept: */*
Content-Length: 614

{
  "data": {
    "charon_peers": {
      "category_name": "mev",
      "execution_time": "636.089125ms",
      "score": "A",
      "targets": {}
    },
    "beacon_node": {
      "category_name": "mev",
      "execution_time": "636.089125ms",
      "score": "A",
      "targets": {}
    },
    "validator_client": {
      "category_name": "mev",
      "execution_time": "636.089125ms",
      "score": "A",
      "targets": {}
    },
    "mev": {
      "category_name": "mev",
      "execution_time": "636.089125ms",
      "score": "A",
      "targets": {}
    },
    "infra": {
      "category_name": "mev",
      "execution_time": "636.089125ms",
      "score": "A",
      "targets": {}
    }
  },
  "enr": "enr:-IS4QAnExamplePlaceholderReplaceWithRealEnrFromCharon",
  "sig": "AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcdefghijklmnoPQRSTUVWxyZ"
}

No content

Get test results by ENR

get

https://api.obol.techhttp://localhost:3000https://localhost:3000

/v1/test/enr/{enr}

This endpoint retrieves test results for a specific ENR.

Path parameters

enrstringRequired

ENR to search for

Responses

200

Test results found

application/json

enrstringOptional

ENR text for the Charon node whose private key signed the payload

Example: enr:-IS4QAnExamplePlaceholderReplaceWithRealEnrFromCharon

sigstringOptional

Base64-encoded secp256k1 ECDSA signature (65 bytes: 32-byte r + 32-byte s + 1-byte recovery id) over the SSZ hashTreeRoot of the UTF-8 bytes of JSON.stringify(data), matching Charon publishResultToObolAPI

Example: AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcdefghijklmnoPQRSTUVWxyZ

404

No test results found for this ENR

500

An unknown error occurred

get

/v1/test/enr/{enr}

HTTPcURLJavaScriptPython

GET /v1/test/enr/{enr} HTTP/1.1
Host: api.obol.tech
Accept: */*

[
  {
    "data": {
      "charon_peers": {
        "category_name": "mev",
        "execution_time": "636.089125ms",
        "score": "A",
        "targets": {}
      },
      "beacon_node": {
        "category_name": "mev",
        "execution_time": "636.089125ms",
        "score": "A",
        "targets": {}
      },
      "validator_client": {
        "category_name": "mev",
        "execution_time": "636.089125ms",
        "score": "A",
        "targets": {}
      },
      "mev": {
        "category_name": "mev",
        "execution_time": "636.089125ms",
        "score": "A",
        "targets": {}
      },
      "infra": {
        "category_name": "mev",
        "execution_time": "636.089125ms",
        "score": "A",
        "targets": {}
      }
    },
    "enr": "enr:-IS4QAnExamplePlaceholderReplaceWithRealEnrFromCharon",
    "sig": "AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcdefghijklmnoPQRSTUVWxyZ"
  }
]