Note: None of this is financial advice!
Update 04/11/2023: Main Net was launched on November 5th, 2023. https://claim.koinos.io is now active for main net claiming. BE AWARE OF SCAMMERS. ONLY ACCESS THE CLAIM LINK via https://koinos.io at the top right corner (see image below)!
There are scammers who are cloning the claim page and stealing tokens when you connect your wallet! DO NOT FALL FOR THIS !
Kondor has also been updated and appears slightly different however the functionality is the same.
Update 10/31/2022: The planned snapshot has been executed. The official snapshot time is Oct-31–2022 04:02:23 AM +UTC per Etherscan and can be verified here:
https://etherscan.io/tx/0xf28c62da7a075d42f471527c8305421fba4d964cf3fb9eea0169927b53e9cf03
If you get stuck, please reach out to anyone from Koinos through official pathways only. I am not a member of Koinos Group and you should not trust anything I say without verifying yourself. Koinos Group’s official twitter is @koinosnetwork. You can reach me @kuixihe on twitter.
ERC-20 KOIN token holders will need to perform a claim in order to obtain their main net KOIN tokens. Main net is LIVE as of November 5th, 2022.
The preferred way is to complete the claim using Kondor+Metamask because it is simple, quick and secure via https://claim.koinos.io. However, this guide will show you how to perform the claim without using Metamask, also via https://claim.koinos.io.
To follow this guide, you must have Kondor Wallet (link), which is available as an extension for Chrome and any chrome-like browser such as Brave.
CREATING KOINOS WALLET ADDRESS WITH KONDOR
To create a Koinos wallet with a new installation of Kondor, simply click “New Wallet” and go through the steps to secure your seed phrase. DO NOT SHARE THIS SEED PHRASE WITH ANYONE. NO ONE FROM THE TEAM WILL EVER ASK YOU FOR YOUR SEED PHRASE, EVER.
When you’ve successfully created a new wallet address, you should see the following screen. In this example, your Koinos wallet address would be: 1EgTMLkzwUCw9hR6k6G7W9BJRNa6zmeLQA.
GETTING TO CLAIM SITE VIA OFFICIAL LINKS
When performing the claim, be sure to go through official links only. Trust absolutely no one except koinos.io. Below is a screen shot of the main page of koinos.io. Click on “Token Claim Website”.
STEP ONE: INSERT ETH ADDRESSS
For step 1, the preferred way is to connect with metamask which provides a very simple to use and self explanatory interface.
For this guide, we’re going to do things manually for all the non-metamask users. To start, hit the toggle button to “Set ethereum address manually” as shown in photo 1 below.
Insert your ETH address that contains your ERC-20 KOIN tokens and click verify. Under “ERC20 Info”, your account details should populate and show you what is available to be claimed. If you have problems, skip to troubleshooting at the bottom of this article.
STEP TWO: INSERT KOINOS ADDRESS
For Step 2, the prefered way is to connect Kondor wallet, but because it is self explanatory, we’re providing a guide for the manual method. Hit the toggle button to “Set Koinos address manually” as shown in photo 2below.
For this trial, I would use our newly created wallet address we created earlier: 1EgTMLkzwUCw9hR6k6G7W9BJRNa6zmeLQA.
STEP THREE: PROVE OWNERSHIP
PLEASE READ CAREFULLY BEFORE PROCEEDING!
The purpose of step three is to prove you own the ERC-20 KOIN tokens and there are many ways to do this!
If you aren’t the owner, main net won’t give you tokens that you do not own. To prove ownership, you must sign a message with the wallet holding your ERC-20 KOIN. This can only be done if you possess the private key (PK) to that wallet.
There is no transaction fee to signing a message and it can be done offline if you are technically savvy enough. Once a message is signed, you can share that message with anyone without any risk of exposing your private key and at the same time, prove ownership of the wallet that is signing.
A BRIEF EXAMPLE ABOUT SIGNING MESSAGES
For example, I can prove I own the private key to this ETH address: 0x5e2a01c0F08B55e7578924df9aDE77Fd8645449 by signing the following message with my Ledger Nano as seen in photo 3:
Once signed, the output is:
{
“address”: “0x5e2a01c0f08b55e7578924df9ade77fd86454495”,
“msg”: “0x4b6f696e6f7320697320617765736f6d65”,
“sig”: “d27eceef8a5e08762a889fc2964104088214a43595ef5e7905b9e57e9633063c2ac9da67062ea2351dbd42e7fa91cfd65728e9dc7aebd93a062c9565026cc71501”,
“version”: “3”,
“signer”: “ledger”
}
Anyone can verify this by inserting the above message into a verifier, such as the one provided by My Ether Wallet (link) and also shown in photo 4 below. Be careful as copying and pasting can result in hidden characters and spaces causing a failed verification.
Now that you have an understanding about signing messages, we can move forward to actually signing the message itself to prove you control the wallet with ERC-20 KOIN.
Step three can be completed three ways:
Option 1: Completing the claim with Metamask
This is the simplest way so I wont be showing examples. Just follow the on screen prompts.
Option 2: Completing the claim with a hardware wallet
Ledger and Trezor can both connect to Metamask making it similar to option 1. But if you do not want to install and use metamask, you can also use MyEtherWallet, which I outline how to use below.
Option 3: Completing the claim with CoinBase Wallet or Trust Wallet
CoinBase Wallet on mobile devices do not provide users with the ability to sign transactions, however there is a desktop extension which you can download and sign in with your mobile wallet. Both CoinBase Wallet and Trust Wallet can connect to MyEtherWallet, which I will outline how to use below.
In Step Three, if you are choosing option 2 or option 3, you may toggle the slide bar to enable “Sign with a different wallet”. The screen will provide a message in pink that has the following format:
claim tkoins <ethereum address>:<kondor address
Photo 5 provides an example of how this would appear using my example addresses.
You must copy the entire message that is in shown in pink and insert it into MyEtherWallet to sign. Conveniently, the claim site provides a direct link under “Go to MyEtherWallet”. This will bring you to MEW’s home page as shown in photo 6.
If you use CoinBase Wallet you’ll want to click “Browser Extension” and follow those steps to connect your CoinBase Wallet.
If you use Trust Wallet, you’ll want to click “Mobile Apps and Wallet Connect” and follow those steps to connect your Trust Wallet.
If you use Ledger or Trezor, you’ll want to click “Hardware wallets” to follow those steps to connect your hardware wallet.
Regardless of what choice you choose, once you connect your wallet to MEW, you’ll end up with the dashboard shown in photo 7. Notice on the left hand side, there is a menu option called message. When you click it, it provides a drop down menu with “Sign Message” and “Verify Message”. Click on “Sign Message”.
Paste the entire message that claim.koinos.io provided to you and click sign as shown in photo 8.
After clicking sign; if you are using Trust wallet, a popup should come up on your phone. If you are using CoinBase wallet, a popup should come up on your browser. If you are using a hardware wallet, the message should appear on your hardware device. Sign the message through your selected device. For example, the CoinBase Wallet desktop extension will provide a popup shown in photo 9.
Which ever way you confirm, MyEtherWallet will provide a confirmation of signed message as shown in photo 10.
Click “Copy” to copy the entire contents back into Step 3 of the claim site as shown in photo 11 and click next.
STEP FOUR: SET THE MANA PAYER
Since you do not have any mana, this is the easiest step, just click next! If for whatever reason you do want to use Koinos Groups’ mana and you rather pay with your own mana, simply set the toggle switch to “Set payer address manually” and insert the address which you want to use to pay the Mana cost. Doing this requires the payer to have KOIN already.
You should use the default setting and click next.
STEP FIVE: SUBMIT THE CLAIM
You’re almost there!
If you created a Kondor wallet using the instructions above, toggle the switch to green under “Claim with Kondor” as shown in photo 13 will suffice and I encourage you to simply do that and finish here!
FOR ADVANCE USERS ONLY!
Some users have express that they are unwilling to use Kondor Wallet because it’s not produced by Koinos Group. Be aware that claim.koinos.io was created by the same person who developed Kondor Wallet and it is endorsed by Koinos Group. If you’ve read this entire guide and do not want to use Kondor or Koinos-CLI for any reason then there is an alternative option that involves leaving the toggle bar under “Claim with Kondor” greyed out.
Koinos address format is similar to a typical bitcoin address. Specifically the P2PKH address that is derived from a compressed public key. The private keys must start with K or L and the address must start with 1 (not 3 or bc1 which is for segwit). For this reason, it is possible to generate a private key for a bitcoin wallet and use that address in step 1.
If you choose to do this, you still need to submit the claim payload to the Koinos Blockchain to complete your claim and this is the reason why you would leave the toggle greyed out.
The claim site is using their own instance of Kondor to submit the claim transaction on your behalf because the claim doesn’t care who submits the message. It will ultimately deposit the main net tokens into whatever Koinos address is listed within the claim message (assuming it was signed by a valid ETH address).
If you go this route, you can try to get a bitcoin address using bitaddress.org.
Regardless of how you want to complete step 5, once you completed the claim, you should see a message appear such as shown in photo 14 and a confirmation.
To verify you’ve received the tokens, go to koinosblocks.com and enter your Koinos wallet address into the “Search by block, transaction or address” field as shown in photo 15.
TROUBLSHOOTING
Q: My transactions won’t go through!
A: By default Kondor wallet uses https://api.koinos.io which has been provided by Koinos Group. Since Koinos is still undergoing optimization, the API can sometimes be slow or not available. Go to your extension settings and set the RPC to https://api.koinosblocks.com which was created by community developer named engrave. Thank you for providing that!
Q: When I click “Verify” under step one, my tokens dont show up!
A: The test claim that you are performing prior to main net launch uses a trial snapshot that occured around the end of August. If you purchased after this time, then the test claim wont include your newly purchased tokens.
Q: When I click “Verify” under step one, the amount of tokens doesn’t match up to what I have!
A: The test claim that you are performing prior to main net launch uses a trial snapshot that occurred around the end of August. If you purchased after this time, then the test claim wont include your newly purchased tokens.
Q: I need more help!
A: Join the telegram channel or discord channel. You should use official links by going to koinos.io and use the resource drop down menu. Remember that this is a scammy environment. Always use official links and never trust anyone without verifying!