Getting Read Access to Chronicle Oracles - Process Explained
We know how much builders have to juggle when bringing a project to life. To support builders, Chronicle has partnered with several ecosystems to offer waived-fee access to existing oracles on select chains.
This currently applies to:
-
Mantle
-
Optimism
-
zkSync
If you're building on any of these chains and need production oracle access, reach out in the 🆘｜support channel—we're here to help.
Reading from Chronicle Oracles on Testnet in 4 Steps​
1 Select the chain you want to use.​
Chronicle Oracles are live on several 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​
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 select the Testnets tab on the Dashboard, then select the desired chain.
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 |
| Gnosis Mainnet | 0x0Dcc19657007713483A5cA76e6A7bbe5f56EA37d |
| Mantle Testnet | 0x9ee0DC1f7cF1a5c083914e3de197Fd1F484E0578 |
| Scroll Sepolia | 0x0Dcc19657007713483A5cA76e6A7bbe5f56EA37d |
| zkSync Sepolia | 0x25f594edde4f58A14970b2ef6616badBa4B1CdDD |
| Optimism Sepolia | 0xfF619a90cDa4020897808D74557ce3b648922C37 |
| Berachain Bepolia | 0x584914a893aBefB95abC02A5604338c0390F328B |
| Superseed Sepolia | 0x371A53bB4203Ad5D7e60e220BaC1876FF3Ddda5B |
| Corn Sepolia | 0x8CA2E3a09c79233127dC21955e28A6b9C4bf166E |
| Plume Testnet | 0xd6de00f82738c966c88F55017e8aCcA192AF42a1 |
| Monad Testnet | 0x9a0de663c20127a229891eA0C7Db99c785BF91e3 |
| Unichain Sepolia | 0x371A53bB4203Ad5D7e60e220BaC1876FF3Ddda5B |
| Avalanche Fuji Testnet | 0x371A53bB4203Ad5D7e60e220BaC1876FF3Ddda5B |
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.