Skip to main content

πŸ‡ΉπŸ‡­ 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.

tip

Chronicle Protocol Contracts​

You can view all the smart contract addresses here, or directly via the Dashboard. If you are using the Dashboard, you can find the Testnet addresses for different chains by toggling <dev mode>.

important

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:

  1. A public demo URL to your deployed project that judges can test.
  2. A short video that demonstrates your submission (approximately 2-3 minutes)
  3. A public GitHub repository with the code.
  4. 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:​

✏️ Workshops​

  • πŸ”Œ Chronicle Workshop: Powering DApps with Data from Oracles - Friday, 15th Nov, 6PM, Room 3

πŸ“€ Resources​

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​

note

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​

List of Sepolia ETH Faucets:
Chainlist RPCs:
RPC Providers:

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.

Good luck and happy hacking! πŸ§™β€‹