Submission Requirements

  1. All submissions must be open source and licensed under the MIT license.
  2. All submissions must have an open-source repository.
  3. Must include a short video (max 5 minutes) covering:
    • What the hook does
    • How it brings value
    • Walkthrough of the hook contract functionality/demo
  4. Optionally, you may attach a link to a working demo of your project (nice to have, not required). This could be a working frontend, test demo, or any other interactive method to showcase the hook in action.
  5. You can create slides or a pitch deck as a bonus, but it is not mandatory.
  6. Preferred hook submission format is to raise a clean PR titled "BAL Hookathon - your hook title" against scaffold-balancer-v3 repo with the new hook and a README.md file covering:
    • What the hook does
    • An example use case
    • Feedback about DevX

Application Questions

Please ensure these are answered in your BUIDL submission

Hook Submission
1 - Team Name
2 - Hook Title
3 - Hook description (include demo)
4 - Explanation of how submission meets judging criteria
5 - Pool Lifecycle Implementation Point(s)
-onRegister
-onBeforeInitialize
-onAfterInitialize
-onBeforeAddLiquidity
-onAfterAddLiquidity
-onBeforeRemoveLiquidity
-onAfterRemoveLiquidity
-onBeforeSwap
-onAfterSwap
-onComputeDynamicSwapFeePercentage
6 - Challenges
7 - Team Contributions
8 - Links

Educational / DevRel / Tooling Submission
1 - Team Name
2 - Submission Title
3 - Description
4 - Explanation of how submission meets judging criteria
5 - Team Contributions
6 - Links

Getting Started [3-5 MIN]

1. Submit your BUIDL via DoraHacks.io. To begin, you’ll need a DoraHacks account. Click the Login button in the top-right corner to sign up.

You can create an account with GitHub, a crypto wallet, or your email address. We recommend using GitHub to reach a wider audience with your project

*Note: You may be asked to verify your email. The code can take a few minutes to arrive, but don’t worry—it will be valid for 10 minutes after you click “send code.”

2. Make sure to add your GitHub link to your project before the submission deadline. You can submit first and make edits until the hackathon submission deadline.

Click “Submit BUIDL” to open the Hackathon submission form.

→ Already have a BUIDL on DoraHacks?

Click “Use Existing BUIDL” and select your project. Choose the track you'd like to join, answer the organizer’s questions, and then click “Submit for review.”

→ Submitting a new BUIDL?

Click “Create new BUIDL” and fill out the form with your project details.

Be sure to include URLs (with http/https://) for your demo, demo link, and social media.

Once you’ve completed the new BUIDL setup, select the relevant track, and click “Submit for review.”

After submission, you’ll see a notification confirming your project has been submitted.

Project Approval

After submission, your project needs to be approved by the Hackathon Organizer before it becomes publicly visible in the Hackathon BUIDLs gallery.

Getting Support

If you have any questions for the hackathon organizers, feel free to contact them via their dedicated Telegram, Discord, or Slack communication channel. You can also click the "Message" button next to the organizer's logo to DM them on DoraHacks.

Need to Update Your BUIDL?

To make changes to your project, click [Avatar] -> [Profile] to access your Account Center. Then, click the "Edit" button on the top right of your BUIDL to update your BUIDL information.