[BLOCK-2214] - How to create trx, check explorer (toolkit) (#165)

* [BLOCK-2214] - How to create trx, check explorer (toolkit) * [BLOCK-2214] - How to create trx, check explorer (toolkit); fix dead link * [BLOCK-2214] - How to create trx, check explorer (toolkit); different explanation for searching Uniqs * [BLOCK-2214] - How to create trx, check explorer (toolkit); fix testnet endpoint * [BLOCK-2214] - How to create trx, check explorer (toolkit); remove Explore Available Uniqs section * [BLOCK-2214] - How to create trx, check explorer (toolkit); Prerequisites was changed * BLOCK-2214 - Update wording and update the first-hand purchase image --------- Co-authored-by: Janos Lazar <[email protected]> Co-authored-by: Igor Sikachyna <[email protected]>
ultraio · Apr 18, 2024 · f0eb08f · f0eb08f
1 parent 092e090
commit f0eb08f
Show file tree

Hide file tree

Showing 18 changed files with 146 additions and 0 deletions.
diff --git a/docs/tutorials/fundamentals/images/purchase-action-builder.png b/docs/tutorials/fundamentals/images/purchase-action-builder.png
diff --git a/docs/tutorials/fundamentals/images/purchase-attribute-I.png b/docs/tutorials/fundamentals/images/purchase-attribute-I.png
diff --git a/docs/tutorials/fundamentals/images/purchase-attribute-II.png b/docs/tutorials/fundamentals/images/purchase-attribute-II.png
diff --git a/docs/tutorials/fundamentals/images/purchase-confirm-ultra-wallet.png b/docs/tutorials/fundamentals/images/purchase-confirm-ultra-wallet.png
diff --git a/docs/tutorials/fundamentals/images/purchase-confirm.png b/docs/tutorials/fundamentals/images/purchase-confirm.png
diff --git a/docs/tutorials/fundamentals/images/purchase-factory-explorer.png b/docs/tutorials/fundamentals/images/purchase-factory-explorer.png
diff --git a/docs/tutorials/fundamentals/images/purchase-ultra-wallet-confirm.png b/docs/tutorials/fundamentals/images/purchase-ultra-wallet-confirm.png
diff --git a/docs/tutorials/fundamentals/images/purchase-user-uniq-explorer-show-uniqs.png b/docs/tutorials/fundamentals/images/purchase-user-uniq-explorer-show-uniqs.png
diff --git a/docs/tutorials/fundamentals/images/purchase-user-uniq-explorer.png b/docs/tutorials/fundamentals/images/purchase-user-uniq-explorer.png
diff --git a/docs/tutorials/fundamentals/images/token-transfer-action-builder.png b/docs/tutorials/fundamentals/images/token-transfer-action-builder.png
diff --git a/docs/tutorials/fundamentals/images/token-transfer-attributes.png b/docs/tutorials/fundamentals/images/token-transfer-attributes.png
diff --git a/docs/tutorials/fundamentals/images/token-transfer-confirm.png b/docs/tutorials/fundamentals/images/token-transfer-confirm.png
diff --git a/docs/tutorials/fundamentals/images/token-transfer-eosio.token.png b/docs/tutorials/fundamentals/images/token-transfer-eosio.token.png
diff --git a/docs/tutorials/fundamentals/images/token-transfer-explorer.png b/docs/tutorials/fundamentals/images/token-transfer-explorer.png
diff --git a/docs/tutorials/fundamentals/images/token-transfer-txn-completed.png b/docs/tutorials/fundamentals/images/token-transfer-txn-completed.png
diff --git a/docs/tutorials/fundamentals/images/token-transfer-ultra-wallet-confirm.png b/docs/tutorials/fundamentals/images/token-transfer-ultra-wallet-confirm.png
diff --git a/docs/tutorials/fundamentals/tutorial-token-transfer-and-nft-purchase.md b/docs/tutorials/fundamentals/tutorial-token-transfer-and-nft-purchase.md
@@ -0,0 +1,141 @@
+---
+title: 'Tutorial - Token transfer and Uniq purchase transactions'
+order: -99998
+outline: [0, 5]
+---
+
+# Tutorial - Token transfer and Uniq purchase transactions
+
+This tutorial will demonstrate how to use the Ultra toolkit for sending asset (transfer) and purchasing Uniq interact with Ultra the blockchain.
+
+## Prerequisites
+
+Before starting this tutorial, you will need:
+
+- A developer account on the Ultra testnet. If you don't have one, follow our previous tutorial: [Generate a key and create a developer Testnet account](./tutorial-generate-key-and-create-testnet-account.md).
+- Your account must have sufficient UOS tokens for transactions and fees. If you don't have tokens, see [how to get tokens](./how-to-get-tokens.md).
+
+## Goal
+
+The goal of this tutorial is to show you how to:
+
+1. Transfer UOS tokens between accounts using the `eosio.token::transfer` action.
+2. Purchase digital assets (Uniqs) using the `eosio.nft.ft::purchase.a` action within the Ultra ecosystem.
+
+## Transferring Tokens
+
+To transfer tokens using the Ultra toolkit, follow these steps closely:
+
+### Step 1: Access the Transaction Builder
+
+Open the Ultra toolkit and log in with your developer account. Click on the 'Transaction Builder' tab to begin creating a new transaction.
+
+![](./images/token-transfer-action-builder.png)
+
+### Step 2: Select the eosio.token Contract
+
+Navigate to the `eosio.token` contract by clicking on it from the list of available contracts. Once you select the contract, choose the `eosio.token::transfer` action to initiate a token transfer.
+
+![](./images/token-transfer-eosio.token.png)
+
+### Step 3: Fill in the Transfer Details
+
+In the token transfer fields, enter the details of the transaction:
+- **From**: `1aa2aa3aa4in` (your account)
+- **To**: `1aa2aa3aa4io` (recipient's account)
+- **Quantity**: `0.00000001 UOS` (amount to be transferred)
+- **Memo**: `Test transaction` (a note about the transaction)
+
+Ensure all details are correct to avoid any errors in the transaction.
+
+Finally press the `Send 1 Action` button.
+
+![](./images/token-transfer-attributes.png)
+
+### Step 4: Preview and Confirm the Transaction
+
+Review all the transaction details on the preview screen. Make sure that everything is accurate before you proceed.
+
+![](./images/token-transfer-confirm.png)
+
+### Step 5: Confirm and Sign with Ultra Wallet
+
+Confirm and sign the transaction using the Ultra Wallet extension. This step is crucial as it authorizes the blockchain to execute the transfer under your account.
+
+![](./images/token-transfer-ultra-wallet-confirm.png)
+
+### Step 6: Transaction Completion
+
+After signing the transaction, you will see a confirmation screen indicating that the transaction was successfully completed.
+
+![](./images/token-transfer-txn-completed.png)
+
+### Step 7: Verify the Transaction
+
+To ensure the transaction was successfully processed, visit the Ultra Testnet Explorer at `https://explorer.testnet.ultra.io/`. Search for your account (e.g. `1aa2aa3aa4in`) to view the transaction details and confirm that the transfer went through as intended.
+
+![](./images/token-transfer-explorer.png)
+
+## Purchasing Digital Assets (Uniqs)
+
+To purchase a Uniq from the Uniq Factory using the Ultra toolkit, follow these steps carefully:
+
+### Step 1: Verify Factory Details
+
+Begin by checking the Factory Explorer in the Uniq Explorer. Confirm the on-chain data for the Uniq Factory you are interested in, which in this case is Factory ID 4243, owned by account `1aa2aa3aa4io`.
+
+![](./images/purchase-factory-explorer.png)
+
+### Step 2: Initiate Purchase Action
+
+Navigate to the action builder in your toolkit and select the `eosio.nft.ft` contract. Choose the purchase action to start the process of buying a Uniq.
+
+![](./images/purchase-action-builder.png)
+
+### Step 3: Enter Purchase Details
+
+On the purchase action screen, fill out the attributes necessary for the transaction:
+- **Factory ID**: `4243` (ID of the Uniq Factory)
+- **Maximum Price**: `1.00000000 UOS` (maximum amount you are willing to pay)
+- **Buyer**: `1aa2aa3aa4in` (your account)
+- **Receiver**: `1aa2aa3aa4in` (your account, receiving the Uniq)
+
+![](./images/purchase-attribute-I.png)
+
+Scroll down to complete any additional required attributes for the purchase.
+
+![](./images/purchase-attribute-II.png)
+
+After filling the indicated fields press the `Send 1 Action` button.
+
+### Step 4: Review and Confirm Transaction
+
+Carefully review all the transaction details on the confirmation screen to ensure they are correct before proceeding.
+
+![](./images/purchase-confirm.png)
+
+### Step 5: Confirm and Sign with Ultra Wallet
+
+Confirm and sign the transaction using the Ultra Wallet extension. This step is essential to authorize the transaction on the blockchain.
+
+![](./images/purchase-confirm-ultra-wallet.png)
+
+### Step 6: Transaction Completion
+
+Once the transaction is signed, a confirmation screen will display indicating that the purchase was successfully completed.
+
+![](./images/purchase-ultra-wallet-confirm.png)
+
+### Step 7: Verify Ownership of New Uniq
+
+#### Step 7a: Access Your User Inventory Page
+
+To confirm the purchase of your new Uniq, navigate to the Ultra toolkit page ([https://toolkit.ultra.io/user](https://toolkit.ultra.io/user)). Once there, enter your account name (e.g. `1aa2aa3aa4in`) in the `Start the search by entering a username` field. Make sure to set your endpoint to the test network at the top right corner, which for this example is [https://ultratest.api.eosnation.io](https://ultratest.api.eosnation.io).
+
+![](./images/purchase-user-uniq-explorer.png)
+
+#### Step 7b: Verify the Newly Purchased Uniq
+
+After entering your account name and setting the correct network endpoint, scroll down to view your Uniqs. Here, you should see the newly purchased Uniq with ID 303221 from Uniq Factory 4243.
+
+![](./images/purchase-user-uniq-explorer-show-uniqs.png)
diff --git a/docs/tutorials/index/index.md b/docs/tutorials/index/index.md
@@ -27,6 +27,11 @@ General tutorials to help feed your curiosity.
         <td>Learn how to use our Ultra Wallet extension and set it up</td>
         <td><a href="../fundamentals/tutorial-setup-the-wallet">Link</a></td>
     </tr>
+    <tr>
+        <td>Tutorial - Token transfer and Uniq purchase transactions</td>
+        <td>Demonstrating token transfer and Uniq puchasing</td>
+        <td><a href="../fundamentals/tutorial-token-transfer-and-nft-purchase">Link</a></td>
+    </tr>
     <tr>
         <td>How to get Tokens</td>
         <td>How to get tokens for interactions on the testnet</td>