🇧🇪 Chronicle @ETHGlobal Brussels
🛠️💻🛠️ Hello builders and welcome to ETHGlobal Brussels Chronicle bounties page!
This document serves as a guide for integrating Chronicle Oracles into your hackathon projects.
You can only compete for one track. For Tracks 1 (DeFi) and 2 (Innovation), if the judges determine that your project is a better fit for the other track, they will move it automatically. You only need to submit your project once.
💰 Bounties: 10K
Track 1: DeFi Track (Integrate Chronicle Oracles into one of the following DeFi applications: Borrowing & Lending dApps, Decentralized Exchanges (DEX), Liquidity Mining, Prediction Markets, or Stablecoins)
Track 1: DeFi Track (Integrate Chronicle Oracles into one of the following DeFi applications: Borrowing & Lending dApps, Decentralized Exchanges (DEX), Liquidity Mining, Prediction Markets, or Stablecoins)
- 🥇 1st: $2500
- 🥈 2nd: $1500
- 🥉 3rd: $700
📜 Qualification rules:
-
Each project must use Chronicle Oracles in some form to make a state change on a blockchain, otherwise it will not be eligible. This means that a front end simply reading from Chronicle Oracles doesn't count.
-
You can deploy your contracts on any of the following chains:
- Ethereum Sepolia
- Arbitrum Sepolia
- Base Sepolia
- Polygon zkEVM Sepolia
- Gnosis Chain Mainnet
- Scroll Sepolia
- zkSync Sepolia
- Optimism Sepolia
- Mantle Sepolia
🎯 Judging Criteria
- Code quality - well organized and readable code will score higher.
- Documentation - the better the documentation the higher the score.
- Extensibility - how easy can a developer use this to build out their own idea?
- DX - does the project provide a high quality developer experience?
- UI/UX - Projects with an intuitive UI will score higher.
🏁 Assets to submit:
Make sure to include the following in your project submission:
- A public demo URL to your deployed project that judges can test.
- A short video that demonstrates your submission (approximately 2-3 minutes).
- A public GitHub repository with the code.
- Complete the Builder Feedback Form.
Track 2: Most Innovative Chronicle Oracle Integration
Track 2: Most Innovative Chronicle Oracle Integration
- 🥇 1st: $2500
- 🥈 2nd: $1500
- 🥉 3rd: $700
📜 Qualification rules:
-
Each project must use Chronicle Oracles in some form to make a state change on a blockchain, otherwise it will not be eligible. This means that a front end simply reading from Chronicle Oracles doesn't count.
-
The prize will go to the top three teams with the most innovative integration of Scribe, Chronicle's new Schnorr Oracle. You can deploy your contracts on any of the following chains:
- Ethereum Sepolia
- Arbitrum Sepolia
- Base Sepolia
- Polygon zkEVM Sepolia
- Gnosis Chain Mainnet
- Scroll Sepolia
- zkSync Sepolia
- Optimism Sepolia
- Mantle Sepolia
Solutions must integrate the Chronicle Oracle smart contracts. The innovation should stem from the use case of the Oracle, i.e., the idea or utility of the project.
🎯 Judging Criteria
- Code quality - well organized and readable code will score higher.
- Documentation - the better the documentation the higher the score.
- Extensibility - how easy can a developer use this to build out their own idea?
- DX - does the project provide a high quality developer experience?
- UI/UX - Projects with an intuitive UI will score higher.
🏁 Assets to submit:
Make sure to include the following in your project submission:
- A public demo URL to your deployed project that judges can test.
- A short video that demonstrates your submission (approximately 2-3 minutes).
- A public GitHub repository with the code.
- Complete the Builder Feedback Form.
Track 3: Best Educational Resource for Builders
Track 3: Best Educational Resource for Builders
Create a tutorial for developers on integrating Chronicle Scribe Oracles.
- 🥇 1st: $350
- 🥈 2nd: $250
📜 Qualification rules:
- The submitted material should be your own. Material originating from other sources or generated with AI does not qualify.
🎯 Judging Criteria
- Accuracy: Information provided should be factually correct and well-researched.
- Clarity: Concepts should be explained clearly and concisely, avoiding unnecessary jargon.
- Extensibility - how easy can a developer use this material to build out their own idea?
- Relevance: The content should be relevant to the target audience and meet their learning needs.
- Practicality: The content should offer practical insights, tips, or steps that the audience can apply.
🏁 Assets to submit:
For this track you only need to submit a link to your content and to complete the Builder Feedback Form.
✏️ Talks & Workshops
- 🛠️ Chronicle Workshop: Scalable, Decentralized, Cost-Efficient Oracles
- Friday, 12th July, 04:30pm, Room 3
- GitHub Repository for the workshop
Chronicle Protocol Contracts
Scribe
Scribe is an extremely gas-efficient Oracle based on aggregated Schnorr signatures. Providing nearly constant gas costs on Layer 2s and on Layer 1s, Scribe boasts of fixed gas costs, leading to substantial savings—over 60% relative to competing Oracles and an impressive 80% compared to Chainlink. This approach to gas management significantly boosts the scalability of the Oracle.
The Chronicle Scribe Oracle interface is plug-and-play with Chainlink and Maker Oracles, providing a smooth transition for developers used to these platforms.
All data delivered by a Chronicle Oracle on Mainnet is verifiable via The Chronicle Dashboard.
CAST
Cast is a command-line interface (CLI) tool by the Foundry team to streamline your interaction with Ethereum and other EVM-based chains. Whether you're making smart contract calls, sending transactions, or retrieving any chain data, cast can help with that. You can read more here.
Self-Kisser: Permissionless Whitelisting
Chronicle safeguards Oracle read functions with a whitelist, ensuring controlled access to critical data. However, the SelfKisser contract unfolds a possibility where you can whitelist yourself (or, as whimsically termed, "kiss") yourself.
To kiss yourself, i.e., msg.sender, please check out the following guide, Getting Read Access to Contracts.
Please note that this is a mandatory step in order to be able to read from Chronicle Oracles.
Common Pitfalls
- ⛽️ Ensure you have a sufficient amount of tokens in your wallet to cover gas fees for transactions.
- ⛓️ Ensure your wallet is connected to the correct network corresponding to the contract you are interacting with.
📤 Resources
- Scaffold-oracle-reader based on Scaffold-ETH2, to help you prototype easily and experiment with Solidity using a frontend that adapts to your smart contract
- Self-kisser Contract on Sepolia network
- How To Use Read/Write Contract Features on Etherscan
You can view all the smart contract addresses below organized by chains:👇
Smart Contract Addresses on Ethereum Sepolia
Smart Contract Addresses on Base Sepolia
| Contract Name | Contract Address on Base Sepolia |
|---|---|
| SelfKisser_1 | 0x70E58b7A1c884fFFE7dbce5249337603a28b8422 |
| Chronicle_CBETH_USD_1 | 0x11E155b04f0498bc6B6EB0086A2148368F0b64F0 |
| Chronicle_CBETH_USDC_1 | 0x371A53bB4203Ad5D7e60e220BaC1876FF3Ddda5B |
| Chronicle_DAI_USD_1 | 0xC32753217DcC7Bb2F449bD6f1bC384d1AC72a7B6 |
| Chronicle_ETH_USD_1 | 0xea347Db6ef446e03745c441c17018eF3d641Bc8f |
| Chronicle_HYUSD_USD_1 | 0x1C082338961068009d9F33ea48aa13623e63B18e |
| Chronicle_RETH_USD_1 | 0x829124df58D1b4853f8669C867d3991cA09265Aa |
| Chronicle_USDC_USD_1 | 0x088BEA5f90C316e1c8b898C4A9AF27C2F2984cd7 |
| Chronicle_USDT_USD_1 | 0xC1A83Bed9d7E434a3E8608f7C5438F805D404F8F |
| Chronicle_WBTC_USD_1 | 0x8E947Ea7D5881Cd600Ace95F1201825F8C708844 |
| Chronicle_WSTETH_ETH_1 | 0x450F6F025aD017f345CD17407Ee22d90E5F87441 |
| Chronicle_WSTETH_USD_1 | 0x834c4f996B8a6411AEC0f8a0cF6fAfd4423dBEe2 |
| Chronicle_WSTETH_USDC_1 | 0x262034B41F0C33b67e96b6495b7Bf650dC85acda |
| Chronicle_WUSDM_USD_1 | 0xe20165f58B507DF17187D6FCc12E741423075C5c |
Smart Contract Addresses on Arbitrum Sepolia
Smart Contract Addresses on Polygon zkEVM Testnet Cardona
Smart Contract Addresses on Gnosis Mainnet
Smart Contract Addresses on Mantle Testnet
Smart Contract Addresses on Scroll Sepolia
Smart Contract Addresses on zkSync Sepolia
Smart Contract Addresses on Optimism Sepolia
🤝 Getting Help
If you have any questions and would like support with your project, please join our Discord and drop your question in the hackathons channel.
Say hi 👋 when you see them around and ask your questions directly to one of our team members who are on-site during the event:
- Alexander Vasylchenko, Product, @AlexanderVasyl
- Angus Tookey, Marketing, @AngusTookey
- Bianca Buzea, Developer Relations, @buzea200
- Jenn Senhaji, BD/Growth, @jensenhaji
- Niklas Kunkel, Founder, @nomos_paradox
- Pawel Zaremba, Engineering, @teghnet
General Setup Useful Links
List of Sepolia ETH Faucets:
- https://cloud.google.com/application/web3/faucet/ethereum/sepolia - Does not require to have any funds on Mainnet
- https://www.alchemy.com/faucets/ethereum-sepolia
- https://ethglobal.com/faucet - Faucets for different Testnet networks for various chains
- https://sepoliafaucet.com/
Chainlist RPCs:
- Foundry Setup:
- Create a Test Wallet:
cast new wallet