Skip to content

Proposal Submission

This guide explains how to create and submit Blocknet Superblock proposals for funded initiatives to be voted on by the Service Node network. 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.


Create A Proposal

  1. It's recommended to submit a draft proposal to the proposal forum that clearly and accurately conveys the following relevant information:
  2. Proposal name using only alpha-numerics (example: Qt-Exchange-Widget)
  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
  10. See this guide for help posting.
  11. After allowing some time for the draft proposal to be reviewed, the final proposal with any edits should be submitted to the relevant final proposal Superblock category.
  12. Once a final proposal is submitted to the forum, copy the post URL and create a shortened URL: https://bit.ly/
  13. Continue on to submit the proposal from the Qt wallet or to submit the proposal via command line.

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]
    
    • PROPOSAL_NAME = The name of the proposal using only alpha-numerics.
    • SUPERBLOCK_BLOCK = The Superblock block number the proposal is being submitted for.

      • 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]
    
    • PROPOSAL_NAME = The name of the proposal using only alpha-numerics.
    • SUPERBLOCK_BLOCK = The Superblock block number the proposal is being submitted for.

      • 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. 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: 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.

    2. 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%\Roaming\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]
    
    • PROPOSAL_NAME = The name of the proposal using only alpha-numerics.
    • SUPERBLOCK_BLOCK = The Superblock block number the proposal is being submitted for.

      • 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. 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: ~/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.

    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 ~/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]
    
    • PROPOSAL_NAME = The name of the proposal using only alpha-numerics.
    • SUPERBLOCK_BLOCK = The Superblock block number the proposal is being submitted for.

      • 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...