Wallet Structure

The semi-custodial wallet of Solana has the following structure.

• Main Address
• Fee Address
• Child Address

TIP
The fee address is used to recharge the child address with the fees (SOL) if necessary.

Child Address

Generates child addresses by calling the Generate Child Address API. Generally, one child address is given to each end user. Generated child addresses can be checked from [Child Address Information] from the console or by calling the Access Child Address List API.

Response example

[
  {
    "address": "8Y1Fw9f2K2zVUmcRmvnULsBwpRg8aRxKjVzfALti7SVx",
    "name": "test SOL address"
  }
]

Deposit

Deposit Status

When an asset from the outside arrives at the main or a child address, Octet recognizes it as a deposit. However, the deposit is not finalized even if the deposit transaction is included in the blocks. Additional blocks must be generated to finalize(FINALIZED) the transaction to ensure the integrity of the transaction. 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.

The number of blocks required to finalize the deposit is different depending on the network. Both testnet and mainnet require additional 20 blocks to finalize the transaction.

Deposit Confirmation

1. Checking from the Console

You can check the deposit status from [Transaction History] on the console. UNFINALIZED deposits are displayed as ‘Processing’, and FINALIZED deposits are displayed as ‘Completed’.

2. Checking with Webhooks

When a deposit is finalized to a main or a child address, a deposit webhook will be sent. You can check the deposit status from the received webhook. For more information about how to use webhooks and their data structure, check the 'Webhook' page.

출금

출금 과정

Semi-custodial wallet withdraws assets from the main and child addresses to the outside.

1. Request withdrawal.
2. Generate transaction.
3. Calculates the optimal fees and propagates the transactions.
4. Withdrawal is completed when the transactions are confirmed in the blocks.

Withdrawal Status

Unlike a deposit, a withdrawal is finalized(FINALIZED) at the moment when the transaction is included in the blocks.

Withdrawal Fees

You need to choose whether to use fee delegation for withdrawals.

1. Using Fee Delegation

The withdrawal fee will be deducted from the fee address if the fee delegation feature is enabled. In this case, the fee address should have assets (SOL) to pay the fee. Withdrawal will not proceed if the withdrawal fee is insufficient.

2. Not Using Fee Delegation

When the fee delegation feature is disabled, withdrawal fees will be deducted from the address to be withdrawn. For example, when withdrawing from ‘child address A’, a fee will be deducted from ‘child address A’. Therefore, the address to be withdrawn should have assets (SOL) to pay the fee. Withdrawal will not proceed if the withdrawal fee is insufficient.

Withdraw

You can request a withdrawal from the main or child address to the outside by calling the Request Withdrawal API. The uuid value will be returned when the withdrawal request is successful. The value can be used to access the withdrawal process.

Response example

{
  "uuid": "18012e3f-07f3-45ec-862b-f020c0ca935a"
}

Withdrawal Confirmation

1. Checking from the Console

You can check the withdrawal status from [Transaction History] on the console. AWAITING_WITHDRAWAL or PENDING withdrawals are displayed as ‘Processing’, and FINALIZED withdrawals are displayed as ‘Completed’.

2. Checking with API

You can check the progress of a specific withdrawal transaction by calling the Access Withdrawal Transaction Information API.

Response example

{
  "idx": 608,
  "uuid": "07efdcb2-b3fd-4fe7-bf47-c0b460b289e3",
  "fromAddress": "Ek2fgHXmLWDnCt8sEmUMmT6Hvr8uz79ZxPtRcMRyiJRm",
  "toAddress": "8Y1Fw9f2K2zVUmcRmvnULsBwpRg8aRxKjVzfALti7SVx",
  "amount": "1.22300000000000000000",
  "memo": null,
  "requestId": "20221030170000",
  "type": "API",
  "description": "",
  "requiredApprovalCount": 1,
  "useApiAutoApproval": true,
  "status": "SENT",
  "createdDate": "2022-01-25T09:25:02.383Z",
  "modifiedDate": "2022-01-25T09:25:10.000Z",
  "rejectedDate": null
}

3. Checking with Webhooks

When the withdrawal from the main address is finished, a withdrawal webhook will be sent. You can check the withdrawal status from the webhook. For more information about how to use webhooks and their data structure, check the Webhook page.

Balance Access Criteria

You can check the balance of the asset stored in a specific address by calling the Access Address Balance API. The accessed balances are specified into total balances and liquid balances.

• Total balance is all assets with a confirmation of 1 or above.
• Liquid balance is assets that can be withdrawn in each address.

Fees

Solana transaction fee is determined by the base fee per signature. Therefore, in general, 0.000005 SOL of fee occurs for a transaction. However, if fee delegation is enabled, two signatures are required, which occurs 0.00001 SOL of fee.

Faucet

In the case of the testnet, you must obtain a testing SOL from the faucet website and deposit it. When an actual SOL is deposited in the testnet, it will not be recognized.

TIP : Must proceed with DEVNET’s faucet.