auction

package
v0.0.0-...-71e40f4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 22, 2021 License: LGPL-3.0 Imports: 17 Imported by: 0

Documentation

Index

Constants

View Source
const (
	OP_START = uint32(1)
	OP_STOP  = uint32(2)
	OP_BID   = uint32(3)

	USER_BID = uint32(0)
	AUTO_BID = uint32(1)
)
View Source
const (
	AUCTION_MAX_SUMMARIES = 32
)

Variables

View Source
var (
	// normal min amount is 10 mtr, autobid is 0.1 mtr
	MinimumBidAmount = new(big.Int).Mul(big.NewInt(10), big.NewInt(1e18))
	AutobidMinAmount = big.NewInt(1e17)
)
View Source
var (
	// 0x74696f6e2d6163636f756e742d61646472657373
	AuctionAccountAddr = meter.BytesToAddress([]byte("auction-account-address"))
	SummaryListKey     = meter.Blake2b([]byte("summary-list-key"))
	AuctionCBKey       = meter.Blake2b([]byte("auction-active-cb-key"))
)

the global variables in auction

Functions

func AuctionEncodeBytes

func AuctionEncodeBytes(sb *AuctionBody) []byte

func GetOpName

func GetOpName(op uint32) string

func SetAuctionGlobInst

func SetAuctionGlobInst(inst *Auction)

Types

type Auction

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

Candidate indicates the structure of a candidate

var (
	AuctionGlobInst *Auction
)

func GetAuctionGlobInst

func GetAuctionGlobInst() *Auction

func NewAuction

func NewAuction(ch *chain.Chain, sc *state.Creator) *Auction

func (*Auction) ClearAuction

func (a *Auction) ClearAuction(cb *AuctionCB, state *state.State, env *AuctionEnv) (*big.Int, *big.Int, []*DistMtrg, error)

////////////////////// called when auction is over

func (*Auction) GetAuctionCB

func (a *Auction) GetAuctionCB(state *state.State) (result *AuctionCB)

Candidate List

func (*Auction) GetSummaryList

func (a *Auction) GetSummaryList(state *state.State) (result *AuctionSummaryList)

summary List

func (*Auction) PrepareAuctionHandler

func (a *Auction) PrepareAuctionHandler() (AuctionHandler func([]byte, *meter.Address, *xenv.TransactionContext, uint64, *state.State) (*setypes.ScriptEngineOutput, uint64, error))

func (*Auction) SendMTRGToBidder

func (a *Auction) SendMTRGToBidder(addr meter.Address, amount *big.Int, stateDB *statedb.StateDB, env *AuctionEnv)

func (*Auction) SetAuctionCB

func (a *Auction) SetAuctionCB(auctionCB *AuctionCB, state *state.State)

func (*Auction) SetSummaryList

func (a *Auction) SetSummaryList(summaryList *AuctionSummaryList, state *state.State)

func (*Auction) Start

func (a *Auction) Start() error

func (*Auction) TransferAutobidMTRToAuction

func (a *Auction) TransferAutobidMTRToAuction(addr meter.Address, amount *big.Int, state *state.State, env *AuctionEnv) error

==================== account openation=========================== from meter.ValidatorBenefitAddr ==> AuctionAccountAddr

func (*Auction) TransferMTRToAuction

func (a *Auction) TransferMTRToAuction(addr meter.Address, amount *big.Int, state *state.State, env *AuctionEnv) error

from addr == > AuctionAccountAddr

func (*Auction) TransferMTRToValidatorBenefit

func (a *Auction) TransferMTRToValidatorBenefit(amount *big.Int, state *state.State, env *AuctionEnv) error

form AuctionAccountAddr ==> meter.ValidatorBenefitAddr

type AuctionBody

type AuctionBody struct {
	Opcode        uint32
	Version       uint32
	Option        uint32
	StartHeight   uint64
	StartEpoch    uint64
	EndHeight     uint64
	EndEpoch      uint64
	Sequence      uint64
	AuctionID     meter.Bytes32
	Bidder        meter.Address
	Amount        *big.Int
	ReserveAmount *big.Int
	Token         byte   // meter or meter gov
	Timestamp     uint64 // timestamp
	Nonce         uint64 // nonce
}

Candidate indicates the structure of a candidate

func AuctionDecodeFromBytes

func AuctionDecodeFromBytes(bytes []byte) (*AuctionBody, error)

func (*AuctionBody) CloseAuctionCB

func (ab *AuctionBody) CloseAuctionCB(env *AuctionEnv, gas uint64) (leftOverGas uint64, err error)

func (*AuctionBody) GetOpName

func (ab *AuctionBody) GetOpName(op uint32) string

func (*AuctionBody) HandleAuctionTx

func (ab *AuctionBody) HandleAuctionTx(env *AuctionEnv, gas uint64) (leftOverGas uint64, err error)

func (*AuctionBody) StartAuctionCB

func (ab *AuctionBody) StartAuctionCB(env *AuctionEnv, gas uint64) (leftOverGas uint64, err error)

func (*AuctionBody) ToString

func (ab *AuctionBody) ToString() string

type AuctionCB

type AuctionCB struct {
	AuctionID   meter.Bytes32
	StartHeight uint64
	StartEpoch  uint64
	EndHeight   uint64
	EndEpoch    uint64
	Sequence    uint64
	RlsdMTRG    *big.Int //released mtrg
	RsvdMTRG    *big.Int // reserved mtrg
	RsvdPrice   *big.Int
	CreateTime  uint64

	//changed fields after auction start
	RcvdMTR    *big.Int
	AuctionTxs []*AuctionTx
}

///////////////////////////////////////////////// auctionTx indicates the structure of a auctionTx

func GetActiveAuctionCB

func GetActiveAuctionCB() (*AuctionCB, error)

api routine interface

func (*AuctionCB) Add

func (cb *AuctionCB) Add(tx *AuctionTx)

func (*AuctionCB) AddAuctionTx

func (cb *AuctionCB) AddAuctionTx(tx *AuctionTx) error

func (*AuctionCB) Count

func (cb *AuctionCB) Count() int

func (*AuctionCB) Exist

func (cb *AuctionCB) Exist(id meter.Bytes32) bool

func (*AuctionCB) Get

func (cb *AuctionCB) Get(id meter.Bytes32) *AuctionTx

func (*AuctionCB) ID

func (cb *AuctionCB) ID() (hash meter.Bytes32)

bucketID auctionTx .. are excluded

func (*AuctionCB) IsActive

func (cb *AuctionCB) IsActive() bool

func (*AuctionCB) Remove

func (cb *AuctionCB) Remove(id meter.Bytes32)

func (*AuctionCB) RemoveAuctionTx

func (cb *AuctionCB) RemoveAuctionTx(tx *AuctionTx) error

Actually Auction do not allow to cancel, so this func should not be called

func (*AuctionCB) ToString

func (cb *AuctionCB) ToString() string

func (*AuctionCB) ToTxList

func (cb *AuctionCB) ToTxList() []*AuctionTx

type AuctionEnv

type AuctionEnv struct {
	*setypes.ScriptEnv
	// contains filtered or unexported fields
}

func NewAuctionEnv

func NewAuctionEnv(auction *Auction, state *state.State, txCtx *xenv.TransactionContext, to *meter.Address) *AuctionEnv

func (*AuctionEnv) GetAuction

func (env *AuctionEnv) GetAuction() *Auction

type AuctionSummary

type AuctionSummary struct {
	AuctionID    meter.Bytes32
	StartHeight  uint64
	StartEpoch   uint64
	EndHeight    uint64
	EndEpoch     uint64
	Sequence     uint64
	RlsdMTRG     *big.Int
	RsvdMTRG     *big.Int
	RsvdPrice    *big.Int
	CreateTime   uint64
	RcvdMTR      *big.Int
	ActualPrice  *big.Int
	LeftoverMTRG *big.Int
	AuctionTxs   []*AuctionTx
	DistMTRG     []*DistMtrg
}

func (*AuctionSummary) ToString

func (a *AuctionSummary) ToString() string

type AuctionSummaryList

type AuctionSummaryList struct {
	Summaries []*AuctionSummary
}

func GetAuctionSummaryList

func GetAuctionSummaryList() (*AuctionSummaryList, error)

func GetAuctionSummaryListByHeader

func GetAuctionSummaryListByHeader(header *block.Header) (*AuctionSummaryList, error)

api routine interface

func NewAuctionSummaryList

func NewAuctionSummaryList(summaries []*AuctionSummary) *AuctionSummaryList

func (*AuctionSummaryList) Add

func (a *AuctionSummaryList) Add(summary *AuctionSummary) error

func (*AuctionSummaryList) Count

func (a *AuctionSummaryList) Count() int

func (*AuctionSummaryList) Get

func (*AuctionSummaryList) Last

func (*AuctionSummaryList) Remove

func (a *AuctionSummaryList) Remove(id meter.Bytes32) error

unsupport at this time

func (*AuctionSummaryList) String

func (a *AuctionSummaryList) String() string

func (*AuctionSummaryList) ToList

func (a *AuctionSummaryList) ToList() []AuctionSummary

func (*AuctionSummaryList) ToString

func (a *AuctionSummaryList) ToString() string

type AuctionTx

type AuctionTx struct {
	TxID      meter.Bytes32
	Address   meter.Address
	Amount    *big.Int // total amont wei is unit
	Type      uint32   // USER_BID or AUTO_BID
	Timestamp uint64   //timestamp
	Nonce     uint64   //randomness
}

func NewAuctionTx

func NewAuctionTx(addr meter.Address, amount *big.Int, txtype uint32, time uint64, nonce uint64) *AuctionTx

func (*AuctionTx) ID

func (a *AuctionTx) ID() (hash meter.Bytes32)

func (*AuctionTx) ToString

func (a *AuctionTx) ToString() string

type DistMtrg

type DistMtrg struct {
	Addr   meter.Address
	Amount *big.Int
}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL