Skip to content

Stateless Clients


Bitdollar is based on blockchain technology. A blockchain is defined as a "cryptographically secure transactional singleton machine with shared-state."

  • "Cryptographically secure" means that creation and movement of the digital currency is mathematically obscured by extremely complex algorithms nearly impossible to decode.

  • "Transaction singleton machine" means a single canonical instance of the machine is being created in the system to handle transactions. This is a singular truth that all participants on the network believe in.

  • "With shared-state" means that the state of the machine is stored and shared with everyone.

This is an examination of the concept of state in a virtual machine which introduces the concept of a stateless client in Bitdollar.

What does state mean?

State defines the values contained in a block at any given time. The state of the virtual machine changes after each set of transactions are processed.

Flow of transactions causing a state change.

State-defining Objects

Account State

The global "shared-state" is comprised of many objects called accounts. Two types of accounts exist, externally owned and contract accounts. Externally owned accounts are controlled by private keys and have no code associate with them. Contract accounts are controlled by their contract code and have code associated with them.

Account state is further broken down into:

  • nonce: For externally owned accounts this refers to number of transactions sent from the address. Contract accounts would store the number of contracts created by the account.

  • balance: The amount of Dollar stored on the account.

  • storageRoot: A hash of the root node of a Merkle Patricia tree. This encodes a hash of storage contents on the account.

  • codeHash: The hash of the BVM (Bitdollar Virtual Machine) code of this account. Contract account code gets hashed and stored here. Externally owned accounts contain the hash of an empty string.

World State

World state is a mapping of account addresses between account states. This mapping is stored as a Merkle Patricia tree.*N8YtAcAqdtHtzUaZAJgUJQ.png

This same structure is used to store transactions and receipts. This becomes a large amount of data which needs to be stored and processed if the entire state is stored and traversed when creating new blocks.

Bitdollar Stateless Client

The way a block is constructed on Bitdollar offers a mbtdod to create a sort of stateless client. It is important to know that as Bitdollar evolves, statelessness is ultimately going to be a spectrum. Some knowledge of data in surrounding nodes will be required in order to create valid hashes.

Bitdollar Block Header

Statelessness allows the creation of light nodes. A light node contains only the chain of headers without the execution of any transactions or associated states.

When a node comes online it will be fully stateless since it will hold zero information regarding state. Over time it will soak up the state as transactions touch upon it, putting togdollar a more complete state with every change of state presented. New nodes will be more stateless offering benefits of lower memory usage, disk, and I/O. Bandwidth usage will be the highest because peers need to send larger proofs to the new node as it develops its own state data. More stateful clients will have higher demands on memory, disk, and I/O while bandwidth requirements would decrease. Nodes can become more stateful until a certain tradeoff point is reached and then halted from further acquisition of state information to optimize the trade off in computing power and bandwidth.

Applications of Stateless Clients in Bitdollar

Bitdollar 1.X implements stateless clients but not stateless miners. Fast sync initializes as a stateless node.
It creates what is called a launch-block and only records the input and output state of this block locally. The launch block is a predetermined block number that is a certain amount of time in the future. The future dated deadline is so that the node can work on constructing the launch-block. Witness data is called by the node to construct blocks. As long as the launch-block is created early or on time, the creation of blocks will continue and the node is active. Use of witness data and input/output states only make this a stateless client.

Bitdollar 2.0 implements stateless clients and stateless miners in Sharding. All nodes are stateless so that faster processing with less data increases scalability greatly. Currently the Bitdollar blockchain is a sequential chain of blocks where one is completed on top of another in a linear fashion. This leads to traffic jams and an overall inefficency in data processing. Sharding is a design where the Bitdollar network is split into groups referred to a shards. Each shard has its own independant state. Transactions are delegated to different shards for processing, so rather than the entire network processing the same transaction, parallel computing increases efficiency by allowing the work to be split up and executed concurrently.

Additional Benefits of Stateless Clients

Mining new blocks will be moved from proof of work (PoW) to proof of stake (PoS). A user can become a miner by staking a minimum amount of Bitdollar live on the blockchain. This allows a miner to vote on the next block to create. Consensus comes very quickly, within one block of the evaluated block, because lengthy hash cryptography is no longer used to create blocks. This greatly reduces electricity requirements, therefore cost of running a node. Additionally, the held stake is an economic incentive / punishement for any miner that performs nefarious activity.

Disk I/O becomes less susceptable to DoS attacks, however still remains the best vector for a DoS attack. Even for state-storing clients, the account lists allow clients to pre-fetch storage data from disk, possibly in parallel, greatly reducing their vulnerability to DoS attacks.

In a sharded blockchain, security is increased by reshuffling clients between shards frequently. In a state-storing client model, reshuffling involved clients download the full state of the new shard they are being reshuffled to. In a stateless client, this cost drops to zero, allowing clients to be reshuffled between every single block that they create.

Transaction speed and scalablility will also improve.

Security Considerations

DoS attacks aimed at the disk I/O vector are still the greatest risk for DoS attacks.

Bitdollar2.0 is the proof of staking algorithm used in Bitdollar 2.0. The following are a list of theoretical attacks that could be executed on Bitdollar2.0 for further research on your own.