DFSonBlockchain

Introduction

DFSonBlockchain implements a peer-to-peer miner network and a distributed file storage service that runs on top of it. Each miner is capable of serving mutiple clients concurrently and mines the coins needed for file operations requested by its clients; it then floods these operations to the miner network.

Usage

go run miner.go </path/to/config.json>

Example

go run miner.go settings.json

ClientAPI

func (*ClientAPI) ReadRecord

func (capi *ClientAPI) ReadRecord(recordInfo *rfslib.OperationRecord, minerRes *rfslib.MinerRes) error

The ReadRecord RPC reads a confirmed record with recordInfo.FileName at position recordInfo.RecordNum into memory pointed to by minerRes

func (*ClientAPI) ConfirmOperation

func (capi *ClientAPI) ConfirmOperation(operationRecord *rfslib.OperationRecord, minerRes *rfslib.MinerRes) error

The ConfirmOperation RPC confirms the operation by checking the OPBlock containing the operation is followed by some fixed number of other blocks in the longest blockchain

func (*ClientAPI) GetBalance

func (capi *ClientAPI) GetBalance(caller string, currentBalance *uint32) error

The GetBalance RPC returns the current balance of the longest local block chain

MinerAPI

func (*MinerAPI) GetChainTips

func (mapi *MinerAPI) GetChainTips(caller string, reply *map[string]int) error

The GetChainTips RPC returns information about the highest-height block (tip) of each local block chain

func (*MinerAPI) GetBlock

func (mapi *MinerAPI) GetBlock(headerHash string, packet *BlockPacket) error

The GetBlock RPC gets a block with a particular header hash from the local block hash map as a BlockPacket

func (*MinerAPI) AddNode

func (mapi *MinerAPI) AddNode(minerInfo PeerMinerInfo, hasInternalError *bool) error

The AddNode RPC attempts to try a connection to a Miner node once

func (*MinerAPI) GetPeerInfo

func (mapi *MinerAPI) GetPeerInfo(caller string, minerID *string) error

The GetPeerInfo RPC returns the MinerID of the connected Miner node

func (*MinerAPI) SubmitRecord

func (mapi *MinerAPI) SubmitRecord(newOpRecord *rfslib.OperationRecord, hasInternalError *bool) error

The SubmitRecord RPC accepts an OperationRecord, verifies it is a valid addition to the block chain, and broadcasts it to the network

func (*MinerAPI) SubmitBlock

func (mapi *MinerAPI) SubmitBlock(packet BlockPacket, hasInternalError *bool) error

The SubmitBlock RPC accepts a BlockPacket, verifies it is a valid addition to the block chain, and broadcasts it to the network.