mirror of
https://github.com/logos-blockchain/lez-programs.git
synced 2026-06-28 11:10:08 +00:00
7461c9552b
Adds the CreateOraclePriceAccount instruction to the TWAP oracle program. The instruction initialises a canonical OraclePriceAccount PDA for a given price source and time window, seeding it with a non-zero initial price and the current block timestamp so the account is immediately valid to consumers. - PDA mirrors PriceObservations: derived from (oracle_program_id, price_source_id, window_duration) with a distinct seed constant, so each (source, window) pair maps to a distinct oracle price account that cannot collide with its corresponding observations account. - source_id is not a parameter: it is always set to price_source.account_id. Accepting it as a free parameter would allow callers to register a price account that claims to represent a source it does not control. Deriving it from the authorized price source account closes that vector entirely. - Authorization follows the same model as CreatePriceObservations: is_authorized = true on the price source proves the caller controls it; the PDA check ensures the supplied oracle price account address is the one derived from that specific source and window. - The initial timestamp is read from the canonical 1-block LEZ clock (CLOCK_01_PROGRAM_ACCOUNT_ID), never from a caller-supplied value. The clock account_id is asserted, so a caller cannot substitute an account they control to forge the seeding timestamp. - A zero price or zero timestamp is rejected at creation. Both are the "no valid price" sentinel consumers treat as unset, so an account must never be created in that state; the instruction asserts a non-zero initial_price and a non-zero clock timestamp. - initial_price is a Q64.64 fixed-point value (real price = initial_price / 2^64), matching the oracle price representation. The non-zero check rejects the sentinel but cannot validate scale — supplying a correctly-scaled value is the caller's responsibility. Closes #129
164 lines
3.2 KiB
JSON
164 lines
3.2 KiB
JSON
{
|
|
"version": "0.1.0",
|
|
"name": "twap_oracle",
|
|
"instructions": [
|
|
{
|
|
"name": "create_price_observations",
|
|
"accounts": [
|
|
{
|
|
"name": "price_observations",
|
|
"writable": false,
|
|
"signer": false,
|
|
"init": false
|
|
},
|
|
{
|
|
"name": "price_source",
|
|
"writable": false,
|
|
"signer": false,
|
|
"init": false
|
|
},
|
|
{
|
|
"name": "clock",
|
|
"writable": false,
|
|
"signer": false,
|
|
"init": false
|
|
}
|
|
],
|
|
"args": [
|
|
{
|
|
"name": "initial_tick",
|
|
"type": "i32"
|
|
},
|
|
{
|
|
"name": "window_duration",
|
|
"type": "u64"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"name": "create_oracle_price_account",
|
|
"accounts": [
|
|
{
|
|
"name": "oracle_price_account",
|
|
"writable": false,
|
|
"signer": false,
|
|
"init": false
|
|
},
|
|
{
|
|
"name": "price_source",
|
|
"writable": false,
|
|
"signer": false,
|
|
"init": false
|
|
},
|
|
{
|
|
"name": "clock",
|
|
"writable": false,
|
|
"signer": false,
|
|
"init": false
|
|
}
|
|
],
|
|
"args": [
|
|
{
|
|
"name": "base_asset",
|
|
"type": "account_id"
|
|
},
|
|
{
|
|
"name": "quote_asset",
|
|
"type": "account_id"
|
|
},
|
|
{
|
|
"name": "initial_price",
|
|
"type": "u128"
|
|
},
|
|
{
|
|
"name": "window_duration",
|
|
"type": "u64"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"accounts": [
|
|
{
|
|
"name": "PriceObservations",
|
|
"type": {
|
|
"kind": "struct",
|
|
"fields": [
|
|
{
|
|
"name": "price_source_id",
|
|
"type": "account_id"
|
|
},
|
|
{
|
|
"name": "write_index",
|
|
"type": "u32"
|
|
},
|
|
{
|
|
"name": "total_entries",
|
|
"type": "u64"
|
|
},
|
|
{
|
|
"name": "last_recorded_tick",
|
|
"type": "i32"
|
|
},
|
|
{
|
|
"name": "entries",
|
|
"type": {
|
|
"vec": {
|
|
"defined": "ObservationEntry"
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
},
|
|
{
|
|
"name": "OraclePriceAccount",
|
|
"type": {
|
|
"kind": "struct",
|
|
"fields": [
|
|
{
|
|
"name": "base_asset",
|
|
"type": "account_id"
|
|
},
|
|
{
|
|
"name": "quote_asset",
|
|
"type": "account_id"
|
|
},
|
|
{
|
|
"name": "price",
|
|
"type": "u128"
|
|
},
|
|
{
|
|
"name": "timestamp",
|
|
"type": "u64"
|
|
},
|
|
{
|
|
"name": "source_id",
|
|
"type": "account_id"
|
|
},
|
|
{
|
|
"name": "confidence_interval",
|
|
"type": "u128"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
],
|
|
"types": [
|
|
{
|
|
"name": "ObservationEntry",
|
|
"kind": "struct",
|
|
"fields": [
|
|
{
|
|
"name": "timestamp",
|
|
"type": "u64"
|
|
},
|
|
{
|
|
"name": "tick_cumulative",
|
|
"type": "i64"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"instruction_type": "twap_oracle_core::Instruction"
|
|
}
|