ownership

Documentation

Overview

this handles low-level access to the ownership data in storage pool

Index

• func CreateAsset(issueTxId merkle.Digest, issueBlockNumber uint64, ...)
• func CreateBlock(issueTxId merkle.Digest, blockNumber uint64, newOwner *account.Account)
• func CurrentlyOwns(owner *account.Account, txId merkle.Digest) bool
• func OwnerOf(txId merkle.Digest) (uint64, *account.Account)
• func Share(previousTxId merkle.Digest, transferTxId merkle.Digest, ...)
• func Transfer(previousTxId merkle.Digest, transferTxId merkle.Digest, ...)
• type AssetOwnerData
  • func (a AssetOwnerData) IssueBlockNumber() uint64
  • func (a AssetOwnerData) IssueTxId() merkle.Digest
  • func (a AssetOwnerData) Pack() PackedOwnerData
  • func (a AssetOwnerData) TransferBlockNumber() uint64
• type BlockOwnerData
  • func (b BlockOwnerData) IssueBlockNumber() uint64
  • func (b BlockOwnerData) IssueTxId() merkle.Digest
  • func (b BlockOwnerData) Pack() PackedOwnerData
  • func (b BlockOwnerData) TransferBlockNumber() uint64
• type OwnedItem
  • func (item OwnedItem) MarshalText() ([]byte, error)
  • func (item OwnedItem) String() string
  • func (item *OwnedItem) UnmarshalText(s []byte) error
• type OwnerData
  • func GetOwnerData(txId merkle.Digest) (OwnerData, error)
  • func GetOwnerDataB(txId []byte) (OwnerData, error)
• type Ownership
  • func ListBitmarksFor(owner *account.Account, start uint64, count int) ([]Ownership, error)
• type PackedOwnerData
  • func (packed PackedOwnerData) Unpack() (OwnerData, error)
• type ShareOwnerData
  • func (a ShareOwnerData) IssueBlockNumber() uint64
  • func (a ShareOwnerData) IssueTxId() merkle.Digest
  • func (a ShareOwnerData) Pack() PackedOwnerData
  • func (a ShareOwnerData) TransferBlockNumber() uint64

Functions

func CreateAsset

func CreateAsset(issueTxId merkle.Digest, issueBlockNumber uint64, assetId transactionrecord.AssetIdentifier, newOwner *account.Account)

func CreateBlock

func CreateBlock(issueTxId merkle.Digest, blockNumber uint64, newOwner *account.Account)

func CurrentlyOwns

func CurrentlyOwns(owner *account.Account, txId merkle.Digest) bool

check owner currently owns this transaction id

func OwnerOf

func OwnerOf(txId merkle.Digest) (uint64, *account.Account)

find the owner of a specific transaction

func Share

func Share(previousTxId merkle.Digest, transferTxId merkle.Digest, transferBlockNumber uint64, currentOwner *account.Account, balance uint64)

need to have a lock

func Transfer

func Transfer(previousTxId merkle.Digest, transferTxId merkle.Digest, transferBlockNumber uint64, currentOwner *account.Account, newOwner *account.Account)

Types

type AssetOwnerData

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

func (AssetOwnerData) IssueBlockNumber

func (a AssetOwnerData) IssueBlockNumber() uint64

func (AssetOwnerData) IssueTxId

func (a AssetOwnerData) IssueTxId() merkle.Digest

accessors

func (AssetOwnerData) Pack

func (a AssetOwnerData) Pack() PackedOwnerData

pack asset owner data to byte slice

func (AssetOwnerData) TransferBlockNumber

func (a AssetOwnerData) TransferBlockNumber() uint64

type BlockOwnerData

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

func (BlockOwnerData) IssueBlockNumber

func (b BlockOwnerData) IssueBlockNumber() uint64

func (BlockOwnerData) IssueTxId

func (b BlockOwnerData) IssueTxId() merkle.Digest

accessors

func (BlockOwnerData) Pack

func (b BlockOwnerData) Pack() PackedOwnerData

pack block owner data to byte slice

func (BlockOwnerData) TransferBlockNumber

func (b BlockOwnerData) TransferBlockNumber() uint64

type OwnedItem

type OwnedItem byte

the flag byte

const (
	OwnedAsset OwnedItem = iota
	OwnedBlock OwnedItem = iota
	OwnedShare OwnedItem = iota
)

type codes for flag byte

func (OwnedItem) MarshalText

func (item OwnedItem) MarshalText() ([]byte, error)

convert item to text

func (OwnedItem) String

func (item OwnedItem) String() string

convert a owned item to its string symbol

func (*OwnedItem) UnmarshalText

func (item *OwnedItem) UnmarshalText(s []byte) error

convert test to Item

type OwnerData

type OwnerData interface {
	Pack() PackedOwnerData

	IssueTxId() merkle.Digest
	TransferBlockNumber() uint64
	IssueBlockNumber() uint64
}

func GetOwnerData

func GetOwnerData(txId merkle.Digest) (OwnerData, error)

fetch and unpack owner data

func GetOwnerDataB

func GetOwnerDataB(txId []byte) (OwnerData, error)

fetch and unpack owner data

type Ownership

type Ownership struct {
	N           uint64                             `json:"n,string"`
	TxId        merkle.Digest                      `json:"txId"`
	IssueTxId   merkle.Digest                      `json:"issue"`
	Item        OwnedItem                          `json:"item"`
	AssetId     *transactionrecord.AssetIdentifier `json:"assetId,omitempty"`
	BlockNumber *uint64                            `json:"blockNumber,omitempty"`
}

type to represent an ownership record

func ListBitmarksFor

func ListBitmarksFor(owner *account.Account, start uint64, count int) ([]Ownership, error)

fetch a list of bitmarks for an owner

type PackedOwnerData

type PackedOwnerData []byte

func (PackedOwnerData) Unpack

func (packed PackedOwnerData) Unpack() (OwnerData, error)

unpack record into the appropriate type

type ShareOwnerData

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

func (ShareOwnerData) IssueBlockNumber

func (a ShareOwnerData) IssueBlockNumber() uint64

func (ShareOwnerData) IssueTxId

func (a ShareOwnerData) IssueTxId() merkle.Digest

accessors

func (ShareOwnerData) Pack

func (a ShareOwnerData) Pack() PackedOwnerData

pack share owner data to byte slice

func (ShareOwnerData) TransferBlockNumber

func (a ShareOwnerData) TransferBlockNumber() uint64