HomeGuidesChangelog
GuidesDiscussions & SupportGitHubLog In
Guides
These docs are for v3.1.4. Click to read the latest docs for v4.4.2.

Creating a New Alias

Creating an Alias in Syscoin Core

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. ](Updating Syscoin-Qt from Previous Versions)

  • Fund your up to date Syscoin wallet.

Step 1: Assign an Alias to your Syscoin Address

1.1 Find all 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; this will pop-up an Options menu.
  3. Click on the Wallet tab.
  4. Check the "Enable coin control features" option, then click "OK"
962

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

  1. Click on "Send" near the top-left
    in the latest Syscoin-QT Send Menu .
  2. Click on the "Inputs..." blue button not far below the top-left.
945
  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.
960

Find the "Unlock Wallet..." Option

  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.
961

Enter your password for unlock your wallet

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.
789

The Debug Console is used for Syscoin Commands

  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.
682

Check if your Alias already exists

When an Alias you want is available, you will receive the following error code: "SYSCOINALIAS_RPC_ERROR: 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.

665

This alias is not yet assigned

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
770

1.3 aliasnew

961

Unlock your wallet

  1. In the 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 earlier
  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.
737

1st Console Command: aliasnew

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.
741

Second Console Command: syscointxfund

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.
719

Third Console Command: signrawtransaction

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.
717

Fourth Console Command: syscoinsendrawtransaction

1.7 Wait!

Quite simple really, just wait a few minutes. This is mandatory as you need to wait for the blockchain to work its magic. Take a breather, you deserve it!

1.8 aliasnew (again)

  1. In the console, paste the following command:
aliasnew youralias "" 3 EXPIRYTIME ALIASADDRESS "" "" ""
  1. Replace "youralias" with the alias you already assigned.
  2. Replace "EXPIRYTIME" with the epoch time you determined earlier.
  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 "FIFTHHEX" in this document.
721

Fifth Console Command: aliasnew (again)

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.
1600

Seventh Console Command: syscointxfund (again)


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.
1600

Eight Console Command: signrawtransaction (again) .

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.
1600

Ninth Console Command: syscoinsendrawtransaction (again)

CONGRATULATIONS! You are now the proud new owner of a Syscoin Alias! Follow the next steps to verify that you have correctly followed the steps.

You can repeat these steps to assign aliases to all your Syscoin addresses.

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