Skip to content

Proposals

HBOT holders can vote on three types of proposals:

Each proposal type has different parameters:

Proposal Type Pull Request Improvement Governance
Snapshot Space https://snapshot.org/#/hbot-prp.eth https://snapshot.org/#/hbot-ip.eth https://snapshot.org/#/hbot.eth
Vote Duration 7 days 7 days 7 days
Minimum HBOT Balance 1 10,000 50,000
Quorum Percentage 0.1% of HBOT circulating supply 3% of HBOT circulating supply 10% of HBOT circulating supply
Approval Threshold >50% of tokens approved >50% of tokens approved >50% of tokens approved

See HBOT for the current Quorum Percentage, which is based on the HBOT circulating supply.

Types of Proposals

Pull Request Proposals

  • Pull Request Proposals (PRP) let HBOT holders approve pull requests for merge and inclusion into the Hummingbot codebase.
  • Any wallet with a HBOT balance that meets Minimum HBOT Balance with can create a PRP at the Snapshot sub-space: https://snapshot.org/#/hbot-prp.eth.
  • A PRP links to a valid pull request in the Hummingbot code repository. See Contribution Guidelines for more information about the process of creating a valid pull request.
  • If the PRP is approved after the Vote Duration and the Quorum Percentage is met, then the Foundation will begin the process of reviewing and merging the pull request into the codebase.
  • During the review process, the Foundation will test the submitted pull request to ensure that it fulfills its stated intention, conduct a technical code review, check for conflicts with other parts of the Hummingbot codebase and security issues. If the review passes, the pull request is merged into the codebase.
  • If the PRP fails to meet the Approval Threshold, the Foundation will close the related pull request. However, the developer is free to create a new pull request and a new PRP at a subsequent date.

To be considered valid, a PRP should contain the following fields (otherwise the Foundation may close it):

  • Title: Starts with PRP followed by count and summary (i.e. PRP-100: [summary])
  • Github Link: Link to a Github pull request, which should contain a detailed explanation of the changes proposed

Hummingbot Improvement Proposals

  • Hummingbot Improvement Proposals (HIP) let HBOT holders propose developer bounties for improvements or fixes to the Hummingbot codebase
  • HIPs may name a specific developer, in which case the bounty is assigned to the developer if it is approved. If not, the Foundation will mark the bounty as Open and publicize it to the community.
  • Any wallet with a HBOT balance that meets Minimum HBOT Balance with can create a HIP at the Snapshot sub-space: https://snapshot.org/#/hbot-hip.eth
  • Before creating an HIP, we recommend creating a thread in Discord under the #proposal-discussions channel to gauge whether the requested HBOT amount is appropriate.
  • If the HIP is approved after the Vote Duration and the Quorum Percentage is met, then the Foundation will create a Bounty and follow the assignation process.

To be considered valid, a HIP should contain the following fields (otherwise the Foundation may close it):

  • Title: Starts with HIP followed by count and summary (i.e. HIP-100: [summary])
  • Github Link: Link to a Github issue or pull request
  • HBOT Allocation: Proposed HBOT bounty amount
  • Developer (if assigned): Link to a developer's Github page or website

Hummingbot Governance Proposals

  • Hummingbot Governance Proposals (HGP) are generally used by the Foundation to conduct regular polls that allow HBOT holders to decide how engineering bandwidth should be allocated across the exchanges, strategies, and issues in the codebase.
  • The Foundation also uses an HGP to elects its Board of Directors every year.
  • In addition, HGPs are used to propose HBOT allocations for non-development purposes, such as community incentives and liquidity mining programs.

  • Any wallet with a HBOT balance that meets Minimum HBOT Balance with can create a HGP at the main Snapshot space: https://snapshot.org/#/hbot.eth.

  • Before creating an HGP, we recommend creating a thread in Discord under the #proposal-discussions channel to gauge whether the requested HBOT amount is appropriate.

To be considered valid, an HGP should contain the following fields:

  • Title: Starts with HGP followed by count and summary (i.e. HGP-100: [summary])
  • Description: Detailed explanation of the proposed initiative or program
  • HBOT Allocation (if any): Proposed HBOT bounty amount