bitcoin-withdrawal-handling-lld

Bitcoin Withdrawal Handling LLD

This document assumes that the multi-signature wallet is existing

This document is intended to outline generic design of a Bitcoin withdrawal handler, a component used for processing withdrawals to Bitcoin network.

For general information on deposit handlers, read: Generic Sidechain Withdrawal HLD

Peerplays SON network is able to transfer assets on Bitcoin network - FULFILLED
Peerplays SON network have dedicated account on Bitcoin sidechain - FULFILLED (multisig addresses)
Sidechain operating node has access to assets exchange rate list, containing exchange rates for every asset on every supported sidechain network - FULFILLED For Bitcoin, exchange rate is fixed 1 BTC = 1 PPY
Sidechain operating node has access to user accounts mapping list, containing user addresses on supported sidechains - FULLFILLED

Link to draw.io file

Withdrawal process is initiated by sending Peerplays core asser to a SON shared account
Peerplays listener will pick up this transaction
Peerplays sidechain handler will create sidechain_event_data data structure, with the information about transaction, and pass it to the sidechain_event_data_received
sidechain_event_data_received will create a proposal for creating withdrawal descriptor object - son_wallet_withdrawal_object
When proposal is approved, object will be created, or if it is already created by another SON, it will be confirmed
Scheduled SON will start processing withdrawals by creating Bitcoin transaction for sending funds from primary wallet (Bitcoin multisig address controlled by active SONs) to the a Bitcoin address which is registered as a sidechain user address for withdrawals
Bitcoin transaction will be signed and sent to Bitcoin node
Scheduled SON will mark son_wallet_withdrawal_object as processed

Last updated 1 year ago