Search…
ICON2
What is ICON?
Getting Started
How to run a local network
How to run a Validator node
How to run an API Endpoint
How to create an ICON account
How to write a smart contract
How to use the JSON-RPC API
Concepts
Economics
Governance
Network
Computational utilities
Accounts
Transactions
Blocks
Consensus mechanism
Goloop
ICON Stack
Intro to the stack
ICON execution environments
Smart contracts
ICON networks
Client APIs
Storage
IDEs
Projects
BTP & ICON Bridge
Decentralized applications (dApps)
ICON Improvement Proposals (IIPs)
Support
Support
Security
Advanced topics
Release notes
2022-04-11
2021-12-23
2021-12-20
2021-12-10
2021-12-07
2021-10-22
2021-10-12
2021-03-20
2021-03-04
2021-02-17
2020-09-03
2020-08-27
2020-08-23
2020-08-10
2020-04-08
2020-01-28
2019-12-19
Powered By GitBook
Transactions

What is a transaction?

As defined by the ICON glossary:
Cryptographically signed instructions from accounts
A transaction will contain instructions on how to initiate the process of updating the state of the blockchain. A simple example of a transaction would be to send ICX from one account to another.
On ICON, a transaction has an associated identity value, also referred to as a transaction hash.

Performing a transaction

The three main categories of ways to perform a transaction are as follows: through the Hana wallet, through a decentralized application (dApp), or via the ICON JSON-RPC API.
To use Hana wallet, you must first create an account. Then, open the wallet via web browser and perform a transaction.
In the case of using a dApp, each application will have different instructions for performing a transaction. Typically they will make the information on how to do so available either on their main application interface or through their own documentations.
To use the JSON-RPC API, see the icx_sendTransaction function in the API specifications.

Querying a transaction

There are two main ways to query a transaction: through the Tracker or through the JSON-RPC API available from an API Endpoint.
To query a transaction through the tracker, click the search icon and paste in the transaction hash.
For users that intend to perform transaction queries in a programmatic way through an API Endpoint, you can follow the instructions below to validate and confirm the transaction.
Check the Transaction Validation using the JSON-RPC API
If you get the transaction hash as a response to sending a transaction to the ICON network, this means that your transaction has passed the validation. ICON network returns the transaction hash only when a transaction is valid. For specific information about this process, see the JSON-RPC APIs "icx_sendTransaction" section of the ICON JSON-RPC API v3 Specification documentation.
Check the Transaction Confirmation using the JSON-RPC API
You can check if a transaction is confirmed or pending using "icx_getTransactionResult" JSON-RPC API. "Pending" means that a transaction is in the transaction pool or block generation stage (except in the case of consensus failure on the block, it can be temporarily marked as "pending"). For specific information about this process, see the JSON-RPC APIs "icx_getTransactionResult" section of the ICON JSON-RPC API v3 Specification documentation.

The transaction process

Create Transaction
Create and propagate a transaction to the ICON network. Propagated transactions proceed with basic syntax and signature validation, and is put into the transaction pool to be recorded to a block if they are valid. At the same time, the ICON network returns the transaction hash data. If a transaction is invalid, that transaction is immediately rejected and the ICON network returns an error instead of a transaction hash. The word "rejected" refers to the transaction being removed because it can not be propagated on the ICON network.
Transaction Pool
In this stage, a transaction is waiting before being put into the block.
Block Generation
In this stage, a transaction is put into a generated block. If consensus is reached regarding the generated block (after the consensus process), that block is connected to the blockchain, and the transactions in the block are recorded permanently. If the consensus on the block fails, all transactions in that block are removed after a certain period of time. The word "removed" refers to ceasing to exist on the ICON network entirely. Therefore, the user who created and propagated the transaction needs to track the transaction until it is recorded on the blockchain (i.e. confirmed).
Confirmed
The block which contains a transaction is connected to the blockchain after the consensus process. This state of the transaction is called "confirmed". A transaction in a confirmed block is recorded permanently regardless of the transaction processing result (success or failure).

Transaction fees

Fees are incurred when executing a smart contract on the ICON network, and the fees are determined based on the total amount of resources used to execute the transaction. STEP is the unit of the resource-usage measurement.
There are three categories that charge transaction fees:
  1. 1.
    Smart Contract Function Usage
  2. 2.
    Blockchain Database Usage
  3. 3.
    Amount of Transaction Data
Previous
Accounts
Next
Blocks
Last modified 2mo ago
Copy link
Contents
What is a transaction?
Performing a transaction
Querying a transaction
The transaction process
Transaction fees