gaspersic/solana
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Update SPL Token exchange documentation to include associated-token-account workflow (#13397)

Browse Source 
(cherry picked from commit 97284adabb)

Co-authored-by: Michael Vines <mvines@gmail.com>
This commit is contained in:
mergify[bot]
2020-11-04 19:57:02 +00:00
committed by GitHub
parent e476dc4eaa
commit 61246999ac
1 changed files with 38 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
docs/src/integrations/exchange.md
View File

@ -576,8 +576,10 @@ spl-token-cli 2.0.1
SPL Token accounts carry additional requirements that native System Program SPL Token accounts carry additional requirements that native System Program
accounts do not: accounts do not:
1. SPL Token accounts are not implicitly created, so must be created explicitly 1. SPL Token accounts must be created before an amount of tokens can be
before an SPL Token balance can be deposited deposited. Token accounts can be created explicitly with the
`spl-token create-account` command, or implicitly by the
`spl-token transfer --fund-recipient ...` command.
1. SPL Token accounts must remain [rent-exempt](https://docs.solana.com/apps/rent#rent-exemption) 1. SPL Token accounts must remain [rent-exempt](https://docs.solana.com/apps/rent#rent-exemption)
for the duration of their existence and therefore require a small amount of for the duration of their existence and therefore require a small amount of
native SOL tokens be deposited at account creation. For SPL Token v2 accounts, native SOL tokens be deposited at account creation. For SPL Token v2 accounts,
@ -585,7 +587,6 @@ this amount is 0.00203928 SOL (2,039,280 lamports).
#### Command Line #### Command Line
To create an SPL Token account with the following properties: To create an SPL Token account with the following properties:
1. At a random address
1. Associated with the given mint 1. Associated with the given mint
1. Owned by the funding account's keypair 1. Owned by the funding account's keypair
@ -600,6 +601,14 @@ Creating account 6VzWGL51jLebvnDifvcuEDec17sK6Wupi4gYhm5RzfkV
Signature: 4JsqZEPra2eDTHtHpB4FMWSfk3UgcCVmkKkP7zESZeMrKmFFkDkNd91pKP3vPVVZZPiu5XxyJwS73Vi5WsZL88D7 Signature: 4JsqZEPra2eDTHtHpB4FMWSfk3UgcCVmkKkP7zESZeMrKmFFkDkNd91pKP3vPVVZZPiu5XxyJwS73Vi5WsZL88D7
``` ```
Or to create an SPL Token account with a specific keypair:
```
$ solana-keygen new -o token-account.json
$ spl-token create-account AkUFCWTXb3w9nY2n6SFJvBV6VwvFUCe4KBMCcgLsa2ir token-account.json
Creating account 6VzWGL51jLebvnDifvcuEDec17sK6Wupi4gYhm5RzfkV
Signature: 4JsqZEPra2eDTHtHpB4FMWSfk3UgcCVmkKkP7zESZeMrKmFFkDkNd91pKP3vPVVZZPiu5XxyJwS73Vi5WsZL88D7
```
### Checking an Account's Balance ### Checking an Account's Balance
#### Command Line #### Command Line
@ -615,16 +624,17 @@ $ solana balance 6VzWGL51jLebvnDifvcuEDec17sK6Wupi4gYhm5RzfkV
### Token Transfers ### Token Transfers
For SPL Token transfers to succeed, a few prerequisite conditions must be met: The source account for a transfer is the actual token account that contains the
1. The recipient account must exist before the transfer is executed. As described amount.
in [account creation](#account-creation), SPL Token accounts are *not* explicitly
created. The recipient address however can be a normal wallet account. If an associated
1. Both the sender and recipient accounts must belong to the same mint. SPL Token token account for the given mint does not yet exist for that wallet, the
accounts can only hold one type of SPL token. transfer will create it provided that the `--fund-recipient` argument as
provided.
#### Command Line #### Command Line
``` ```
spl-token transfer <SENDER_ACCOUNT_PUBKEY> <AMOUNT> <RECIPIENT_ACCOUNT_PUBKEY> spl-token transfer <SENDER_ACCOUNT_ADDRESS> <AMOUNT> <RECIPIENT_WALLET_ADDRESS> --fund-recipient
``` ```
#### Example #### Example
@ -655,12 +665,24 @@ made to exend the `preBalance` and `postBalance` transaction status metadata
fields to include SPL Token balance transfers. fields to include SPL Token balance transfers.
### Withdrawing ### Withdrawing
The withdrawal address a user provides must point to an initialized SPL Token account The withdrawal address a user provides should be the same address used for
of the correct mint. Before executing a withdrawal [transfer](#token-transfers), regular SOL withdrawal.
it is recommended that the exchange check the address as
[described above](#validating-user-supplied-account-addresses-for-withdrawals) Before executing a withdrawal [transfer](#token-transfers),
as well as query the account to verify its existence and that it belongs to the the exchange should check the address as
correct mint. [described above](#validating-user-supplied-account-addresses-for-withdrawals).
From the withdrawal address, the associated token account for the correct mint
determined and the transfer issued to that account. Note that it's possible
that the associated token account does not yet exist, at which point the
exchange should fund the account on behalf of the user. For SPL Token v2
accounts, funding the withdrawal account will require 0.00203928 SOL (2,039,280
lamports).
Template `spl-token transfer` command for a withdrawal:
```
$ spl-token transfer --fund-recipient <exchange token account> <withdrawal amount> <withdrawal address>
```
### Other Considerations ### Other Considerations