{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://api.transpose.io/schemas/transaction",
  "title": "Transaction",
  "description": "A blockchain transaction on an EVM-compatible chain.",
  "type": "object",
  "properties": {
    "transaction_hash": {
      "type": "string",
      "description": "The unique transaction hash (32-byte hex string prefixed with 0x).",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    },
    "block_number": {
      "type": "integer",
      "description": "Block number containing this transaction.",
      "minimum": 0
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "ISO-8601 timestamp of the block that included this transaction."
    },
    "from_address": {
      "type": "string",
      "description": "The sender's blockchain address.",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "to_address": {
      "type": ["string", "null"],
      "description": "The recipient's address, or null for contract creation transactions.",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "value": {
      "type": "string",
      "description": "Native token value transferred in wei (as a string to preserve precision)."
    },
    "gas_price": {
      "type": "string",
      "description": "Gas price in wei."
    },
    "gas_used": {
      "type": "integer",
      "description": "Actual gas units consumed by this transaction.",
      "minimum": 0
    },
    "gas_limit": {
      "type": "integer",
      "description": "Maximum gas units the sender was willing to pay.",
      "minimum": 0
    },
    "status": {
      "type": "integer",
      "description": "Transaction execution status: 1 = success, 0 = failure.",
      "enum": [0, 1]
    },
    "method_id": {
      "type": ["string", "null"],
      "description": "First 4 bytes of call data (hex) identifying the called contract method.",
      "pattern": "^0x[0-9a-fA-F]{8}$"
    },
    "nonce": {
      "type": "integer",
      "description": "Sender's transaction count at time of inclusion.",
      "minimum": 0
    }
  },
  "required": ["transaction_hash", "block_number", "timestamp", "from_address"],
  "additionalProperties": true
}