BlockNumberRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/grokzilla-shop/json-schema/grokzilla-shop-block-number-request-schema.json",
  "title": "BlockNumberRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/grokzilla-shop-openapi.json#/components/schemas/BlockNumberRequest",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "chains": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "base",
          "ethereum"
        ]
      },
      "minItems": 1,
      "maxItems": 2,
      "default": [
        "base"
      ],
      "uniqueItems": true
    },
    "include_timestamp": {
      "type": "boolean",
      "default": false,
      "description": "When true, also fetch eth_getBlockByNumber for the tip timestamp"
    },
    "request_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Optional idempotency key. Echoed back; a credit-pack redemption with the same request_id and body is charged once."
    }
  }
}