Articles in this section

    See more

    How to set a custom trust line in the mobile app

    • Updated

    The XRP Ledger is home to its native currency XRP. Any wallet can receive and send XRP without limits if it holds a sufficient XRP reserve.

     

    The XRPL also lets users create new currencies easily. This is enabled by issuing and trust lines where issuing lets an address create new tokens and send them to other addresses as long as they have a trust line enabled for said token.

     

    Gateways like GateHub are businesses that can create new tokens that act as representations of actual currencies on the XRPL. For example, GateHub issues the GateHub BTC, but this is not actual BTC and is also not perfectly equivalent to Bitstamp BTC. Their value is similar because they are redeemable for actual BTC with their respective issuers.

     

    Some projects like Casinocoin, issue and run their project natively on the XRPL. In this particular case, CSC tokens on the XRPL are actual tokens and not just representations of CSC somewhere else.

     

    Lastly, issuing is available to anyone and anything is possible in theory. There are projects emerging with tokenization, NFTs, learning tools, specific industries and so much more in mind.

     

    GateHub does not endorse any project on the XRPL. However, anyone is free to interact with any of the projects at their own discretion as the XRPL is a completely free and unrestricted blockchain.

    How to set a custom trust line:

    A custom trust line allows you to receive crypto assets from issuers other than GateHub and GateHub Fifth.

    1. Select the wallet you want to set the trust line for from the drop-down menu. 
    2. Go to settings in the top right corner. 

    Wallet settings APP.png

    1. Select "Wallet settings".

    Walet settings APP.png

    1. Click on "Trustlines" at the bottom of the screen.

    Trust Lines Settings App.png

     

    1. Click on "Add custom" at the bottom of the list.

    App Custom market trut line.png

    1. Enter the issuing XRP Ledger address.
    2. Enter the 3-letter currency code (standard currency code) or 40-character hexadecimal string for non-standard currency code.

    Add Custom App.png

    1. OPTIONAL: advanced options.
    2. Click "Confirm".

     

    Standard and non-standard currency codes

    Standard currency codes are the most frequently used type of currency code. These are used for most currencies that exist on the XRPL like GateHub USD, EUR, BTC and so on.

     

    These are the rules:

    • Currency codes must be exactly 3 ASCII characters in length. The following characters are permitted: all uppercase and lowercase letters, digits, as well as the symbols ?, !, @, #, $, %, ^, &, *, <, >, (, ), {, }, [, ], and |.
    • Currency codes are case sensitive, which means that BTC, BTc and btc are all different currencies on the ledger. For this reason, users need to specify exactly which currency they want to trust when creating a new trust line.
    • The currency code XRP (all-uppercase) is disallowed. Real XRP typically does not use a currency code in the XRP Ledger protocol.

    All GateHub trust lines are created automatically with just a few clicks. The correct currency code and the issuer will be set for you without your input. For third-party currencies, you will need to double-check the case of the currency code.

     

    Non-standard currency codes allow projects and businesses to issue currencies with longer currency codes like (potentially) DOGE, LUNA, LINK, MATIC, etc.

     

    In this case, a 160-bit/40-character hexadecimal string is used to specify the currency code. This string is decoded into a human-readable format. To prevent this from being treated as a "standard" currency code, the first 8 bits MUST NOT be 0x00.

     

    The option to set a custom market is currently not available in the GateHub mobile app. See the instruction on how to set up a custom market on the GateHub webpage.