Getting Read Access to Chronicle Oracles - Process Explained
Reading from Chronicle Oracles on Testnet in 4 Stepsβ
1 Select the chain you want to use.β
Chronicle Oracles are live on 10 chains, with more integrations rolling out regularly. Using the Dashboard, you can quickly find the available chains.
2 Select the Oracle(s) to use and its addressβ
Once on the desired chain, find the oracle address that you need for that chain. Before reading from an Oracle, the address making the call needs to be whitelisted for that Oracle. To find the Testnet addresses for the Oracles, simply toggle the <dev mode> on the Dashboard.
3 Get the address of the SelfKisser for the selected chainβ
Chronicle Oracles are read protected by a whitelist. On Testnet networks, you can whitelist yourself using the SelfKisser contract. Ensure you're using the correct SelfKisser address for each chain.
| Testnet Network | SelfKisser Address |
|---|---|
| Ethereum Sepolia | 0x0Dcc19657007713483A5cA76e6A7bbe5f56EA37d |
| Base Sepolia | 0x70E58b7A1c884fFFE7dbce5249337603a28b8422 |
| Arbitrum Sepolia | 0xc0fe3a070Bc98b4a45d735A52a1AFDd134E0283f |
| Polygon zkEVM Testnet Cardona | 0xCce64A8127c051E784ba7D84af86B2e6F53d1a09 |
| Gnosis Mainnet | 0x0Dcc19657007713483A5cA76e6A7bbe5f56EA37d |
| Mantle Testnet | 0x9ee0DC1f7cF1a5c083914e3de197Fd1F484E0578 |
| Scroll Sepolia | 0x0Dcc19657007713483A5cA76e6A7bbe5f56EA37d |
| zkSync Sepolia | 0x25f594edde4f58A14970b2ef6616badBa4B1CdDD |
| Optimism Sepolia | 0xfF619a90cDa4020897808D74557ce3b648922C37 |
| Berachain Bartio | 0x2FFCAfF4BcF6D425c424f303eff66954Aa3A27Fd |
If you need to read from multiple Oracles, make sure that you repeat the whitelisting process for each Oracle.
4 Using the SelfKisser, whitelist the address used to read from the oracleβ
The ISelfKisser interface defines 2 function for whitelisting:
function selfKiss(address oracle) external;- whitelist your own address (msg.sender)function selfKiss(address oracle, address who) external;- specifies a different address to whitelist, such as a smart contract
In most cases, you'll use the second option to whitelist another address.
Ensure you have sufficient funds for the whitelisting process, as itβs a write operation requiring gas to complete.
On Mainnet, the process is similar, but the whitelisting is permissioned. To get whitelisted, please open a ticket on Discord via the π ο½ support channel to reach out to the team.