system

package
v0.0.0-...-9ffcaaa Latest Latest
Warning

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

Go to latest
Published: Jul 19, 2019 License: MIT Imports: 5 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var AN = uos.AN
View Source
var ActN = uos.ActN
View Source
var PN = uos.PN

Functions

func NewBidname

func NewBidname(bidder, newname uos.AccountName, bid uos.Asset) *uos.Action

func NewBuyRAM

func NewBuyRAM(payer, receiver uos.AccountName, uosQuantity uint64) *uos.Action

func NewBuyRAMBytes

func NewBuyRAMBytes(payer, receiver uos.AccountName, bytes uint32) *uos.Action

NewBuyRAMBytes will buy at current market price a given number of bytes of RAM, and grant them to the `receiver` account.

func NewCancelDelay

func NewCancelDelay(cancelingAuth uos.PermissionLevel, transactionID uos.Checksum256) *uos.Action

NewCancelDelay creates an action from the `uosio.system` contract called `canceldelay`.

`canceldelay` allows you to cancel a deferred transaction, previously sent to the chain with a `delay_sec` larger than 0. You need to sign with cancelingAuth, to cancel a transaction signed with that same authority.

func NewClaimRewards

func NewClaimRewards(owner uos.AccountName) *uos.Action

NewClaimRewards will buy at current market price a given number of bytes of RAM, and grant them to the `receiver` account.

func NewCustomNewAccount

func NewCustomNewAccount(creator, newAccount uos.AccountName, owner, active uos.Authority) *uos.Action

NewCustomNewAccount returns a `newaccount` action that lives on the `uosio.system` contract. You can specify your own `owner` and `active` permissions.

func NewDelegateBW

func NewDelegateBW(from, receiver uos.AccountName, stakeCPU, stakeNet uos.Asset, transfer bool) *uos.Action

NewDelegateBW returns a `delegatebw` action that lives on the `uosio.system` contract.

func NewDelegatedNewAccount

func NewDelegatedNewAccount(creator, newAccount uos.AccountName, delegatedTo uos.AccountName) *uos.Action

NewDelegatedNewAccount returns a `newaccount` action that lives on the `uosio.system` contract. It is filled with an authority structure that delegates full control of the new account to an already existing account.

func NewDeleteAuth

func NewDeleteAuth(account uos.AccountName, permission uos.PermissionName) *uos.Action

NewDeleteAuth creates an action from the `uosio.system` contract called `deleteauth`.

You cannot delete the `owner` or `active` permissions. Also, if a permission is still linked through a previous `updatelink` action, you will need to `unlinkauth` first.

func NewLinkAuth

func NewLinkAuth(account, code uos.AccountName, actionName uos.ActionName, requiredPermission uos.PermissionName) *uos.Action

NewLinkAuth creates an action from the `uosio.system` contract called `linkauth`.

`linkauth` allows you to attach certain permission to the given `code::actionName`. With this set on-chain, you can use the `requiredPermission` to sign transactions for `code::actionName` and not rely on your `active` (which might be more sensitive as it can sign anything) for the given operation.

func NewNewAccount

func NewNewAccount(creator, newAccount uos.AccountName, publicKey ecc.PublicKey) *uos.Action

NewNewAccount returns a `newaccount` action that lives on the `uosio.system` contract.

func NewNonce

func NewNonce(nonce string) *uos.Action

NewNonce returns a `nonce` action that lives on the `uosio.bios` contract. It should exist only when booting a new network, as it is replaced using the `uos-bios` boot process by the `uosio.system` contract.

func NewRefund

func NewRefund(owner uos.AccountName) *uos.Action

NewRefund returns a `refund` action that lives on the `uosio.system` contract.

func NewRegProducer

func NewRegProducer(producer uos.AccountName, producerKey ecc.PublicKey, url string, location uint16) *uos.Action

NewRegProducer returns a `regproducer` action that lives on the `uosio.system` contract.

func NewRegProxy

func NewRegProxy(proxy uos.AccountName, isProxy bool) *uos.Action

NewRegProxy returns a `regproxy` action that lives on the `uosio.system` contract.

func NewRemoveProducer

func NewRemoveProducer(producer uos.AccountName) *uos.Action

NewRemoveProducer returns a `rmvproducer` action that lives on the `uosio.system` contract. This is to be called by the consortium of BPs, to oust a BP from its place. If you want to unregister yourself as a BP, use `unregprod`.

func NewSellRAM

func NewSellRAM(account uos.AccountName, bytes uint64) *uos.Action

NewSellRAM will sell at current market price a given number of bytes of RAM.

func NewSetABI

func NewSetABI(account uos.AccountName, abiPath string) (out *uos.Action, err error)

func NewSetCode

func NewSetCode(account uos.AccountName, wasmPath string) (out *uos.Action, err error)

func NewSetCodeTx

func NewSetCodeTx(account uos.AccountName, wasmPath, abiPath string) (out *uos.Transaction, err error)

NewSetCodeTx is _deprecated_. Use NewSetContract instead, and build your transaction yourself.

func NewSetContract

func NewSetContract(account uos.AccountName, wasmPath, abiPath string) (out []*uos.Action, err error)

func NewSetPriv

func NewSetPriv(account uos.AccountName) *uos.Action

NewSetPriv returns a `setpriv` action that lives on the `uosio.bios` contract. It should exist only when booting a new network, as it is replaced using the `uos-bios` boot process by the `uosio.system` contract.

func NewSetProds

func NewSetProds(producers []ProducerKey) *uos.Action

NewSetPriv returns a `setpriv` action that lives on the `uosio.bios` contract. It should exist only when booting a new network, as it is replaced using the `uos-bios` boot process by the `uosio.system` contract.

func NewSetRAM

func NewSetRAM(maxRAMSize uint64) *uos.Action

func NewSetRAMRate

func NewSetRAMRate(bytesPerBlock uint16) *uos.Action

func NewSetalimits

func NewSetalimits(account uos.AccountName, ramBytes, netWeight, cpuWeight int64) *uos.Action

NewSetalimits sets the account limits. Requires signature from `uosio@active` account.

func NewUndelegateBW

func NewUndelegateBW(from, receiver uos.AccountName, unstakeCPU, unstakeNet uos.Asset) *uos.Action

NewUndelegateBW returns a `undelegatebw` action that lives on the `uosio.system` contract.

func NewUnlinkAuth

func NewUnlinkAuth(account, code uos.AccountName, actionName uos.ActionName) *uos.Action

NewUnlinkAuth creates an action from the `uosio.system` contract called `unlinkauth`.

`unlinkauth` detaches a previously set permission from a `code::actionName`. See `linkauth`.

func NewUnregProducer

func NewUnregProducer(producer uos.AccountName) *uos.Action

NewUnregProducer returns a `unregprod` action that lives on the `uosio.system` contract.

func NewUpdateAuth

func NewUpdateAuth(account uos.AccountName, permission, parent uos.PermissionName, authority uos.Authority, usingPermission uos.PermissionName) *uos.Action

NewUpdateAuth creates an action from the `uosio.system` contract called `updateauth`.

usingPermission needs to be `owner` if you want to modify the `owner` authorization, otherwise `active` will do for the rest.

func NewVoteProducer

func NewVoteProducer(voter uos.AccountName, proxy uos.AccountName, producers ...uos.AccountName) *uos.Action

NewNonce returns a `nonce` action that lives on the `uosio.bios` contract. It should exist only when booting a new network, as it is replaced using the `uos-bios` boot process by the `uosio.system` contract.

Types

type Bidname

type Bidname struct {
	Bidder  uos.AccountName `json:"bidder"`
	Newname uos.AccountName `json:"newname"`
	Bid     uos.Asset       `json:"bid"` // specified in UOS
}

Bidname represents the `uosio.system_contract::bidname` action.

type BlockchainParameters

type BlockchainParameters struct {
	MaxBlockNetUsage               uos.Uint64 `json:"max_block_net_usage"`
	TargetBlockNetUsagePct         uint32     `json:"target_block_net_usage_pct"`
	MaxTransactionNetUsage         uint32     `json:"max_transaction_net_usage"`
	BasePerTransactionNetUsage     uint32     `json:"base_per_transaction_net_usage"`
	NetUsageLeeway                 uint32     `json:"net_usage_leeway"`
	ContextFreeDiscountNetUsageNum uint32     `json:"context_free_discount_net_usage_num"`
	ContextFreeDiscountNetUsageDen uint32     `json:"context_free_discount_net_usage_den"`
	MaxBlockCPUUsage               uint32     `json:"max_block_cpu_usage"`
	TargetBlockCPUUsagePct         uint32     `json:"target_block_cpu_usage_pct"`
	MaxTransactionCPUUsage         uint32     `json:"max_transaction_cpu_usage"`
	MinTransactionCPUUsage         uint32     `json:"min_transaction_cpu_usage"`
	MaxTransactionLifetime         uint32     `json:"max_transaction_lifetime"`
	DeferredTrxExpirationWindow    uint32     `json:"deferred_trx_expiration_window"`
	MaxTransactionDelay            uint32     `json:"max_transaction_delay"`
	MaxInlineActionSize            uint32     `json:"max_inline_action_size"`
	MaxInlineActionDepth           uint16     `json:"max_inline_action_depth"`
	MaxAuthorityDepth              uint16     `json:"max_authority_depth"`
	MaxGeneratedTransactionCount   uint32     `json:"max_generated_transaction_count"`
}

BlockchainParameters are all the params we can set through `setparams`.

type BuyRAM

type BuyRAM struct {
	Payer    uos.AccountName `json:"payer"`
	Receiver uos.AccountName `json:"receiver"`
	Quantity uos.Asset       `json:"quant"` // specified in UOS
}

BuyRAM represents the `uosio.system::buyram` action.

type BuyRAMBytes

type BuyRAMBytes struct {
	Payer    uos.AccountName `json:"payer"`
	Receiver uos.AccountName `json:"receiver"`
	Bytes    uint32          `json:"bytes"`
}

BuyRAMBytes represents the `uosio.system::buyrambytes` action.

type CancelDelay

type CancelDelay struct {
	CancelingAuth uos.PermissionLevel `json:"canceling_auth"`
	TransactionID uos.Checksum256     `json:"trx_id"`
}

CancelDelay represents the native `canceldelay` action, through the system contract.

type ClaimRewards

type ClaimRewards struct {
	Owner uos.AccountName `json:"owner"`
}

ClaimRewards represents the `uosio.system::claimrewards` action.

type DelegateBW

type DelegateBW struct {
	From     uos.AccountName `json:"from"`
	Receiver uos.AccountName `json:"receiver"`
	StakeNet uos.Asset       `json:"stake_net"`
	StakeCPU uos.Asset       `json:"stake_cpu"`
	Transfer uos.Bool        `json:"transfer"`
}

DelegateBW represents the `uosio.system::delegatebw` action.

type DeleteAuth

type DeleteAuth struct {
	Account    uos.AccountName    `json:"account"`
	Permission uos.PermissionName `json:"permission"`
}

DeleteAuth represents the native `deleteauth` action, reachable through the `uosio.system` contract.

type LinkAuth

type LinkAuth struct {
	Account     uos.AccountName    `json:"account"`
	Code        uos.AccountName    `json:"code"`
	Type        uos.ActionName     `json:"type"`
	Requirement uos.PermissionName `json:"requirement"`
}

LinkAuth represents the native `linkauth` action, through the system contract.

type NewAccount

type NewAccount struct {
	Creator uos.AccountName `json:"creator"`
	Name    uos.AccountName `json:"name"`
	Owner   uos.Authority   `json:"owner"`
	Active  uos.Authority   `json:"active"`
}

NewAccount represents a `newaccount` action on the `uosio.system` contract. It is one of the rare ones to be hard-coded into the blockchain.

type Nonce

type Nonce struct {
	Value string `json:"value"`
}

Nonce represents the `uosio.system::nonce` action. It is used to add variability in a transaction, so you can send the same many times in the same block, without it having the same Tx hash.

type ProducerKey

type ProducerKey struct {
	ProducerName    uos.AccountName `json:"producer_name"`
	BlockSigningKey ecc.PublicKey   `json:"block_signing_key"`
}

type Refund

type Refund struct {
	Owner uos.AccountName `json:"owner"`
}

Refund represents the `uosio.system::refund` action

type RegProducer

type RegProducer struct {
	Producer    uos.AccountName `json:"producer"`
	ProducerKey ecc.PublicKey   `json:"producer_key"`
	URL         string          `json:"url"`
	Location    uint16          `json:"location"` // what,s the meaning of that anyway ?
}

RegProducer represents the `uosio.system::regproducer` action

type RegProxy

type RegProxy struct {
	Proxy   uos.AccountName `json:"proxy"`
	IsProxy bool            `json:"isproxy"`
}

RegProxy represents the `uosio.system::regproxy` action

type RemoveProducer

type RemoveProducer struct {
	Producer uos.AccountName `json:"producer"`
}

RemoveProducer represents the `uosio.system::rmvproducer` action

type SellRAM

type SellRAM struct {
	Account uos.AccountName `json:"account"`
	Bytes   uint64          `json:"bytes"`
}

SellRAM represents the `uosio.system::sellram` action.

type SetABI

type SetABI struct {
	Account uos.AccountName `json:"account"`
	ABI     uos.HexBytes    `json:"abi"`
}

SetABI represents the hard-coded `setabi` action.

type SetCode

type SetCode struct {
	Account   uos.AccountName `json:"account"`
	VMType    byte            `json:"vmtype"`
	VMVersion byte            `json:"vmversion"`
	Code      uos.HexBytes    `json:"code"`
}

SetCode represents the hard-coded `setcode` action.

type SetPriv

type SetPriv struct {
	Account uos.AccountName `json:"account"`
	IsPriv  uos.Bool        `json:"is_priv"`
}

SetPriv sets privileged account status. Used in the bios boot mechanism.

type SetProds

type SetProds struct {
	Schedule []ProducerKey `json:"schedule"`
}

SetProds is present in `uosio.bios` contract. Used only at boot time.

type SetRAM

type SetRAM struct {
	MaxRAMSize uos.Uint64 `json:"max_ram_size"`
}

SetRAM represents the hard-coded `setram` action.

type SetRAMRate

type SetRAMRate struct {
	BytesPerBlock uint16 `json:"bytes_per_block"`
}

SetRAMRate represents the system contract's `setramrate` action.

type Setalimits

type Setalimits struct {
	Account   uos.AccountName `json:"account"`
	RAMBytes  int64           `json:"ram_bytes"`
	NetWeight int64           `json:"net_weight"`
	CPUWeight int64           `json:"cpu_weight"`
}

Setalimits represents the `uosio.system::setalimit` action.

type UOSIOGlobalState

type UOSIOGlobalState struct {
	BlockchainParameters
	TotalStorageBytesReserved uos.Uint64 `json:"total_storage_bytes_reserved"`
	TotalStorageStake         uos.Uint64 `json:"total_storage_stake"`
	PaymentPerBlock           uos.Uint64 `json:"payment_per_block"`
}

type UndelegateBW

type UndelegateBW struct {
	From       uos.AccountName `json:"from"`
	Receiver   uos.AccountName `json:"receiver"`
	UnstakeNet uos.Asset       `json:"unstake_net_quantity"`
	UnstakeCPU uos.Asset       `json:"unstake_cpu_quantity"`
}

UndelegateBW represents the `uosio.system::undelegatebw` action.

type UnlinkAuth

type UnlinkAuth struct {
	Account uos.AccountName `json:"account"`
	Code    uos.AccountName `json:"code"`
	Type    uos.ActionName  `json:"type"`
}

UnlinkAuth represents the native `unlinkauth` action, through the system contract.

type UnregProducer

type UnregProducer struct {
	Producer uos.AccountName `json:"producer"`
}

UnregProducer represents the `uosio.system::unregprod` action

type UpdateAuth

type UpdateAuth struct {
	Account    uos.AccountName    `json:"account"`
	Permission uos.PermissionName `json:"permission"`
	Parent     uos.PermissionName `json:"parent"`
	Auth       uos.Authority      `json:"auth"`
}

UpdateAuth represents the hard-coded `updateauth` action.

If you change the `active` permission, `owner` is the required parent.

If you change the `owner` permission, there should be no parent.

type VoteProducer

type VoteProducer struct {
	Voter     uos.AccountName   `json:"voter"`
	Proxy     uos.AccountName   `json:"proxy"`
	Producers []uos.AccountName `json:"producers"`
}

VoteProducer represents the `uosio.system::voteproducer` action

Jump to

Keyboard shortcuts

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