Skip to main content

Cosmos (ATOM)

Cosmos wallet structure​

The Cosmos wallet has the following structure.

  • Main address
  • Child address

TIP Cosmos has a fee address, but does not use it.







Deposit​

Deposit status​

When an asset from the outside arrives at the main or a child address, Octet recognizes it as a deposit. When the deposit transaction is included in the blocks, it is finalized (FINALIZED). When an asset is sent to a main or a child address but has not arrived, that transaction is not recognized. Therefore, there is no FAILED status for the deposit transaction.





Gathering​

Gathering is only available for centralized wallets.

Gathering process and fees​

Assets stored in child addresses don't move to the main address unless gathering is requested. Therefore, gatherings should be made regularly to avoid a deficit in the main address.

When gathering of a specific asset is requested, all ATOM stored in every child address gets transferred to the main address. At this point, one transaction occurs per child address. For example, if ATOM is stored in 10 child addresses, 10 transactions will occur in total.


A gathering fee occurs once per transaction, and it is deducted from the asset to be gathered. Gathering will not be made for child addresses with assets less than the estimated fees. The gathering process is as follows.

  1. Request gathering.
  2. Generate a transaction for each child address to be gathered.
  3. Calculate the optimal fees and propagate the transactions.
  4. Gathering is completed when the transactions are confirmed in the blocks.


Gathering status​

Gathering status can be specified into four types, depending on the process. The asset stored in the child address is in AWAITING_GATHERING status.

When gathering is requested and a gathering transaction is generated, the status of the asset changes to GATHERING. When the transaction is included in the blocks, the status of the asset is processed to COMPLETED and the gathering is finished.

When a gathering is tried and the transaction failed, the status of the asset remains as GATHERING_FAILED. Assets in gathering failed status are included in the gathering target again. When a gathering is tried but failed to generate a transaction due to insufficient fees, it remains in AWAITING_GATHERING status.

Status nameDescription
AWAITING_GATHERINGAwaiting gathering
GATHERINGGenerate gathering transaction
COMPLETEDComplete gathering transaction
GATHERING_FAILEDFailed gathering transaction




Withdrawal​

Withdrawal status​

A withdrawal is finalized (FINALIZED) when the transaction is included in the blocks.

Status nameDescription
PENDINGWithdrawal transaction is generated
FINALIZEDWithdrawal transaction is included in the blocks
FAILEDWithdrawal transaction failed




Fees​

Transaction fees are calculated by multiplying the maximum gas usage and the gas price.

Transaction Fees = Gas Wanted x Gas Price
  • Gas Wanted is the maximum gas usage. The actual gas usage is less than that. However, regardless of the actual usage, the fee is paid for the full Gas wanted value.
  • Gas Price is the price per gas.