diff --git a/docs/learn/learn-guides-treasury.md b/docs/learn/learn-guides-treasury.md index 8ea594aec7ff..7919535ac390 100644 --- a/docs/learn/learn-guides-treasury.md +++ b/docs/learn/learn-guides-treasury.md @@ -6,3 +6,106 @@ description: Advanced How-to Guides about requesting funds from the Polkadot Tre keywords: [opengov, polkadot opengov, referenda, treasury, tips, bounties] slug: ../learn-guides-treasury --- + +import RPC from "./../../components/RPC-Connection"; + +## Creating a Treasury Proposal + +Your proposal should address a problem, outline a goal, give a detailed account of how you will +reach that goal, and include any ongoing maintenance needs. As much as possible, you should itemize +the tasks to be completed so fees can be evaluated and milestones can be followed. You can check the +{{ polkadot: [guidelines for a successful proposal](https://docs.google.com/document/d/1IZykdp2cyQavcRyZd_dgNj5DcgxgZR6kAqGdcNARu1w) :polkadot }}{{ kusama: [guidelines for a successful proposal](https://docs.google.com/document/d/1CzEnurqwqLBOGrJI9CQORiGW9m6QyPOSshhzJdR57Pk) :kusama }} +and fill out the +{{ polkadot: [Treasury proposal template](https://docs.google.com/document/d/1O_84mXYFERCavmnJyxbIPKFkG0bVBySRjCVy-d-VKcc) :polkadot }}{{ kusama: Treasury proposal template :kusama }} +provided. + +### Announcing the Proposal + +To minimize storage on chain, proposals don't contain contextual information. When a user submits a +proposal, they will need to find an off-chain way to explain the proposal: + +- Many community members participate in discussion in the + {{ polkadot: [Polkadot Watercooler](https://matrix.to/#/#polkadot-watercooler:web3.foundation) and :polkadot }} + {{ kusama: [Kusama Direction room](https://matrix.to/#/#Kusama-Direction:parity.io) and the :kusama }} + {{ polkadot: [Polkadot Direction room](https://matrix.to/#/#Polkadot-Direction:parity.io). :polkadot }} + {{ kusama: [Kusama Watercooler](https://matrix.to/#/#kusamawatercooler:polkadot.builders). :kusama }} +- Use platforms like [Polkassembly](https://polkassembly.io) and + [SubSquare](https://www.subsquare.io/) to initiate discussion with the community. They also offer + a gauge poll to capture the community sentiment before submitting an on-chain referendum. + +Spreading the word about the proposal's explanation to the community is ultimately up to the +proposer. + +:::tip Use Accounts with Verified On-Chain Identity for Treasury Proposals + +To ensure legitimacy, it is required that the account linked to the Treasury proposal has an +[identity set](https://support.polkadot.network/support/solutions/articles/65000181981-how-to-set-and-clear-an-identity) +and is +[verified by an on-chain registrar](https://support.polkadot.network/support/solutions/articles/65000181990-how-to-request-and-cancel-identity-judgement). + +::: + +### Submit Treasury Proposal Preimage + +The example below shows how to create a [preimage](../general/glossary#preimage) for a transaction +that requests 100 DOT from Treasury. + +- Navigate to [Polkadot-JS UI > Governance > Preimages](https://polkadot.js.org/apps/#/preimages) + and then click on Add Preimage. +- Select the account which will be used to submit the preimage. +- Choose `treasury` pallet in the "propose" dropdown and the `spend(amount, beneficiary)`call +- Enter the DOT amount. +- Enter the AccountID of the beneficiary (which has a verified on-chain identity). +- Submit preimage +- Sign and submit the transaction by paying the specified transaction fees. + +:::info Preimage Submission Deposit + +A deposit is required for the preimage to be stored on chain. The deposit amount required for a +preimage with a treasury spend transaction is around +{{ polkadot: 41 DOT :polkadot }}{{ kusama: 1.4 KSM :kusama }}. Ensure you have enough account +balance to pay for the submission deposit and the transaction fees. + +::: + +![Treasury Preimage](../assets/treasury/treasury-preimage.png) + +After successful submission of the preimage, it is displayed on Polkadot-JS UI > Governance > +Preimages page. Every preimage is associated with a unique preimage hash (highlighted in a box in +the image below). Take a note of this preimage hash, which is required to submit a referendum. + +![Treasury Preimage Hash](../assets/treasury/treasury-preimage-hash.png) + +### Submit a Treasury Track Referendum + +The example below shows how to submit a Treasury track referendum. + +- Navigate to [Polkadot-JS UI > Governance > Referenda](https://polkadot.js.org/apps/#/referenda) + and then click on Submit proposal. +- Select the account which will be used to submit the proposal. +- Choose the appropriate submission track (The example below selected Small Spender track). +- Enter the preimage hash of the treasury spend transaction.(If the preimage exists on-chain, the + preimage length box is automatically populated) +- Click on Submit proposal. +- Sign and submit the transaction. + +![Submit Treasury Proposal](../assets/treasury/submit-proposal-treasury.png) + +Once your submission is executed, your referendum will appear under your chosen track on the +Polkadot-JS UI [referenda page](https://polkadot.js.org/apps/#/referenda). + +### Place a Decision Deposit for the Treasury Track Referendum + +For the referendum to move from preparing phase to the deciding phase, a decision deposit needs to +be placed. The decision deposit values for each individual [Treasury Tracks](#treasury-tracks) are +listed in a section above in this document. + +![Submit Treasury Proposal Decision Deposit](../assets/treasury/treasury-proposal-decision-deposit.png) + +### Claiming the Preimage and Decision Deposits + +After the referendum finishes its life cycle (and gets approved or rejected or timed out), the +deposits can be claimed. For claiming the preimage deposit, navigate to Polkadot-JS UI > +Governance > Preimages and click on unnote button shown on the preimage you submitted. Similarly, to +claim the decision deposit, navigate to Polkadot-JS UI > Governance > Referenda and scroll down to +the end of the page to click on the referenda with the decision depoit and claim it. diff --git a/docs/learn/learn-polkadot-opengov-treasury.md b/docs/learn/learn-polkadot-opengov-treasury.md index 94eea891c064..01ba8a4b2965 100644 --- a/docs/learn/learn-polkadot-opengov-treasury.md +++ b/docs/learn/learn-polkadot-opengov-treasury.md @@ -58,8 +58,8 @@ OpenGov allows for managing funds through six tracks, each with its own :::info How to access Treasury funds? Access to Treasury funds requires successful enactment of referendum in the respective treasury -track on-chain. Learn how to create a referendum -[here](../maintain/maintain-guides-polkadot-opengov.md#create-a-referenda-proposal-using-polkadot-js-ui). +track on-chain. Learn how to submit a treasury proposal for referendum +[here](./learn-guides-treasury.md#creating-a-treasury-proposal). ::: @@ -100,98 +100,3 @@ requires a decision deposit of {{ polkadot: 10 DOT :polkadot }}{{ kusama: 0.33 This track can be used for treasury spending requests up to {{ polkadot: 100 DOT :polkadot }}{{ kusama: 8.25 KSM :kusama }} per referendum. Each referendum requires a decision deposit of {{ polkadot: 1 DOT :polkadot }}{{ kusama: 0.033 KSM :kusama }}. - -## Creating a Treasury Proposal - -Your proposal should address a problem, outline a goal, give a detailed account of how you will -reach that goal, and include any ongoing maintenance needs. As much as possible, you should itemize -the tasks to be completed so fees can be evaluated and milestones can be followed. You can check the -{{ polkadot: [guidelines for a successful proposal](https://docs.google.com/document/d/1IZykdp2cyQavcRyZd_dgNj5DcgxgZR6kAqGdcNARu1w) :polkadot }}{{ kusama: [guidelines for a successful proposal](https://docs.google.com/document/d/1CzEnurqwqLBOGrJI9CQORiGW9m6QyPOSshhzJdR57Pk) :kusama }} -and fill out the {{ polkadot: [Treasury proposal template](https://docs.google.com/document/d/1O_84mXYFERCavmnJyxbIPKFkG0bVBySRjCVy-d-VKcc) :polkadot }}{{ kusama: Treasury proposal template :kusama }} provided. - -### Announcing the Proposal - -To minimize storage on chain, proposals don't contain contextual information. When a user submits a -proposal, they will need to find an off-chain way to explain the proposal: - -- Many community members participate in discussion in the - {{ polkadot: [Polkadot Watercooler](https://matrix.to/#/#polkadot-watercooler:web3.foundation) and :polkadot }} - {{ kusama: [Kusama Direction room](https://matrix.to/#/#Kusama-Direction:parity.io) and the :kusama }} - {{ polkadot: [Polkadot Direction room](https://matrix.to/#/#Polkadot-Direction:parity.io). :polkadot }} - {{ kusama: [Kusama Watercooler](https://matrix.to/#/#kusamawatercooler:polkadot.builders). :kusama }} -- Use platforms like [Polkassembly](https://polkassembly.io) and [SubSquare](https://www.subsquare.io/) to initiate discussion with the community. They also offer a gauge poll to capture the community sentiment before submitting an on-chain referendum. - -Spreading the word about the proposal's explanation to the community is ultimately up to the -proposer. - -:::tip Use Accounts with Verified On-Chain Identity for Treasury Proposals - -To ensure legitimacy, it is required that the account linked to the Treasury proposal has an -[identity set](https://support.polkadot.network/support/solutions/articles/65000181981-how-to-set-and-clear-an-identity) -and is -[verified by an on-chain registrar](https://support.polkadot.network/support/solutions/articles/65000181990-how-to-request-and-cancel-identity-judgement). - -::: - -### Submit Treasury Proposal Preimage - -The example below shows how to create a [preimage](../general/glossary#preimage) for a transaction that requests 100 DOT from -Treasury. - -- Navigate to [Polkadot-JS UI > Governance > Preimages](https://polkadot.js.org/apps/#/preimages) and then click on Add Preimage. -- Select the account which will be used to submit the preimage. -- Choose `treasury` pallet in the "propose" dropdown and the `spend(amount, beneficiary)`call -- Enter the DOT amount. -- Enter the AccountID of the beneficiary (which has a verified on-chain identity). -- Submit preimage -- Sign and submit the transaction by paying the specified transaction fees. - -:::info Preimage Submission Deposit - -A deposit is required for the preimage to be stored on chain. The deposit amount required for a -preimage with a treasury spend transaction is around -{{ polkadot: 41 DOT :polkadot }}{{ kusama: 1.4 KSM :kusama }}. Ensure you have enough account -balance to pay for the submission deposit and the transaction fees. - -::: - -![Treasury Preimage](../assets/treasury/treasury-preimage.png) - -After successful submission of the preimage, it is displayed on Polkadot-JS UI > Governance > -Preimages page. Every preimage is associated with a unique preimage hash (highlighted in a box in -the image below). Take a note of this preimage hash, which is required to submit a referendum. - -![Treasury Preimage Hash](../assets/treasury/treasury-preimage-hash.png) - -### Submit a Treasury Track Referendum - -The example below shows how to submit a Treasury track referendum. - -- Navigate to [Polkadot-JS UI > Governance > Referenda](https://polkadot.js.org/apps/#/referenda) and then click on Submit proposal. -- Select the account which will be used to submit the proposal. -- Choose the appropriate submission track (The example below selected Small Spender track). -- Enter the preimage hash of the treasury spend transaction.(If the preimage exists on-chain, the - preimage length box is automatically populated) -- Click on Submit proposal. -- Sign and submit the transaction. - -![Submit Treasury Proposal](../assets/treasury/submit-proposal-treasury.png) - -Once your submission is executed, your referendum will appear under your chosen track on the -Polkadot-JS UI [referenda page](https://polkadot.js.org/apps/#/referenda). - -### Place a Decision Deposit for the Treasury Track Referendum - -For the referendum to move from preparing phase to the deciding phase, a decision deposit needs to -be placed. The decision deposit values for each individual [Treasury Tracks](#treasury-tracks) are -listed in a section above in this document. - -![Submit Treasury Proposal Decision Deposit](../assets/treasury/treasury-proposal-decision-deposit.png) - -### Claiming the Preimage and Decision Deposits - -After the referendum finishes its life cycle (and gets approved or rejected or timed out), the -deposits can be claimed. For claiming the preimage deposit, navigate to Polkadot-JS UI > -Governance > Preimages and click on unnote button shown on the preimage you submitted. Similarly, to -claim the decision deposit, navigate to Polkadot-JS UI > Governance > Referenda and scroll down to -the end of the page to click on the referenda with the decision depoit and claim it.