πΉπ Chronicle @ETHGlobal Bangkok
π οΈπ»π οΈ Hello builders and welcome to ETHGlobal Bangkok bounties page!
This document serves as a guide for integrating Chronicle Oracles into your hackathon projects.
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 on Testnet chains.
To kiss yourself, i.e., msg.sender, please check out the following guide, Getting Read Access to Contracts. On the same page, you will find a table with the SelfKisser addresses for different Testnet chains.
Please note that this is a mandatory step to be able to read from Chronicle Oracles!
You can find a step by step process for whitelisting an address to read from Chronicle Oracles on Testnet on this page.
π° Bounties: 10Kβ
𧩠Best Integration of Chronicle Oracles
𧩠Best Integration of Chronicle Protocol βΈΊ $6,500β
Use Chronicle Oracles to power up your DApp! You can utilize any of the oracles provided on the Dashboard across any of the 10 chains where Chronicle is live.
- π₯ 1st: $3000
- π₯ 2nd: $2000
- π₯ 3rd: $1000
- π 4th: $500
π Qualification rules:β
π οΈ Your project must read from a Chronicle oracle and then make a state change on a blockchain. π 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 2-min Builder Feedback Form: https://forms.gle/EZiu96gfhBBnwuAQ8
π― 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.
πββοΈ Chronicle Pool Prize
πββοΈ Chronicle Pool Prize βΈΊ $3,500β
Integrate Chronicle Oracles into your project to qualify for the Chronicle Pool Prize. The Pool Prize will be evenly distributed to all projects that integrate Chronicle Oracles (excluding those that win a separate prize from Chronicle).
π Qualification rules:β
Projects must demonstrate a good-faith effort to integrate Chronicle Oracles to be eligible for the Pool Prize. This is a great add-on bounty as Chronicle is compatible with many chains (Ethereum, Arbitrum, Mantle, Polygon zkEVM, Gnosis Chain, zkSync, Base, Optimism, Scroll, Berachain).
π Assets to submit:β
- A public GitHub repository with the code.
- Complete the 2-min Builder Feedback Form: https://forms.gle/EZiu96gfhBBnwuAQ8
βοΈ Workshopsβ
- π Chronicle Workshop: Powering DApps with Data from Oracles - Friday, 15th Nov, 6PM, Room 3
π€ 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
- How To Use Read/Write Contract Features on Etherscan
- Creating a TokenVendor using the ETH/USD price feed
- Integrating Cartesi Rollups with Chronicle Oracles
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 is verifiable via The Chronicle Dashboard.
π Scribe Public Repo
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.
π€ 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 spot the team in their Chronicle t-shirts and feel free to ask any questions directly to our on-site team members. You can also visit the Chronicle booth for hackathon support.
More on Scribeβ
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
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.
- βͺοΈ Make sure to whitelist the address that reads from each Oracle you use. For example, if you're using ETH/USD and ETH/BTC, you'll need to whitelist your address for both Oracles.
- β Ensure you are using the correct SelfKisser address for the chain you are working with, as the SelfKisser may have different addresses across chains. You can find the corresponding SelfKisser addresses for each chain on this page.