ARCHIVE/xrpl-dev-portal
1
0
Fork 0
mirror of https://github.com/XRPLF/xrpl-dev-portal.git synced 2025-11-04 11:55:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Issue a token: minor cleanup

Browse Source
This commit is contained in:
mDuo13
2021-08-27 11:14:08 -07:00
parent 03dfe6d6de
commit a5bd489248
2 changed files with 16 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
assets/js/tutorials/issue-a-token.js
View File

@@ -131,6 +131,10 @@ $(document).ready(() => {
$("#currency-code-hex").keyup(update_currency_code)
$("#use-std-code").change(update_currency_code)
$("#use-hex-code").change(update_currency_code)
// run once on load because some browsers pre-fill values from previous
// pageviews.
update_currency_code()
// Configure Issuer Settings handler -----------------------------------------
$("#config-issuer-button").click( async (event) => {

13
content/tutorials/use-tokens/issue-a-fungible-token.md
View File

@@ -318,10 +318,21 @@ As before, wait for the previous transaction to be validated by consensus before
Before you can receive tokens, you need to create a [trust line](trust-lines-and-issuing.html) to the token issuer. This trust line is specific to the [currency code](currency-formats.html#currency-codes) of the token you want to issue, such as USD or FOO. You can choose any currency code you want; each issuer's tokens are treated as separate in the XRP Ledger protocol. However, users' balances of tokens with the same currency code can [ripple](rippling.html) between different issuers if the users enable rippling settings.
The hot address needs a trust line like this before it can receive tokens from the issuer. Similarly, each user who wants to hold your token must also create a trust line[¹](#footnotes).
The hot address needs a trust line like this before it can receive tokens from the issuer. Similarly, each user who wants to hold your token must also create a trust line[¹](#footnotes). Each trust line increases the [reserve requirement](reserves.html) of the hot address, so you must hold enough spare XRP to pay for the increased requirement. Your reserve requirement goes back down if you remove the trust line.
**Tip:** A trust line has a "limit" on how much the recipient is willing to hold; others cannot send you more tokens than your specified limit. For community credit systems, you may want to configure limits per individual based on how much you trust that person. For other types and uses of tokens, it is normally OK to set the limit to a very large number.
To create a trust line, send a [TrustSet transaction][] from the **hot address** with the following fields:
| Field | Value |
|:-----------------------|:----------------------------------------------------|
| `TransactionType` | `"TrustSet"` |
| `Account` | The hot address. (More generally, this is the account that wants to receive the token.) |
| `LimitAmount` | An object specifying how much, of which token, from which issuer, you are willing to hold. |
| `LimitAmount.currency` | The currency code of the token. |
| `LimitAmount.issuer` | The cold address. |
| `LimitAmount.value` | The maximum amount of the token you are willing to hold. |
The following code sample shows how to send a [TrustSet transaction][] from the hot address, trusting the issuing address for a limit of 1 billion FOO:
<!-- MULTICODE_BLOCK_START -->