Paycoin (PCI)
Paycoin wallet structure
A Paycoin wallet has the following structure.
- Main address
- Child address
TIP Paycoin does not use a fee address.
Creating a wallet
Paycoin's address creation process differs from other platforms. Therefore, additional steps are required when creating a wallet.
Multisig wallet
- Call the Create Main Address API to obtain a key file. The key file contains the address and an encrypted key.
- Download and run the key generator, then register the received key file in the program.
- A Paycoin multisig key is generated.
Singlesig wallet
The wallet creation process is the same as other platforms. However, creating a wallet takes about 5 seconds.
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. 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. Since Paycoin generates a block every time a transaction occurs, there is no separate block time. When the deposit transaction is included in a block, it is processed as completed (FINALIZED).
| Status name | Description |
|---|---|
FINALIZED | Deposit transaction is included in a block |
Gathering
Gathering is only available in centralized wallets.
Gathering process and fees
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 is requested, the PCI stored in every child address is transferred to the main address. At this point, one transaction occurs per child address. For example, if PCI is stored in 10 child addresses, 10 transactions occur in total.
A gathering fee occurs once per transaction, and it is deducted from the assets to be gathered. Gathering does not proceed for child addresses whose assets to be gathered are less than the estimated fee. The gathering process is as follows.
- Request gathering.
- A transaction is created for each child address to be gathered.
- The fee is calculated and the transaction is propagated.
- The gathering is completed when the transaction is included in a block.
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 remains 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 name | Description |
|---|---|
AWAITING_GATHERING | Awaiting gathering |
GATHERING | Gathering transaction created |
COMPLETED | Gathering transaction completed |
GATHERING_FAILED | Gathering transaction failed |
Withdrawal
Withdrawal status
A withdrawal is processed as withdrawal completed (FINALIZED) as soon as the transaction is included in a block.
| Status name | Description |
|---|---|
AWAITING_DECISION | Awaiting withdrawal approval |
REJECTED | Withdrawal is rejected |
AWAITING_WITHDRAWAL | Withdrawal is approved and awaiting withdrawal |
PENDING | Withdrawal transaction is created |
FINALIZED | Withdrawal transaction is included in a block |
FAILED | Withdrawal transaction failed |
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
When a transaction is created, 0.1% of the amount of the asset being sent is deducted as the fee.
Transaction fee = Amount of asset sent x 0.001