Before You Begin:

Before creating a new Alias you will need to complete the following steps:

  • Delete old Syscoin Core software and install the latest version for your operating system, and update your syscoin.conf file.

  • Fund your up to date Syscoin wallet.


Step 1: Assigning an Alias to Your Syscoin Address

1.1 Find all of the Syscoin addresses associated with your wallet.dat

  1. In latest Syscoin-QT, Click on the "File" menu option near the top left.
  2. Select the "Options" menu option.
  3. Click on the Wallet tab.
  4. Check the "Enable coin control features" option, then click "OK". 


Coin Control Allows you to see the "Inputs..." section in your Syscoin wallet



  1. Click on "Send" near the top-left
  2. Click on the "Inputs..." blue button near the top left.




  1. Copy each address that contains coins and paste the addresses in a separate document. This will be important for the next steps.


1.2 Unlock your wallet (If it is locked)

  1. Select the "Settings" menu on the top-left of the screen.



  1. Click the "Unlock Wallet..." option.
  2. Enter the password you had previously set for your wallet, then click "OK". Your wallet will be unlocked as long as you entered the password correctly.



1.2.1 Aliasinfo: Open the Syscoin Debug Console and see if the Alias you want is available.

  1. Click on the "Tools" menu item at the top left menu.
  2. Select the "Debug Console" option.




  1. In the console, paste the following command:
aliasinfo YOURALIAS


  1. Replace "YOURALIAS" with the alias you want to assign to your Syscoin address. In this case, the output provided after the command clearly shows an Alias assigned to address SSiuRbddTt6QweUWW1pFCFoUHow4zmF3i6and is not expired("expired" is set to "false"); this means that the Alias is already assigned to an address.




When an Alias you want is available, you will receive the following error code: "SYSCOIN_ALIAS_RPCERROR: ERRCODE: 5517 — Failed to read from alias DB (code -1)". This means that you can proceed with the following steps, using the alias you selected.



IMPORTANT: There are a few things to understand before we proceed.

You need to provide the console with two addresses.
The address that will pay the fee to create the Alias(referred to as the PAYMENTADDRESS in these instructions), and the address you want to assign the Alias to (or ALIASADDRESS). Please note that you can use the same address for both the PAYMENTADDRESS and the ALIASADDRESS, just make sure you have enough Syscoin to cover fees with the PAYMENTADDRESS. In this example, we will be using the same address (SSiuRbddTt6QweUWW1pFCFoUHow4zmF3i6).


You need to determine when you want your alias to expire.
Alias creation is very inexpensive, however, the longer the expiry date, the more it will cost exponentially; we suggest that you create an expiry of no more than two years away from today's date and simply renew it when you are closer to your expiry. Syscoin uses Epoch time (or Unix time) to determine the expiry of your Alias, so you need to determine what epoch time you want the expiry to take place.

  • Enter the date that you would like your Alias to expire on at epochconverter.com; in this case, we will expire the Alias on May 28th, 2020.
  • Click "Human date to Timestamp"
  • Copy and paste the number that appears under "Epoch Timestamp" somewhere safe; in this case, the number is 1590702110




1.3 aliasnew


  1. In the debug console, paste the following command:
aliasnew YOURALIAS "" 3 EXPIRYTIME ALIASADDRESS " " "


  1. Replace "YOURALIAS" with the alias you want to create. 
  2. Replace "EXPIRYTIME" with the epoch time you determined previously. 
  3. Replace "ALIASADDRESS" with the address you have selected to assign to the alias.
  4. Press "Enter" and this will return a long strand of letters and numbers called a hex. Copy the hex (without quotes) for the next step. We're going to call this "FIRSTHEX" in this document.



1.4 syscointxfund

  1. In the console, paste the following command:


syscointxfund FIRSTHEX '{"addresses": ["PAYMENTADDRESS"]}' false


  1. Replace "FIRSTHEX" with the hex that step 1.3.4 provided you.
  2. Replace "PAYMENTADDRESS" (but keep the quotation marks) with the Syscoin address you will use to pay for the Alias creation.
  3. Press "Enter" and this will return a long strand of letters and numbers called a hex, copy the hex (without quotes) for the next step; we're going to call this "SECONDHEX" in this document.



1.5 signrawtransaction

  1. In the console, paste the following command:
signrawtransaction SECONDHEX


  1. Replace "SECONDHEX" with the hex that step 1.4.4 provided you.
  2. Press "Enter" and this will return a long strand of letters and numbers called a hex, copy the hex (without quotes) for the next step; we're going to call this "THIRDHEX" in this document.



1.6 syscoinsendrawtransaction

  1. In the console, paste the following command:
syscoinsendrawtransaction THIRDHEX
  1. Replace "THIRDHEX" with the hex that step 1.5.3 provided you.
  2. Press "Enter" and this will return a long strand of letters and numbers called a hex, you don't need to copy this hex.



1.8 aliasnew (again)

  1. In the console, paste the following command:


aliasnew youralias "" 3 EXPIRYTIME ALIASADDRESS "" "" ""


        2. Replace "youralias" with the alias you already assigned.

        3. Replace "EXPIRYTIME" with the epoch time you determined earlier.

        4. Replace "ALIASADDRESS" with the address you have selected to assign to the alias.

        5. Press "Enter" and this will return a long strand of letters and numbers called a hex, copy the hex (without quotes) for the next step;                 we're going to call this "FIFTHHEX" in this document.




1.9 syscointxfund (again)

  1. In the console, paste the following command:
syscointxfund FIFTHHEX '{"addresses": ["PAYMENTADDRESS"]}' false
  1. Replace "FIFTHHEX" with the hex that step 1.8.5 provided you.
  2. Replace "PAYMENTADDRESS" with the Syscoin address you are using to pay for the Alias creation.
  3. Press "Enter" and this will return a long strand of letters and numbers called a hex, copy the hex (without quotes) for the next step; we're going to call this "SIXTHHEX" in this document.



1.10 signrawtransaction (again)

  1. In the console, paste the following command:
signrawtransaction SIXTHHEX
  1. Replace "SIXTHHEX" with the hex that step 1.9.4 provided you.
  2. Press "Enter" and this will return a long strand of letters and numbers called a hex, copy the hex (without quotes) for the next step; we're going to call this "SEVENTHHEX" in this document.



1.11 syscoinsendrawtransaction (again)

  1. In the console, paste the following command:
syscoinsendrawtransaction SEVENTHHEX
  1. Replace "SEVENTHHEX" with the hex that step 1.10.3 provided you.
  2. Press "Enter" and this will return a long strand of letters and numbers called a hex, you don't need to copy this hex.



STEP 2: Verify

2.1: aliasinfo

  1. Wait a few minutes, it will take another few minutes to confirm your transaction.
  2. In the console, paste the following command:


aliasinfo youralias
  1. Replace "youralias" with the Alias you just created.

  2. Press "ENTER", your alias should now show the address you assigned to it under the "address" field as shown in the example below.
    aliasinfo confirms that your alias is linked to your Syscoin address


2.2 aliasbalance

  1. In the console, paste the following command:


aliasbalance youralias
  1. Replace "youralias" with the Alias you just created.

  2. Press "ENTER", your alias should now show the balance of the address you assigned to it.
    aliasbalance shows you the balance of the address linked to your alias