Internet Computer Wiki Staging - User contributions [en]

Internet Computer wiki

2021-11-20T19:41:51Z

Timo: /* How-To section */

Welcome to the Internet Computer Wiki! Feel free to join in. All are welcome!
== Topics Central ==

* [[Internet computer]]
* [[Internet Computer vision]]
* [[Index of dapps on the Internet Computer]]
* [[ICP token]]
* [[Internet Identity]]
* [https://dashboard.internetcomputer.org/ Internet Computer dashboard]
* [[Internet Computer Performance]]
* [[DFINITY]]
* [[Custody, Staking, and Voting]]
*[[Network Nervous System]]
== For blockchain & crypto enthusiasts ==
* [[Myths and facts]]
* [https://www.reddit.com/r/dfinity/ r/dfinity]
* [[How to stake on the Internet computer]]
* [[Tokenomics of the Internet Computer]]
* [[Governance of the Internet Computer]]

== For dapp developers ==
* [[Internet Computer for dapp developers]]
* [[Canister smart contracts]]
* [https://forum.dfinity.org/ IC community developer forum]
* [[Best practices for a high traffic dapp launch]]
* [[Best practices for NFT drops]]

== For computer scientists ==
* [[The Internet Computer for Computer Scientists]]

== For node owners ==
* [[Internet Computer for node owners]]

== FAQs ==

* [[FAQ]]

'''Computer Scientists FAQ'''
* [[The Internet Computer for Computer Scientists]]
== How-To section ==
How-Tos are step-by-step instructions for specific, narrow goals.
* [[How-To: Claim neurons for seed participants]]

== Tutorial section ==
Tutorials are guided introductions to user stories, intended for first-time users and characterized by a shallow learning curve.
* [[Tutorial: Neuron control]]

== Contributors ==

=== Housekeeping Rules ===

* Please refrain from redundancy, such as referring to the Internet Computer in article titles. This is, after all, the Internet Computer Wiki.
* Please carefully consider your use of capitalisation. Most words in titles should be capitalised. DFINITY is always stylised in all-caps.

=== How to Contribute ===
Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]

Use this page to test editing
* [[Test editing the Internet Computer Wiki]]

Number of articles: {{NUMBEROFARTICLES}}

Managing ICP holdings

2021-11-20T19:06:25Z

Timo: /* Custody */

The governance of the Internet Computer depends on people staking their ICP and voting on proposals.

To do this, there are three steps (each with different sets of options):

# Choose a custody method for your ICP
# Stake your ICP by creating neurons
# Vote on [[NNS proposals]] with your neurons

==Custody==

Custody is the act of managing your ICP. There are many options, each with different security and usability trade-offs.

Below is a summary of the range of options available to you depending on your comfort level.

* [[ICP custody options]]
* [[How-To: Claim neurons for seed participants]]

==Staking==

Once you decide on your custody, staking is the action of locking ICP within a [[neuron]] with a dissolve delay. There are many options, each with different security and usability trade-offs.

[[ICP staking options]]

==Voting==

Voting is the act of voting on [[NNS proposals]] using neurons.

[[ICP voting options]]

Neuron/ICP Instructions for Seed Participants

2021-11-20T19:04:58Z

Timo:

Redirect to: [[How-To: Claim neurons for seed participants]]

==Introduction==

Seed participants have been granted ICP at a rate of 30 tokens per Swiss Franc of value donated in 2017, which Genesis Unlock is disbursing in the form of a basket of 49 voting neurons.

These neurons already exist inside the Network Nervous System, the completely open, tokenized governance system that controls the Internet Computer blockchain network. Seed participant neurons contain the ICP seed participants have been awarded, staked inside. Seed participant neurons have been configured to vote automatically and are already earning voting rewards for seed participants. Seed participants do not need to do anything to initialize their neurons in order to continue earning voting rewards.

A neuron is like a savings account where seed participant must provide notice of withdrawals. The configured notice period is called the “dissolve delay”. Seed participants can start and stop dissolving a neuron at any time. The greater the dissolve delay, the greater the neuron’s voting power, and the greater the voting rewards it receives.

seed participant neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases the voting power and the voting rewards seed participant receive.

'''Warning: When seed round participants start dissolving a neuron, the blockchain will reset its age to zero immediately. Therefore, one should be very careful to only begin dissolving neurons when thet wish to unstake the ICP inside.'''

Genesis Unlock created 49 neurons for you. They have dissolve delays of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

To configure one of your neurons, for example, to change how it votes, or to place it into dissolving mode, follow these steps:

==Methods for Configure one of the neurons==

* [[Seed participant configuration with DFINITY Canister SDK]]
* [[Seed participant configuration with Ledger Nano]] (Coming soon)

Seed participant configuration with DFINITY Canister SDK

2021-11-20T19:04:07Z

Timo:

'''Superseded by separate updated documents on [[How-To: Claim neurons for seed participants|claiming]] and [[Tutorial: Neuron control|controlling]] neurons.'''

==Introduction==

Steps to configure a neuron using the DFINITY Canistr SDK.

==Warning==

This process is not currently possible on macOS computers with M1 chips. You can only install the DFINITY Canister SDK dfx and the Candid compiler didc on Intel-based macOS and Linux computers.

==Step 1: Derive a native Internet Computer principal from your Ethereum seed==

As an early contributor or seed donor, you wrote down a 12-word mnemonic seed phrase that was generated by the DFINITY Chrome extension. To create an identity, you must derive a private key from your seed phrase and import that private key into the DFINITY Canister SDK. This step is required before you can Take control of your neurons.

===Step 1a: Secure your environment===

The safety and security of your private key is your responsibility and there is no substitute for planning ahead, bringing the right equipment, having the right skills, and using good judgment. We strongly recommend you proceed using an air-gapped computer to reduce the risk of having your private key compromised. Depending on the hardware available, you might want to physically remove your network controller, microphone, speakers, and other components, or disable them in your BIOS. Covert channels can be established through a variety of different mediums, including sound, light, radio-frequency, and physical media. Be sure to evaluate the capabilities of your system before settling on a configuration that makes sense for you. If you don’t know what you are doing, you should consult with a computer security expert. Do not contact the DFINITY Foundation for help with securing your environment.

===Step 1b: Install Keysmith===

You need [https://github.com/dfinity/keysmith Keysmith] to derive your private/public key pair from the seed phrase.

To install Keysmith, there are two options:

a. '''Fetch the release binary'''

b. '''Build Keysmith from source'''.

====Option A: Fetch the release binary====

If you want to download the Keysmith release binary, keep in mind that you must perform this action on a computer with a network connection. If you are using an air-gapped computer, then you must copy the release binary from your networked computer to your air-gapped computer. How you do this will depend on your configuration.

To download the Keysmith release binary, fetch release v1.5.0 from Github.

Keysmith supports the following operating systems and architectures:

* Darwin / AMD64 – for macOS models with an Intel chip ([[https://www.howtogeek.com/706226/how-to-check-if-your-mac-is-using-an-intel-or-apple-silicon-processor/#:~:text=Here%2C%20you%E2%80%99ll%20find%20the,Mac%20with%20an%20Intel%20chip. how to check]])

* Darwin / ARM64 – for newer macOS models with an M1 chip ([[https://www.howtogeek.com/706226/how-to-check-if-your-mac-is-using-an-intel-or-apple-silicon-processor/#:~:text=Here%2C%20you%E2%80%99ll%20find%20the,Mac%20with%20an%20Intel%20chip. how to check]])

* Linux / AMD64

* Linux / ARM32

* Linux / ARM64

* Windows / AMD64

Download the {{code | .tar.gz}} file matching your architecture and operating system. If you have a newer M1-based macOS, download {{code |keysmith-darwin-arm64.tar.gz}}. Although you can install keysmith on macOS computers with an M1 chip, you can only install the DFINITY Canister SDK {{code|dfx}} command-line interface on Intel-based macOS computers. For an Intel-based macOS, download {{code|keysmith-darwin-amd64.tar.gz}}.

=====Verify the SHA256 checksum of your download=====

Open a terminal and change to the download directory. On a Mac this is

<pre>
$ cd ~/Downloads
</pre>

Compute the SHA256 checksum of your download.

<pre>
$ openssl dgst -sha256 keysmith-*.tar*
</pre>

Make sure the output matches one of the following lines:

<pre>
SHA256(keysmith-darwin-amd64.tar.gz)= ad7383d60bced19580fa37b77e133b1e80416b482e4c5326ac2fd17a7710a318
SHA256(keysmith-darwin-arm64.tar.gz)= da1a4ac5ae04b85d4c5b0a3deb6442fb7c456dcf97cbd6ff8153316c5dbb29a9
SHA256(keysmith-linux-amd64.tar.gz)= 7901c3a23aef298f930d1dddf8eee23bc51a55ffda670accfd7b9e37748913d8
SHA256(keysmith-linux-arm32.tar.gz)= 0ab44e74cc502aa653dcb28962bcada5cbefb9e0ec41853a03fb4745c5cd51a9
SHA256(keysmith-linux-arm64.tar.gz)= 635c0bf98dd15f27b302ec0ea793f75c797441009c74500bd9d0a5df26092264
SHA256(keysmith-windows-amd64.tar.gz)= cb398c39583b81d5170dd0a9539d902715317572f6a640b45d3d2db01946b8fa
</pre>

If your browser already unzipped the .tar.gz for you and you have a file ending in .tar then make sure the output of openssl matches one of the following lines:

<pre>
SHA256(keysmith-darwin-amd64.tar)= 97b8048f00e75d6adc8651aac1aa77d9bd9c150b0dbc0b0f6409f0d6bdbb24a4
SHA256(keysmith-darwin-arm64.tar)= 07e296fbf33b0c06bd04a8ead30487762aa30ca2daf7e19948d74a96f2c34067
SHA256(keysmith-linux-amd64.tar)= 1d2d986a971f8c7ef0eeb4b01624f023ef8dc9c71d2f0127f21fcc99aebdc99a
SHA256(keysmith-linux-arm32.tar)= 8eb8efecd9182822326f2e60fcff32c0b1541cce206a12b3f2e94547c66dfe63
SHA256(keysmith-linux-arm64.tar)= 82264487e83cbfdd758c1227375758b7d1f0c864adb555775777e7d3afa19e08
SHA256(keysmith-windows-amd64.tar)= b85224d4e9807b8335295193c12dd0cab22bd38881d14c1f1c21479801ace17d
</pre>

====Unpack and install keysmith====

To extract the executable from the tarball, enter the following command into your terminal:

<pre>
$ tar -f keysmith-*.tar* -x
</pre>

Next, add the executable to your PATH by entering the commands below:

<pre>
$sudo install -d /usr/local/bin
$sudo install keysmith /usr/local/bin
</pre>

You will be prompted to enter your laptop password. The password itself will not appear, simply type it and press enter.

====Run it====

<pre>
$ keysmith
</pre>

You should see:

<pre>
usage: keysmith <command> [<args>]

Available Commands:
account Print your account identifier.
generate Generate your mnemonic seed.
legacy-address Print your legacy address.
principal Print your principal identifier.
private-key Write your private key to a file.
public-key Print your public key.
version Print the version number.
x-public-key Print your extended public key.
</pre>

If you are using macOS, making the keysmith binary executable might require you to change a permission setting using System Preferences > Security & Privacy > General.

====Option B: Build Keysmith from source====

f you want to build the Keysmith from source, keep in mind that you must perform this action on a computer with a network connection. If you are using an air-gapped computer, then you must copy the target binary from your networked computer to your air-gapped computer. How you do this will depend on your configuration.

Keysmith is written in [https://golang.org/ Go], so if you choose to build it from source, then you must first download and install Go, verify that go is in your PATH, and configure your GOPATH and GOBIN environment variables.

Run the following command to build Keysmith from source.

<pre>
$ go get github.com/dfinity/keysmith
</pre>

===Step 1c: Install the DFINITY Canister SDK===

You can install the DFINITY Canister SDK by fetching the v0.7.0 release binary from our website. It is not yet possible to build the DFINITY Canister SDK from source. Note that this action can only be performed on a networked computer. If you are using an air-gapped computer, then you must copy the release binary from your networked computer to your air-gapped computer. How you do this will depend on your configuration.

Run the following command to install the DFINITY Canister SDK.

<pre>
$ sh -ci "$(curl -fsSL https://sdk.dfinity.org/install.sh)"
</pre>

Warning: Note that dfx will currently not install on M1-based Macs.

===Step 1d: Set your seed phrase for use with keysmith===

Once you have installed Keysmith and the DFINITY Canister SDK, and you are '''confident that your environment is secure''', then you are ready to enter your seed for use with keysmith. For the duration of your session, you store your seed phrase in an environment variable. It will be eliminated from your system when you turn your computer off.

<pre>
$ read seed
</pre>

Enter your seed phrase and finish with Return.

If you prefer to not have your seed phrase displayed as you type then use this command instead:

<pre>
$ read -s seed
</pre>

===Step 1e: Check your legacy address and balance (optional)===

At this point you can already verify your legacy address and ICPT balance. The legacy address matches to what was formerly called "DFN address" in the Dfinity Chrome extension. You may have copied it from the Chrome extension for your records back when you used the extension.

<pre>
echo $seed | keysmith legacy-address -f -
</pre>

The output is a 40 character hex string. It looks something like this:

<pre>2d89d96b10f7a9456a9154b2f5309ee70df5bce1</pre>

You can check your ICPT balance as follows:

<pre>
echo {} > dfx.json
GTC=renrk-eyaaa-aaaaa-aaada-cai
ADDR=$(echo $seed | keysmith legacy-address -f -)
dfx canister --network=https://ic0.app --no-wallet call $GTC balance '("'$ADDR'")'
</pre>

The output is the number of ICPT associated with your address.

If you are an early contributor then you may have multiple addresses, all derived from your one seed phrase. To check the balance in each of them you do the following commands:

<pre>
GTC=renrk-eyaaa-aaaaa-aaada-cai
ADDR=$(echo $seed | keysmith legacy-address -f - -i 0)
dfx canister --network=https://ic0.app --no-wallet call $GTC balance '("'$ADDR'")'
</pre>

Then you repeat the last two lines with -i 1, -i 2, etc.

===Step 1f: Derive and import your private key===

Derive your private key from your seed phrase.

<pre>
$ echo $seed | keysmith private-key -f -
</pre>

This creates a file identity.pem containing your private key. Import your private key(s) into the DFINITY Canister SDK and then remove it from the filesystem.

<pre>
$ dfx identity import <name> identity.pem
$ rm identity.pem
</pre>

Here, <name> is an alias that you can choose arbitrarily for your identity, e.g. "jane". The command above displays output similar to the following:

<pre>
Creating identity: "jane".
Created identity: "jane".
</pre>

Make your new identity the currently-active one.

<pre>
$ dfx identity use <name>
</pre>

The command above displays output similar to the following:

<pre>
Using identity: "jane".
</pre>

At any time, you can list all available identities with

<pre>
$ dfx identity list
</pre>

==Step 2: Take control of your neurons==

You will receive your tokens inside a set of neurons that have been pre-created for you. The number of neurons will total 31 or 49 depending on whether you are an early contributor or seed donor, respectively. Your tokens are disbursed equally over these neurons. Claiming your neurons is the process of obtaining control over your neurons. It is done for all neurons at once.

Your neurons differ by their dissolve delay. For an explanation of dissolve delay see Instruct the neurons you wish to unstake to dissolve below.

To claim your neurons, you need to sign and send a message to the Genesis Token Canister. You can accomplish this in one step on a networked computer using dfx canister call, or as two separate steps, one on an air-gapped computer using dfx canister sign, and another on a networked computer using dfx canister send. We strongly recommend the latter approach to reduce the risk of having your private key compromised.

Regardless of which method you choose, you will need to download and install didc, the Candid compiler, on your networked computer. You can find the latest release here. Note that the binaries are suffixed by the operating systems they run on, didc-linux64 and didc-macos. Be sure to download the correct one. Below are commands to install didc on macos. If your’re using Linux, simply use the linux64 suffix instead.

<pre>
$ sudo install -d /usr/local/bin
$ sudo install -m 0755 ~/Downloads/didc-macos /usr/local/bin/didc
</pre>

Regardless of which method you choose, you will also need to download and extract the NNS canister interfaces on your networked computer. You can find the latest release here. Below are commands to extract the NNS canister interfaces.

<pre>
pushd ~/Downloads
tar -f nns-ifaces-0.8.0.tar.gz -x
popd
</pre>

Additionally, you will need to have dfx.json file available in the directory from which you are running dfx commands. You can create an empty dfx.json file in your current directory by running the following command.

<pre>
$ echo {} > dfx.json
</pre>

Note that if you’re using an air-gapped computer, then you’ll need to repeat this step since you’ll be running dfx commands in both places.

After downloading and installing didc, downloading and extracting the NNS canister interfaces, and creating your dfx.json file(s), you can Claim in one step (not recommended) or Claim in two steps.

===Claim in one step (not recommended)===
Verify that you can connect to the Internet Computer.

<pre>
$ dfx ping https://ic0.app
</pre>

Derive your public key.

<pre>
$ PUBLIC_KEY="$(echo $seed | keysmith public-key -f -)"
</pre>

Call the Genesis Token Canister to claim your neurons.

<pre>
CANISTER=renrk-eyaaa-aaaaa-aaada-cai
RESULT="$(dfx canister --network=https://ic0.app --no-wallet call $CANISTER claim_neurons '("'$PUBLIC_KEY'")' --output=raw)"
didc decode -t "(Result)" -d ~/Downloads/nns-ifaces-0.8.0/genesis_token.did $RESULT
</pre>

===Claim in two steps===

'''On your air-gapped computer:'''

Derive your public key.

PUBLIC_KEY="$(echo $seed | keysmith public-key -f -)"

Sign a message to claim your neurons.

Note that the time allotted to send a signed message is a fixed 5-minute window. The --expire-after option enables you to specify the point in time when the 5-minute window for sending the signed message should end. For example, if you set the --expire-after option to one hour (1h), then you must wait at least 55 minutes before you send the generated message and the signature for the message is only valid during the 5-minute window ending in the 60th minute. Hence, you would need to send the message after 55 minutes and before 60 minutes for the message to be recognized as valid. If you don’t specify the --expire-after option, then the default expiration is five minutes.

<pre>
CANISTER=renrk-eyaaa-aaaaa-aaada-cai
dfx canister --network=https://ic0.app --no-wallet sign --expire-after=1h $CANISTER claim_neurons '("'$PUBLIC_KEY'")'
</pre>

The command above results in a message.json file in your current directory. You must copy that file from your air-gapped computer to your networked computer. How you do this will depend on your configuration.

'''On your networked computer:'''

Verify that you can connect to the Internet Computer.

<pre>
$ dfx ping https://ic0.app
</pre>

copy
Send the signed message to the Genesis Token Canister to claim your neurons. As previously mentioned, you can only perform this action within the 5-minute window that you specified.

<pre>
dfx canister --network=https://ic0.app --no-wallet send message.json
</pre>

Unlike dfx canister call in the section [Claim in one step], the command dfx canister send does not return output that can be parsed by didc. Instead, it outputs only a request id.

In order to see the effect of your send request, you have to do an additional step. Perform the following commands on your networked machine:

<pre>
CANISTER=renrk-eyaaa-aaaaa-aaada-cai
RESULT="$(dfx canister --network=https://ic0.app --no-wallet call $CANISTER get_account '("paste legacy address here")' --output=raw)"
didc decode -t "(Result_2)" -d ~/Downloads/nns-ifaces-0.8.0/genesis_token.did $RESULT
</pre>

The legacy address to paste here in the second line above is what was formerly called "DFN address" in the Chrome extension. Note that the legacy address must be pasted without the 0x prefix and without the 8-character checksum at the end, i.e. it has exactly 40 characters in length. Furthermore, the legacy address must be in all lowercase. If you don’t remember it then you can obtain your legacy address by running this on your air-gapped machine:

<pre>
$ echo $seed | keysmith legacy-address -f -
</pre>

What you want to look for in the output of the get_account request is has_claimed = true and your principal. For example, the output of the get_account command looks like this for an unclaimed account:

<pre>
(
variant {
Ok = record {
authenticated_principal_id = null;
successfully_transferred_neurons = vec {};
has_donated = false;
failed_transferred_neurons = vec {};
neuron_ids = vec { record { id = 1_234_567_890_123_456_789 : nat64;}; ...
};
has_claimed = false;
has_forwarded = false;
icpts = 12345 : nat32;
}
},
)
</pre>

And like this for a successfully claimed account:

<pre>
(
variant {
Ok = record {
authenticated_principal_id = opt principal "a56gn-wnhrl-i76df-ewgfe-23jfd-dfh03-ergrg-fesr1-1jhs9-reg2o-ure";
successfully_transferred_neurons = vec {};
has_donated = false;
failed_transferred_neurons = vec {};
neuron_ids = vec { record { id = 1_234_567_890_123_456_789 : nat64;}; ...
};
has_claimed = true;
has_forwarded = false;
icpts = 12345 : nat32;
}
},
)
</pre>

==Step 3: Enable disbursal by passing the KYC process==

Before you can disburse ICPT from your dissolved genesis neuron you must pass KYC. Note that this applies only to genesis neurons such as the ones given to seed donors. It does not apply to neurons that you later create by staking already-liquid ICPT.

===Derive your DFN address===

The DFINITY Chrome extension generated a 12-word mnemonic seed phrase. From that seed phrase, an Ethereum-style address can be derived, which was referred to in the Chrome extension as the "DFN address". The KYC process requires that you submit your DFN address along with other information.

====Using Keysmith====

The easiest way to obtain your DFN address is to derive it from your seed phrase using Keysmith. The section Derive a native Internet Computer principal from your Ethereum seed already explained how to set up Keysmith and write your seed phrase into a file in a safe way. We assume here that you have carried out the steps at least up until that point. It is not important whether you have carried out any of the remaining steps on the way to claim your neurons. It is also not important whether you have installed the DFINITY Canister SDK. You only need Keysmith.

Derive your DFN address.

<pre>
$ echo $seed | keysmith legacy-address -f -
</pre>

The command above displays output similar to a typical Ethereum address, but without the leading 0x prefix, and you will use it without the 0x prefix.

====Using the DFINITY Chrome extension====

Alternatively, you may have already written down your DFN address when you ran the Chrome extension to make the donation, or taken a screenshot of it. In this case, you can use the DFN address from there and you do not have to derive it from your seed phrase. The following is to remind you where it was visible in the Chrome extension.

On the Chrome extension’s main page there was an information button (“i” in blue circle) next to the DFN balance:

[[File:dfn-chrome-extension-1.png|512px|dfn chrome extension 1]]

Clicking it presented a window displaying the DFN address:

[[File:dfn-chrome-extension-1.png|512px|dfn chrome extension 2]]

The DFN address displayed in the Chrome extension has a 4-byte checksum at the end and the 0x prefix. For our purposes here, you have to delete the last 8 characters and the prefix. For example: 0x98b20cae8074067c29c07a0a4ad94346cc33ee948bdcfe41 becomes 98b20cae8074067c29c07a0a4ad94346cc33ee94 which is 40 hex characters long.

===Derive your principal identifier===

The KYC form will also ask you for your principal. Derive it with Keysmith.

<pre>
echo $seed | keysmith principal -f -
</pre>

The command above will display your principal identifier, which should look something like this: {{code|a56gn-wnhrl-i76df-ewgfe-23jfd-dfh03-ergrg-fesr1-1jhs9-reg2o-ure}} You will be asked to enter your principal identifier on the KYC form.

===Submit your information===

To submit your information, you first go to the [https://kyc.dfinity.org/gtc KYC landing page]. The landing page is a frontend hosted by the DFINITY Foundation and any information entered here is not shared with the external KYC provider.

If the DFN address is valid, you are forwarded to the KYC main page.

If you are not forwarded and instead see "Address not found" then your DFN address is invalid. Please double-check the address. For troubleshooting, see the subsection below.

Once you are on the KYC main page, you can submit your personal identifying information (PII). Information entered on this page will be sent directly to the KYC provider.

===Troubleshooting===

If you have problems with your DFN address, then you can verify it using [https://etherscan.io/address/0x1Be116204bb55CB61c821a1C7866fA6f94b561a5#readContract Etherscan].

After you connect to Etherscan, scroll down to row “51. tokens”, open the dropdown form by expanding the row, paste your DFN address in the field “<input> (address)” and click “Query”. For the example address 2d89d96b10f7a9456a9154b2f5309ee70df5bce1 you will see:

[File:Etherscan-FDC-query.png|512px|Etherscan]

If you made a seed donation then you will see the token amount that the FDC calculated. If the DFN address is incorrect then it will show a token amount of 0.

==Step 4: Instruct the neurons you wish to unstake to dissolve==

Once you have claimed your neurons and completed the KYC process, you can start "dissolving" your neurons.

YOU ARE HIGHLY ENCOURAGED TO READ [https://medium.com/dfinity/understanding-the-internet-computers-network-nervous-system-neurons-and-icp-utility-tokens-730dab65cae8 THIS BLOG POST] BEFORE YOU START DISSOLVING YOUR NEURONS. THERE ARE MANY BENEFITS TO NEURON OWNERSHIP. BE SURE YOU UNDERSTAND EXACTLY WHAT YOU ARE GIVING UP BY DISSOLVING THEM. IN PARTICULAR, YOUR NEURONS A PRE-AGED AT 18-MONTHS, MEANING THAT YOUR VOTING REWARDS RECEIVE A MULTIPLIER EFFECT, WHICH YOU WILL LOSE WHEN YOUR NEURONS ENTER THE DISSOLVE STATE.

Dissolving a neuron is not instantaneous, but rather takes place over a period of time known as the "dissolve delay". The dissolve delay is a parameter of the individual neuron. In general, different neurons have different dissolve delays. When a neuron is dissolving, its dissolve delay falls over the passage of time, until either it is stopped by you, or it reaches zero. Once the dissolve delay reaches zero, it stops falling, and only then can you instruct the neuron to disburse your ICP tokens.

Your neurons have dissolve delays of 0,1,2,…,30 or 48 months.

To start the dissolution of one of your neurons, you must sign and send a message to the governance canister. You can accomplish this in one step on a networked computer using dfx canister call, or as two separate steps, one on an air-gapped computer using dfx canister sign, and another on a networked computer using dfx canister send. We strongly recommend the latter approach to reduce the risk of having your private key compromised.

===Dissolve in one step (not recommended)===

Verify that you can connect to the Internet Computer.

<pre>
$ dfx ping https://ic0.app
</pre>

Recall the identifier of the neuron you want to dissolve and declare it as an environment variable.

<pre>
NEURON_ID=...
</pre>

Call the governance canister to dissolve your neuron.

<pre>
CANISTER=rrkah-fqaaa-aaaaa-aaaaq-cai
RESULT="$(dfx canister --network=https://ic0.app --no-wallet call $CANISTER manage_neuron "(record { id = opt record { id = $NEURON_ID:nat64 }; command = opt variant { Configure = record { operation = opt variant { StartDissolving = record {} } } } })" --output=raw)"
didc decode -t "(ManageNeuronResponse)" -d ~/Downloads/nns-ifaces-0.8.0/governance.did $RESULT
</pre>

Note that if you want to dissolve all of your neurons, then you must repeat the step above for each neuron identifier.

===Dissolve in two steps===

====On your air-gapped computer====

Recall the identifier of the neuron you want to dissolve and declare it as an environment variable.

<pre>
NEURON_ID=...
</pre>

Sign a message to dissolve your neurons.

Recall the behavior of the {{code|--expire-after}} option to ensure that you deliver the message within the correct 5-minute window.

<pre>
CANISTER=rrkah-fqaaa-aaaaa-aaaaq-cai
dfx canister --network=https://ic0.app --no-wallet sign --expire-after=1h $CANISTER manage_neuron "(record { id = opt record { id = $NEURON_ID:nat64 }; command = opt variant { Configure = record { operation = opt variant { StartDissolving = record {} } } } })"
</pre>

The command above results in a {{code|message.json}} file in your current directory. You must copy that file from your air-gapped computer to your networked computer. How you do this will depend on your configuration.

====On your networked computer====

Verify that you can connect to the Internet Computer.

<pre>
$ dfx ping https://ic0.app
</pre>

Send the signed message to the governance canister to dissolve your neurons. As previously mentioned, you can only perform this action within the 5-minute window that you specified.

<pre>
$ dfx canister --network=https://ic0.app --no-wallet send message.json
</pre>

==Step 5: Disburse ICP from neurons that are fully dissolved==

===Disburse in one step (not recommended)===

Verify that you can connect to the Internet Computer.

<pre>
dfx ping https://ic0.app
</pre>

Recall your account identifier and declare it as an environment variable.

<pre>
ACCOUNT_ID=$(echo $seed | keysmith account -f -)
</pre>

Recall the identifier of the neuron you want to dissolve and declare it as an environment variable.

<pre>
NEURON_ID=...
</pre>

Disburse the ICP tokens locked in your neuron.

<pre>
CANISTER=rrkah-fqaaa-aaaaa-aaaaq-cai
ACCOUNT_ID_WITHOUT_CHECKSUM_BYTES="$(printf ${ACCOUNT_ID:8} | fold -w 2 | xargs -I {} printf '%d:nat8; ' '0x{}')"
RESULT="$(dfx canister --network=https://ic0.app --no-wallet call $CANISTER manage_neuron "(record { id = opt record { id = $NEURON_ID:nat64 }; command = opt variant { Disburse = record { to_account = opt record { hash = vec { $ACCOUNT_ID_WITHOUT_CHECKSUM_BYTES } }; amount = null } } })" --output=raw)"
didc decode -t "(ManageNeuronResponse)" -d ~/Downloads/nns-ifaces-0.8.0/governance.did $RESULT
</pre>

===Disburse in two steps===

====On your air-gapped computer====

Recall your account identifier and declare it as an environment variable.

<pre>
ACCOUNT_ID=$(echo $seed | keysmith account -f -)
</pre>

Recall the identifier of the neuron you want to dissolve and declare it as an environment variable.

<pre>
NEURON_ID=...
</pre>

Sign a message to disburse the ICP tokens locked your neuron.

Recall the behavior of the {{code|--expire-after}} option to ensure you that you deliver the message within the correct 5-minute window.

<pre>
CANISTER=rrkah-fqaaa-aaaaa-aaaaq-cai
ACCOUNT_ID_WITHOUT_CHECKSUM_BYTES="$(printf ${ACCOUNT_ID:8} | fold -w 2 | xargs -I {} printf '%d:nat8; ' '0x{}')"
dfx canister --network=https://ic0.app --no-wallet sign --expire-after=1h $CANISTER manage_neuron "(record { id = opt record { id = $NEURON_ID:nat64 }; command = opt variant { Disburse = record { to_account = opt record { hash = vec { $ACCOUNT_ID_WITHOUT_CHECKSUM_BYTES } }; amount = null } } })"
</pre>

The command above results in a {{code|message.json}} file in your current directory. You must copy that file from your air-gapped computer to your networked computer. How you do this will depend on your configuration.

====On your networked computer====

Verify that you can connect to the Internet Computer.

<pre>
$ dfx ping https://ic0.app
</pre>

Send the signed message to the governance canister to disburse the ICP tokens locked your neuron. As previously mentioned, you can only perform this action within the 5-minute window that you specified.

<pre>
dfx canister --network=https://ic0.app --no-wallet send message.json
</pre>

==Related topics==

* [[Neuron/ICP Instructions for Seed Participants]]

Network Nervous System

2021-11-20T19:01:13Z

Timo:

The Network Nervous System (NNS) is explained in the article: [[Governance of the Internet Computer]]

External links:

* [https://medium.com/dfinity/the-network-nervous-system-governing-the-internet-computer-1d176605d66a Medium article]
* [https://dfinity.org/howitworks/network-nervous-system-nns Video]

Internet Computer wiki

2021-11-20T18:57:07Z

Timo: /* Tutorial section */

Welcome to the Internet Computer Wiki! Feel free to join in. All are welcome!
== Topics Central ==

* [[Internet computer]]
* [[Internet Computer vision]]
* [[Index of dapps on the Internet Computer]]
* [[ICP token]]
* [[Internet Identity]]
* [https://dashboard.internetcomputer.org/ Internet Computer dashboard]
* [[Internet Computer Performance]]
* [[DFINITY]]
* [[Custody, Staking, and Voting]]
*[[Network Nervous System]]
== For blockchain & crypto enthusiasts ==
* [[Myths and facts]]
* [https://www.reddit.com/r/dfinity/ r/dfinity]
* [[How to stake on the Internet computer]]
* [[Tokenomics of the Internet Computer]]
* [[Governance of the Internet Computer]]

== For dapp developers ==
* [[Internet Computer for dapp developers]]
* [[Canister smart contracts]]
* [https://forum.dfinity.org/ IC community developer forum]
* [[Best practices for a high traffic dapp launch]]
* [[Best practices for NFT drops]]

== For computer scientists ==
* [[The Internet Computer for Computer Scientists]]

== For node owners ==
* [[Internet Computer for node owners]]

== FAQs ==

* [[FAQ]]

'''Computer Scientists FAQ'''
* [[The Internet Computer for Computer Scientists]]
== How-To section ==

* [[How-To: Claim neurons for seed participants]]

== Tutorial section ==

* [[Tutorial: Neuron control]]

== Contributors ==

=== Housekeeping Rules ===

* Please refrain from redundancy, such as referring to the Internet Computer in article titles. This is, after all, the Internet Computer Wiki.
* Please carefully consider your use of capitalisation. Most words in titles should be capitalised. DFINITY is always stylised in all-caps.

=== How to Contribute ===
Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]

Use this page to test editing
* [[Test editing the Internet Computer Wiki]]

Number of articles: {{NUMBEROFARTICLES}}

Tutorial: Neuron control

2021-11-20T18:54:09Z

Timo:

There are the following options to control neurons:

# NNS dapp
# quill (command line tool)
# ic-repl (command line tool)

Options 1 and 2 can be used in conjunction with a Ledger hardware wallets. Options 2 and 3 work well with an air-gapped computer.

It is also possible to control neurons with dfx but that is not covered in this tutorial.

== NNS dapp ==
https://nns.ic0.app/

== quill ==

=== Installation ===

== ic-repl ==

Tutorial: Neuron control

2021-11-20T18:52:22Z

Timo: Created page with "There are the following options to control neurons: # NNS dapp # quill (command line tool) # ic-repl (command line tool) Options 1 and 2 can be used in conjunction with a Le..."

Internet Computer wiki

2021-11-20T18:46:42Z

Timo: /* How-Tos */

Welcome to the Internet Computer Wiki! Feel free to join in. All are welcome!
== Topics Central ==

* [[Internet computer]]
* [[Internet Computer vision]]
* [[Index of dapps on the Internet Computer]]
* [[ICP token]]
* [[Internet Identity]]
* [https://dashboard.internetcomputer.org/ Internet Computer dashboard]
* [[Internet Computer Performance]]
* [[DFINITY]]
* [[Custody, Staking, and Voting]]
*[[Network Nervous System]]
== For blockchain & crypto enthusiasts ==
* [[Myths and facts]]
* [https://www.reddit.com/r/dfinity/ r/dfinity]
* [[How to stake on the Internet computer]]
* [[Tokenomics of the Internet Computer]]
* [[Governance of the Internet Computer]]

== For dapp developers ==
* [[Internet Computer for dapp developers]]
* [[Canister smart contracts]]
* [https://forum.dfinity.org/ IC community developer forum]
* [[Best practices for a high traffic dapp launch]]
* [[Best practices for NFT drops]]

== For computer scientists ==
* [[The Internet Computer for Computer Scientists]]

== For node owners ==
* [[Internet Computer for node owners]]

== FAQs ==

* [[FAQ]]

'''Computer Scientists FAQ'''
* [[The Internet Computer for Computer Scientists]]
== How-To section ==

* [[How-To: Claim neurons for seed participants]]

== Tutorial section ==

*

== Contributors ==

=== Housekeeping Rules ===

* Please refrain from redundancy, such as referring to the Internet Computer in article titles. This is, after all, the Internet Computer Wiki.
* Please carefully consider your use of capitalisation. Most words in titles should be capitalised. DFINITY is always stylised in all-caps.

=== How to Contribute ===
Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]

Use this page to test editing
* [[Test editing the Internet Computer Wiki]]

Number of articles: {{NUMBEROFARTICLES}}

How-To: Claim neurons for seed participants

2021-11-20T09:57:57Z

Timo: /* Create your private key (.pem file) */

You are a ''seed participant'' if you donated to the DFINITY foundation in February of 2017. At that time, 30 tokens per Swiss Franc of value donated were allotted to your key. These tokens are now called "ICP tokens" or, shortly, "ICP".

At Genesis Unlock your ICP were disbursed to you in the form of a basket of 49 voting [[Network Nervous System|neurons]]. These neurons already exist inside the [[Network Nervous System]]. Your neurons contain the ICP you have been awarded, staked inside.

Your neurons have been configured to vote automatically and are already earning voting rewards for you. You do not need to do anything to initialize your neurons in order to continue earning voting rewards.

The 49 neurons created for you have dissolve [[Network Nervous System|delays]] of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

We are pleased to inform you that your neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases your voting power and the voting rewards you receive.

To control your neurons you must use the same secret key that you generated when the donation was made. It was recorded as a 12-word mnemonic phrase. In order to control your neurons you need to first ''claim'' the whole basket. This article explains how to do the claiming. For how to control your neurons after claiming them see this [[Tutorial: Neuron control|tutorial]].

== Claiming with a Ledger Nano device ==

'''Coming soon.''' This will come with the next update of the IC's app for the Ledger Nano. The current release can manage neurons but cannot yet claim them.

== Claiming with an air-gapped computer ==

Claiming requires access to your secret mnemonic phrase and to secret keys derived from it. It is highly advised that you use an air-gapped computer for the purpose of claiming. If you are not comfortable with such a setup or with any of the following steps then you have to wait for the next release of the IC's app for the Ledger Nano device.

As an air-gapped device you can use a Windows, Linux or MacOS machine. Linux includes Raspberry Pi.

=== Download the tools ===
To download the tools you need a second, networked computer. The tools are called ''keysmith'' and ''quill.'' We describe here how to find and download a binary for your architecture. If you want to compile the tools yourself then we provide more information for you at the end of the document (TODO).

Binaries are available for the following hardware architectures. Here, architecture refers to the air-gapped computer, not the networked computer.
{| class="wikitable"
|+
!Hardware
!keysmith
!quill
|-
|Mac, Intel silicon
|darwin-amd64
|macos-x86_64
|-
|Mac, Apple silicon (M1)
|darwin-arm64
| -
|-
|Linux (x86)
|linux-amd64
|linux-x86_64
|-
|Raspberry Pi
|linux-arm32
|arm_32
|-
|Linux (arm)
|linux-arm64
| -
|-
|Windows
|windows-amd64
|windows-x86_64
|}
==== Download keysmith ====

Go to [https://github.com/dfinity/keysmith/releases/ keysmith], choose the latest release (currently v1.6.2) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

==== Download quill ====

Go to [https://github.com/dfinity/quill/releases quill] , choose the latest release (must be >= 0.2.12) and fetch the executable file that matches the air-gapped machine's architecture in the table above.

=== Copy to air-gapped machine ===

Copy the keysmith .tar.gz file and the quill executable from the networked machine to the air-gapped machine. For example, you can do so with a USB drive.

=== Verify the hashes ===

On the air-gapped machine, go to the terminal. Change the directory to the folder where the keysmith .tar.gz files and quill executables are. Compute the SHA256 hashes with the commands<syntaxhighlight lang="bash">
openssl dgst -sha256 keysmith-*
</syntaxhighlight>and<syntaxhighlight lang="bash">
openssl dgst -sha256 quill-*
</syntaxhighlight>The hashes should match the following entries:<syntaxhighlight lang="bash">
SHA256(keysmith-darwin-amd64.tar.gz)= a53bad6fa36c1eb35cd36059ffe9cbf4c063b515e47ccf666b7e1c174a7d1088
SHA256(keysmith-darwin-arm64.tar.gz)= 47932452353fe7f921b4ac41828dd19530ae0c4bdb72bcbb016a0715ca80e879
SHA256(keysmith-linux-amd64.tar.gz)= cb283dac031d8676f25e72d19115be347d2b85c864a17dd563104bf496b14a06
SHA256(keysmith-linux-arm32.tar.gz)= b28670e2b3483ea9f9ba691e9f76f99df31b2678db33b69c888fb08b634de162
SHA256(keysmith-linux-arm64.tar.gz)= ebe9cde3cf440ebbfb53dd10bf7f412cbff8b089551100ee0fa48f3ac9bd66c3
SHA256(keysmith-windows-amd64.tar.gz)= 1ef9b77ccaae980aad4a227fe1a817821245da491a90f0e6ad323426b49ae40a
</syntaxhighlight>and<syntaxhighlight lang="bash">
SHA256(quill-arm_32)= ebe2506e4dc4422e7670094e8b2b1d854a3b3c317b25c1c88990853d3d85c064
SHA256(quill-linux-x86_64)= 18fc671ee8c96b367875b39470073d68db78d32d242d14d4682025ef2a5d9ad4
SHA256(quill-macos-x86_64)= 97c373ab871be377ac784faff089ca26d23c37725230fb36d78f17d7a73b0867
SHA256(quill-windows-x86_64.exe)= 2542244c9ad3a9baf54bc2227e8c71ea8a8fb9f7e6065cc7a848c7b1cdce906e
</syntaxhighlight>

=== Unpack and install ===

For keysmith:<syntaxhighlight lang="bash">
tar -f keysmith-*.tar* -x
sudo install -d /usr/local/bin
sudo install keysmith /usr/local/bin
</syntaxhighlight>You will be prompted to enter your laptop password. The password itself will not appear, simply type it and press enter.

For quill:<syntaxhighlight lang="bash">
mv quill-arm_32 quill
sudo install quill /usr/local/bin
</syntaxhighlight>

== Produce the private key file with keysmith ==

=== Test the installation ===
On the air-gapped computer run:<syntaxhighlight lang="bash">
keysmith
</syntaxhighlight>You should see:<syntaxhighlight lang="bash">
usage: keysmith <command> [<args>]

Available Commands:
account Print your account identifier.
generate Generate your mnemonic seed and write it to a file.
legacy-address Print your legacy address.
principal Print your principal identifier.
private-key Derive your private key and write it to a file.
public-key Print your public key.
shortlist Print the available commands.
version Print the version number.
x-private-key Derive your extended private key and write it to a file.
x-public-key Print your extended public key.
</syntaxhighlight>If you are using macOS, running <code>keysmith</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Enter your mnemonic phrase (aka "seed") ===

If you confident that your environment is secure, then you are ready to enter your seed for use with <code>keysmith</code>. For the duration of your session, you store your seed phrase in an environment variable. It will be eliminated from your system when you turn your computer off.
<syntaxhighlight lang="bash">
read seed
</syntaxhighlight>
Enter your seed phrase and finish with Return.

If you prefer to not have your seed phrase displayed as you type then use this command instead:<syntaxhighlight lang="bash">
read -s seed
</syntaxhighlight>

=== Optional: check your legacy address and balance ===

At this point you can already verify your legacy address and ICPT balance. The legacy address matches to what was formerly called "DFN address" in the Dfinity Chrome extension. You may have copied it from the Chrome extension for your records back when you used the extension.
<syntaxhighlight lang="bash">
echo $seed | keysmith legacy-address -f -
</syntaxhighlight>
The output is a 40 character hex string. It looks something like this:
<syntaxhighlight lang="bash">
2d89d96b10f7a9456a9154b2f5309ee70df5bce1
</syntaxhighlight>
You can check your ICPT balance as follows: Go to https://ic.rocks/principal/renrk-eyaaa-aaaaa-aaada-cai, look for "Canister interface" and the method "balance". There, paste your DFN address in to the field labeled "text" and click the button labeled "Query". Your ICP balance will appear below "nat32".

=== Create your private key (.pem file) ===

Derive your private key from your seed phrase.
<syntaxhighlight lang="bash">echo $seed | keysmith private-key -f -</syntaxhighlight>
This creates a file <code>identity.pem</code> containing your private key.

==== Optional: Store .pem file only in RAM ====
We will later wipe the identity.pem file from the filesystem. There is however a remaining risk that the data could survive in the disk and later extracted despite it being wiped. It is more secure to create a RAM disk and store the .pem file only in the RAM disk.

===== Create RAM disk on MacOS =====
Run these commands<syntaxhighlight lang="bash" line="1">
DISK=$(hdiutil attach -nomount ram://16384)
diskutil erasevolume HFS+ RD $DISK
cd /Volumes/RD
</syntaxhighlight>before running<syntaxhighlight lang="bash">
echo $seed | keysmith private-key -f -
</syntaxhighlight>

===== Create RAM disk on Linux =====
Todo

===== Create RAM disk on Windows =====
Todo

== Submit claim with quill ==

=== Test the installation ===
On the air-gapped computer run:
quill
You should see:<syntaxhighlight lang="bash">
quill 0.2.12

Ledger & Governance ToolKit for cold wallets

USAGE:
quill [OPTIONS] <SUBCOMMAND>

OPTIONS:
-h, --help Print help information
--pem-file <PEM_FILE> Path to your PEM file (use "-" for STDIN)
-V, --version Print version information

SUBCOMMANDS:
account-balance Queries a ledger account balance
claim-neurons Claim seed neurons from the Genesis Token Canister
get-proposal-info
help Print this message or the help of the given subcommand(s)
list-neurons Signs the query for all neurons belonging to the signin principal
list-proposals
neuron-manage Signs a neuron configuration change
neuron-stake Signs topping up of a neuron (new or existing)
public-ids Prints the principal id and the account id
send Sends a signed message or a set of messages
transfer Signs an ICP transfer transaction
</syntaxhighlight>If you are using macOS, running <code>quill</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Sign the claim request ===

On the air-gapped computer run:<syntaxhighlight lang="bash">
quill --pem-file identity.pem claim-neurons >msg.json

</syntaxhighlight>

=== Submit the claim to the IC ===

==== Option 1: With quill on the networked computer ====

Copy the resulting file `msg.json` back to the networked computer. On the networked computer, change into the directory where `msg.json` is and run:<syntaxhighlight lang="bash">
quill send msg.json
</syntaxhighlight>Your neurons should now be claimed.

You can double-check if you claim was successful in the following way: Go to https://ic.rocks/genesis/2d89d96b10f7a9456a9154b2f5309ee70df5bce1 where you replace <code>2d89d96b10f7a9456a9154b2f5309ee70df5bce1</code> with your own DFN address. Under "Status" you should see "Claimed".

==== Option 2: Use the QR scanner app ====

* Install <code>qrencode</code>
* Run <code>cat msg.json | gzip -c | base64 | qrencode -o msg.png</code>
* Open <code>msg.png</code> in an image viewer
* Open scanner app in a browser on a phone: https://p5deo-6aaaa-aaaab-aaaxq-cai.raw.ic0.app
* Scan QR code and submit

=== Clean up the air-gapped computer ===

If your claim was successful then do not forget to remove the g <code>.pem</code> file on the air-gapped computer:<syntaxhighlight lang="bash">
rm identity.pem

</syntaxhighlight>

How-To: Claim neurons for seed participants

2021-11-20T09:57:04Z

Timo:

You are a ''seed participant'' if you donated to the DFINITY foundation in February of 2017. At that time, 30 tokens per Swiss Franc of value donated were allotted to your key. These tokens are now called "ICP tokens" or, shortly, "ICP".

At Genesis Unlock your ICP were disbursed to you in the form of a basket of 49 voting [[Network Nervous System|neurons]]. These neurons already exist inside the [[Network Nervous System]]. Your neurons contain the ICP you have been awarded, staked inside.

Your neurons have been configured to vote automatically and are already earning voting rewards for you. You do not need to do anything to initialize your neurons in order to continue earning voting rewards.

The 49 neurons created for you have dissolve [[Network Nervous System|delays]] of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

We are pleased to inform you that your neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases your voting power and the voting rewards you receive.

To control your neurons you must use the same secret key that you generated when the donation was made. It was recorded as a 12-word mnemonic phrase. In order to control your neurons you need to first ''claim'' the whole basket. This article explains how to do the claiming. For how to control your neurons after claiming them see this [[Tutorial: Neuron control|tutorial]].

== Claiming with a Ledger Nano device ==

'''Coming soon.''' This will come with the next update of the IC's app for the Ledger Nano. The current release can manage neurons but cannot yet claim them.

== Claiming with an air-gapped computer ==

Claiming requires access to your secret mnemonic phrase and to secret keys derived from it. It is highly advised that you use an air-gapped computer for the purpose of claiming. If you are not comfortable with such a setup or with any of the following steps then you have to wait for the next release of the IC's app for the Ledger Nano device.

As an air-gapped device you can use a Windows, Linux or MacOS machine. Linux includes Raspberry Pi.

=== Download the tools ===
To download the tools you need a second, networked computer. The tools are called ''keysmith'' and ''quill.'' We describe here how to find and download a binary for your architecture. If you want to compile the tools yourself then we provide more information for you at the end of the document (TODO).

Binaries are available for the following hardware architectures. Here, architecture refers to the air-gapped computer, not the networked computer.
{| class="wikitable"
|+
!Hardware
!keysmith
!quill
|-
|Mac, Intel silicon
|darwin-amd64
|macos-x86_64
|-
|Mac, Apple silicon (M1)
|darwin-arm64
| -
|-
|Linux (x86)
|linux-amd64
|linux-x86_64
|-
|Raspberry Pi
|linux-arm32
|arm_32
|-
|Linux (arm)
|linux-arm64
| -
|-
|Windows
|windows-amd64
|windows-x86_64
|}
==== Download keysmith ====

Go to [https://github.com/dfinity/keysmith/releases/ keysmith], choose the latest release (currently v1.6.2) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

==== Download quill ====

Go to [https://github.com/dfinity/quill/releases quill] , choose the latest release (must be >= 0.2.12) and fetch the executable file that matches the air-gapped machine's architecture in the table above.

=== Copy to air-gapped machine ===

Copy the keysmith .tar.gz file and the quill executable from the networked machine to the air-gapped machine. For example, you can do so with a USB drive.

=== Verify the hashes ===

On the air-gapped machine, go to the terminal. Change the directory to the folder where the keysmith .tar.gz files and quill executables are. Compute the SHA256 hashes with the commands<syntaxhighlight lang="bash">
openssl dgst -sha256 keysmith-*
</syntaxhighlight>and<syntaxhighlight lang="bash">
openssl dgst -sha256 quill-*
</syntaxhighlight>The hashes should match the following entries:<syntaxhighlight lang="bash">
SHA256(keysmith-darwin-amd64.tar.gz)= a53bad6fa36c1eb35cd36059ffe9cbf4c063b515e47ccf666b7e1c174a7d1088
SHA256(keysmith-darwin-arm64.tar.gz)= 47932452353fe7f921b4ac41828dd19530ae0c4bdb72bcbb016a0715ca80e879
SHA256(keysmith-linux-amd64.tar.gz)= cb283dac031d8676f25e72d19115be347d2b85c864a17dd563104bf496b14a06
SHA256(keysmith-linux-arm32.tar.gz)= b28670e2b3483ea9f9ba691e9f76f99df31b2678db33b69c888fb08b634de162
SHA256(keysmith-linux-arm64.tar.gz)= ebe9cde3cf440ebbfb53dd10bf7f412cbff8b089551100ee0fa48f3ac9bd66c3
SHA256(keysmith-windows-amd64.tar.gz)= 1ef9b77ccaae980aad4a227fe1a817821245da491a90f0e6ad323426b49ae40a
</syntaxhighlight>and<syntaxhighlight lang="bash">
SHA256(quill-arm_32)= ebe2506e4dc4422e7670094e8b2b1d854a3b3c317b25c1c88990853d3d85c064
SHA256(quill-linux-x86_64)= 18fc671ee8c96b367875b39470073d68db78d32d242d14d4682025ef2a5d9ad4
SHA256(quill-macos-x86_64)= 97c373ab871be377ac784faff089ca26d23c37725230fb36d78f17d7a73b0867
SHA256(quill-windows-x86_64.exe)= 2542244c9ad3a9baf54bc2227e8c71ea8a8fb9f7e6065cc7a848c7b1cdce906e
</syntaxhighlight>

=== Unpack and install ===

For keysmith:<syntaxhighlight lang="bash">
tar -f keysmith-*.tar* -x
sudo install -d /usr/local/bin
sudo install keysmith /usr/local/bin
</syntaxhighlight>You will be prompted to enter your laptop password. The password itself will not appear, simply type it and press enter.

For quill:<syntaxhighlight lang="bash">
mv quill-arm_32 quill
sudo install quill /usr/local/bin
</syntaxhighlight>

== Produce the private key file with keysmith ==

=== Test the installation ===
On the air-gapped computer run:<syntaxhighlight lang="bash">
keysmith
</syntaxhighlight>You should see:<syntaxhighlight lang="bash">
usage: keysmith <command> [<args>]

Available Commands:
account Print your account identifier.
generate Generate your mnemonic seed and write it to a file.
legacy-address Print your legacy address.
principal Print your principal identifier.
private-key Derive your private key and write it to a file.
public-key Print your public key.
shortlist Print the available commands.
version Print the version number.
x-private-key Derive your extended private key and write it to a file.
x-public-key Print your extended public key.
</syntaxhighlight>If you are using macOS, running <code>keysmith</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Enter your mnemonic phrase (aka "seed") ===

If you confident that your environment is secure, then you are ready to enter your seed for use with <code>keysmith</code>. For the duration of your session, you store your seed phrase in an environment variable. It will be eliminated from your system when you turn your computer off.
<syntaxhighlight lang="bash">
read seed
</syntaxhighlight>
Enter your seed phrase and finish with Return.

If you prefer to not have your seed phrase displayed as you type then use this command instead:<syntaxhighlight lang="bash">
read -s seed
</syntaxhighlight>

=== Optional: check your legacy address and balance ===

At this point you can already verify your legacy address and ICPT balance. The legacy address matches to what was formerly called "DFN address" in the Dfinity Chrome extension. You may have copied it from the Chrome extension for your records back when you used the extension.
<syntaxhighlight lang="bash">
echo $seed | keysmith legacy-address -f -
</syntaxhighlight>
The output is a 40 character hex string. It looks something like this:
<syntaxhighlight lang="bash">
2d89d96b10f7a9456a9154b2f5309ee70df5bce1
</syntaxhighlight>
You can check your ICPT balance as follows: Go to https://ic.rocks/principal/renrk-eyaaa-aaaaa-aaada-cai, look for "Canister interface" and the method "balance". There, paste your DFN address in to the field labeled "text" and click the button labeled "Query". Your ICP balance will appear below "nat32".

=== Create your private key (.pem file) ===

Derive your private key from your seed phrase.
<syntaxhighlight lang="bash">echo $seed | keysmith private-key -f -</syntaxhighlight>
This creates a file <code>identity.pem</code> containing your private key.

==== Option: Store .pem file only in RAM ====
We will later wipe the identity.pem file from the filesystem. There is however a remaining risk that the data could survive in the disk and later extracted despite it being wiped. It is more secure to create a RAM disk and store the .pem file only in the RAM disk.

===== Create RAM disk on MacOS =====
Run these commands<syntaxhighlight lang="bash" line="1">
DISK=$(hdiutil attach -nomount ram://16384)
diskutil erasevolume HFS+ RD $DISK
cd /Volumes/RD
</syntaxhighlight>before running<syntaxhighlight lang="bash">
echo $seed | keysmith private-key -f -
</syntaxhighlight>

===== Create RAM disk on Linux =====
Todo

===== Create RAM disk on Windows =====
Todo

== Submit claim with quill ==

=== Test the installation ===
On the air-gapped computer run:
quill
You should see:<syntaxhighlight lang="bash">
quill 0.2.12

Ledger & Governance ToolKit for cold wallets

USAGE:
quill [OPTIONS] <SUBCOMMAND>

OPTIONS:
-h, --help Print help information
--pem-file <PEM_FILE> Path to your PEM file (use "-" for STDIN)
-V, --version Print version information

SUBCOMMANDS:
account-balance Queries a ledger account balance
claim-neurons Claim seed neurons from the Genesis Token Canister
get-proposal-info
help Print this message or the help of the given subcommand(s)
list-neurons Signs the query for all neurons belonging to the signin principal
list-proposals
neuron-manage Signs a neuron configuration change
neuron-stake Signs topping up of a neuron (new or existing)
public-ids Prints the principal id and the account id
send Sends a signed message or a set of messages
transfer Signs an ICP transfer transaction
</syntaxhighlight>If you are using macOS, running <code>quill</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Sign the claim request ===

On the air-gapped computer run:<syntaxhighlight lang="bash">
quill --pem-file identity.pem claim-neurons >msg.json

</syntaxhighlight>

=== Submit the claim to the IC ===

==== Option 1: With quill on the networked computer ====

Copy the resulting file `msg.json` back to the networked computer. On the networked computer, change into the directory where `msg.json` is and run:<syntaxhighlight lang="bash">
quill send msg.json
</syntaxhighlight>Your neurons should now be claimed.

You can double-check if you claim was successful in the following way: Go to https://ic.rocks/genesis/2d89d96b10f7a9456a9154b2f5309ee70df5bce1 where you replace <code>2d89d96b10f7a9456a9154b2f5309ee70df5bce1</code> with your own DFN address. Under "Status" you should see "Claimed".

==== Option 2: Use the QR scanner app ====

* Install <code>qrencode</code>
* Run <code>cat msg.json | gzip -c | base64 | qrencode -o msg.png</code>
* Open <code>msg.png</code> in an image viewer
* Open scanner app in a browser on a phone: https://p5deo-6aaaa-aaaab-aaaxq-cai.raw.ic0.app
* Scan QR code and submit

=== Clean up the air-gapped computer ===

If your claim was successful then do not forget to remove the g <code>.pem</code> file on the air-gapped computer:<syntaxhighlight lang="bash">
rm identity.pem

</syntaxhighlight>

How-To: Claim neurons for seed participants

2021-11-20T09:55:46Z

Timo:

You are a ''seed participant'' if you donated to the DFINITY foundation in February of 2017. At that time, 30 tokens per Swiss Franc of value donated were allotted to your key. These tokens are now called "ICP tokens" or, shortly, "ICP".

At Genesis Unlock your ICP were disbursed to you in the form of a basket of 49 voting [[Network Nervous System|neurons]]. These neurons already exist inside the [[Network Nervous System]]. Your neurons contain the ICP you have been awarded, staked inside.

Your neurons have been configured to vote automatically and are already earning voting rewards for you. You do not need to do anything to initialize your neurons in order to continue earning voting rewards.

The 49 neurons created for you have dissolve [[Network Nervous System|delays]] of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

We are pleased to inform you that your neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases your voting power and the voting rewards you receive.

To control your neurons you must use the same secret key that you generated when the donation was made. It was recorded as a 12-word mnemonic phrase. In order to control your neurons you need to first ''claim'' the whole basket. This article explains how to do the claiming. For how to control your neurons after claiming them see this [[Tutorial: Neuron control|tutorial]].

== Claiming with a Ledger Nano device ==

'''Coming soon.''' This will come with the next update of the IC's app for the Ledger Nano. The current release can manage neurons but cannot yet claim them.

== Claiming with an air-gapped computer ==

Claiming requires access to your secret mnemonic phrase and to secret keys derived from it. It is highly advised that you use an air-gapped computer for the purpose of claiming. If you are not comfortable with such a setup or with any of the following steps then you have to wait for the next release of the IC's app for the Ledger Nano device.

As an air-gapped device you can use a Windows, Linux or MacOS machine. Linux includes Raspberry Pi.

=== Download the tools ===
To download the tools you need a second, networked computer. The tools are called ''keysmith'' and ''quill.'' We describe here how to find and download a binary for your architecture. If you want to compile the tools yourself then we provide more information for you at the end of the document (TODO).

Binaries are available for the following hardware architectures. Here, architecture refers to the air-gapped computer, not the networked computer.
{| class="wikitable"
|+
!Hardware
!keysmith
!quill
|-
|Mac, Intel silicon
|darwin-amd64
|macos-x86_64
|-
|Mac, Apple silicon (M1)
|darwin-arm64
| -
|-
|Linux (x86)
|linux-amd64
|linux-x86_64
|-
|Raspberry Pi
|linux-arm32
|arm_32
|-
|Linux (arm)
|linux-arm64
| -
|-
|Windows
|windows-amd64
|windows-x86_64
|}
==== Download keysmith ====

Go to [https://github.com/dfinity/keysmith/releases/ keysmith], choose the latest release (currently v1.6.2) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

==== Download quill ====

Go to [https://github.com/dfinity/quill/releases quill] , choose the latest release (must be >= 0.2.12) and fetch the executable file that matches the air-gapped machine's architecture in the table above.

=== Copy to air-gapped machine ===

Copy the keysmith .tar.gz file and the quill executable from the networked machine to the air-gapped machine. For example, you can do so with a USB drive.

=== Verify the hashes ===

On the air-gapped machine, go to the terminal. Change the directory to the folder where the keysmith .tar.gz files and quill executables are. Compute the SHA256 hashes with the commands<syntaxhighlight lang="bash">
openssl dgst -sha256 keysmith-*
</syntaxhighlight>and<syntaxhighlight lang="bash">
openssl dgst -sha256 quill-*
</syntaxhighlight>The hashes should match the following entries:<syntaxhighlight lang="bash">
SHA256(keysmith-darwin-amd64.tar.gz)= a53bad6fa36c1eb35cd36059ffe9cbf4c063b515e47ccf666b7e1c174a7d1088
SHA256(keysmith-darwin-arm64.tar.gz)= 47932452353fe7f921b4ac41828dd19530ae0c4bdb72bcbb016a0715ca80e879
SHA256(keysmith-linux-amd64.tar.gz)= cb283dac031d8676f25e72d19115be347d2b85c864a17dd563104bf496b14a06
SHA256(keysmith-linux-arm32.tar.gz)= b28670e2b3483ea9f9ba691e9f76f99df31b2678db33b69c888fb08b634de162
SHA256(keysmith-linux-arm64.tar.gz)= ebe9cde3cf440ebbfb53dd10bf7f412cbff8b089551100ee0fa48f3ac9bd66c3
SHA256(keysmith-windows-amd64.tar.gz)= 1ef9b77ccaae980aad4a227fe1a817821245da491a90f0e6ad323426b49ae40a
</syntaxhighlight>and<syntaxhighlight lang="bash">
SHA256(quill-arm_32)= ebe2506e4dc4422e7670094e8b2b1d854a3b3c317b25c1c88990853d3d85c064
SHA256(quill-linux-x86_64)= 18fc671ee8c96b367875b39470073d68db78d32d242d14d4682025ef2a5d9ad4
SHA256(quill-macos-x86_64)= 97c373ab871be377ac784faff089ca26d23c37725230fb36d78f17d7a73b0867
SHA256(quill-windows-x86_64.exe)= 2542244c9ad3a9baf54bc2227e8c71ea8a8fb9f7e6065cc7a848c7b1cdce906e
</syntaxhighlight>

=== Unpack and install ===

For keysmith:<syntaxhighlight lang="bash">
tar -f keysmith-*.tar* -x
sudo install -d /usr/local/bin
sudo install keysmith /usr/local/bin
</syntaxhighlight>You will be prompted to enter your laptop password. The password itself will not appear, simply type it and press enter.

For quill:<syntaxhighlight lang="bash">
mv quill-arm_32 quill
sudo install quill /usr/local/bin
</syntaxhighlight>

== Produce the private key file with keysmith ==

=== Test the installation ===
On the air-gapped computer run:<syntaxhighlight lang="bash">
keysmith
</syntaxhighlight>You should see:<syntaxhighlight lang="bash">
usage: keysmith <command> [<args>]

Available Commands:
account Print your account identifier.
generate Generate your mnemonic seed and write it to a file.
legacy-address Print your legacy address.
principal Print your principal identifier.
private-key Derive your private key and write it to a file.
public-key Print your public key.
shortlist Print the available commands.
version Print the version number.
x-private-key Derive your extended private key and write it to a file.
x-public-key Print your extended public key.
</syntaxhighlight>If you are using macOS, running <code>keysmith</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Enter your mnemonic phrase (aka "seed") ===

If you confident that your environment is secure, then you are ready to enter your seed for use with <code>keysmith</code>. For the duration of your session, you store your seed phrase in an environment variable. It will be eliminated from your system when you turn your computer off.
<syntaxhighlight lang="bash">
read seed
</syntaxhighlight>
Enter your seed phrase and finish with Return.

If you prefer to not have your seed phrase displayed as you type then use this command instead:<syntaxhighlight lang="bash">
read -s seed
</syntaxhighlight>

=== Optional: check your legacy address and balance ===

At this point you can already verify your legacy address and ICPT balance. The legacy address matches to what was formerly called "DFN address" in the Dfinity Chrome extension. You may have copied it from the Chrome extension for your records back when you used the extension.
<syntaxhighlight lang="bash">
echo $seed | keysmith legacy-address -f -
</syntaxhighlight>
The output is a 40 character hex string. It looks something like this:
<syntaxhighlight lang="bash">
2d89d96b10f7a9456a9154b2f5309ee70df5bce1
</syntaxhighlight>
You can check your ICPT balance as follows: Go to https://ic.rocks/principal/renrk-eyaaa-aaaaa-aaada-cai, look for "Canister interface" and the method "balance". There, paste your DFN address in to the field labeled "text" and click the button labeled "Query". Your ICP balance will appear below "nat32".

=== Create your private key (.pem file) ===

Derive your private key from your seed phrase.
<syntaxhighlight lang="bash">echo $seed | keysmith private-key -f -</syntaxhighlight>
This creates a file <code>identity.pem</code> containing your private key.

==== Option: Store .pem file only in RAM ====
We will later wipe the identity.pem file from the filesystem. There is however a remaining risk that the data could survive in the disk and later extracted despite it being wiped. It is more secure to create a RAM disk and store the .pem file only in the RAM disk.

===== Create RAM disk on MacOS =====
Run these commands<syntaxhighlight lang="bash" line="1">
DISK=$(hdiutil attach -nomount ram://16384)
diskutil erasevolume HFS+ RD $DISK
cd /Volumes/RD
</syntaxhighlight>before running<syntaxhighlight lang="bash">
echo $seed | keysmith private-key -f -
</syntaxhighlight>
echo $seed | keysmith private-key -f -

===== Create RAM disk on Linux =====
Todo

===== Create RAM disk on Windows =====
Todo

== Submit claim with quill ==

=== Test the installation ===
On the air-gapped computer run:
quill
You should see:<syntaxhighlight lang="bash">
quill 0.2.12

Ledger & Governance ToolKit for cold wallets

USAGE:
quill [OPTIONS] <SUBCOMMAND>

OPTIONS:
-h, --help Print help information
--pem-file <PEM_FILE> Path to your PEM file (use "-" for STDIN)
-V, --version Print version information

SUBCOMMANDS:
account-balance Queries a ledger account balance
claim-neurons Claim seed neurons from the Genesis Token Canister
get-proposal-info
help Print this message or the help of the given subcommand(s)
list-neurons Signs the query for all neurons belonging to the signin principal
list-proposals
neuron-manage Signs a neuron configuration change
neuron-stake Signs topping up of a neuron (new or existing)
public-ids Prints the principal id and the account id
send Sends a signed message or a set of messages
transfer Signs an ICP transfer transaction
</syntaxhighlight>If you are using macOS, running <code>quill</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Sign the claim request ===

On the air-gapped computer run:<syntaxhighlight lang="bash">
quill --pem-file identity.pem claim-neurons >msg.json

</syntaxhighlight>

=== Submit the claim to the IC ===

==== Option 1: With quill on the networked computer ====

Copy the resulting file `msg.json` back to the networked computer. On the networked computer, change into the directory where `msg.json` is and run:<syntaxhighlight lang="bash">
quill send msg.json
</syntaxhighlight>Your neurons should now be claimed.

You can double-check if you claim was successful in the following way: Go to https://ic.rocks/genesis/2d89d96b10f7a9456a9154b2f5309ee70df5bce1 where you replace <code>2d89d96b10f7a9456a9154b2f5309ee70df5bce1</code> with your own DFN address. Under "Status" you should see "Claimed".

==== Option 2: Use the QR scanner app ====

* Install <code>qrencode</code>
* Run <code>cat msg.json | gzip -c | base64 | qrencode -o msg.png</code>
* Open <code>msg.png</code> in an image viewer
* Open scanner app in a browser on a phone: https://p5deo-6aaaa-aaaab-aaaxq-cai.raw.ic0.app
* Scan QR code and submit

=== Clean up the air-gapped computer ===

If your claim was successful then do not forget to remove the g <code>.pem</code> file on the air-gapped computer:<syntaxhighlight lang="bash">
rm identity.pem

</syntaxhighlight>

How-To: Claim neurons for seed participants

2021-11-20T09:47:10Z

Timo:

You are a ''seed participant'' if you donated to the DFINITY foundation in February of 2017. At that time, 30 tokens per Swiss Franc of value donated were allotted to your key. These tokens are now called "ICP tokens" or, shortly, "ICP".

At Genesis Unlock your ICP were disbursed to you in the form of a basket of 49 voting [[Network Nervous System|neurons]]. These neurons already exist inside the [[Network Nervous System]]. Your neurons contain the ICP you have been awarded, staked inside.

Your neurons have been configured to vote automatically and are already earning voting rewards for you. You do not need to do anything to initialize your neurons in order to continue earning voting rewards.

The 49 neurons created for you have dissolve [[Network Nervous System|delays]] of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

We are pleased to inform you that your neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases your voting power and the voting rewards you receive.

To control your neurons you must use the same secret key that you generated when the donation was made. It was recorded as a 12-word mnemonic phrase. In order to control your neurons you need to first ''claim'' the whole basket. This article explains how to do the claiming. For how to control your neurons after claiming them see this [[Tutorial: Neuron control|tutorial]].

== Claiming with a Ledger Nano device ==

'''Coming soon.''' This will come with the next update of the IC's app for the Ledger Nano. The current release can manage neurons but cannot yet claim them.

== Claiming with an air-gapped computer ==

Claiming requires access to your secret mnemonic phrase and to secret keys derived from it. It is highly advised that you use an air-gapped computer for the purpose of claiming. If you are not comfortable with such a setup or with any of the following steps then you have to wait for the next release of the IC's app for the Ledger Nano device.

As an air-gapped device you can use a Windows, Linux or MacOS machine. Linux includes Raspberry Pi.

=== Download the tools ===
To download the tools you need a second, networked computer. The tools are called ''keysmith'' and ''quill.'' We describe here how to find and download a binary for your architecture. If you want to compile the tools yourself then we provide more information for you at the end of the document (TODO).

Binaries are available for the following hardware architectures. Here, architecture refers to the air-gapped computer, not the networked computer.
{| class="wikitable"
|+
!Hardware
!keysmith
!quill
|-
|Mac, Intel silicon
|darwin-amd64
|macos-x86_64
|-
|Mac, Apple silicon (M1)
|darwin-arm64
| -
|-
|Linux (x86)
|linux-amd64
|linux-x86_64
|-
|Raspberry Pi
|linux-arm32
|arm_32
|-
|Linux (arm)
|linux-arm64
| -
|-
|Windows
|windows-amd64
|windows-x86_64
|}
==== Download keysmith ====

Go to [https://github.com/dfinity/keysmith/releases/ keysmith], choose the latest release (currently v1.6.2) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

==== Download quill ====

Go to [https://github.com/dfinity/quill/releases quill] , choose the latest release (must be >= 0.2.12) and fetch the executable file that matches the air-gapped machine's architecture in the table above.

=== Copy to air-gapped machine ===

Copy the keysmith .tar.gz file and the quill executable from the networked machine to the air-gapped machine. For example, you can do so with a USB drive.

=== Verify the hashes ===

On the air-gapped machine, go to the terminal. Change the directory to the folder where the keysmith .tar.gz files and quill executables are. Compute the SHA256 hashes with the commands<syntaxhighlight lang="bash">
openssl dgst -sha256 keysmith-*
</syntaxhighlight>and<syntaxhighlight lang="bash">
openssl dgst -sha256 quill-*
</syntaxhighlight>The hashes should match the following entries:<syntaxhighlight lang="bash">
SHA256(keysmith-darwin-amd64.tar.gz)= a53bad6fa36c1eb35cd36059ffe9cbf4c063b515e47ccf666b7e1c174a7d1088
SHA256(keysmith-darwin-arm64.tar.gz)= 47932452353fe7f921b4ac41828dd19530ae0c4bdb72bcbb016a0715ca80e879
SHA256(keysmith-linux-amd64.tar.gz)= cb283dac031d8676f25e72d19115be347d2b85c864a17dd563104bf496b14a06
SHA256(keysmith-linux-arm32.tar.gz)= b28670e2b3483ea9f9ba691e9f76f99df31b2678db33b69c888fb08b634de162
SHA256(keysmith-linux-arm64.tar.gz)= ebe9cde3cf440ebbfb53dd10bf7f412cbff8b089551100ee0fa48f3ac9bd66c3
SHA256(keysmith-windows-amd64.tar.gz)= 1ef9b77ccaae980aad4a227fe1a817821245da491a90f0e6ad323426b49ae40a
</syntaxhighlight>and<syntaxhighlight lang="bash">
SHA256(quill-arm_32)= ebe2506e4dc4422e7670094e8b2b1d854a3b3c317b25c1c88990853d3d85c064
SHA256(quill-linux-x86_64)= 18fc671ee8c96b367875b39470073d68db78d32d242d14d4682025ef2a5d9ad4
SHA256(quill-macos-x86_64)= 97c373ab871be377ac784faff089ca26d23c37725230fb36d78f17d7a73b0867
SHA256(quill-windows-x86_64.exe)= 2542244c9ad3a9baf54bc2227e8c71ea8a8fb9f7e6065cc7a848c7b1cdce906e
</syntaxhighlight>

=== Unpack and install ===

For keysmith:<syntaxhighlight lang="bash">
tar -f keysmith-*.tar* -x
sudo install -d /usr/local/bin
sudo install keysmith /usr/local/bin
</syntaxhighlight>You will be prompted to enter your laptop password. The password itself will not appear, simply type it and press enter.

For quill:<syntaxhighlight lang="bash">
mv quill-arm_32 quill
sudo install quill /usr/local/bin
</syntaxhighlight>

== Produce the private key file with keysmith ==

=== Test the installation ===
On the air-gapped computer run:<syntaxhighlight lang="bash">
keysmith
</syntaxhighlight>You should see:<syntaxhighlight lang="bash">
usage: keysmith <command> [<args>]

Available Commands:
account Print your account identifier.
generate Generate your mnemonic seed and write it to a file.
legacy-address Print your legacy address.
principal Print your principal identifier.
private-key Derive your private key and write it to a file.
public-key Print your public key.
shortlist Print the available commands.
version Print the version number.
x-private-key Derive your extended private key and write it to a file.
x-public-key Print your extended public key.
</syntaxhighlight>If you are using macOS, running <code>keysmith</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Enter your mnemonic phrase (aka "seed") ===

If you confident that your environment is secure, then you are ready to enter your seed for use with <code>keysmith</code>. For the duration of your session, you store your seed phrase in an environment variable. It will be eliminated from your system when you turn your computer off.
<syntaxhighlight lang="bash">
read seed
</syntaxhighlight>
Enter your seed phrase and finish with Return.

If you prefer to not have your seed phrase displayed as you type then use this command instead:<syntaxhighlight lang="bash">
read -s seed
</syntaxhighlight>

=== Optional: check your legacy address and balance ===

At this point you can already verify your legacy address and ICPT balance. The legacy address matches to what was formerly called "DFN address" in the Dfinity Chrome extension. You may have copied it from the Chrome extension for your records back when you used the extension.
<syntaxhighlight lang="bash">
echo $seed | keysmith legacy-address -f -
</syntaxhighlight>
The output is a 40 character hex string. It looks something like this:
<syntaxhighlight lang="bash">
2d89d96b10f7a9456a9154b2f5309ee70df5bce1
</syntaxhighlight>
You can check your ICPT balance as follows: Go to https://ic.rocks/principal/renrk-eyaaa-aaaaa-aaada-cai, look for "Canister interface" and the method "balance". There, paste your DFN address in to the field labeled "text" and click the button labeled "Query". Your ICP balance will appear below "nat32".

=== Create your private key (.pem file) ===

Derive your private key from your seed phrase.
<syntaxhighlight lang="bash">echo $seed | keysmith private-key -f -</syntaxhighlight>
This creates a file <code>identity.pem</code> containing your private key.

== Run quill ==

=== Test the installation ===
On the air-gapped computer run:
quill
You should see:<syntaxhighlight lang="bash">
quill 0.2.12

Ledger & Governance ToolKit for cold wallets

USAGE:
quill [OPTIONS] <SUBCOMMAND>

OPTIONS:
-h, --help Print help information
--pem-file <PEM_FILE> Path to your PEM file (use "-" for STDIN)
-V, --version Print version information

SUBCOMMANDS:
account-balance Queries a ledger account balance
claim-neurons Claim seed neurons from the Genesis Token Canister
get-proposal-info
help Print this message or the help of the given subcommand(s)
list-neurons Signs the query for all neurons belonging to the signin principal
list-proposals
neuron-manage Signs a neuron configuration change
neuron-stake Signs topping up of a neuron (new or existing)
public-ids Prints the principal id and the account id
send Sends a signed message or a set of messages
transfer Signs an ICP transfer transaction
</syntaxhighlight>If you are using macOS, running <code>quill</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Sign the claim request ===

On the air-gapped computer run:<syntaxhighlight lang="bash">
quill --pem-file identity.pem claim-neurons >msg.json

</syntaxhighlight>

=== Submit the claim to the IC ===

==== Option 1: With quill on the networked computer ====

Copy the resulting file `msg.json` back to the networked computer. On the networked computer, change into the directory where `msg.json` is and run:<syntaxhighlight lang="bash">
quill send msg.json
</syntaxhighlight>Your neurons should now be claimed.

You can double-check if you claim was successful in the following way: Go to https://ic.rocks/genesis/2d89d96b10f7a9456a9154b2f5309ee70df5bce1 where you replace <code>2d89d96b10f7a9456a9154b2f5309ee70df5bce1</code> with your own DFN address. Under "Status" you should see "Claimed".

==== Option 2: Use the QR scanner app ====

* Install <code>qrencode</code>
* Run <code>cat msg.json | gzip -c | base64 | qrencode -o msg.png</code>
* Open <code>msg.png</code> in an image viewer
* Open scanner app in a browser on a phone: https://p5deo-6aaaa-aaaab-aaaxq-cai.raw.ic0.app
* Scan QR code and submit

=== Clean up the air-gapped computer ===

If your claim was successful then do not forget to remove the g <code>.pem</code> file on the air-gapped computer:<syntaxhighlight lang="bash">
rm identity.pem

</syntaxhighlight>

How-To: Claim neurons for seed participants

2021-11-20T09:46:02Z

Timo:

You are a ''seed participant'' if you donated to the DFINITY foundation in February of 2017. At that time, 30 tokens per Swiss Franc of value donated were allotted to your key. These tokens are now called "ICP tokens" or, shortly, "ICP".

At Genesis Unlock your ICP were disbursed to you in the form of a basket of 49 voting [[Network Nervous System|neurons]]. These neurons already exist inside the [[Network Nervous System]]. Your neurons contain the ICP you have been awarded, staked inside.

Your neurons have been configured to vote automatically and are already earning voting rewards for you. You do not need to do anything to initialize your neurons in order to continue earning voting rewards.

The 49 neurons created for you have dissolve [[Network Nervous System|delays]] of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

We are pleased to inform you that your neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases your voting power and the voting rewards you receive.

To control your neurons you must use the same secret key that you generated when the donation was made. It was recorded as a 12-word mnemonic phrase. In order to control your neurons you need to first ''claim'' the whole basket. This article explains how to do the claiming. For how to control your neurons after claiming them see this [[Tutorial: Neuron control|tutorial]].

== Claiming with a Ledger Nano device ==

'''Coming soon.''' This will come with the next update of the IC's app for the Ledger Nano. The current release can manage neurons but cannot yet claim them.

== Claiming with an air-gapped computer ==

Claiming requires access to your secret mnemonic phrase and to secret keys derived from it. It is highly advised that you use an air-gapped computer for the purpose of claiming. If you are not comfortable with such a setup or with any of the following steps then you have to wait for the next release of the IC's app for the Ledger Nano device.

As an air-gapped device you can use a Windows, Linux or MacOS machine. Linux includes Raspberry Pi.

=== Download the tools ===
To download the tools you need a second, networked computer. The tools are called ''keysmith'' and ''quill.'' We describe here how to find and download a binary for your architecture. If you want to compile the tools yourself then we provide more information for you at the end of the document (TODO).

Binaries are available for the following hardware architectures. Here, architecture refers to the air-gapped computer, not the networked computer.
{| class="wikitable"
|+
!Hardware
!keysmith
!quill
|-
|Mac, Intel silicon
|darwin-amd64
|macos-x86_64
|-
|Mac, Apple silicon (M1)
|darwin-arm64
| -
|-
|Linux (x86)
|linux-amd64
|linux-x86_64
|-
|Raspberry Pi
|linux-arm32
|arm_32
|-
|Linux (arm)
|linux-arm64
| -
|-
|Windows
|windows-amd64
|windows-x86_64
|}
==== Download keysmith ====

Go to [https://github.com/dfinity/keysmith/releases/ keysmith], choose the latest release (currently v1.6.2) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

==== Download quill ====

Go to [https://github.com/dfinity/quill/releases quill] , choose the latest release (must be >= 0.2.12) and fetch the executable file that matches the air-gapped machine's architecture in the table above.

=== Copy to air-gapped machine ===

Copy the keysmith .tar.gz file and the quill executable from the networked machine to the air-gapped machine. For example, you can do so with a USB drive.

=== Verify the hashes ===

On the air-gapped machine, go to the terminal. Change the directory to the folder where the keysmith .tar.gz files and quill executables are. Compute the SHA256 hashes with the commands<syntaxhighlight lang="bash">
openssl dgst -sha256 keysmith-*
</syntaxhighlight>and<syntaxhighlight lang="bash">
openssl dgst -sha256 quill-*
</syntaxhighlight>The hashes should match the following entries:<syntaxhighlight lang="bash">
SHA256(keysmith-darwin-amd64.tar.gz)= a53bad6fa36c1eb35cd36059ffe9cbf4c063b515e47ccf666b7e1c174a7d1088
SHA256(keysmith-darwin-arm64.tar.gz)= 47932452353fe7f921b4ac41828dd19530ae0c4bdb72bcbb016a0715ca80e879
SHA256(keysmith-linux-amd64.tar.gz)= cb283dac031d8676f25e72d19115be347d2b85c864a17dd563104bf496b14a06
SHA256(keysmith-linux-arm32.tar.gz)= b28670e2b3483ea9f9ba691e9f76f99df31b2678db33b69c888fb08b634de162
SHA256(keysmith-linux-arm64.tar.gz)= ebe9cde3cf440ebbfb53dd10bf7f412cbff8b089551100ee0fa48f3ac9bd66c3
SHA256(keysmith-windows-amd64.tar.gz)= 1ef9b77ccaae980aad4a227fe1a817821245da491a90f0e6ad323426b49ae40a
</syntaxhighlight>and<syntaxhighlight lang="bash">
SHA256(quill-arm_32)= ebe2506e4dc4422e7670094e8b2b1d854a3b3c317b25c1c88990853d3d85c064
SHA256(quill-linux-x86_64)= 18fc671ee8c96b367875b39470073d68db78d32d242d14d4682025ef2a5d9ad4
SHA256(quill-macos-x86_64)= 97c373ab871be377ac784faff089ca26d23c37725230fb36d78f17d7a73b0867
SHA256(quill-windows-x86_64.exe)= 2542244c9ad3a9baf54bc2227e8c71ea8a8fb9f7e6065cc7a848c7b1cdce906e
</syntaxhighlight>

=== Unpack and install ===

For keysmith:<syntaxhighlight lang="bash">
tar -f keysmith-*.tar* -x
sudo install -d /usr/local/bin
sudo install keysmith /usr/local/bin
</syntaxhighlight>You will be prompted to enter your laptop password. The password itself will not appear, simply type it and press enter.

For quill:<syntaxhighlight lang="bash">
mv quill-arm_32 quill
sudo install quill /usr/local/bin
</syntaxhighlight>

== Produce the private key file with keysmith ==

=== Test the installation ===
On the air-gapped computer run:<syntaxhighlight lang="bash">
keysmith
</syntaxhighlight>You should see:<syntaxhighlight lang="bash">
usage: keysmith <command> [<args>]

Available Commands:
account Print your account identifier.
generate Generate your mnemonic seed and write it to a file.
legacy-address Print your legacy address.
principal Print your principal identifier.
private-key Derive your private key and write it to a file.
public-key Print your public key.
shortlist Print the available commands.
version Print the version number.
x-private-key Derive your extended private key and write it to a file.
x-public-key Print your extended public key.
</syntaxhighlight>If you are using macOS, running <code>keysmith</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Enter your mnemonic phrase (aka "seed") ===

If you confident that your environment is secure, then you are ready to enter your seed for use with <code>keysmith</code>. For the duration of your session, you store your seed phrase in an environment variable. It will be eliminated from your system when you turn your computer off.
<syntaxhighlight lang="bash">
read seed
</syntaxhighlight>
Enter your seed phrase and finish with Return.

If you prefer to not have your seed phrase displayed as you type then use this command instead:<syntaxhighlight lang="bash">
read -s seed
</syntaxhighlight>

=== Optional: check your legacy address and balance ===

At this point you can already verify your legacy address and ICPT balance. The legacy address matches to what was formerly called "DFN address" in the Dfinity Chrome extension. You may have copied it from the Chrome extension for your records back when you used the extension.
<syntaxhighlight lang="bash">
echo $seed | keysmith legacy-address -f -
</syntaxhighlight>
The output is a 40 character hex string. It looks something like this:
<syntaxhighlight lang="bash">
2d89d96b10f7a9456a9154b2f5309ee70df5bce1
</syntaxhighlight>
You can check your ICPT balance as follows: Go to https://ic.rocks/principal/renrk-eyaaa-aaaaa-aaada-cai, look for "Canister interface" and the method "balance". There, paste your DFN address in to the field labeled "text" and click the button labeled "Query". Your ICP balance will appear below "nat32".

=== Create your private key (.pem file) ===

Derive your private key from your seed phrase.
<syntaxhighlight lang="bash">echo $seed | keysmith private-key -f -</syntaxhighlight>
This creates a file <code>identity.pem</code> containing your private key.

== Run quill ==

=== Test the installation ===
On the air-gapped computer run:
quill
You should see:<syntaxhighlight lang="bash">
quill 0.2.12

Ledger & Governance ToolKit for cold wallets

USAGE:
quill [OPTIONS] <SUBCOMMAND>

OPTIONS:
-h, --help Print help information
--pem-file <PEM_FILE> Path to your PEM file (use "-" for STDIN)
-V, --version Print version information

SUBCOMMANDS:
account-balance Queries a ledger account balance
claim-neurons Claim seed neurons from the Genesis Token Canister
get-proposal-info
help Print this message or the help of the given subcommand(s)
list-neurons Signs the query for all neurons belonging to the signin principal
list-proposals
neuron-manage Signs a neuron configuration change
neuron-stake Signs topping up of a neuron (new or existing)
public-ids Prints the principal id and the account id
send Sends a signed message or a set of messages
transfer Signs an ICP transfer transaction
</syntaxhighlight>If you are using macOS, running <code>quill</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Sign the claim request ===

On the air-gapped computer run:<syntaxhighlight lang="bash">
quill --pem-file identity.pem claim-neurons >msg.json

</syntaxhighlight>

=== Submit the claim to the IC ===

==== Option 1: With quill on the networked computer ====

Copy the resulting file `msg.json` back to the networked computer. On the networked computer, change into the directory where `msg.json` is and run:<syntaxhighlight lang="bash">
quill send msg.json
</syntaxhighlight>Your neurons should now be claimed.

You can double-check if you claim was successful in the following way: Go to https://ic.rocks/genesis/2d89d96b10f7a9456a9154b2f5309ee70df5bce1 where you replace 2d89d96b10f7a9456a9154b2f5309ee70df5bce1 with your own DFN address. Under "Status" you should see "Claimed".

==== Option 2: Use the QR scanner app ====

* Install qrencode
* Run cat msg.json | gzip -c | base64 | qrencode -o msg.png
* Open msg.png in an image viewer
* Use scanner app on a phone: https://p5deo-6aaaa-aaaab-aaaxq-cai.raw.ic0.app
* Scan QR code and submit

=== Clean up the air-gapped computer ===

If your claim was successful then do not forget to remove the g <code>.pem</code> file on the air-gapped computer:<syntaxhighlight lang="bash">
rm identity.pem

</syntaxhighlight>

How-To: Claim neurons for seed participants

2021-11-20T09:42:16Z

Timo:

You are a ''seed participant'' if you donated to the DFINITY foundation in February of 2017. At that time, 30 tokens per Swiss Franc of value donated were allotted to your key. These tokens are now called "ICP tokens" or, shortly, "ICP".

At Genesis Unlock your ICP were disbursed to you in the form of a basket of 49 voting [[Network Nervous System|neurons]]. These neurons already exist inside the [[Network Nervous System]]. Your neurons contain the ICP you have been awarded, staked inside.

Your neurons have been configured to vote automatically and are already earning voting rewards for you. You do not need to do anything to initialize your neurons in order to continue earning voting rewards.

The 49 neurons created for you have dissolve [[Network Nervous System|delays]] of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

We are pleased to inform you that your neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases your voting power and the voting rewards you receive.

To control your neurons you must use the same secret key that you generated when the donation was made. It was recorded as a 12-word mnemonic phrase. In order to control your neurons you need to first ''claim'' the whole basket. This article explains how to do the claiming. For how to control your neurons after claiming them see this [[Tutorial: Neuron control|tutorial]].

== Claiming with a Ledger Nano device ==

'''Coming soon.''' This will come with the next update of the IC's app for the Ledger Nano. The current release can manage neurons but cannot yet claim them.

== Claiming with an air-gapped computer ==

Claiming requires access to your secret mnemonic phrase and to secret keys derived from it. It is highly advised that you use an air-gapped computer for the purpose of claiming. If you are not comfortable with such a setup or with any of the following steps then you have to wait for the next release of the IC's app for the Ledger Nano device.

As an air-gapped device you can use a Windows, Linux or MacOS machine. Linux includes Raspberry Pi.

=== Download the tools ===
To download the tools you need a second, networked computer. The tools are called ''keysmith'' and ''quill.'' We describe here how to find and download a binary for your architecture. If you want to compile the tools yourself then we provide more information for you at the end of the document (TODO).

Binaries are available for the following hardware architectures. Here, architecture refers to the air-gapped computer, not the networked computer.
{| class="wikitable"
|+
!Hardware
!keysmith
!quill
|-
|Mac, Intel silicon
|darwin-amd64
|macos-x86_64
|-
|Mac, Apple silicon (M1)
|darwin-arm64
| -
|-
|Linux (x86)
|linux-amd64
|linux-x86_64
|-
|Raspberry Pi
|linux-arm32
|arm_32
|-
|Linux (arm)
|linux-arm64
| -
|-
|Windows
|windows-amd64
|windows-x86_64
|}
==== Download keysmith ====

Go to [https://github.com/dfinity/keysmith/releases/ keysmith], choose the latest release (currently v1.6.2) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

==== Download quill ====

Go to [https://github.com/dfinity/quill/releases quill] , choose the latest release (must be >= 0.2.12) and fetch the executable file that matches the air-gapped machine's architecture in the table above.

=== Copy to air-gapped machine ===

Copy the keysmith .tar.gz file and the quill executable from the networked machine to the air-gapped machine. For example, you can do so with a USB drive.

=== Verify the hashes ===

On the air-gapped machine, go to the terminal. Change the directory to the folder where the keysmith .tar.gz files and quill executables are. Compute the SHA256 hashes with the commands<syntaxhighlight lang="bash">
openssl dgst -sha256 keysmith-*
</syntaxhighlight>and<syntaxhighlight lang="bash">
openssl dgst -sha256 quill-*
</syntaxhighlight>The hashes should match the following entries:<syntaxhighlight lang="bash">
SHA256(keysmith-darwin-amd64.tar.gz)= a53bad6fa36c1eb35cd36059ffe9cbf4c063b515e47ccf666b7e1c174a7d1088
SHA256(keysmith-darwin-arm64.tar.gz)= 47932452353fe7f921b4ac41828dd19530ae0c4bdb72bcbb016a0715ca80e879
SHA256(keysmith-linux-amd64.tar.gz)= cb283dac031d8676f25e72d19115be347d2b85c864a17dd563104bf496b14a06
SHA256(keysmith-linux-arm32.tar.gz)= b28670e2b3483ea9f9ba691e9f76f99df31b2678db33b69c888fb08b634de162
SHA256(keysmith-linux-arm64.tar.gz)= ebe9cde3cf440ebbfb53dd10bf7f412cbff8b089551100ee0fa48f3ac9bd66c3
SHA256(keysmith-windows-amd64.tar.gz)= 1ef9b77ccaae980aad4a227fe1a817821245da491a90f0e6ad323426b49ae40a
</syntaxhighlight>and<syntaxhighlight lang="bash">
SHA256(quill-arm_32)= ebe2506e4dc4422e7670094e8b2b1d854a3b3c317b25c1c88990853d3d85c064
SHA256(quill-linux-x86_64)= 18fc671ee8c96b367875b39470073d68db78d32d242d14d4682025ef2a5d9ad4
SHA256(quill-macos-x86_64)= 97c373ab871be377ac784faff089ca26d23c37725230fb36d78f17d7a73b0867
SHA256(quill-windows-x86_64.exe)= 2542244c9ad3a9baf54bc2227e8c71ea8a8fb9f7e6065cc7a848c7b1cdce906e
</syntaxhighlight>

=== Unpack and install ===

For keysmith:<syntaxhighlight lang="bash">
tar -f keysmith-*.tar* -x
sudo install -d /usr/local/bin
sudo install keysmith /usr/local/bin
</syntaxhighlight>You will be prompted to enter your laptop password. The password itself will not appear, simply type it and press enter.

For quill:<syntaxhighlight lang="bash">
mv quill-arm_32 quill
sudo install quill /usr/local/bin
</syntaxhighlight>

== Produce the private key file with keysmith ==

=== Test the installation ===
On the air-gapped computer run:<syntaxhighlight lang="bash">
keysmith
</syntaxhighlight>You should see:<syntaxhighlight lang="bash">
usage: keysmith <command> [<args>]

Available Commands:
account Print your account identifier.
generate Generate your mnemonic seed and write it to a file.
legacy-address Print your legacy address.
principal Print your principal identifier.
private-key Derive your private key and write it to a file.
public-key Print your public key.
shortlist Print the available commands.
version Print the version number.
x-private-key Derive your extended private key and write it to a file.
x-public-key Print your extended public key.
</syntaxhighlight>If you are using macOS, running <code>keysmith</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Enter your mnemonic phrase (aka "seed") ===

If you confident that your environment is secure, then you are ready to enter your seed for use with <code>keysmith</code>. For the duration of your session, you store your seed phrase in an environment variable. It will be eliminated from your system when you turn your computer off.
<syntaxhighlight lang="bash">
read seed
</syntaxhighlight>
Enter your seed phrase and finish with Return.

If you prefer to not have your seed phrase displayed as you type then use this command instead:<syntaxhighlight lang="bash">
read -s seed
</syntaxhighlight>

=== Optional: check your legacy address and balance ===

At this point you can already verify your legacy address and ICPT balance. The legacy address matches to what was formerly called "DFN address" in the Dfinity Chrome extension. You may have copied it from the Chrome extension for your records back when you used the extension.
<syntaxhighlight lang="bash">
echo $seed | keysmith legacy-address -f -
</syntaxhighlight>
The output is a 40 character hex string. It looks something like this:
<syntaxhighlight lang="bash">
2d89d96b10f7a9456a9154b2f5309ee70df5bce1
</syntaxhighlight>
You can check your ICPT balance as follows: Go to https://ic.rocks/principal/renrk-eyaaa-aaaaa-aaada-cai, look for "Canister interface" and the method "balance". There, paste your DFN address in to the field labeled "text" and click the button labeled "Query". Your ICP balance will appear below "nat32".

=== Create your private key (.pem file) ===

Derive your private key from your seed phrase.
<syntaxhighlight lang="bash">echo $seed | keysmith private-key -f -</syntaxhighlight>
This creates a file <code>identity.pem</code> containing your private key.

== Run quill ==

=== Test the installation ===
On the air-gapped computer run:
quill
You should see:<syntaxhighlight lang="bash">
quill 0.2.12

Ledger & Governance ToolKit for cold wallets

USAGE:
quill [OPTIONS] <SUBCOMMAND>

OPTIONS:
-h, --help Print help information
--pem-file <PEM_FILE> Path to your PEM file (use "-" for STDIN)
-V, --version Print version information

SUBCOMMANDS:
account-balance Queries a ledger account balance
claim-neurons Claim seed neurons from the Genesis Token Canister
get-proposal-info
help Print this message or the help of the given subcommand(s)
list-neurons Signs the query for all neurons belonging to the signin principal
list-proposals
neuron-manage Signs a neuron configuration change
neuron-stake Signs topping up of a neuron (new or existing)
public-ids Prints the principal id and the account id
send Sends a signed message or a set of messages
transfer Signs an ICP transfer transaction
</syntaxhighlight>If you are using macOS, running <code>quill</code> for the first time might require you to grant permission under System Preferences > Security & Privacy > General.

=== Sign the claim request ===

On the air-gapped computer run:<syntaxhighlight lang="bash">
quill --pem-file identity.pem claim-neurons >msg.json

</syntaxhighlight>

=== Submit the claim to the IC ===

==== Option 1: With quill on the networked computer ====

Copy the resulting file `msg.json` back to the networked computer. On the networked computer, change into the directory where `msg.json` is and run:<syntaxhighlight lang="bash">
quill send msg.json
</syntaxhighlight>Your neurons should now be claimed.

You can double-check if you claim was successful in the following way: Go to https://ic.rocks/genesis/2d89d96b10f7a9456a9154b2f5309ee70df5bce1 where you replace 2d89d96b10f7a9456a9154b2f5309ee70df5bce1 with your own DFN address. Under "Status" you should see "Claimed".

==== Option 2: Use the QR scanner app ====

=== Clean up the air-gapped computer ===

If your claim was successful then do not forget to remove the g <code>.pem</code> file on the air-gapped computer:<syntaxhighlight lang="bash">
rm identity.pem

</syntaxhighlight>

How-To: Claim neurons for seed participants

2021-11-20T08:05:03Z

Timo:

You are a ''seed participant'' if you donated to the DFINITY foundation in February of 2017. At that time, 30 tokens per Swiss Franc of value donated were allotted to your key. These tokens are now called "ICP tokens" or, shortly, "ICP".

At Genesis Unlock your ICP were disbursed to you in the form of a basket of 49 voting [[Network Nervous System|neurons]]. These neurons already exist inside the [[Network Nervous System]]. Your neurons contain the ICP you have been awarded, staked inside.

Your neurons have been configured to vote automatically and are already earning voting rewards for you. You do not need to do anything to initialize your neurons in order to continue earning voting rewards.

The 49 neurons created for you have dissolve [[Network Nervous System|delays]] of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

We are pleased to inform you that your neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases your voting power and the voting rewards you receive.

To control your neurons you must use the same secret key that you generated when the donation was made. It was recorded as a 12-word mnemonic phrase. In order to control your neurons you need to first ''claim'' the whole basket. This article explains how to do the claiming. For how to control your neurons after claiming them see this [[Tutorial: Neuron control|tutorial]].

== Claiming with a Ledger Nano device ==

'''Coming soon.''' This will come with the next update of the IC's app for the Ledger Nano. The current release can manage neurons but cannot yet claim them.

== Claiming with an air-gapped computer ==

Claiming requires access to your secret mnemonic phrase and to secret keys derived from it. It is highly advised that you use an air-gapped computer for the purpose of claiming. If you are not comfortable with such a setup or with any of the following steps then you have to wait for the next release of the IC's app for the Ledger Nano device.

As an air-gapped device you can use a Windows, Linux or MacOS machine. Linux includes Raspberry Pi.

=== Download the tools ===
To download the tools you need a second, networked computer. The tools are called ''keysmith'' and ''quill.'' We describe here how to find and download a binary for your architecture. If you want to compile the tools yourself then we provide more information for you at the end of the document (TODO).

Binaries are available for the following hardware architectures. Here, architecture refers to the air-gapped computer, not the networked computer.
{| class="wikitable"
|+
!Hardware
!keysmith
!quill
|-
|Mac, Intel silicon
|darwin-amd64
|macos-x86_64
|-
|Mac, Apple silicon (M1)
|darwin-arm64
| -
|-
|Linux (x86)
|linux-amd64
|linux-x86_64
|-
|Raspberry Pi
|linux-arm32
|arm_32
|-
|Linux (arm)
|linux-arm64
| -
|-
|Windows
|windows-amd64
|windows-x86_64
|}
==== Download keysmith ====

Go to [https://github.com/dfinity/keysmith/releases/ keysmith], choose the latest release (currently v1.6.2) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

==== Download quill ====

Go to [https://github.com/dfinity/quill/releases quill] , choose the latest release (must be >= 0.2.12) and fetch the executable file that matches the air-gapped machine's architecture in the table above.

=== Copy to air-gapped machine ===

Copy the keysmith .tar.gz file and the quill executable from the networked machine to the air-gapped machine. For example, you can do so with a USB drive.

=== Verify the hashes ===

On the air-gapped machine, go to the terminal. Change the directory to the folder where the keysmith .tar.gz files and quill executables are. Compute the SHA256 hashes with the commands<syntaxhighlight lang="bash">
openssl dgst -sha256 keysmith-*
</syntaxhighlight>and<syntaxhighlight lang="bash">
openssl dgst -sha256 quill-*
</syntaxhighlight>The hashes should match the following entries:<syntaxhighlight lang="bash">
SHA256(keysmith-darwin-amd64.tar.gz)= a53bad6fa36c1eb35cd36059ffe9cbf4c063b515e47ccf666b7e1c174a7d1088
SHA256(keysmith-darwin-arm64.tar.gz)= 47932452353fe7f921b4ac41828dd19530ae0c4bdb72bcbb016a0715ca80e879
SHA256(keysmith-linux-amd64.tar.gz)= cb283dac031d8676f25e72d19115be347d2b85c864a17dd563104bf496b14a06
SHA256(keysmith-linux-arm32.tar.gz)= b28670e2b3483ea9f9ba691e9f76f99df31b2678db33b69c888fb08b634de162
SHA256(keysmith-linux-arm64.tar.gz)= ebe9cde3cf440ebbfb53dd10bf7f412cbff8b089551100ee0fa48f3ac9bd66c3
SHA256(keysmith-windows-amd64.tar.gz)= 1ef9b77ccaae980aad4a227fe1a817821245da491a90f0e6ad323426b49ae40a
</syntaxhighlight>and<syntaxhighlight lang="bash">
SHA256(quill-arm_32)= ebe2506e4dc4422e7670094e8b2b1d854a3b3c317b25c1c88990853d3d85c064
SHA256(quill-linux-x86_64)= 18fc671ee8c96b367875b39470073d68db78d32d242d14d4682025ef2a5d9ad4
SHA256(quill-macos-x86_64)= 97c373ab871be377ac784faff089ca26d23c37725230fb36d78f17d7a73b0867
SHA256(quill-windows-x86_64.exe)= 2542244c9ad3a9baf54bc2227e8c71ea8a8fb9f7e6065cc7a848c7b1cdce906e
</syntaxhighlight>

=== Unpack and install ===

For keysmith:<syntaxhighlight lang="bash">
tar -f keysmith-*.tar* -x
sudo install -d /usr/local/bin
sudo install keysmith /usr/local/bin
</syntaxhighlight>You will be prompted to enter your laptop password. The password itself will not appear, simply type it and press enter.

For quill:<syntaxhighlight lang="bash">
sudo install quill /usr/local/bin
</syntaxhighlight>

== Run keysmith ==
<syntaxhighlight lang="bash">
keysmith
</syntaxhighlight>You should see:<syntaxhighlight lang="bash">
usage: keysmith <command> [<args>]

Available Commands:
account Print your account identifier.
generate Generate your mnemonic seed and write it to a file.
legacy-address Print your legacy address.
principal Print your principal identifier.
private-key Derive your private key and write it to a file.
public-key Print your public key.
shortlist Print the available commands.
version Print the version number.
x-private-key Derive your extended private key and write it to a file.
x-public-key Print your extended public key.
</syntaxhighlight>If you are using macOS, making the <code>keysmith</code> binary executable might require you to change a permission setting using System Preferences > Security & Privacy > General.

=== Enter your mnemonic phrase (aka "seed") ===

If you confident that your environment is secure, then you are ready to enter your seed for use with <code>keysmith</code>. For the duration of your session, you store your seed phrase in an environment variable. It will be eliminated from your system when you turn your computer off.
<syntaxhighlight lang="bash">
read seed
</syntaxhighlight>
Enter your seed phrase and finish with Return.

If you prefer to not have your seed phrase displayed as you type then use this command instead:<syntaxhighlight lang="bash">
read -s seed
</syntaxhighlight>

=== Optional: check your legacy address and balance ===

At this point you can already verify your legacy address and ICPT balance. The legacy address matches to what was formerly called "DFN address" in the Dfinity Chrome extension. You may have copied it from the Chrome extension for your records back when you used the extension.
<syntaxhighlight lang="bash">
echo $seed | keysmith legacy-address -f -
</syntaxhighlight>
The output is a 40 character hex string. It looks something like this:
<syntaxhighlight lang="bash">
2d89d96b10f7a9456a9154b2f5309ee70df5bce1
</syntaxhighlight>
You can check your ICPT balance as follows: Go to https://ic.rocks/principal/renrk-eyaaa-aaaaa-aaada-cai, look for "Canister interface" and the method "balance". There, paste your DFN address in to the field labeled "text" and click the button labeled "Query". Your ICP balance will appear below "nat32".

=== Create your private key (.pem file) ===

Derive your private key from your seed phrase.
<syntaxhighlight lang="bash">echo $seed | keysmith private-key -f -</syntaxhighlight>
This creates a file <code>identity.pem</code> containing your private key.

== Run quill ==
On the air-gapped computer run:<syntaxhighlight lang="bash">
quill --pem-file identity.pem claim-neurons >msg.json

</syntaxhighlight>
Copy the resulting file `msg.json` back to the networked computer. On the networked computer, change into the directory where `msg.json` is and run:<syntaxhighlight lang="bash">
quill send msg.json
</syntaxhighlight>Your neurons should now be claimed.

You can double-check if you claim was successful in the following way: Go to https://ic.rocks/genesis/2d89d96b10f7a9456a9154b2f5309ee70df5bce1 where you replace 2d89d96b10f7a9456a9154b2f5309ee70df5bce1 with your own DFN address. Under "Status" you should see "Claimed".

If your claim was successful then do not forget to remove the .pem file on the air-gapped computer:<syntaxhighlight lang="bash">
rm identity.pem

</syntaxhighlight>

Network Nervous System

2021-11-20T07:52:56Z

Timo: Created page with "Various links: * [https://medium.com/dfinity/the-network-nervous-system-governing-the-internet-computer-1d176605d66a] * [https://dfinity.org/howitworks/network-nervous-system..."

Various links:

* [https://medium.com/dfinity/the-network-nervous-system-governing-the-internet-computer-1d176605d66a]
* [https://dfinity.org/howitworks/network-nervous-system-nns]

Internet Computer wiki

2021-11-20T07:51:42Z

Timo: /* Topics Central */

Welcome to the Internet Computer Wiki! Feel free to join in. All are welcome!
== Topics Central ==

* [[Internet computer]]
* [[Internet Computer vision]]
* [[Index of dapps on the Internet Computer]]
* [[ICP token]]
* [[Internet Identity]]
* [https://dashboard.internetcomputer.org/ Internet Computer dashboard]
* [[Internet Computer Performance]]
* [[DFINITY]]
* [[Custody, Staking, and Voting]]
*[[Network Nervous System]]
== For blockchain & crypto enthusiasts ==
* [[Myths and facts]]
* [https://www.reddit.com/r/dfinity/ r/dfinity]
* [[How to stake on the Internet computer]]
* [[Tokenomics of the Internet Computer]]
* [[Governance of the Internet Computer]]

== For dapp developers ==
* [[Internet Computer for dapp developers]]
* [[Canister smart contracts]]
* [https://forum.dfinity.org/ IC community developer forum]
* [[Best practices for a high traffic dapp launch]]
* [[Best practices for NFT drops]]

== For computer scientists ==
* [[The Internet Computer for Computer Scientists]]

== For node owners ==
* [[Internet Computer for node owners]]

== FAQs ==

* [[FAQ]]

'''Computer Scientists FAQ'''
* [[The Internet Computer for Computer Scientists]]
== How-Tos ==

* [[How-To: Claim neurons for seed participants]]

== Contributors ==

=== Housekeeping Rules ===

* Please refrain from redundancy, such as referring to the Internet Computer in article titles. This is, after all, the Internet Computer Wiki.
* Please carefully consider your use of capitalisation. Most words in titles should be capitalised. DFINITY is always stylised in all-caps.

=== How to Contribute ===
Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]

Use this page to test editing
* [[Test editing the Internet Computer Wiki]]

Number of articles: {{NUMBEROFARTICLES}}

How-To: Claim neurons for seed participants

2021-11-19T19:45:20Z

Timo:

You are a ''seed participant'' if you donated to the DFINITY foundation in February of 2017. At that time, 30 tokens per Swiss Franc of value donated were allotted to your key. These tokens are now called "ICP tokens" or, shortly, "ICP".

At Genesis Unlock your ICP were then disbursed to you in the form of a basket of 49 voting neurons (insert link "NNS" here). These neurons already exist inside the Network Nervous System (insert link "NNS" here). Your neurons contain the ICP you have been awarded, staked inside.

Your neurons have been configured to vote automatically and are already earning voting rewards for you. You do not need to do anything to initialize your neurons in order to continue earning voting rewards.

The 49 neurons created for you have dissolve delays (insert link "NNS" here) of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

We are pleased to inform you that your neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases your voting power and the voting rewards you receive.

To control your neurons you must use the same secret key that you generated when the donation was made. It was recorded as a 12-word mnemonic phrase. In order to control your neurons you need to first ''claim'' the whole basket. This article explains how to do the claiming. For how to control your neurons after claiming them see this article (insert link here).

== Claiming with a Ledger Nano device ==

'''Coming soon.''' This will come with the next update of the IC's app for the Ledger Nano. The current release can manage neurons but cannot yet claim them.

== Claiming with an air-gapped computer ==

Claiming requires access to your secret mnemonic phrase and to secret keys derived from it. It is highly advised that you use an air-gapped computer for the purpose of claiming. If you are not comfortable with such a setup or with any of the following steps then you have to wait for the next release of the IC's app for the Ledger Nano device.

As an air-gapped device you can use a Windows, Linux or MacOS machine. Linux includes Raspberry Pi.

=== Download the tools ===
To download the tools you need a second, networked computer. The tools are called ''keysmith'' and ''quill.'' We describe here how to find and download a binary for your architecture. If you want to compile the tools yourself then we provide more information for you at the end of the document (TODO).

Binaries are available for the following hardware architectures. Here, architecture refers to the air-gapped computer, not the networked computer.
{| class="wikitable"
|+
!Hardware
!keysmith
!quill
|-
|Mac, Intel silicon
|darwin-amd64
|macos-x86_64
|-
|Mac, Apple silicon (M1)
|darwin-arm64
|not available
|-
|Linux (x86)
|linux-amd64
|linux-x86_64
|-
|Raspberry Pi
|linux-arm32
|arm_32
|-
|Linux (arm)
|linux-arm64
|not available
|-
|Windows
|windows-amd64
|windows-x86_64
|}
==== Download keysmith ====

Go to [https://github.com/dfinity/keysmith/releases/ keysmith], choose the latest release (currently v1.6.2) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

==== Download quill ====

Go to [https://github.com/dfinity/quill/releases quill] , choose the latest release (must be >= 0.2.12) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

=== Copy to air-gapped machine ===

Copy the .tar.gz files from the networked machine to the air-gapped machine. For example, you can do so with a USB drive.

=== Verify the hashes ===

On the air-gapped machine, go to the terminal. Change the directory to the folder where the .tar.gz files are. Compute the SHA256 hashes with the commands<syntaxhighlight lang="bash">
openssl dgst -sha256 keysmith-*.tar*
</syntaxhighlight>and<syntaxhighlight lang="bash">
openssl dgst -sha256 quill-*.tar*
</syntaxhighlight>The hashes should match the following entries:<syntaxhighlight lang="bash">
SHA256(keysmith-darwin-amd64.tar.gz)= a53bad6fa36c1eb35cd36059ffe9cbf4c063b515e47ccf666b7e1c174a7d1088
SHA256(keysmith-darwin-arm64.tar.gz)= 47932452353fe7f921b4ac41828dd19530ae0c4bdb72bcbb016a0715ca80e879
SHA256(keysmith-linux-amd64.tar.gz)= cb283dac031d8676f25e72d19115be347d2b85c864a17dd563104bf496b14a06
SHA256(keysmith-linux-arm32.tar.gz)= b28670e2b3483ea9f9ba691e9f76f99df31b2678db33b69c888fb08b634de162
SHA256(keysmith-linux-arm64.tar.gz)= ebe9cde3cf440ebbfb53dd10bf7f412cbff8b089551100ee0fa48f3ac9bd66c3
SHA256(keysmith-windows-amd64.tar.gz)= 1ef9b77ccaae980aad4a227fe1a817821245da491a90f0e6ad323426b49ae40a
</syntaxhighlight>and

(enter quill hashes here)

=== Unpack and install ===

For keysmith:<syntaxhighlight lang="bash">
tar -f keysmith-*.tar* -x
sudo install -d /usr/local/bin
sudo install keysmith /usr/local/bin
</syntaxhighlight>You will be prompted to enter your laptop password. The password itself will not appear, simply type it and press enter.

For quill:<syntaxhighlight lang="bash">
tar -f quill-*.tar* -x
sudo install quill /usr/local/bin
</syntaxhighlight>

== Run keysmith ==
<syntaxhighlight lang="bash">
keysmith
</syntaxhighlight>You should see:<syntaxhighlight lang="bash">
usage: keysmith <command> [<args>]

Available Commands:
account Print your account identifier.
generate Generate your mnemonic seed and write it to a file.
legacy-address Print your legacy address.
principal Print your principal identifier.
private-key Derive your private key and write it to a file.
public-key Print your public key.
shortlist Print the available commands.
version Print the version number.
x-private-key Derive your extended private key and write it to a file.
x-public-key Print your extended public key.
</syntaxhighlight>If you are using macOS, making the <code>keysmith</code> binary executable might require you to change a permission setting using System Preferences > Security & Privacy > General.

=== Enter your mnemonic phrase (aka "seed") ===

If you confident that your environment is secure, then you are ready to enter your seed for use with <code>keysmith</code>. For the duration of your session, you store your seed phrase in an environment variable. It will be eliminated from your system when you turn your computer off.
<syntaxhighlight lang="bash">
read seed
</syntaxhighlight>
Enter your seed phrase and finish with Return.

If you prefer to not have your seed phrase displayed as you type then use this command instead:<syntaxhighlight lang="bash">
read -s seed
</syntaxhighlight>

=== Optional: check your legacy address and balance ===

At this point you can already verify your legacy address and ICPT balance. The legacy address matches to what was formerly called "DFN address" in the Dfinity Chrome extension. You may have copied it from the Chrome extension for your records back when you used the extension.
<syntaxhighlight lang="bash">
echo $seed | keysmith legacy-address -f -
</syntaxhighlight>
The output is a 40 character hex string. It looks something like this:
<syntaxhighlight lang="bash">
2d89d96b10f7a9456a9154b2f5309ee70df5bce1
</syntaxhighlight>
You can check your ICPT balance as follows: Go to https://ic.rocks/principal/renrk-eyaaa-aaaaa-aaada-cai, look for "Canister interface" and the method "balance". There, paste your DFN address in to the field labeled "text" and click the button labeled "Query". Your ICP balance will appear below "nat32".

=== Create your private key (.pem file) ===

Derive your private key from your seed phrase.
<syntaxhighlight lang="bash">echo $seed | keysmith private-key -f -</syntaxhighlight>
This creates a file <code>identity.pem</code> containing your private key.

== Run quill ==
On the air-gapped computer run:<syntaxhighlight lang="bash">
quill --pem-file identity.pem claim-neurons >msg.json

</syntaxhighlight>
Copy the resulting file `msg.json` back to the networked computer. On the networked computer, change into the directory where `msg.json` is and run:<syntaxhighlight lang="bash">
quill send msg.json
</syntaxhighlight>Your neurons should now be claimed.

You can double-check if you claim was successful in the following way: Go to https://ic.rocks/genesis/2d89d96b10f7a9456a9154b2f5309ee70df5bce1 where you replace 2d89d96b10f7a9456a9154b2f5309ee70df5bce1 with your own DFN address. Under "Status" you should see "Claimed".

If your claim was successful then do not forget to remove the .pem file on the air-gapped computer:<syntaxhighlight lang="bash">
rm identity.pem

</syntaxhighlight>

How-To: Claim neurons for seed participants

2021-11-19T19:42:56Z

Timo: /* Run quill */

You are a ''seed participant'' if you donated to the DFINITY foundation in February of 2017. At that time, 30 tokens per Swiss Franc of value donated were allotted to your key. These tokens are now called "ICP tokens" or, shortly, "ICP".

At Genesis Unlock your ICP were then disbursed to you in the form of a basket of 49 voting neurons (insert link "NNS" here). These neurons already exist inside the Network Nervous System (insert link "NNS" here). Your neurons contain the ICP you have been awarded, staked inside.

Your neurons have been configured to vote automatically and are already earning voting rewards for you. You do not need to do anything to initialize your neurons in order to continue earning voting rewards.

The 49 neurons created for you have dissolve delays (insert link "NNS" here) of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

We are pleased to inform you that your neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases your voting power and the voting rewards you receive.

To control your neurons you must use the same secret key that you generated when the donation was made. It was recorded as a 12-word mnemonic phrase. In order to control your neurons you need to first ''claim'' the whole basket. This article explains how to do the claiming. For how to control your neurons after claiming them see this article (insert link here).

== Claiming with a Ledger Nano device ==

'''Coming soon.''' This will come with the next update of the IC's app for the Ledger Nano. The current release can manage neurons but cannot yet claim them.

== Claiming with an air-gapped computer ==

Claiming requires access to your secret mnemonic phrase and to secret keys derived from it. It is highly advised that you use an air-gapped computer for the purpose of claiming. If you are not comfortable with such a setup or with any of the following steps then you have to wait for the next release of the IC's app for the Ledger Nano device.

As an air-gapped device you can use a Windows, Linux or MacOS machine. Linux includes Raspberry Pi.

=== Download the tools ===
To download the tools you need a second, networked computer. The tools are called ''keysmith'' and ''quill.'' We describe here how to find and download a binary for your architecture. If you want to compile the tools yourself then we provide more information for you at the end of the document (TODO).

Binaries are available for the following hardware architectures. Here, architecture refers to the air-gapped computer, not the networked computer.
{| class="wikitable"
|+
!Hardware
!keysmith
!quill
|-
|Mac, Intel silicon
|darwin-amd64
|macos-x86_64
|-
|Mac, Apple silicon (M1)
|darwin-arm64
|not available
|-
|Linux (x86)
|linux-amd64
|linux-x86_64
|-
|Raspberry Pi
|linux-arm32
|arm_32
|-
|Linux (arm)
|linux-arm64
|not available
|-
|Windows
|windows-amd64
|windows-x86_64
|}
==== Download keysmith ====

Go to [https://github.com/dfinity/keysmith/releases/ keysmith], choose the latest release (currently v1.6.2) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

==== Download quill ====

Go to [https://github.com/dfinity/quill/releases quill] , choose the latest release (must be >= 0.2.12) and fetch the .tar.gz file that matches the air-gapped machine's architecture in the table above.

=== Copy to air-gapped machine ===

Copy the .tar.gz files from the networked machine to the air-gapped machine. For example, you can do so with a USB drive.

=== Verify the hashes ===

On the air-gapped machine, go to the terminal. Change the directory to the folder where the .tar.gz files are. Compute the SHA256 hashes with the commands<syntaxhighlight lang="bash">
openssl dgst -sha256 keysmith-*.tar*
</syntaxhighlight>and<syntaxhighlight lang="bash">
openssl dgst -sha256 quill-*.tar*
</syntaxhighlight>The hashes should match the following entries:<syntaxhighlight lang="bash">
SHA256(keysmith-darwin-amd64.tar.gz)= a53bad6fa36c1eb35cd36059ffe9cbf4c063b515e47ccf666b7e1c174a7d1088
SHA256(keysmith-darwin-arm64.tar.gz)= 47932452353fe7f921b4ac41828dd19530ae0c4bdb72bcbb016a0715ca80e879
SHA256(keysmith-linux-amd64.tar.gz)= cb283dac031d8676f25e72d19115be347d2b85c864a17dd563104bf496b14a06
SHA256(keysmith-linux-arm32.tar.gz)= b28670e2b3483ea9f9ba691e9f76f99df31b2678db33b69c888fb08b634de162
SHA256(keysmith-linux-arm64.tar.gz)= ebe9cde3cf440ebbfb53dd10bf7f412cbff8b089551100ee0fa48f3ac9bd66c3
SHA256(keysmith-windows-amd64.tar.gz)= 1ef9b77ccaae980aad4a227fe1a817821245da491a90f0e6ad323426b49ae40a
</syntaxhighlight>and

(enter quill hashes here)

=== Unpack and install ===

For keysmith:<syntaxhighlight lang="bash">
tar -f keysmith-*.tar* -x
sudo install -d /usr/local/bin
sudo install keysmith /usr/local/bin
</syntaxhighlight>You will be prompted to enter your laptop password. The password itself will not appear, simply type it and press enter.

For quill:<syntaxhighlight lang="bash">
tar -f quill-*.tar* -x
sudo install quill /usr/local/bin
</syntaxhighlight>

== Run keysmith ==
<syntaxhighlight lang="bash">
keysmith
</syntaxhighlight>You should see:<syntaxhighlight lang="bash">
usage: keysmith <command> [<args>]

Available Commands:
account Print your account identifier.
generate Generate your mnemonic seed and write it to a file.
legacy-address Print your legacy address.
principal Print your principal identifier.
private-key Derive your private key and write it to a file.
public-key Print your public key.
shortlist Print the available commands.
version Print the version number.
x-private-key Derive your extended private key and write it to a file.
x-public-key Print your extended public key.
</syntaxhighlight>If you are using macOS, making the <code>keysmith</code> binary executable might require you to change a permission setting using System Preferences > Security & Privacy > General.

=== Enter your mnemonic phrase (aka "seed") ===

If you confident that your environment is secure, then you are ready to enter your seed for use with <code>keysmith</code>. For the duration of your session, you store your seed phrase in an environment variable. It will be eliminated from your system when you turn your computer off.
<syntaxhighlight lang="bash">
read seed
</syntaxhighlight>
Enter your seed phrase and finish with Return.

If you prefer to not have your seed phrase displayed as you type then use this command instead:<syntaxhighlight lang="bash">
read -s seed
</syntaxhighlight>

=== Optional: check your legacy address and balance ===

At this point you can already verify your legacy address and ICPT balance. The legacy address matches to what was formerly called "DFN address" in the Dfinity Chrome extension. You may have copied it from the Chrome extension for your records back when you used the extension.
<syntaxhighlight lang="bash">
echo $seed | keysmith legacy-address -f -
</syntaxhighlight>
The output is a 40 character hex string. It looks something like this:
<syntaxhighlight lang="bash">
2d89d96b10f7a9456a9154b2f5309ee70df5bce1
</syntaxhighlight>
You can check your ICPT balance as follows: Go to https://ic.rocks/principal/renrk-eyaaa-aaaaa-aaada-cai, look for "Canister interface" and the method "balance". There, paste your DFN address in to the field labeled "text" and click the button labeled "Query". Your ICP balance will appear below "nat32".

=== Create your private key (.pem file) ===

Derive your private key from your seed phrase.
<syntaxhighlight lang="bash">echo $seed | keysmith private-key -f -</syntaxhighlight>
This creates a file <code>identity.pem</code> containing your private key.

== Run quill ==
On the air-gapped computer run:<syntaxhighlight lang="bash">
quill --pem-file identity.pem claim-neurons >msg.json

</syntaxhighlight>
Copy the resulting file `msg.json` back to the networked computer. On the networked computer, change into the directory where `msg.json` is and run:<syntaxhighlight lang="bash">
quill send msg.json
</syntaxhighlight>Your neurons should now be claimed.

You can double-check if you claim was successful in the following way: Go to https://ic.rocks/genesis/2d89d96b10f7a9456a9154b2f5309ee70df5bce1 where you replace 2d89d96b10f7a9456a9154b2f5309ee70df5bce1 with your own DFN address. Under "Status" you should see "Claimed".

How-To: Claim neurons for seed participants

2021-11-19T19:29:23Z

Timo:

How-To: Claim neurons for seed participants

2021-11-19T19:27:27Z

Timo:

How-To: Claim neurons for seed participants

2021-11-19T19:24:23Z

Timo: /* Run keysmith */

How-To: Claim neurons for seed participants

2021-11-19T19:11:58Z

Timo:

How-To: Claim neurons for seed participants

2021-11-19T19:11:00Z

Timo:

How-To: Claim neurons for seed participants

2021-11-19T18:55:34Z

Timo:

How-To: Claim neurons for seed participants

2021-11-19T18:33:49Z

Timo:

How-To: Claim neurons for seed participants

2021-11-19T15:44:11Z

Timo:

How-To: Claim neurons for seed participants

2021-11-19T15:43:10Z

Timo: /* Claiming with an air-gapped computer */

How-To: Claim neurons for seed participants

2021-11-19T11:53:16Z

Timo:

Internet Computer wiki

2021-11-19T11:21:15Z

Timo: /* How-Tos */

Welcome to the Internet Computer Wiki! Feel free to join in. All are welcome!
== Topics Central ==

* [[Internet computer]]
* [[Internet Computer vision]]
* [[Index of dapps on the Internet Computer]]
* [[ICP token]]
* [[Internet Identity]]
* [https://dashboard.internetcomputer.org/ Internet Computer dashboard]
* [[Internet Computer Performance]]
* [[DFINITY]]
* [[Custody, Staking, and Voting]]
== For blockchain & crypto enthusiasts ==
* [[Myths and facts]]
* [https://www.reddit.com/r/dfinity/ r/dfinity]
* [[How to stake on the Internet computer]]
* [[Tokenomics of the Internet Computer]]
* [[Governance of the Internet Computer]]

== For dapp developers ==
* [[Internet Computer for dapp developers]]
* [[Canister smart contracts]]
* [https://forum.dfinity.org/ IC community developer forum]
* [[Best practices for a high traffic dapp launch]]
* [[Best practices for NFT drops]]

== For computer scientists ==
* [[The Internet Computer for Computer Scientists]]

== For node owners ==
* [[Internet Computer for node owners]]

== FAQs ==

* [[FAQ]]

'''Computer Scientists FAQ'''
* [[The Internet Computer for Computer Scientists]]
== How-Tos ==

* [[How-To: Claim neurons for seed participants]]

== Contributors ==

=== Housekeeping Rules ===

* Please refrain from redundancy, such as referring to the Internet Computer in article titles. This is, after all, the Internet Computer Wiki.
* Please carefully consider your use of capitalisation. Most words in titles should be capitalised. DFINITY is always stylised in all-caps.

=== How to Contribute ===
Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]

Use this page to test editing
* [[Test editing the Internet Computer Wiki]]

Number of articles: {{NUMBEROFARTICLES}}

How-To: Claim neurons for seed participants

2021-11-19T09:57:56Z

Timo:

How-To: Claim neurons for seed participants

2021-11-19T09:50:53Z

Timo:

How-To: Claim neurons for seed participants

2021-11-19T09:47:14Z

Timo:

If you donated to the DFINITY foundation in February of 2017 then you are a seed participant.
At the time, 30 tokens per Swiss Franc of value donated were allotted to your key.
These tokens are now called "ICP tokens" or, shortly, "ICP".

At Genesis Unlock your ICP were disbursed in the form of a basket of 49 voting neurons (insert link here).
These neurons already exist inside the Network Nervous System (insert link here).
Your neurons contain the ICP you have been awarded, staked inside.

Your neurons have been configured to vote automatically and are already earning voting rewards for you.
You do not need to do anything to initialize your neurons in order to continue earning voting rewards.

The 49 neurons created for you have dissolve delays (insert link here) of 0 days, 30 days, 60 days, 90 days and so on. Apart from the first neuron which has a dissolve delay of 0 days (which can be dissolved immediately), the other dissolve delays may have a small random number of days either added or removed.

We are pleased to inform you that your neurons have been pre-aged! At the moment of Genesis Unlock, their age was already set to 18 months old. This is important, because neuron age significantly increases your voting power and the voting rewards you receive.

Claim neurons for seed participants

2021-11-19T09:25:29Z

Timo: Created stub for seed participants

THANK YOU for being a Seed participant.

Internet Computer wiki

2021-11-19T09:24:45Z

Timo: /* How-Tos */ fix link

Welcome to the Internet Computer Wiki! Feel free to join in. All are welcome!
== Topics Central ==

* [[Internet computer]]
* [[Internet Computer vision]]
* [[Index of dapps on the Internet Computer]]
* [[ICP token]]
* [[Internet Identity]]
* [https://dashboard.internetcomputer.org/ Internet Computer dashboard]
* [[Internet Computer Performance]]
* [[DFINITY]]
* [[Custody, Staking, and Voting]]
== For blockchain & crypto enthusiasts ==
* [[Myths and facts]]
* [https://www.reddit.com/r/dfinity/ r/dfinity]
* [[How to stake on the Internet computer]]
* [[Tokenomics of the Internet Computer]]
* [[Governance of the Internet Computer]]

== For dapp developers ==
* [[Internet Computer for dapp developers]]
* [[Canister smart contracts]]
* [https://forum.dfinity.org/ IC community developer forum]
* [[Best practices for a high traffic dapp launch]]
* [[Best practices for NFT drops]]

== For computer scientists ==
* [[The Internet Computer for Computer Scientists]]

== For node owners ==
* [[Internet Computer for node owners]]

== FAQs ==

* [[FAQ]]

'''Computer Scientists FAQ'''
* [[The Internet Computer for Computer Scientists]]
== How-Tos ==

* [[Claim neurons for seed participants]]

== Contributors ==

=== Housekeeping Rules ===

* Please refrain from redundancy, such as referring to the Internet Computer in article titles. This is, after all, the Internet Computer Wiki.
* Please carefully consider your use of capitalisation. Most words in titles should be capitalised. DFINITY is always stylised in all-caps.

=== How to Contribute ===
Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]

Use this page to test editing
* [[Test editing the Internet Computer Wiki]]

Number of articles: {{NUMBEROFARTICLES}}

Internet Computer wiki

2021-11-19T09:23:50Z

Timo:

Welcome to the Internet Computer Wiki! Feel free to join in. All are welcome!
== Topics Central ==

* [[Internet computer]]
* [[Internet Computer vision]]
* [[Index of dapps on the Internet Computer]]
* [[ICP token]]
* [[Internet Identity]]
* [https://dashboard.internetcomputer.org/ Internet Computer dashboard]
* [[Internet Computer Performance]]
* [[DFINITY]]
* [[Custody, Staking, and Voting]]
== For blockchain & crypto enthusiasts ==
* [[Myths and facts]]
* [https://www.reddit.com/r/dfinity/ r/dfinity]
* [[How to stake on the Internet computer]]
* [[Tokenomics of the Internet Computer]]
* [[Governance of the Internet Computer]]

== For dapp developers ==
* [[Internet Computer for dapp developers]]
* [[Canister smart contracts]]
* [https://forum.dfinity.org/ IC community developer forum]
* [[Best practices for a high traffic dapp launch]]
* [[Best practices for NFT drops]]

== For computer scientists ==
* [[The Internet Computer for Computer Scientists]]

== For node owners ==
* [[Internet Computer for node owners]]

== FAQs ==

* [[FAQ]]

'''Computer Scientists FAQ'''
* [[The Internet Computer for Computer Scientists]]
== How-Tos ==

* Claim neurons for seed participants

== Contributors ==

=== Housekeeping Rules ===

* Please refrain from redundancy, such as referring to the Internet Computer in article titles. This is, after all, the Internet Computer Wiki.
* Please carefully consider your use of capitalisation. Most words in titles should be capitalised. DFINITY is always stylised in all-caps.

=== How to Contribute ===
Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]

Use this page to test editing
* [[Test editing the Internet Computer Wiki]]

Number of articles: {{NUMBEROFARTICLES}}

Index.php?title=How-To: Claim seed round neurons

2021-11-19T09:20:42Z

Timo: Timo moved page Index.php?title=How-To: Claim seed round neurons to How-To: Claim neurons for seed participants

#REDIRECT [[How-To: Claim neurons for seed participants]]

How-To: Claim neurons for seed participants

2021-11-19T09:20:42Z

Timo: Timo moved page Index.php?title=How-To: Claim seed round neurons to How-To: Claim neurons for seed participants

THANK YOU for being a Seed participant.

How-To: Claim neurons for seed participants

2021-11-19T09:19:57Z

Timo: Created page with "THANK YOU for being a Seed participant."

THANK YOU for being a Seed participant.

Internet Computer wiki

2021-11-19T09:18:53Z

Timo: /* How-Tos */

Welcome to the Internet Computer Wiki! Feel free to join in. All are welcome!
== Topics Central ==

* [[Internet computer]]
* [[Internet Computer vision]]
* [[Index of dapps on the Internet Computer]]
* [[ICP token]]
* [[Internet Identity]]
* [https://dashboard.internetcomputer.org/ Internet Computer dashboard]
* [[Internet Computer Performance]]
* [[DFINITY]]
* [[Custody, Staking, and Voting]]
== For blockchain & crypto enthusiasts ==
* [[Myths and facts]]
* [https://www.reddit.com/r/dfinity/ r/dfinity]
* [[How to stake on the Internet computer]]
* [[Tokenomics of the Internet Computer]]
* [[Governance of the Internet Computer]]

== For dapp developers ==
* [[Internet Computer for dapp developers]]
* [[Canister smart contracts]]
* [https://forum.dfinity.org/ IC community developer forum]
* [[Best practices for a high traffic dapp launch]]
* [[Best practices for NFT drops]]

== For computer scientists ==
* [[The Internet Computer for Computer Scientists]]

== For node owners ==
* [[Internet Computer for node owners]]

== FAQs ==

* [[FAQ]]

'''Computer Scientists FAQ'''
* [[The Internet Computer for Computer Scientists]]
== How-Tos ==

* [[Index.php?title=How-To:_Claim_seed_round_neurons|Claim seed round neurons]]

== Contributors ==

=== Housekeeping Rules ===

* Please refrain from redundancy, such as referring to the Internet Computer in article titles. This is, after all, the Internet Computer Wiki.
* Please carefully consider your use of capitalisation. Most words in titles should be capitalised. DFINITY is always stylised in all-caps.

=== How to Contribute ===
Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]

Use this page to test editing
* [[Test editing the Internet Computer Wiki]]

Number of articles: {{NUMBEROFARTICLES}}

Internet Computer wiki

2021-11-19T08:59:43Z

Timo: Introduce How-Tos section

Welcome to the Internet Computer Wiki! Feel free to join in. All are welcome!
== Topics Central ==

* [[Internet computer]]
* [[Internet Computer vision]]
* [[Index of dapps on the Internet Computer]]
* [[ICP token]]
* [[Internet Identity]]
* [https://dashboard.internetcomputer.org/ Internet Computer dashboard]
* [[Internet Computer Performance]]
* [[DFINITY]]
* [[Custody, Staking, and Voting]]
== For blockchain & crypto enthusiasts ==
* [[Myths and facts]]
* [https://www.reddit.com/r/dfinity/ r/dfinity]
* [[How to stake on the Internet computer]]
* [[Tokenomics of the Internet Computer]]
* [[Governance of the Internet Computer]]

== For dapp developers ==
* [[Internet Computer for dapp developers]]
* [[Canister smart contracts]]
* [https://forum.dfinity.org/ IC community developer forum]
* [[Best practices for a high traffic dapp launch]]
* [[Best practices for NFT drops]]

== For computer scientists ==
* [[The Internet Computer for Computer Scientists]]

== For node owners ==
* [[Internet Computer for node owners]]

== FAQs ==

* [[FAQ]]

'''Computer Scientists FAQ'''
* [[The Internet Computer for Computer Scientists]]
== How-Tos ==

* [[Index.php?title=How-Tos|List of How-Tos]]
== Contributors ==

=== Housekeeping Rules ===

* Please refrain from redundancy, such as referring to the Internet Computer in article titles. This is, after all, the Internet Computer Wiki.
* Please carefully consider your use of capitalisation. Most words in titles should be capitalised. DFINITY is always stylised in all-caps.

=== How to Contribute ===
Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]

Use this page to test editing
* [[Test editing the Internet Computer Wiki]]

Number of articles: {{NUMBEROFARTICLES}}