Proposal Submission

This guide explains how to create and submit Blocknet Superblock proposals for funded initiatives to be voted on by the BLOCK holders. Proposal submission is important for the decentralized governance model to function properly.

Proposal Submission Deadline

The deadline for creating proposals is 2880 blocks prior to the Superblock.

Est. current Block Height:

Block Height at next Superblock:

Block Height at next SB proposal deadline:

Est. date of next SB proposal deadline:

Est. time till next SB proposal deadline: days, hours, and minutes

Create A Proposal

  1. Submit a Draft Proposal to the Blocknet Proposal Forum.

    Tip: Before creating a new proposal, it's recommended to review previous proposals in the Proposal Forum to get an idea of what is generally expected and acceptable.

    1. At the Blocknet Proposal Forum, you'll see this at the top of the page: Draft Proposal
    2. Select Draft Proposal at the top left, then click + New Topic at the top right of the screen.
    3. Create a proposal, embedding Markdown Text as desired for formatting, which clearly and accurately conveys the following relevant information:
      1. Proposal name using only alpha-numerics (example: Qt-Exchange-Widget). Note, it's often useful to include the applicable SuperBlock number in the name, especially if you submit similar proposals each SuperBlock.
      2. Previous work relevant to this proposal
      3. What is being proposed
      4. Rationale and further explanation of proposal & background info
      5. Technical explanation/agenda of feature/proposal
      6. Estimated time for components in the proposal
      7. Teams/person undertaking and responsible for the work
      8. Cost assessment
      9. Fund custodians

  2. Once the Draft Proposal has been submitted and posted to the forum, copy the post's URL and create a shortened URL at https://bit.ly/ (The full URL can be used in place of bit.ly shortened version if the total amount of text entered for the proposal is not large.)

  3. Continue on to submit the proposal from the Qt wallet or to submit the proposal via command line.

  4. (Optional) Once the proposal has been submitted, your proposal will be assigned a proposal hash (a large string of numbers and letter representing your proposal). If using the Command Line Interface, the proposal hash will be returned after submitting the proposal via the createproposal command. The proposal hash will be the xxxx value in the "hash":"xxxx", value returned. You can also display proposal hash and other information about all upcoming proposals as follows:

    1. In Blocknet Qt/GUI wallet, go to Tools->Debug Console
    2. Type listproposals <last_SB_number + 1> where <last_SB_number + 1> is 1 more than the number of the previous SuperBlock.
    3. Or from CLI: ./blocknet-cli listproposals <last_SB_number + 1>

    Once you have your proposal's proposal hash, you can now edit your post in the Proposal Forum to add the command for voting for your proposal from the command line, which is: 

    vote [proposal hash] yes
    For example, 
    vote 8333cdf2fbfe25a78e08876b6ed1bc5cd09efa9edbdf491d2a06e43faf252698 yes

Submit from the Qt Wallet

Submit using the redesigned wallet

Redesigned Wallet

  1. Open and sync the Blocknet wallet. The wallet needs to be unlocked to submit a proposal.
  2. Ensure there is a minimum of 11 BLOCK in your wallet to pay for the proposal submission fee (10 BLOCK fee + transaction fee). This fee should be added to the proposal amount (in a later step) so that you are reimbursed if the proposal passes (see passing criteria). If you would like to confirm the submission fee you can use the proposalfee command.
  3. In the side menu, go to Proposals.
  4. Click on the Create New Proposal button at the top of the screen.

  5. Fill out the form fields:

    • Proposal name = The name of the proposal using only alpha-numerics.
      • URL = The shortened URL for the proposal link created.
      • Description = A short description of the proposal.
      • Superblock # = The Superblock block number the proposal is being submitted for.
      • Amount = The amount of funding requested (must be a whole number).
      • Payment address = The BLOCK address the funding will be paid out to.
      • A total of 107 characters can be used for the proposal name, URL, and description combined.

  6. Click the Continue button at the bottom of the screen.

  7. Follow the screens to review the information and submit the proposal.
  8. Wait for the transaction to have 1 confirmation (about 1 minute) then verify the proposal has been properly submitted by viewing the proposals.
Submit using the classic wallet

Classic Wallet

  1. Open and sync the Blocknet wallet. The wallet needs to be unlocked to submit a proposal.
  2. Ensure there is a minimum of 11 BLOCK in your wallet to pay for the proposal submission fee (10 BLOCK fee + transaction fee). This fee should be added to the proposal amount (in a later step) so that you are reimbursed if the proposal passes (see passing criteria). If you would like to confirm the submission fee you can use the proposalfee command.
  3. In the program menu, go to Window > Console. The debug console will open in a new window.

  4. The proposal submission command uses the following command structure (all one line): 

    createproposal [PROPOSAL_NAME] [SUPERBLOCK_BLOCK] [AMOUNT] [ADDRESS] [URL] [DESCRIPTION]
      • SUPERBLOCK_BLOCK = The Superblock block number the proposal is being submitted for.

      PROPOSAL_NAME = The name of the proposal using only alpha-numerics.

      • Specifying a value of 0 automatically submits for the next Superblock. * If you know the Superblock block number you wish to create a proposal for, then enter that value instead of 0.

    • AMOUNT = The amount of funding requested.

      • ADDRESS = The BLOCK address the funding will be paid out to.
      • URL = The shortened URL for the proposal link created.
      • DESCRIPTION = A short description of the proposal.
      • A total of 107 characters can be used for PROPOSAL_NAME, URL, and DESCRIPTION combined.

  5. Type the above command replacing the variables with the respective values in place. Below is an example:

    createproposal privacy-mixer 0 100 Bxxxxxxxxxxxxxxxxxxxxxxxxx https://goo.gl/xxxxxxx "Build privacy mixer app"

  6. Press the Enter key to submit the proposal to the network.

  7. Wait for the transaction to have 1 confirmation (about 1 minute) then verify the proposal has been properly submitted by viewing the proposals.

Submit from the Terminal

Linux

  1. Start the wallet. If it's not already running, use the following instructions to start it.

    1. Navigate to the bin folder within your Blocknet wallet installation directory (EG: ~/blocknet/bin/)

    2. Type in the following command, replacing [USERNAME] and [PASSWORD] with the respective rpcuser= and rpcpassword= values from your blocknet.conf file located in your ~/.blocknet/ directory.

      ./blocknetd -rpcuser=[USERNAME] -rpcpassword=[PASSWORD] -daemon

      Example:

      ./blocknetd -rpcuser=JohnBlocknet -rpcpassword=supersecretpassword -daemon

  2. The wallet process will begin in the current terminal window. You will need to open a new terminal window or tab and navigate to the same location before continuing.

  3. If your wallet was just started, you may need to wait a few minutes for the wallet to sync.
  4. Ensure there is a minimum of 11 BLOCK in your wallet to pay for the proposal submission fee (10 BLOCK fee + transaction fee). This fee should be added to the proposal amount (in a later step) so that you are reimbursed if the proposal passes (see passing criteria). If you would like to confirm the submission fee you can use the proposalfee command.

  5. The proposal submission command uses the following command structure (all one line): 

    ./blocknet-cli createproposal [PROPOSAL_NAME] [SUPERBLOCK_BLOCK] [AMOUNT] [ADDRESS] [URL] [DESCRIPTION]
      • SUPERBLOCK_BLOCK = The Superblock block number the proposal is being submitted for.

      PROPOSAL_NAME = The name of the proposal using only alpha-numerics.

      • Specifying a value of 0 automatically submits for the next Superblock. * If you know the Superblock block number you wish to create a proposal for, then enter that value instead of 0.

    • AMOUNT = The amount of funding requested.

      • ADDRESS = The BLOCK address the funding will be paid out to.
      • URL = The shortened URL for the proposal link created.
      • DESCRIPTION = A short description of the proposal.
      • A total of 107 characters can be used for PROPOSAL_NAME, URL, and DESCRIPTION combined.

  6. Type the above command replacing the variables with the respective values in place. Below is an example:

    ./blocknet-cli createproposal privacy-mixer 0 100 Bxxxxxxxxxxxxxxxxxxxxxxxxx https://goo.gl/xxxxxxx "Build privacy mixer app"

  7. Press the Enter key to submit the proposal to the network.

  8. Wait for the transaction to have 1 confirmation (about 1 minute) then verify the proposal has been properly submitted by viewing the proposals.
Windows

    1. Navigate to the bin folder within your Blocknet wallet installation directory (EG: C:\Users\[YourUsername]\Downloads\blocknet\bin\)

      Tip: This requires the blocknet-[version]-win64.zip download version
          To interact with the wallet via the command line, the `blocknet-[version]-win64.zip` wallet version is needed.

    Start the wallet. If it's not already running, use the following instructions to start it.

    1. Type in the following command, replacing [USERNAME] and [PASSWORD] with the respective rpcuser= and rpcpassword= values from your blocknet.conf file located in the C:\Users\[YourUsername]\AppData\Roaming\Blocknet directory. This directory can be found by opening the file explorer and pasting in %appdata%\Blocknet\ into the file explorer path field.

      ./blocknetd -rpcuser=[USERNAME] -rpcpassword=[PASSWORD] -daemon

      Example:

      ./blocknetd -rpcuser=JohnBlocknet -rpcpassword=supersecretpassword -daemon

  2. The wallet process will begin in the current terminal window. You will need to open a new terminal window or tab and navigate to the same location before continuing.

  3. If your wallet was just started, you may need to wait a few minutes for the wallet to sync.
  4. Ensure there is a minimum of 11 BLOCK in your wallet to pay for the proposal submission fee (10 BLOCK fee + transaction fee). This fee should be added to the proposal amount (in a later step) so that you are reimbursed if the proposal passes (see passing criteria). If you would like to confirm the submission fee you can use the proposalfee command.

  5. The proposal submission command uses the following command structure (all one line): 

    ./blocknet-cli createproposal [PROPOSAL_NAME] [SUPERBLOCK_BLOCK] [AMOUNT] [ADDRESS] [URL] [DESCRIPTION]
      • SUPERBLOCK_BLOCK = The Superblock block number the proposal is being submitted for.

      PROPOSAL_NAME = The name of the proposal using only alpha-numerics.

      • Specifying a value of 0 automatically submits for the next Superblock. * If you know the Superblock block number you wish to create a proposal for, then enter that value instead of 0.

    • AMOUNT = The amount of funding requested.

      • ADDRESS = The BLOCK address the funding will be paid out to.
      • URL = The shortened URL for the proposal link created.
      • DESCRIPTION = A short description of the proposal.
      • A total of 107 characters can be used for PROPOSAL_NAME, URL, and DESCRIPTION combined.

  6. Type the above command replacing the variables with the respective values in place. Below is an example:

    ./blocknet-cli createproposal privacy-mixer 0 100 Bxxxxxxxxxxxxxxxxxxxxxxxxx https://goo.gl/xxxxxxx "Build privacy mixer app"

  7. Press the Enter key to submit the proposal to the network.

  8. Wait for the transaction to have 1 confirmation (about 1 minute) then verify the proposal has been properly submitted by viewing the proposals.
MacOS

    1. Navigate to the bin folder within your Blocknet wallet installation directory (EG: ~/Downloads/blocknet/bin/)

      Tip: This requires the blocknet-[version]-osx64.tar.gz download version.
          To interact with the wallet via the command line, the `blocknet-[version]-osx64.tar.gz` wallet version is needed.

    Start the wallet. If it's not already running, use the following instructions to start it.

    1. Type in the following command, replacing [USERNAME] and [PASSWORD] with the respective rpcuser= and rpcpassword= values from your blocknet.conf file located in your ~/Library/Application Support/Blocknet/ directory. This directory can be found by opening the Finder, in the program menu selecting Go > Go to Folder, entering ~/Library/Application Support/Blocknet/ in the path, and pressing Enter.

      ./blocknetd -rpcuser=[USERNAME] -rpcpassword=[PASSWORD] -daemon

      Example:

      ./blocknetd -rpcuser=JohnBlocknet -rpcpassword=supersecretpassword -daemon

  2. The wallet process will begin in the current terminal window. You will need to open a new terminal window or tab and navigate to the same location before continuing.

  3. If your wallet was just started, you may need to wait a few minutes for the wallet to sync.
  4. Ensure there is a minimum of 11 BLOCK in your wallet to pay for the proposal submission fee (10 BLOCK fee + transaction fee). This fee should be added to the proposal amount (in a later step) so that you are reimbursed if the proposal passes (see passing criteria). If you would like to confirm the submission fee you can use the proposalfee command.

  5. The proposal submission command uses the following command structure (all one line): 

    ./blocknet-cli createproposal [PROPOSAL_NAME] [SUPERBLOCK_BLOCK] [AMOUNT] [ADDRESS] [URL] [DESCRIPTION]
      • SUPERBLOCK_BLOCK = The Superblock block number the proposal is being submitted for.

      PROPOSAL_NAME = The name of the proposal using only alpha-numerics.

      • Specifying a value of 0 automatically submits for the next Superblock. * If you know the Superblock block number you wish to create a proposal for, then enter that value instead of 0.

    • AMOUNT = The amount of funding requested.

      • ADDRESS = The BLOCK address the funding will be paid out to.
      • URL = The shortened URL for the proposal link created.
      • DESCRIPTION = A short description of the proposal.
      • A total of 107 characters can be used for PROPOSAL_NAME, URL, and DESCRIPTION combined.

  6. Type the above command replacing the variables with the respective values in place. Below is an example:

    ./blocknet-cli createproposal privacy-mixer 0 100 Bxxxxxxxxxxxxxxxxxxxxxxxxx https://goo.gl/xxxxxxx "Build privacy mixer app"

  7. Press the Enter key to submit the proposal to the network.

  8. Wait for the transaction to have 1 confirmation (about 1 minute) then verify the proposal has been properly submitted by viewing the proposals.
XRouter Beta Released! Read more... ✕
Required Wallet Update! View downloads... ✕