In case we have problems connecting our wallet to the blockchain we need addnodes (peers).

In this guide, we will explain in a few simple steps how to add peers to your wallet.

First of all, let's open our wallet (in our case Sapphire)

Now we go to the top right and we will see the configuration file icon (in our case sapphire.conf).

As seen in the following picture

Now click on the configuration file icon to open it.

In case Windows asks us which program we want to use to open it, it is advisable to choose Notepad.

Now we go to https://explorer.decenomy.net/ and search for the coin. (in this case Sapphire).

Then we click on the coin to access the "Overview" page.

As we can see on the next screen, we can choose "Network" from the left menu.

Now we choose from the list the option that corresponds to the version of our wallet (in this case 1.5.2.1)

The version of our wallet can be found at the bottom left when the wallet is opened.

Now we click on the "node list" button next to our preferred wallet version, this window will open and we copy the addnodes.

We go back to the Notepad to paste the addnodes.

Now we can save and close the configuration file as seen in the picture below:

Once this is done, we close and restart our wallet to apply the changes. Now our wallet is ready to be used!

What is a Fork?

A fork in the context of blockchains is when changes are made to the blockchain's protocol which usually results in two separate versions of the blockchain.

Because blockchains are often updated to ensure security and embed new features, there is the need to be on the lookout for instructions on how to update your wallet if it's mandatory.

Failing to respond promptly to upgrades can result in your wallet being associated with the incorrect blockchain.

Possible Scenario your Wallet might be Forked

For example, you might have activated staking for a Decenomy coin, and in a short period, you realize you have received an outrageous amount of staking rewards.

In such an instance, there is a possibility your wallet might have been forked. This means your wallet is on the wrong chain and these rewards earned are useless. Once the issue is resolved, these rewards will not show in your wallet as they aren't real.

Verifying a Wallet Fork

Once you suspect a wallet fork, the following steps will help you to confirm if it's truly a fork. We will use SAPP for demonstration purposes.

• Open your wallet and go to "SETTINGS", then select "Debug". Next, you choose "Information" from the dropdown menu. We then navigate to the "Blockchain" section on the left side of the screen.

• The information of interest is: 1. Current number of blocks: 2360341 2. Last block hash: 616851ded4d975e3dc331a0ecf894bd5814a4b27aaf5e46118bd1adf8e8b8b0d

On the SAPP explorer, we compare the "Current number of blocks" and "Last block hash" from the wallet to ensure they match.

If we confirm the block hashes of both the wallet and the explorer are the same, then our wallet is on the right chain. However, if the hashes are different, then it indicates a fork.

NB: In some cases, it is preferable to use previous blocks in our wallet as bases for the comparison. This is because new releases have self-fork management and the explorer takes a while to index. This causes a difference in the hashes when using the most recent block.

To check the hash of a specific block in our wallet, we do this instead:

• Open your wallet and go to "SETTINGS". Next, we choose 'Debug' and then 'Console"

• We use the command getblockhash with the block number we want its hash. e.g., getblockhash 2360331

We get a response with the hash as shown in the image below:

We then have to compare the hash to that of the explorer to see if they match

Resolving a Fork

• Go to "SETTINGS" in your wallet. Select 'Debug' and then 'Wallet Repair'. Scroll down to the end

• First, we start by selecting the "Rewind blockchain to last week" option

• If it doesn't resolve the issue, we then proceed with the "Rewind blockchain" option. Hopefully, that should put your wallet on the right chain.

One way to backup your wallet is to save a copy of the wallet.dat file on an external device.

First of all, we insert our USB stick into the PC and open our wallet (in our case the SAPP wallet), then go to the bottom left and choose the settings cog.

• 1 Settings

• 2 Wallet Data

• 3 Wallet

As seen in the image below:

Once this is done, as you can see in the image, the backup wallet menu will open, click on the folder icon on the right as in the image below:

After that, a window will open where we can choose the destination for our backup file

• 1 look for our USB stick and click on it to select it

• 2 let's choose a name for our backup

• 3 click on save

If the operation went well, this will appear:

If in case you need to restore your backup, the name to use will be "wallet.dat"

In this guide, we will explain how to stake our DECENOMY coins.

First of all, let's open our wallet (in our case SAPP). In order for staking to be active, our coins must have at least 600 confirmations (about 10 hours).

A second requirement is that the wallet is unlocked. To do this we can click on the padlock icon at the top right.

Make sure to choose the “Staking only” option!

If you happen to have encrypted your wallet, you will be asked to enter your password and confirm the operation by clicking "OK" as seen below:

Once this is done, the staking icon will activate. To be able to stake, the wallet must always remain open.

If staking is not activated, you can use the getstakingstatus command in the debug console to gain more insight into the root causes of the issue.

We have provided more information on this command, which can be accessed on the Staking Best Practices page.

First of all, we insert our USB stick into the PC. After that, we open the USB stick folder and navigate to the backup file.

Let’s now copy the file

After that, we have to navigate to the wallet data directory located in %appdata% as shown in the picture (Windows 11).

We can now open the coin’s folder we are looking for (in our case Sapphire)

NB The file name must always be wallet.dat so we need to rename the old one first.

We can now paste the file we copied previously from the USB stick

As a final step, we rename the file to wallet.dat

The wallet is restored and we can start our Sapphire wallet.

NB: As mentioned earlier, make sure the wallet file name is wallet.dat, or else your wallet will not recognize it. Secondly, do not move or rename other files or data directories.

How to stake on a VPS

In this guide, we are going to explain how to stake on a VPS server.

This guide is for advanced users and assumes that you know how to safely use an Ubuntu server.

We assume that you will run all the commands as root user.

First, we need to connect to our server via SSH and download the wallet we want to install, from our official links on GitHub.

In this case, we have chosen KYAN.

We choose the Linux version and copy the link.

To download the wallet we use wget command.

wget https://github.com/kyancoin/KYAN/releases/download/v1.0.0.1/KYAN-1.0.0.1-Linux.zip

Now we copy the KYAN executables in /usr/local/bin folder to make them available as system command

cp kyanite* /usr/local/bin/

Let’s start the KYAN daemon and encrypt the wallet.

kyanited -daemon

kyanite-cli encryptwallet “YOUR-PASSWORD-HERE”

We can now create a system service to make sure our wallet will always run. nano /etc/systemd/system/kyanite.service

This command will open nano text editor where we paste the following.

[Unit]

Description=KYAN service

After=network.target

StartLimitIntervalSec=0

[Service]

Type=forking

Restart=always

RestartSec=10

User=root

ExecStart=/usr/local/bin/kyanited -conf=/root/.kyanite/kyanite.conf -datadir=/root/.kyanite

ExecStop=-/usr/local/bin/kyanite-cli -conf=/root/.kyanite/kyanite.conf -datadir=/root/.kyanite stop

[Install]

WantedBy=multi-user.target

We can now exit nano and save (ctrl+x, y, enter).

To apply the change we run this command systemctl daemon-reload

Now we need to setup the kyanite.conf file, we use nano again

nano /root/.kyanite/kyanite.conf

Paste the following lines in it:

daemon=1 server=1 rpcuser=kyanite rpcpassword=YOUR-RPC-PASS rpcallowip=127.0.0.1

staking=1

Save and exit nano.

The configuration is now complete and we can start the kyanite service and generate a new address.

systemctl start kyanite.service

kyanite-cli getnewaddress

While we wait for the wallet synchronisation we can transfer our funds to the address we just generated.

As the last step we need to unlock our wallet for staking. kyanite-cli walletpassphrase “YOUR-PASSWORD-HERE” 99999999999999 true

N.B. Coins need 600 network confirmations to start staking

You can verify staking status using the command below

kyanite-cli getstakingstatus

All the fields must return “true”

It is highly recommended to delete terminal history when we enter sensitive information like wallet passwords. It can be done simply using history -c command.

So let's open our Decenomy wallet (in this case the Sapphire wallet).

Now we are going to explain the following functions step by step

1. Home

2. Send

3. Receive

4. Contacts

5. Masternodes

6. Settings

Home

On the "HOME" window, we can see the following:

• Total (the total of the coins owned)

• Available (the total amount of coins that can be spent)

• Locked (the total number of coins locked in the Masternodes)

• Immature (the coins that do not yet have enough confirmations to generate staking)

• Pending (coins received in unconfirmed transactions)

The HOME window also provides transaction history and a means to filter the results:

• All (you can see all transactions)

• Received

• Sent (transactions sent)

• Mined (coin mined or generated through mining)

• Minted (coin generated by staking)

• MN reward (coin generated by the masternode)

• To yourself (transactions sent to ourselves)

Through this filter, we can only view the transactions that interest us.

Beside the filter is the dropdown menu for sorting. We have the following options at our disposal:

• Date desc (from the most recent to the oldest transaction)

• Date asc (oldest to newest)

• Amount desc (from largest to smallest transaction)

• Amount asc (from smallest to largest)

On the far right section of the HOME window, we can see the following:

• Synchronized Block (shows us the status of the wallet synchronization)

• Staking active (indicates if staking is active)

• Staking disabled (staking is disabled)

• sapphire.conf (used to open the wallet configuration file)

• masternode.conf (used to open the masternode configuration file)

• Debug Console (to manually give commands to the wallet)

• Active connection(s) (the active connections in our wallet)

• Unlocked Wallet (used to unlock the wallet for any operation)

• Lock Wallet (used to lock the wallet)

• Staking Only (the wallet is unlocked only to allow staking)

• Dark Theme (used to switch from dark to light theme and vice versa)

• FAQ (frequently asked questions about the wallet)

• All visible (used to reveal or hide wallet details)

• Total Hash Rate (the total hash rate of the blockchain in question)

• Masternodes (shows the number of masternodes created and if they are running or not)

• Wallet Hash Rate (hash rate of wallet when staking is active)

• Collateral (value of current collateral)

In this section of the HOME window, we find the statistics of both staking and masternode rewards.

Send

On the Send window, we can see.

• SAPP address or contact label (where we enter the recipient address )

• Amount (to enter the amount of coins to be sent)

• Address label (optional field, if the address is in our contact list the label will be displayed)

• Customize Fee (this option is used to customize our transaction fee)

It is advisable to use this option only if you are an expert user.

• Clear all (used to clear the fields seen previously)

• Add recipient (used to add additional recipients)

As we can see, a field has been added where you can enter both the address and the number of coins for a second recipient of our SAPP.

On the right, we find three dots where there is the option to add or remove this address from the contacts.

• Send (used to send the coins)

• Coin Control (used to select the inputs to spend and to block or unblock them)

• Change Address (to select a custom change address)

• Open URI (used to open a payment request from the web)

Coin Control

• Amount (the sum of the coins of the selected inputs)

• Quantity (the number of inputs selected)

• Fee (the preview of the transaction fees)

By clicking on the checkbox you can select or deselect the inputs that will be spent in our transaction.

Pressing OK confirms the changes made.

Change Address

This is used to customize the address for receiving the unspent coins when we transfer our coins.

Open URI

It is used to open a payment request from the web.

Reset to default (is used to cancel all changes made)

Receive

• QR (the QR code associated with our SAPP receiving address)

• Add Label (used to assign a label to a generated address)

• Generate Address (used to generate a new address)

• Copy (to copy the address)

• Create Request (used to generate a QR to request a payment)

• My Addresses (list of our addresses)

Create Request

• Amount (insert the coins we want to request)

• Label (label to be associated with our payment request)

• Description (optional comment)

• Generate (used to generate the QR code)

My Addresses

• by Label (order by label)

• by Address (order by address)

• by Date (order by date)

Contacts

• Add new contact

You can save a contact

Masternodes

On the masternodes window, we can check the status of our masternodes and access some functions for their control.

• Info (used to see the information of your masternode)

• Start (to start the masternode)

• Delete (to delete the masternode)

• Reload ( used to reload masternodes)

• Create Masternode Controller (used to access a guided configuration of your masternode)

• Start Inactive/s (to start only inactive masternodes)

Here are some of the masternode states

ENABLED: Your masternode has been enabled and is running on the network

ACTIVE: Your masternode has been activated and is running on the network

NEW_START_REQUIRED: Your masternode needs to be restarted. Go to your local wallet and start your masternode

EXPIRED: Your masternode is not on the network. Simply restart the alias and wait 15 minutes. If that doesn't work, set up your masternode from scratch using a new transaction ID

REMOVE: Your masternode is down and removed from the network. Simply restart the alias and wait 15 minutes. If that doesn't work, set up your masternode from scratch using a new transaction ID

Settings

• Wallet Data (access wallet features)

• Tools (access some utilities)

• Options (generic wallet settings)

• Debug (access console and repair options)

• Help (frequently asked questions)

Wallet Data

• Wallet (from this section you can back up your wallet or change your password if encrypted)

• Export Accounting (you can export the transaction history or your contacts in Excel format)

Tools

• Sign / Verify Message (from this section it is possible to sign a message to prove that you are the owner of an address, or to verify a signed message)

• BIP38 Tool (in this section it is possible to encrypt or decrypt a private key address pair)

Options

• Main (generic wallet options, for example, such as automatic start when the PC is turned on

• Wallet (from here you can change some connectivity options or staking settings)

• Display (you can change the language, the number of decimal units visible, or hide the staking graph)

Debug

• Information (wallet information such as synchronization status, number of connections, and wallet version)

• Console (used to access various wallet control commands)

• Console input (here you can type the desired command)

Below we list some of the most frequent commands

• help (a command that shows us the list of all available commands)

• getinfo (show wallet information such as version, protocol, blocks, and connections)

• listtransactions (show a list of the most recent transactions)

• addnode (to add new peers)

• createmasternodekey (to generate a new masternode key)

• getmasternodeoutputs (to see the list of eligible transactions to start a masternode)

• setstakesplitthreshold (used to divide your coins to optimize staking)

Wallet Repair

• Salvage wallet (try to recover private keys from a corrupt wallet)

• Rescan blockchain file (search for missing transactions in the entire blockchain)

• Recover transactions 1 (recover transactions from the blockchain while keeping the metadata)

• Recover transactions 2 (recover transactions from the blockchain without keeping the metadata)

• Upgrade wallet format (update the wallet.dat to the latest format)

• Rebuild index (rebuilds the blockchain indexes)

• Delete local blockchain (deletes all local blockchain files to synchronize the wallet from scratch)

• Rewind blockchain ( reverse the blockchain to the last checkpoint)

• Rewind blockchain to last week ( reverse the blockchain to the last week)

Help

• FAQ (opens a new window of frequently asked questions

• About SAPP (Opens a new window with information on the software)

All DECENOMY coins use the same base code (DECENOMY standard wallet). So this guide is valid for all DECENOMY coins!

First, let's open our wallet (in this case Sapphire). After this, as we can see in the image below, there is a padlock icon that is used to encrypt our wallet.

It is important to encrypt our wallets to ensure greater security for our coins.

Now let's click on the padlock icon and the following window will open. We recommend that you put a secure password that is not already used elsewhere.

It is important to take care not to lose this password because without the password it will no longer be possible to access funds.

Then we click the "OK" button

A further confirmation screen will open and we will click the ENCRYPT button.

Once this is done, a further confirmation window will open and the wallet will be closed to complete the operation.

Now we can restart our wallet for the encryption to take effect. You will be required to enter your password anytime you send funds or perform other operations that require it.

This guide explains how to optimize staking and solve the most common problems.

We open our wallet (in our case SAPP), and let's make sure staking is active.

Staking optimization

When staking, the larger the address balance the more will be earned. However, when we receive a reward, the coins are spent and it is necessary to wait for 600 confirmations to be available again for staking (mature)

It is therefore useful to divide the coins into different inputs through the setstakesplitthreshold command.

Whenever a successful stake is found, the stake amount is split across as many outputs (each with a value higher than the threshold) as possible.

E.g. If the coin stake input + the block stake reward is 30280, and the split threshold is 3400, the corresponding coinstake transaction will have 9 outputs (of 3400 SAPP each).

It is also possible to set the split value from the UI, Settings→Options→Wallet

Another useful command to know is setautocombinethreshold. Periodically the wallet will look for 'dust' in your addresses, and combine them up to the number of coins set in the configuration setting.

The command setautocombinethresholdtrue value will enable a feature that will automatically combine all staking / masternode rewards you receive into one input, up to the amount that you specify with the value.

So, if you want your minimum input size to be 5000 SAPP via the user interface, then you would want to follow the steps below:

1. Go to 'Settings' from your wallet

2. Select 'Options'

3. Choose 'Wallet' from the dropdown menu

4. Check the 'Autocombine threshold' checkbox to display the input box

5. Enter a value (e.g. 5000)

6. Click 'Save' to store changes

Once done, any inputs less than 5000 will be swept into a new input, repetitively until the combined threshold is exceeded.

Once that threshold is exceeded, the grouping begins with another input. Your wallet MUST be unlocked when a reward is received for this to take effect.

Common problems

We can check the staking status in detail with the following command getstakingstatus

Below is an explanation of the result of the command.

• "staking_status": true|false, (boolean) whether the wallet is staking or not

• "staking_active": true|false, (boolean) whether the wallet is active or not

• "staking_enabled": true|false, (boolean) whether staking is enabled/disabled in sapphire.conf

• "haveconnections": true|false, (boolean) whether network connections are present

• "mnsync": true|false, (boolean) whether masternode data is synced

• "walletunlocked": true|false, (boolean) whether the wallet is unlocked

• "stakeablecoins": n, (numeric) number of stakeable UTXOs

• "stakingbalance": d, (numeric) SAPP value of the stakeable coins (minus reserve balance, if any)

• "stakesplitthreshold": d, (numeric) value of the current threshold for stake split

• "lastattempt_age": n, (numeric) seconds since the last stake attempt

• "lastattempt_depth": n, (numeric) depth of the block on top of which the last stake attempt was made

• "lastattempt_hash": xxx, (hex string) hash of the block on top of which the last stake attempt was made

• "lastattempt_coins": n, (numeric) number of stakeable coins available during the last stake attempt

• "lastattempt_tries": n, (numeric) number of stakeable coins checked during the last stake attempt

For staking to be active, the first six values must necessarily be "true". Below we explain how to solve the most frequent problems you might encounter.

• haveconnections: if false, you don't have connections to the coin network. Make sure you have internet access, consider the port being blocked or bad connectivity.

• walletunlocked: if false, click the lock icon in the top right, select staking only, and enter your passphrase.

• mnsync: if false, wait 20 minutes. If still false, consider deleting mncache.dat and mnpayments.dat files from the data directory.

• staking status: if all of the above is True and this is still False, first try, close the wallet for 30 seconds, open and unlock (if encrypted), and wait 5 minutes.

That’s everything you need to know about staking.

This is important to ensure that your wallet is up to date with the latest security features, bug fixes, and other improvements.

In this guide, we will explain how to update a wallet:

Let's start by opening the wallet, in this case, Sapphire, to verify the wallet version located at the bottom left of the wallet window.

We can check for updates through our official channels (Twitter, Discord, website, or directly on GitHub)

After we have verified that there is an update (in some cases the updates are mandatory otherwise the wallet will stop working) we have to download the latest version. For Sapphire, you can locate it on GitHub using the following link:

https://github.com/decenomy/sapp

To access the latest version on GitHub, simply copy and paste the GitHub address into the address bar, as shown in the image below:

Once you are on GitHub, Click on the RELEASES link as shown in the image below:

This screen will appear:

Apparently, the latest version is v1.5.2.1, which differs from our current wallet version (v1.5.2.0).

Now, we need to select the appropriate version for our operating system, which, in this instance, is Windows. For Windows, you should choose the file named 'SAPP-1.5.2.1-Windows.zip'.

Once the file has been downloaded, we can go back to our wallet to close it.

Once this is done, go to the download folder and extract the zip file which contains the new version of the wallet as in the image below:

Once the file has been extracted we can copy "sapphire-qt" and paste it into the Sapphire wallet folder on our computer. This will replace the previous version.

An easy way to locate the Sapphire wallet folder is to find the "Sapphire Core" shortcut on our desktop. Right-click on the icon and select "Open file location" as seen in the image below:

Upon selection, you will be directed to the correct folder where you should paste the 'sapphire-qt' file. Confirm the replacement of the file, and you're all set to proceed.

Now you can start your wallet, which has been updated and is now ready for use.

In case there are any synchronization problems with your wallet, it is useful to know how to use a bootstrap (i.e. an archive containing the blockchain files). It is highly recommended to backup your wallet.dat file before making these operations. If you don't know how please refer to our guide “How to make a backup on a USB stick” Done this, if your wallet is open you have to close it.

So now let's go to the site as in the image:

After that, we choose in the bar at the top the coin that interests us (in our case Sapphire), and we click on the link in the table below as in the image:

This takes you to the overview page of the coin in question. In our case, we got sent to the landing page of the SAPP coin.

NB: Alternatively, you can access the overview page of any Decenomy coin by choosing "Overview" from the menu on the far left of your screen.

What we have to do next is locate the "download" button as indicated in the image below and click on it to start downloading the bootstrap file onto your computer.

Once this is done we have to go to the taskbar (in this case Windows).

Type in the search box %appdata% and press enter.

Afterward, a screen containing multiple folders will appear, and you should select your specific folder (in this case, Sapphire) and click to open it.

See image:

Now we need to delete some folders and files, as highlighted in the image: it is important not to remove the "wallet.dat" file and the "backups" folder.

Once this is done we will see the folder as in this image:

Now we can go to the downloads folder to extract the files from the previously downloaded bootstrap. As in the picture:

So let's copy the folders as in the image:

Then we paste the files into the AppData \ Sapphire folder (where we previously deleted the files and folders).

As in the picture:

Now as we can see in the next image there are the folders that we have just extracted

We can then restart the wallet (in this case Sapphire) to check the status of the synchronization.

In the box at the top right, you can see the status of the wallet synchronization.