|
|
| (54 intermediate revisions by 8 users not shown) |
| Line 1: |
Line 1: |
| − | This article explains one way to submit NNS motion proposals by using a few command line tools and a self-custody neuron.
| + | Please see [https://35k4u-jqaaa-aaaam-abrma-cai.icp0.io/docs/current/developer-docs/daos/nns/concepts/proposals/proposal-submit How to create NNS proposal on ICP developer docs] |
| − | | |
| − | ==Background==
| |
| − | | |
| − | To properly follow what is going on, there are a few high-level points worth highlighting:
| |
| − | | |
| − | ===Only Neurons can submit NNS proposals===
| |
| − | | |
| − | Neurons with at least 1 ICP and 6 months of dissolve delay can submit NNS proposals. So the first step is to create such a neuron.
| |
| − | | |
| − | ===The NNS Governance Canister accepts motion proposals===
| |
| − | | |
| − | The Governance Canister is just a canister like any other, so it has a Candid file, it accepts messages, etc... This article describes a way where you can have your local computer send a message to the governance canister (signed on behalf of a neuron) that contains a motion proposal.
| |
| − | | |
| − | ==One-time setup==
| |
| − | | |
| − | ===Install Tools===
| |
| − | | |
| − | 1. Install '''dfx'''
| |
| − | | |
| − | * '''dfx''' is the canister SDK and it will be used to send messages from your machine to NNS
| |
| − | * [https://smartcontracts.org/ smartcontracts.org]
| |
| − | <pre>
| |
| − | $ dfx [OPTIONS] <SUBCOMMAND>
| |
| − | </pre>
| |
| − | | |
| − | 2. Install '''keysmith'''
| |
| − | | |
| − | * '''keysmith''' will be used to generate a privat/public key pair for the IC
| |
| − | * https://github.com/dfinity/keysmith
| |
| − | * this article will assume that you execute '''quill''' on your local machine by running
| |
| − | | |
| − | <pre>
| |
| − | $ keysmith $ keysmith [OPTIONS] <SUBCOMMAND>
| |
| − | </pre>
| |
| − | | |
| − | 3. Install '''quill'''
| |
| − | | |
| − | * '''quill''' is a minimalist "governance toolkit". It is wrapper for crafting & sending messages to the NNS and manage one's neuron.
| |
| − | * https://github.com/dfinity/quill
| |
| − | * this article will assume that you execute '''quill''' on your local machine by running
| |
| − | | |
| − | <pre>
| |
| − | /quill $ target/release/quill [OPTIONS] <SUBCOMMAND>
| |
| − | </pre>
| |
| − | | |
| − | ===Create a neuron===
| |
| − | | |
| − | ====1. Create a private/public keypair and account====
| |
| − | | |
| − | Before one starts, they need a private/public keypair.
| |
| − | | |
| − | =====1.1 Create <code>seed phrase</code>=====
| |
| − | | |
| − | <pre>
| |
| − | $ keysmith generate -o seed.txt
| |
| − | </pre>
| |
| − | | |
| − | =====1.2 Create <code>private.pem</code>=====
| |
| − | | |
| − | <pre>
| |
| − | $ keysmith private-key -o private.pem
| |
| − | </pre>
| |
| − | | |
| − | =====1.3 Derive Ledger <code>account</code> from private key=====
| |
| − | | |
| − | <pre>
| |
| − | $ keysmith account -i 0
| |
| − | </pre>
| |
| − | | |
| − | ====2. Link this private/public keypair to <code>dfx</code> so you can use it as an "Identity"====
| |
| − | | |
| − | =====2.1 Install that key into dfx and create an identity=====
| |
| − | | |
| − | In this case, the new identity is called "proposals"
| |
| − | | |
| − | <pre>
| |
| − | $ dfx identity import proposals private.pem
| |
| − | </pre>
| |
| − | | |
| − | * If you see “creating identity: proposals” in the terminal, this means it worked*
| |
| − | * further reading on dfx identities: dfx identity :: Internet Computer 2
| |
| − | | |
| − | ====3. Send 1.0001 ICP to the "account ID" represented by the public/private keypair (now called the "identity")====
| |
| − | | |
| − | | |
| − | =====3.1 Send 1.0001 ICP to the <code>account</code> from 1.4=====
| |
| − | | |
| − | ====4. Now that the account has the required ICP, spawn a neuron====
| |
| − | | |
| − | Note: This section assumes you have Quill installed
| |
| − | | |
| − | =====4.1 Craft and send a message to spawn a neuron from the account=====
| |
| − | | |
| − | <pre>
| |
| − | $ target/release/quill --pem-file private.pem neuron-stake --name $NAME --amount $AMOUNT > message.json
| |
| − | | |
| − | $ target/release/quill send message.json
| |
| − | </pre>
| |
| − | | |
| − | * You should see a message with a neuron ID spawned
| |
| − | | |
| − | ====5. Increase neuron dissolve to at least 6 months====
| |
| − | | |
| − | * Time is measured in milliseconds in the NNS
| |
| − | * One year: 31557600 milliseconds
| |
| − | | |
| − | =====5.1 Craft message to send the neuron=====
| |
| − | | |
| − | <pre>
| |
| − | $ target/release/quill --pem-file private.pem neuron-manage 148885932052941245 --additional-dissolve-delay-seconds 31557600 > message.json
| |
| − | </pre>
| |
| − | | |
| − | =====5.2 Send just-created message to the Governance canister=====
| |
| − | | |
| − | <pre>
| |
| − | $ target/release/quill send message.json
| |
| − | </pre>
| |
| − | | |
| − | ==How to send a proposal==
| |
| − | | |
| − | ===Craft a proposal in markdown===
| |
| − | | |
| − | ===Send proposal via dfx===
| |
| − | | |
| − | ===Check dashboard to see proposal was successful===
| |