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

Judging Criteria

Hook Building

  • Minimum Acceptance Criteria: Does hook work (inclusive of tests), does it add or demonstrate any useful functionality of at least one hook entry point.
  • Innovation and Creativity: How novel and creative is the hook concept
  • Technical Complexity: The technical sophistication of the solution, including gas optimization techniques
  • Practical Applicability: The potential practical impact and usability of the hook, does it solve a known or unknown problem
  • Presentation and Demonstration: How well was the hook and its value explained / presented

Educational / DevRel / Tooling

  • Relevance: Does the submission address an important concept or a gap in the existing documentation for developers? Does it clearly explain what level it is aimed at
  • Content Quality: How well does the content explain a complex topic, does it address the intended audience, is it easy to follow.
  • Presentation: How well is the submission visually presented/UX

Tutorial Video

Getting Started [3-5 MIN]

1. Submit your BUIDL via DoraHacks.io. You need an account with DoraHacks before you can submit.

Use the Log in button in the upper right corner of the page to access the sign-up options.

You can create your account with either your GitHub account, Google account, crypto wallet or email address. We recommend connecting your account to GitHub to share your projects with a wider audience.

*If asked for a verification code via email, the email may take a few minutes to arrive. The code expires 10 minutes after you click “send code”.

2. Before the submission deadline, make sure you have added your Github link to the project. You can submit the project first, and continue editing until the deadline.

Click “Submit BUIDL”.

→ Already have a BUIDL on DoraHacks?

  1. Click “Use existing BUIDL” and select your BUIDL project.
  2. Choose the track you want to enter.
  3. Answer the questions set by the organizer in the input field if applicable.

→ 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 submitting successfully, you'll see this notification.

Manage BUIDL submission

After submitting your application, the "Submit" button will update to "Manage Submission". Click the button to manage your BUIDL's Track/Bounty submission.

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.