LAST UPDATED:

January 19, 2022, 1:55:04 PM

LABEL function

MNEMONIC:

LAB

View, assign and manage address labels.

TABLE OF CONTENTS

  1. SUMMARY
  2. DISAMBIGUATION
  3. SYNTAX
  4. USAGE
  5. CHAINING
  6. RELATED FUNCTIONS

1. SUMMARY

The LABEL function enables you to assign human-readable names to blockchain addresses. Because they are quicker to type, labels allow us to easily and securely reference full addresses in Vektor functions, without worrying about mistakes or typos.

2. DISAMBIGUATION

  • LABEL is not used to view the value of assets held on your labelled addresses. (see PORTFOLIO)

3. SYNTAX

LABEL | LAB
    .LIST
    .ADD (label_name: text, label_address: address)
    .REMOVE (label_name: text)

4. USAGE

LABEL (or its mnemonic LAB) is most commonly used without subfunctions to list labelled addresses or with the subfunctions ADD or REMOVE to manage addresses.

LABEL

This will display all labelled addresses alongside their key details:

  • The associated Blockchain
  • The Date Created
  • Label Name
  • Address Value
screenshot

Labelled addresses can be reordered by Blockchain, Date Created, Name or Address.

The Search Button at the top right corner of the pane is useful to find addresses when you have many labelled addresses.

ADD

The ADD subfunction is used to add new labelled addresses. Label names cannot include spaces.

LABEL.ADD("TEST",0x82b1472515704e29Bcabf2f74EcdD622615918f8)

This command creates a label called TEST using an example address.

screenshot

This Pane shows us key information about our new label and indicates that the label has been successfully added.

If the command submitted to the Command Line has not been formatted correctly, Vektor will open the LABEL.ADD Function Form to help build and achieve the intended command.

screenshot

Once the Label Name and Label Address have been inputted, the Function Form gives us a correctly formatted command.

Pressing INSERT pastes the command to the Command Line, ready for execution.

REMOVE

The REMOVE subfunction is used to remove labelled addresses.

LABEL.REMOVE(TEST)

This command removes a labelled address called TEST.

screenshot

This Pane confirms that the label has been successfully removed.

If the command submitted to the Command Line has not been formatted correctly, Vektor will open the LABEL.REMOVE Function Form to help build and achieve the intended command.

screenshot

Once the Label Name has been selected, the Function Form gives us a correctly formatted command.

Pressing INSERT pastes the command to the Command Line, ready for execution.

5. CHAINING

-