Doppler Oracle

Doppler schemas are fixed-size and packed. A schema defines the bytes that come after the oracle sequence number.

Schema Shape

Use a TypeScript, JavaScript, or JSON config file with a payload object:

payload.ts

export default {
  payload: {
    price: "u64",
    confidence: "u32",
    slot: "u64",
    source: { type: "u8", length: 32 },
  },
} as const;

Supported scalar types:

Type	Size	Notes
`u8`	1 byte	Unsigned integer
`u16`	2 bytes	Little-endian
`u32`	4 bytes	Little-endian
`u64`	8 bytes	Little-endian, `bigint` in TypeScript
`i8`	1 byte	Signed integer
`i16`	2 bytes	Little-endian
`i32`	4 bytes	Little-endian
`i64`	8 bytes	Little-endian, `bigint` in TypeScript
`bool`	1 byte	Encoded as `0` or `1`

Fixed-size arrays use { type, length }:

payload: {
  authority: { type: "u8", length: 32 },
}

The layout is deterministic:

For this schema:

payload: {
  price: "u64",
  confidence: "u32",
  slot: "u64",
}

The payload size is 20 bytes:

offset 0   price       u64   8 bytes
offset 8   confidence  u32   4 bytes
offset 12  slot        u64   8 bytes

Doppler does not support dynamic fields:

Use explicit fixed-size fields instead.