Skip to main content

πŸ‡΅πŸ‡± ETH Warsaw Hackathon

This document provides documentation for integrating Chronicle Oracles into their ETH Warsaw Hackathon projects.

caution

If you have any questions, don’t hesitate to reach out to our booth, or anyone wearing Chronicle hoodies

Chronicle Protocol Contracts​

Scribe​

Scribe is an efficient Schnorr multi-signature based Oracle. Its Chronicle’s new Oracle version enabling more than 60% gas savings.

https://github.com/chronicleprotocol/scribe

Self-Kisser​

Chronicle oracle’s read functions are protected by a whitelist.

However, via the SelfKisser contract you can whitelist (we call it kiss) yourself permissionless.

How to kiss yourself (ie msg.sender)?

$ cast send 0x0dcc19657007713483a5ca76e6a7bbe5f56ea37d "selfKiss(address)()" <oracle address you want you use>

Verify you are whitelisted (returns 1 ie true if whitelisted) :

$ cast call <oracle address> "tolled(address)" <your address>
0x0000000000000000000000000000000000000000000000000000000000000001

For more info, see the SelfKisser repo:

https://github.com/chronicleprotocol/self-kisser

The IChronicle Interface - or how to read Chronicle Oracles?​

The easiest way to read the oracle is…. read() returns (uint).

$ cast call 0xc8A1F9461115EF3C1E84Da6515A88Ea49CA97660 "read()(uint)"
1656870000000000045440
info

You can find the whole interface definition here

Smart Contract Addresses on Sepolia network​

Contract NameContract Address on Sepolia network
Self-kisser0x0Dcc19657007713483A5cA76e6A7bbe5f56EA37d
ETH/USD0xc8A1F9461115EF3C1E84Da6515A88Ea49CA97660
AAVE/USD0xa38C2B5408Eb1DCeeDBEC5d61BeD580589C6e717
ARB/USD0x579BfD0581beD0d18fBb0Ebab099328d451552DD
AVAX/USD0x78C8260AF7C8D0d17Cf3BA91F251E9375A389688
BNB/USD0x26EE3E8b618227C1B735D8D884d52A852410019f
BTC/USD0x4B5aBFC0Fe78233b97C80b8410681765ED9fC29c
CRV/USD0xf29a932ae56bB96CcACF8d1f2Da9028B01c8F030
DAI/USD0xa7aA6a860D17A89810dE6e6278c58EB21Fa00fc4
ETH/BTC0x1804969b296E89C1ddB1712fA99816446956637e
GNO/USD0xA28dCaB66FD25c668aCC7f232aa71DA1943E04b8
IBTA/USD0x07487b0Bf28801ECD15BF09C13e32FBc87572e81
LDO/USD0xa53dc5B100f0e4aB593f2D8EcD3c5932EE38215E
LINK/USD0xecB89B57A60ac44E06ab1B767947c19b236760c3
MATIC/USD0xa48c56e48A71966676d0D113EAEbe6BE61661F18
MKR/USD0x67ffF0C6abD2a36272870B1E8FE42CC8E8D5ec4d
OP/USD0xfadF055f6333a4ab435D2D248aEe6617345A4782
RETH/USD0xEE02370baC10b3AC3f2e9eebBf8f3feA1228D263
SDAI/DAI0xD93c56Aa71923228cDbE2be3bf5a83bF25B0C491
SNX/USD0xD20f1eC72bA46b6126F96c5a91b6D3372242cE98
SOL/USD0x4D1e6f39bbfcce8b471171b8431609b83f3a096D
UNI/USD0x2aFF768F5d6FC63fA456B062e02f2049712a1ED5
USDC/USD0x1173da1811a311234e7Ab0A33B4B7B646Ff42aEC
USDT/USD0x0bd446021Ab95a2ABd638813f9bDE4fED3a5779a
WBTC/USD0xA7226d85CE5F0DE97DCcBDBfD38634D6391d0584
WSTETH/USD0xc9Bb81d3668f03ec9109bBca77d32423DeccF9Ab
YFI/USD0x0893EcE705639112C1871DcE88D87D81540D0199

Some General Stuff​

Some more Scribe Background Info​