Skip to main content

Solana (SOL)

Solana wallet structure​

A Solana wallet has the following structure.

  • Main address
  • Fee address
  • Child address

TIP In a centralized wallet, the fee (SOL) is deducted from the fee address when gathering. However, when withdrawing, the fee is deducted from the fee address only when the fee delegation feature is used.






Deposit​

Deposit status​

When an asset sent from the outside arrives at the main address or a child address, Octet recognizes it as a deposit. However, the deposit is not processed as completed even if the deposit transaction is included in a block. To ensure the finality of the transaction, additional blocks must be generated before the transaction is processed as completed (FINALIZED). When an asset is sent from the outside but has not arrived at the main address or a child address, that transaction is not recognized. Therefore, there is no failed (FAILED) status for deposit transactions.

Status nameDescription
UNFINALIZEDDeposit transaction is included in a block
FINALIZEDDeposit transaction is included in a block and the next block is generated



Gathering​

Gathering is only available in centralized wallets.

Gathering process​

Assets stored in child addresses do not move to the main address until gathering is requested. Therefore, you should gather regularly to avoid a deficit in the main address.

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

At this point, if the assets to be gathered are less than the estimated fee, the gathering does not proceed. The gathering process is as follows.

  1. Request gathering.
  2. A transaction is created for each child address to be gathered.
  3. The optimal fee is calculated and the transaction is propagated.
  4. The gathering is completed when the transaction is included in a block.


Gathering fees​

The gathering fee is deducted from the fee address using the Solana fee delegation feature. Therefore, before gathering, you must fill the fee address with the fee (SOL) so that its balance is not insufficient.

If the balance of the fee address is insufficient, gathering proceeds only for as many transactions as can be created. For example, if gathering needs to proceed for 10 child addresses but the fee address only has enough balance to generate 5 transactions, only 5 addresses are gathered and the remaining addresses are not.



Gathering status​

Gathering status is divided into four statuses depending on the gathering process. Assets stored in child addresses are in awaiting gathering (AWAITING_GATHERING) status.

When gathering is requested and a gathering transaction is created, the asset status changes to gathering (GATHERING). When the transaction is included in a block, the asset status is processed as gathering completed (COMPLETED) and the gathering is finished.

When gathering is attempted but the transaction fails, the asset status is processed as gathering failed (GATHERING_FAILED). Assets in gathering failed status are included in the gathering targets again. When gathering is attempted but the transaction could not be created due to insufficient fees, it remains in awaiting gathering (AWAITING_GATHERING) status.

Status nameDescription
AWAITING_GATHERINGAwaiting gathering
GATHERINGGathering transaction created
COMPLETEDGathering transaction completed
GATHERING_FAILEDGathering transaction failed




Withdrawal​

Withdrawal status​

Unlike deposits, a withdrawal is processed as withdrawal completed (FINALIZED) as soon as the transaction is included in a block.

Status nameDescription
AWAITING_DECISIONAwaiting withdrawal approval
REJECTEDWithdrawal is rejected
AWAITING_WITHDRAWALWithdrawal is approved and awaiting withdrawal
PENDINGWithdrawal transaction is created
FINALIZEDWithdrawal transaction is included in a block
FAILEDWithdrawal transaction failed


Withdrawal fees​

When withdrawing, you must choose whether to use fee delegation.


1. When using fee delegation​

When the fee delegation feature is used, the withdrawal fee is deducted from the fee address. In this case, the fee address must hold assets (SOL) to pay the fee. If the withdrawal fee is insufficient, the withdrawal does not proceed.


2. When not using fee delegation​

When the fee delegation feature is not used, the withdrawal fee is deducted from the main address. Therefore, the main address must hold assets (SOL) to pay the fee. If the withdrawal fee is insufficient, the withdrawal does not proceed.






Balance lookup criteria​

You can check the balance of the assets stored in a specific address by calling the Get Address Balance API. The balance returned is divided into total balance and liquid balance.

  • Total balance means all assets with a confirmation of 1 or more.
  • Liquid balance means the assets that can be gathered or withdrawn. The liquid balance of a child address means the assets that can be gathered, and the liquid balance of the main address means the assets that can be withdrawn.





Fees​

The Solana transaction fee is determined by the base fee per signature. Therefore, a typical transaction incurs a fee of 0.000005 SOL. However, when the fee delegation feature is used, two signatures are required, so a fee of 0.00001 SOL is incurred.