Getting Started with MacOS Mining

Welcome to the Hive!

Thank you for choosing to participate in the Gajumaru mining hive.
Please follow the steps below.

1. Determine what type of Mac you have

There are two types of hardware that your Mac may have:

  1. Apple Silicon (ARM64) ー this is found on M1 and later Macs
  2. Intel Chips (x86)

To figure out which one you have you will need to check your system settings.
Go to the upper left corner of your screen and click on the "Apple" mark, and select "About this Mac".

A new window will pop up in the middle of your screen with the relevant information. In this case we have a "Chip" entry on the information screen and it says "Apple M4".
This means that we are on "Apple Silicon" (aka ARM64) and should choose the installer for that system type below.

2. Download the correct package

Now that we know which kind of Mac you have, we can pick the correct MacOS installer for GajuMine.
Please select the correct download from the options below:

Apple Silicon Installer

Intel Mac Installer

3. Install the software

Your software package will normally appear in your "Downloads" folder on your computer.
Check for it there and click it.

You will be presented with an installer screen like the following:

Click the "Install" button.

When installation is complete there will be three new icons available in Launchpad: The first one, with a "ZX" icon and the title "Vapor" is part of the Erlang runtime launcher.
The other two, GajuMine and GajuDesk, are the ones we are going to be using directly below.

4. Run GajuDesk for the first time

The first time GajuDesk is run it will offer to create a new default wallet and a new blockchain account for you.
Select the "I'm new!" option and let it set up a wallet and an account for you.

As part of the wallet creation routine it will ask you to provide a name for the wallet, and decide here whether you want your wallet to be protected by a passphrase on disk or not.
We strongly recommend that you use a passphrase.
Do not forget this passphrase! From now on every time you open your wallet you will need to provide your passphrase in order for GajuDesk to be able to read your wallet!

Here is how GajuDesk will look once you have completed the above steps:

5. SAVE YOUR RECOVERY PHRASE

At this point we need to save your mnemonic recovery phrase offline somewhere.
A mnemonic recovery phrase is a way that GajuDesk can encode your account key in a sequence of words.
Using the mnemonic recovery phrase you can import or transfer your account key to another wallet, or recover it in the event that you accidentally delete your wallet or something happens to your computer.

WARNING: Your mnemonic recovery phrase is your private key. DO NOT LOSE IT.

WARNING: KEEP YOUR MNEMONIC RECOVERY PHRASE SECRET

At the top of the GajuDesk main screen, right in the middle above your account (named "Account 1" by default) is a button that says "Mnemonic". Click this button to bring up your mnemonic phrase in a pop-up window.

The window will look like the image below, with your words in the blocked-out part in red. We strongly recommend that you write down the words on paper, but if you are concerned that you might not transcribe perfectly, copy the phrase and paste it into a text document and print that out on paper.

We urge you to maintain a paper copy of your mnemonic phrase for several reasons. One reason is that the contents of your disk are subject to capture by Apple's indexing and AI services, or even being uploaded to any number of cloud services. Another reason is that in the event your computer's drive becomes corrupted it is possible that your key/accountID is simply lost forever if you do not save a copy of your mnemonic phrase somewhere. And a final reason is that at some point you are likely to want to transfer this account to another device, and the easiest way to do that is by using your mnemonic recovery phrase.

6. Log in to GajuMining.com

Now that you have created a Gajumaru account ID, you can log in to gajumining.com.

IMPORTANT!
Moving forward the assumption is that you arrived at gajumining.com by clicking the link in your mining welcome email.
If this is not the case, stop now, open your email, and open the site by clicking the link in your welcome email.
This is important because that link carries a code that links your purchase with your first login.

In the upper right of the site is a "LOGIN" link that looks like this:

Clicking that link will take you to a QR code based login screen with a GRIDS URL encoded on it.
In the lower right there is a clipboard icon (indicated with a red arrow in the image below). Click that clipboard link to copy the URL to your system clipboard.

Now return to GajuDesk and click the "GRIDS URL" button (toward the bottom right of the GajuDesk window).
You will be presented with an input field where you can paste the URL you copied from the site.

Click "OK" and GajuDesk will retrieve a login message from the server which now needs to be signed and returned.
The message will be shown to you by GajuDesk in a window that looks like this: Click "OK" to sign the message with your account key and submit it to the site.

Once the signed message is submitted to the site, you will notice the gajumining.com site changes from the QR screen to a logged in view.
Congratulations! You are now logged in and registered with the hive leader!

7. Configure GajuMine

Finally, the part you have been waiting for: GajuMine!

What we are going to do now is tell GajuMine which account(s) we are going to be mining on behalf of on this system.
Look at the main screen of the wallet, GajuDesk, and find the "Copy" button in the lower right (next to the account balance and account ID display). This will copy your account ID to the clipboard.

Return to Launchpad and click the "GajuMine" link.
The first time you run GajuMine you will be presented with a configuration menu. At the top of this menu is a field called "GajuMining Account ID".
Paste the account ID you copied from your GajuDesk wallet into this field and click "OK" (If you have already run GajuMine out of curiosity and clicked away from this, don't worry, just click the "Configure" button at the bottom right of the GajuMine screen and the configuration screen will open.)

And that's it! GajuMine is now configured and you can click "Start" and GajuMine will begin mining.

8. Hi-ho, hi-ho, it's off to work we go...

Your freshly created Gajumaru account ID is now registered with the hive leader, GajuMine is configured with your account ID, and GajuMine is all set to go.

GajuMine will remember its configuration, so you do not need to repeat any of these steps unless you want to run GajuMine on multiple computers at the same time, or alter the configuration later.

From now on whenever you want to mine, you simply open GajuMine and click "Start" and it will start mining.
You can stop mining by simply closing GajuMine and it will stop all solvers.

In the event you want to run your computer constantly as a miner, 24 hours a day, you will need to configure the system to not go into a "sleep" mode.
This is done in slightly different ways on different versions of MacOS, but the basic idea is that in power options or display settings settings there will be an option for this.