diff --git a/docs/user/governance/img/core-qt/governance-tab.png b/docs/user/governance/img/core-qt/governance-tab.png new file mode 100644 index 000000000..a6cb7f5ef Binary files /dev/null and b/docs/user/governance/img/core-qt/governance-tab.png differ diff --git a/docs/user/governance/img/core-qt/proposal-burn-fee-notice.png b/docs/user/governance/img/core-qt/proposal-burn-fee-notice.png new file mode 100644 index 000000000..06ac5c7c6 Binary files /dev/null and b/docs/user/governance/img/core-qt/proposal-burn-fee-notice.png differ diff --git a/docs/user/governance/img/core-qt/proposal-create.png b/docs/user/governance/img/core-qt/proposal-create.png new file mode 100644 index 000000000..aeae4e147 Binary files /dev/null and b/docs/user/governance/img/core-qt/proposal-create.png differ diff --git a/docs/user/governance/img/core-qt/proposal-prepare-burn.png b/docs/user/governance/img/core-qt/proposal-prepare-burn.png new file mode 100644 index 000000000..c44b3f671 Binary files /dev/null and b/docs/user/governance/img/core-qt/proposal-prepare-burn.png differ diff --git a/docs/user/governance/img/core-qt/proposal-prepare-burned-conf-wait.png b/docs/user/governance/img/core-qt/proposal-prepare-burned-conf-wait.png new file mode 100644 index 000000000..7e1b72833 Binary files /dev/null and b/docs/user/governance/img/core-qt/proposal-prepare-burned-conf-wait.png differ diff --git a/docs/user/governance/img/core-qt/proposal-prepare-burned.png b/docs/user/governance/img/core-qt/proposal-prepare-burned.png new file mode 100644 index 000000000..eda510815 Binary files /dev/null and b/docs/user/governance/img/core-qt/proposal-prepare-burned.png differ diff --git a/docs/user/governance/img/core-qt/proposal-submit-awaiting.png b/docs/user/governance/img/core-qt/proposal-submit-awaiting.png new file mode 100644 index 000000000..3a9dd14b3 Binary files /dev/null and b/docs/user/governance/img/core-qt/proposal-submit-awaiting.png differ diff --git a/docs/user/governance/img/core-qt/proposal-submitted-conf.png b/docs/user/governance/img/core-qt/proposal-submitted-conf.png new file mode 100644 index 000000000..43ce8efec Binary files /dev/null and b/docs/user/governance/img/core-qt/proposal-submitted-conf.png differ diff --git a/docs/user/governance/img/core-qt/proposal-submitted.png b/docs/user/governance/img/core-qt/proposal-submitted.png new file mode 100644 index 000000000..9071fe48a Binary files /dev/null and b/docs/user/governance/img/core-qt/proposal-submitted.png differ diff --git a/docs/user/governance/img/core-qt/proposal-validate.png b/docs/user/governance/img/core-qt/proposal-validate.png new file mode 100644 index 000000000..004d3519e Binary files /dev/null and b/docs/user/governance/img/core-qt/proposal-validate.png differ diff --git a/docs/user/governance/using.rst b/docs/user/governance/using.rst index c31a14d7e..eb4ad6103 100644 --- a/docs/user/governance/using.rst +++ b/docs/user/governance/using.rst @@ -58,7 +58,7 @@ Object structure The following information is required to create a proposal: -- proposal-name: a unique label, 20 characters or less +- proposal-name: a unique label, 40 characters or less - url: a proposer-created webpage or forum post containing detailed proposal information - payment-count: how many cycles the proposal is requesting payment @@ -140,11 +140,143 @@ You can view the source code for this calculation at this Creating proposals ================== -Once you have prepared the text of your proposal and set up a website or -forum post, it is time to submit your proposal to the blockchain for -voting. While all tasks involved with creating a budget proposal can be -executed from the Dash Core wallet console, several tools providing a -user interface have been developed to simplify this procedure. +Once you have prepared the text of your proposal and set up a website or forum post, it is time to +submit your proposal to the blockchain for voting. While all tasks involved with creating a budget +proposal can be executed from the Dash Core wallet (:ref:`GUI ` or +:ref:`console `) or the :ref:`Dash Budget Proposal Generator +`. + +.. _proposal-create-core-qt: + +Dash Core Wallet +---------------- + +Dash Core Wallet includes a built-in graphical interface for creating governance proposals directly +from the Governance tab. This provides a user-friendly alternative to using external web tools or +manual console commands. To use this feature, your wallet must be unlocked and contain sufficient +balance to cover the 1 DASH proposal fee plus a small transaction fee. + +Accessing the Governance tab +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Open your Dash Core Wallet and click on the **Governance** tab. This displays a list of existing +proposals and provides a **Create Proposal** button in the upper right corner. + +.. figure:: img/core-qt/governance-tab.png + :width: 500px + + The Governance tab showing existing proposals and the Create Proposal button + +Creating a new proposal +^^^^^^^^^^^^^^^^^^^^^^^ + +Click the **Create Proposal** button to open the proposal creation dialog. Enter your proposal +details: + +- **Proposal name**: A unique identifier +- **URL**: Link to detailed proposal information (use a URL shortener if needed) +- **Payment address**: The Dash address that will receive payments +- **Payment amount**: Amount requested per payment cycle +- **First payment date**: Select the superblock date for the first payment +- **# of payments**: Number of payment cycles requested + +The dialog displays the total amount requested and notes the 1 DASH proposal fee that will be +burned. Click **Next** when all fields are complete. + +.. figure:: img/core-qt/proposal-create.png + :width: 350px + + Entering proposal details in the creation dialog + +Validating the proposal +^^^^^^^^^^^^^^^^^^^^^^^ + +The wallet will generate and display your proposal data in JSON format along with the proposal hash. +Review the information carefully to ensure accuracy. + +Click **Validate** to check the format of the proposal data. If the data is valid, click **Next** to +proceed to the next step. Otherwise, click **Back** to adjust your proposal data. + +.. figure:: img/core-qt/proposal-validate.png + :width: 400px + + Validating the proposal JSON and hash + +Preparing the collateral +^^^^^^^^^^^^^^^^^^^^^^^^ + +.. warning:: + + The following step will create a transaction burning 1 DASH as the proposal submission fee. This + transaction is irreversible once broadcast. Verify all proposal details are correct before + proceeding. + +After validation, you will see a screen prompting you to prepare and burn the 1 DASH collateral fee. +This fee is required to prevent spam and is permanently removed from circulation. Click **Prepare +proposal** to create the fee transaction. + +.. figure:: img/core-qt/proposal-prepare-burn.png + :width: 350px + + Proposal collateral burn preparation screen + +Click **Yes** on the confirmation dialog to broadcast the collateral transaction. + +.. figure:: img/core-qt/proposal-burn-fee-notice.png + :width: 300px + + Confirmation dialog for burning the proposal fee + +The transaction ID will be generated and displayed in the TxID field. + +.. figure:: img/core-qt/proposal-prepare-burned.png + :width: 350px + + Transaction ID generated for the proposal collateral + +Waiting for confirmations +^^^^^^^^^^^^^^^^^^^^^^^^^ + +The wallet will display the confirmation progress for your collateral transaction. One confirmation +is required before you can submit the proposal to the network. After the first confirmation, click +the **Next** button to move to the proposal submission screen. + +.. figure:: img/core-qt/proposal-prepare-burned-conf-wait.png + :width: 350px + + Waiting for confirmations (1 of 6) + +Submitting the proposal +^^^^^^^^^^^^^^^^^^^^^^^ + +Click **Submit Proposal** to broadcast your governance object to the network. + +.. figure:: img/core-qt/proposal-submit-awaiting.png + :width: 350px + + Submitting proposal with 5 of 6 confirmations + +If successful, a message will be displayed with your proposal ID. Click **OK** to close the message. + +.. figure:: img/core-qt/proposal-submitted-conf.png + :width: 300px + + Proposal successfully submitted to the network + +The proposal ID will also be shown on the submission screen. The proposal ID can be used to track +voting on the proposal. + +.. figure:: img/core-qt/proposal-submitted.png + :width: 350px + + Proposal submitted with proposal ID shown + +.. note:: + + You can submit your proposal ID to DashCentral to claim ownership and enable simplified voting + for masternodes using DashCentral voting services. + +.. _dash-budget-proposal-generator: Dash Budget Proposal Generator ------------------------------ @@ -217,16 +349,7 @@ closes and you receive your payout. You can also submit the ID to DashCentral to claim your proposal and enable simplified voting for masternodes using DashCentral voting services. -DashCentral Proposal Generator ------------------------------- - -- https://www.dashcentral.org/budget/create - -DashCentral also includes a tool to create budget proposals, or claim -existing proposals so you can add a description on DashCentral and begin -discussion with the community. The steps to be taken are almost -identical to the procedure described above, and documentation is -available `here `_. +.. _proposal-create-core-console: Dash Core Wallet Console ------------------------ diff --git a/docs/user/wallets/dashcore/img/linux/dash-mnemonic-save-confirm.png b/docs/user/wallets/dashcore/img/linux/dash-mnemonic-save-confirm.png new file mode 100644 index 000000000..39b09732b Binary files /dev/null and b/docs/user/wallets/dashcore/img/linux/dash-mnemonic-save-confirm.png differ diff --git a/docs/user/wallets/dashcore/img/linux/dash-mnemonic-save-show.png b/docs/user/wallets/dashcore/img/linux/dash-mnemonic-save-show.png new file mode 100644 index 000000000..7f9d13308 Binary files /dev/null and b/docs/user/wallets/dashcore/img/linux/dash-mnemonic-save-show.png differ diff --git a/docs/user/wallets/dashcore/img/linux/dash-mnemonic-save.png b/docs/user/wallets/dashcore/img/linux/dash-mnemonic-save.png new file mode 100644 index 000000000..c33039b7d Binary files /dev/null and b/docs/user/wallets/dashcore/img/linux/dash-mnemonic-save.png differ diff --git a/docs/user/wallets/dashcore/img/macos/dash-mnemonic-save-confirm.png b/docs/user/wallets/dashcore/img/macos/dash-mnemonic-save-confirm.png new file mode 100644 index 000000000..d1c775509 Binary files /dev/null and b/docs/user/wallets/dashcore/img/macos/dash-mnemonic-save-confirm.png differ diff --git a/docs/user/wallets/dashcore/img/macos/dash-mnemonic-save-show.png b/docs/user/wallets/dashcore/img/macos/dash-mnemonic-save-show.png new file mode 100644 index 000000000..43b325aae Binary files /dev/null and b/docs/user/wallets/dashcore/img/macos/dash-mnemonic-save-show.png differ diff --git a/docs/user/wallets/dashcore/img/macos/dash-mnemonic-save.png b/docs/user/wallets/dashcore/img/macos/dash-mnemonic-save.png new file mode 100644 index 000000000..0078fc2d0 Binary files /dev/null and b/docs/user/wallets/dashcore/img/macos/dash-mnemonic-save.png differ diff --git a/docs/user/wallets/dashcore/installation-linux.rst b/docs/user/wallets/dashcore/installation-linux.rst index 605f78f3d..e4d1b215b 100644 --- a/docs/user/wallets/dashcore/installation-linux.rst +++ b/docs/user/wallets/dashcore/installation-linux.rst @@ -211,6 +211,9 @@ wallet in the following section. .. figure:: img/linux/dash-name-wallet.png :width: 300px +Setting your password +^^^^^^^^^^^^^^^^^^^^^ + If you do choose to encrypt now, you will be asked to enter and verify a password. .. figure:: img/linux/dash-encrypt-wallet.png @@ -218,13 +221,59 @@ If you do choose to encrypt now, you will be asked to enter and verify a passwor Enter a password -Following that, you will get a standard warning. +Following that, you will get a standard warning. Click **Yes** to continue. .. figure:: img/linux/dash-encrypt-wallet-confirmation.png :width: 350px Confirm you want to encrypt your wallet +.. _dashcore-wallet-mnemonic-backup: + +Backing up your mnemonic +^^^^^^^^^^^^^^^^^^^^^^^^ + +Dash Core will display your mnemonic phrase (also called a recovery phrase) for all wallets +(encrypted or not). This phrase can be used to restore your wallet if you lose access to your +device. + +.. warning:: + + **CRITICAL**: If you lose your mnemonic seed phrase, you will permanently lose access to your + wallet and all funds. Write it down on paper (not digitally) and store it in a safe, secure + location. Never share your mnemonic with anyone. + +.. figure:: img/linux/dash-mnemonic-save.png + :width: 400px + + Mnemonic phrase backup prompt + +Click the **Show** button to reveal your mnemonic phrase. Then, write down all the words in order +and check the "I have written down my mnemonic" checkbox to continue. + +.. figure:: img/linux/dash-mnemonic-save-show.png + :width: 400px + + Revealing the mnemonic phrase + +Dash Core will then ask you to verify that you correctly saved the phrase by entering specific words +from your mnemonic. Enter the requested words to confirm you have properly saved your mnemonic +phrase. + +As you enter each word correctly, a green checkmark will appear beside it. Once you have +successfully verified your mnemonic, click **Continue** to complete the wallet creation process. + + +.. figure:: img/linux/dash-mnemonic-save-confirm.png + :width: 400px + + Mnemonic verification + +.. note:: + + For more information about HD wallets and how to view or restore your mnemonic phrase later, see + the :hoverxref:`advanced topics section `. + The following section will detail the steps you need to follow if you choose to encrypt your Dash wallet later. diff --git a/docs/user/wallets/dashcore/installation-macos.rst b/docs/user/wallets/dashcore/installation-macos.rst index d12b1c789..30bdc8106 100644 --- a/docs/user/wallets/dashcore/installation-macos.rst +++ b/docs/user/wallets/dashcore/installation-macos.rst @@ -172,6 +172,9 @@ wallet in the following section. .. figure:: img/macos/wallet-name.png :width: 300px +Setting your password +^^^^^^^^^^^^^^^^^^^^^ + If you do choose to encrypt now, you will be asked to enter and verify a password. .. figure:: img/macos/112596740.png @@ -186,6 +189,50 @@ Following that, you will get a standard warning. Confirm you want to encrypt your wallet +Backing up your mnemonic +^^^^^^^^^^^^^^^^^^^^^^^^ + +Dash Core will display your mnemonic phrase (also called a recovery phrase) for all wallets +(encrypted or not). This phrase can be used to restore your wallet if you lose access to your +device. + +.. warning:: + + **CRITICAL**: If you lose your mnemonic seed phrase, you will permanently lose access to your + wallet and all funds. Write it down on paper (not digitally) and store it in a safe, secure + location. Never share your mnemonic with anyone. + +.. figure:: img/macos/dash-mnemonic-save.png + :width: 400px + + Mnemonic phrase backup prompt + +Click the **Show** button to reveal your mnemonic phrase. Then, write down all the words in order +and check the "I have written down my mnemonic" checkbox to continue. + +.. figure:: img/macos/dash-mnemonic-save-show.png + :width: 400px + + Revealing the mnemonic phrase + +Dash Core will then ask you to verify that you correctly saved the phrase by entering specific words +from your mnemonic. Enter the requested words to confirm you have properly saved your mnemonic +phrase. + +As you enter each word correctly, a green checkmark will appear beside it. Once you have +successfully verified your mnemonic, click **Continue** to complete the wallet creation process. + + +.. figure:: img/macos/dash-mnemonic-save-confirm.png + :width: 400px + + Mnemonic verification + +.. note:: + + For more information about HD wallets and how to view or restore your mnemonic phrase later, see + the :hoverxref:`advanced topics section `. + The following section will detail the steps you need to follow if you choose to encrypt your Dash wallet later. diff --git a/docs/user/wallets/dashcore/installation-windows.rst b/docs/user/wallets/dashcore/installation-windows.rst index 2628cf6c5..759d559fc 100644 --- a/docs/user/wallets/dashcore/installation-windows.rst +++ b/docs/user/wallets/dashcore/installation-windows.rst @@ -220,6 +220,9 @@ wallet in the following section. .. figure:: img/windows/dash-name-wallet.png :width: 300px +Setting your password +^^^^^^^^^^^^^^^^^^^^^ + If you do choose to encrypt now, you will be asked to enter and verify a password. .. figure:: img/windows/dash-encrypt-wallet.png @@ -234,6 +237,50 @@ Following that, you will get a standard warning. Confirm you want to encrypt your wallet +Backing up your mnemonic +^^^^^^^^^^^^^^^^^^^^^^^^ + +Dash Core will display your mnemonic phrase (also called a recovery phrase) for all wallets +(encrypted or not). This phrase can be used to restore your wallet if you lose access to your +device. + +.. warning:: + + **CRITICAL**: If you lose your mnemonic seed phrase, you will permanently lose access to your + wallet and all funds. Write it down on paper (not digitally) and store it in a safe, secure + location. Never share your mnemonic with anyone. + +.. figure:: img/linux/dash-mnemonic-save.png + :width: 400px + + Mnemonic phrase backup prompt + +Click the **Show** button to reveal your mnemonic phrase. Then, write down all the words in order +and check the "I have written down my mnemonic" checkbox to continue. + +.. figure:: img/linux/dash-mnemonic-save-show.png + :width: 400px + + Revealing the mnemonic phrase + +Dash Core will then ask you to verify that you correctly saved the phrase by entering specific words +from your mnemonic. Enter the requested words to confirm you have properly saved your mnemonic +phrase. + +As you enter each word correctly, a green checkmark will appear beside it. Once you have +successfully verified your mnemonic, click **Continue** to complete the wallet creation process. + + +.. figure:: img/linux/dash-mnemonic-save-confirm.png + :width: 400px + + Mnemonic verification + +.. note:: + + For more information about HD wallets and how to view or restore your mnemonic phrase later, see + the :hoverxref:`advanced topics section `. + The following section will detail the steps you need to follow if you choose to encrypt your Dash wallet later.