money

Documentation

Index

• Constants
• Variables
• func HashForIDCalculation(idBytes []byte, attr []byte, timeout uint64, hashFunc crypto.Hash) []byte
• func NewBillID(shardPart []byte, unitPart []byte) types.UnitID
• func NewFeeCreditRecordID(shardPart []byte, unitPart []byte) types.UnitID
• func NewTxSystem(opts ...Option) (*txsystem.GenericTxSystem, error)
• type BillData
  • func (b *BillData) Copy() state.UnitData
  • func (b *BillData) SummaryValueInput() uint64
  • func (b *BillData) Write(hasher hash.Hash)
• type DustCollector
  • func NewDustCollector(s *state.State) *DustCollector
  • func (d *DustCollector) AddDustBill(id types.UnitID, currentBlockNumber uint64)
  • func (d *DustCollector) GetDustBills(blockNumber uint64) []types.UnitID
  • func (d *DustCollector) RemoveDustBills(blockNumber uint64)
• type InitialBill
• type Module
  • func NewMoneyModule(options *Options) (m *Module, err error)
  • func (m *Module) BeginBlockFuncs() []func(blockNr uint64) error
  • func (m *Module) EndBlockFuncs() []func(blockNumber uint64) error
  • func (m *Module) GenericTransactionValidator() txsystem.GenericTransactionValidator
  • func (m *Module) TxExecutors() map[string]txsystem.TxExecutor
• type Option
  • func WithDCMoneyAmount(a uint64) Option
  • func WithFeeCalculator(calc fc.FeeCalculator) Option
  • func WithHashAlgorithm(hashAlgorithm gocrypto.Hash) Option
  • func WithInitialBill(bill *InitialBill) Option
  • func WithState(s *state.State) Option
  • func WithSystemDescriptionRecords(records []*genesis.SystemDescriptionRecord) Option
  • func WithSystemIdentifier(systemIdentifier []byte) Option
  • func WithTrustBase(trust map[string]crypto.Verifier) Option
• type Options
  • func DefaultOptions() *Options
• type SplitAttributes
• type SwapDCAttributes
• type TransferAttributes
• type TransferDCAttributes

Constants

const (
	PayloadTypeTransfer = "trans"
	PayloadTypeSplit    = "split"
	PayloadTypeTransDC  = "transDC"
	PayloadTypeSwapDC   = "swapDC"
)

const (
	UnitIDLength   = UnitPartLength + TypePartLength
	UnitPartLength = 32
	TypePartLength = 1
)

Variables

var (
	ErrInitialBillIsNil                  = errors.New("initial bill may not be nil")
	ErrInvalidInitialBillID              = errors.New("initial bill ID may not be equal to the DC money supply ID")
	ErrUndefinedSystemDescriptionRecords = errors.New("undefined system description records")
	ErrNilFeeCreditBill                  = errors.New("fee credit bill is nil in system description record")
	ErrInvalidFeeCreditBillID            = errors.New("fee credit bill may not be equal to the DC money supply ID and initial bill ID")
)

var (
	ErrReclaimFCInvalidTargetUnit         = errors.New("invalid target unit")
	ErrReclaimFCInvalidTxFee              = errors.New("the transaction fees cannot exceed the transferred value")
	ErrReclaimFCInvalidTargetUnitBacklink = errors.New("invalid target unit backlink")
)

var (
	ErrInvalidBillValue       = errors.New("transaction value must be equal to bill value")
	ErrSplitBillZeroAmount    = errors.New("when splitting a bill the value assigned to the new bill must be greater than zero")
	ErrSplitBillZeroRemainder = errors.New("when splitting a bill the remaining value of the bill must be greater than zero")
	ErrInvalidDataType        = errors.New("invalid data type")
)

var (
	ErrTxNil                       = errors.New("tx is nil")
	ErrBillNil                     = errors.New("bill is nil")
	ErrTargetSystemIdentifierEmpty = errors.New("TargetSystemIdentifier is empty")
	ErrTargetRecordIDEmpty         = errors.New("TargetRecordID is empty")
	ErrAdditionTimeInvalid         = errors.New("EarliestAdditonTime is greater than LatestAdditionTime")
	ErrRecordIDExists              = errors.New("fee tx cannot contain fee credit reference")
	ErrFeeProofExists              = errors.New("fee tx cannot contain fee authorization proof")
	ErrInvalidFCValue              = errors.New("the amount to transfer cannot exceed the value of the bill")
	ErrInvalidFeeValue             = errors.New("the transaction max fee cannot exceed the transferred amount")
	ErrInvalidBacklink             = errors.New("the transaction backlink is not equal to unit backlink")
)

var (
	BillUnitType            = []byte{0x00}
	FeeCreditRecordUnitType = []byte{0x0f}
)

var DefaultSystemIdentifier = []byte{0, 0, 0, 0}

Functions

func HashForIDCalculation

func HashForIDCalculation(idBytes []byte, attr []byte, timeout uint64, hashFunc crypto.Hash) []byte

func NewBillID

func NewBillID(shardPart []byte, unitPart []byte) types.UnitID

func NewFeeCreditRecordID

func NewFeeCreditRecordID(shardPart []byte, unitPart []byte) types.UnitID

func NewTxSystem

func NewTxSystem(opts ...Option) (*txsystem.GenericTxSystem, error)

Types

type BillData

type BillData struct {
	V        uint64 // The monetary value of this bill
	T        uint64 // The round number of the last transaction with the bill
	Backlink []byte // Backlink (256-bit hash)
}

func (*BillData) Copy

func (b *BillData) Copy() state.UnitData

func (*BillData) SummaryValueInput

func (b *BillData) SummaryValueInput() uint64

func (*BillData) Write

func (b *BillData) Write(hasher hash.Hash)

type DustCollector

type DustCollector struct {
	// contains filtered or unexported fields
}

func NewDustCollector

func NewDustCollector(s *state.State) *DustCollector

func (*DustCollector) AddDustBill

func (d *DustCollector) AddDustBill(id types.UnitID, currentBlockNumber uint64)

func (*DustCollector) GetDustBills

func (d *DustCollector) GetDustBills(blockNumber uint64) []types.UnitID

func (*DustCollector) RemoveDustBills

func (d *DustCollector) RemoveDustBills(blockNumber uint64)

type InitialBill

type InitialBill struct {
	ID    types.UnitID
	Value uint64
	Owner state.Predicate
}

type Module

type Module struct {
	// contains filtered or unexported fields
}

func NewMoneyModule

func NewMoneyModule(options *Options) (m *Module, err error)

func (*Module) BeginBlockFuncs

func (m *Module) BeginBlockFuncs() []func(blockNr uint64) error

func (*Module) EndBlockFuncs

func (m *Module) EndBlockFuncs() []func(blockNumber uint64) error

func (*Module) GenericTransactionValidator

func (m *Module) GenericTransactionValidator() txsystem.GenericTransactionValidator

func (*Module) TxExecutors

func (m *Module) TxExecutors() map[string]txsystem.TxExecutor

type Option

type Option func(*Options)

func WithDCMoneyAmount

func WithDCMoneyAmount(a uint64) Option

func WithFeeCalculator

func WithFeeCalculator(calc fc.FeeCalculator) Option

func WithHashAlgorithm

func WithHashAlgorithm(hashAlgorithm gocrypto.Hash) Option

func WithInitialBill

func WithInitialBill(bill *InitialBill) Option

func WithState

func WithState(s *state.State) Option

func WithSystemDescriptionRecords

func WithSystemDescriptionRecords(records []*genesis.SystemDescriptionRecord) Option

func WithSystemIdentifier

func WithSystemIdentifier(systemIdentifier []byte) Option

func WithTrustBase

func WithTrustBase(trust map[string]crypto.Verifier) Option

type Options

type Options struct {
	// contains filtered or unexported fields
}

func DefaultOptions

func DefaultOptions() *Options

type SplitAttributes

type SplitAttributes struct {
	Amount         uint64
	TargetBearer   []byte
	RemainingValue uint64
	Backlink       []byte
	// contains filtered or unexported fields
}

type SwapDCAttributes

type SwapDCAttributes struct {
	OwnerCondition   []byte
	DcTransfers      []*types.TransactionRecord
	DcTransferProofs []*types.TxProof
	TargetValue      uint64 // value added to target bill
	// contains filtered or unexported fields
}

type TransferAttributes

type TransferAttributes struct {
	NewBearer   []byte
	TargetValue uint64
	Backlink    []byte
	// contains filtered or unexported fields
}

type TransferDCAttributes

type TransferDCAttributes struct {
	Value              uint64
	TargetUnitID       []byte
	TargetUnitBacklink []byte
	Backlink           []byte
	// contains filtered or unexported fields
}