accounts

package
v1.0.1-rc.16 Latest Latest
Warning

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

Go to latest
Published: Jan 12, 2024 License: Apache-2.0 Imports: 23 Imported by: 4

Documentation

Index

Constants

View Source
const (
	ParamAccountNonce           = "n"
	ParamAgentID                = "a"
	ParamBalance                = "B"
	ParamCollectionID           = "C"
	ParamDestroyTokens          = "y"
	ParamForceMinimumBaseTokens = "f"
	ParamFoundryOutputBin       = "b"
	ParamFoundrySN              = "s"
	ParamGasReserve             = "g"
	ParamNFTAmount              = "A"
	ParamNFTData                = "e"
	ParamNFTID                  = "z"
	ParamNFTIDs                 = "i"
	ParamNFTImmutableData       = "I"
	ParamNFTWithdrawOnMint      = "w"
	ParamMintID                 = "D"
	ParamNativeTokenID          = "N"
	ParamSupplyDeltaAbs         = "d"
	ParamTokenScheme            = "t"
)

request parameters

View Source
const (
	// KeyAllAccounts stores a map of <agentID> => true
	// where sum = baseTokens + native tokens + nfts
	KeyAllAccounts = "a"

	// prefixBaseTokens | <accountID> stores a map of <nativeTokenID> => big.Int
	PrefixNativeTokens = "t"

	// L2TotalsAccount is the special <accountID> storing the total fungible tokens
	// controlled by the chain
	L2TotalsAccount = "*"

	// PrefixNFTs | <agentID> stores a map of <NFTID> => true
	PrefixNFTs = "n"
	// PrefixNFTsByCollection | <agentID> | <collectionID> stores a map of <nftID> => true
	PrefixNFTsByCollection = "c"

	// PrefixFoundries + <agentID> stores a map of <foundrySN> (uint32) => true
	PrefixFoundries = "f"
)

Variables

View Source
var (
	// Funcs
	FuncDeposit                = coreutil.Func("deposit")
	FuncFoundryCreateNew       = coreutil.Func("foundryCreateNew")
	FuncFoundryDestroy         = coreutil.Func("foundryDestroy")
	FuncFoundryModifySupply    = coreutil.Func("foundryModifySupply")
	FuncMintNFT                = coreutil.Func("mintNFT")
	FuncTransferAccountToChain = coreutil.Func("transferAccountToChain")
	FuncTransferAllowanceTo    = coreutil.Func("transferAllowanceTo")
	FuncWithdraw               = coreutil.Func("withdraw")

	// Views
	ViewAccountFoundries             = coreutil.ViewFunc("accountFoundries")
	ViewAccountNFTAmount             = coreutil.ViewFunc("accountNFTAmount")
	ViewAccountNFTAmountInCollection = coreutil.ViewFunc("accountNFTAmountInCollection")
	ViewAccountNFTs                  = coreutil.ViewFunc("accountNFTs")
	ViewAccountNFTsInCollection      = coreutil.ViewFunc("accountNFTsInCollection")
	ViewNFTIDbyMintID                = coreutil.ViewFunc("NFTIDbyMintID")
	ViewAccounts                     = coreutil.ViewFunc("accounts")
	ViewBalance                      = coreutil.ViewFunc("balance")
	ViewBalanceBaseToken             = coreutil.ViewFunc("balanceBaseToken")
	ViewBalanceBaseTokenEVM          = coreutil.ViewFunc("balanceBaseTokenEVM")
	ViewBalanceNativeToken           = coreutil.ViewFunc("balanceNativeToken")
	ViewFoundryOutput                = coreutil.ViewFunc("foundryOutput")
	ViewGetAccountNonce              = coreutil.ViewFunc("getAccountNonce")
	ViewGetNativeTokenIDRegistry     = coreutil.ViewFunc("getNativeTokenIDRegistry")
	ViewNFTData                      = coreutil.ViewFunc("nftData")
	ViewTotalAssets                  = coreutil.ViewFunc("totalAssets")
)
View Source
var (
	ErrNotEnoughFunds                       = coreerrors.Register("not enough funds").Create()
	ErrNotEnoughBaseTokensForStorageDeposit = coreerrors.Register("not enough base tokens for storage deposit").Create()
	ErrNotEnoughAllowance                   = coreerrors.Register("not enough allowance").Create()
	ErrBadAmount                            = coreerrors.Register("bad native asset amount").Create()
	ErrRepeatingFoundrySerialNumber         = coreerrors.Register("repeating serial number of the foundry").Create()
	ErrFoundryNotFound                      = coreerrors.Register("foundry not found").Create()
	ErrOverflow                             = coreerrors.Register("overflow in token arithmetics").Create()
	ErrTooManyNFTsInAllowance               = coreerrors.Register("expected at most 1 NFT in allowance").Create()
	ErrNFTIDNotFound                        = coreerrors.Register("NFTID not found").Create()
)
View Source
var Processor = Contract.Processor(nil,

	FuncDeposit.WithHandler(deposit),
	FuncFoundryCreateNew.WithHandler(foundryCreateNew),
	FuncFoundryDestroy.WithHandler(foundryDestroy),
	FuncFoundryModifySupply.WithHandler(foundryModifySupply),
	FuncMintNFT.WithHandler(mintNFT),
	FuncTransferAccountToChain.WithHandler(transferAccountToChain),
	FuncTransferAllowanceTo.WithHandler(transferAllowanceTo),
	FuncWithdraw.WithHandler(withdraw),

	ViewAccountNFTs.WithHandler(viewAccountNFTs),
	ViewAccountNFTAmount.WithHandler(viewAccountNFTAmount),
	ViewAccountNFTsInCollection.WithHandler(viewAccountNFTsInCollection),
	ViewAccountNFTAmountInCollection.WithHandler(viewAccountNFTAmountInCollection),
	ViewNFTIDbyMintID.WithHandler(viewNFTIDbyMintID),
	ViewAccountFoundries.WithHandler(viewAccountFoundries),
	ViewAccounts.WithHandler(viewAccounts),
	ViewBalance.WithHandler(viewBalance),
	ViewBalanceBaseToken.WithHandler(viewBalanceBaseToken),
	ViewBalanceBaseTokenEVM.WithHandler(viewBalanceBaseTokenEVM),
	ViewBalanceNativeToken.WithHandler(viewBalanceNativeToken),
	ViewFoundryOutput.WithHandler(viewFoundryOutput),
	ViewGetAccountNonce.WithHandler(viewGetAccountNonce),
	ViewGetNativeTokenIDRegistry.WithHandler(viewGetNativeTokenIDRegistry),
	ViewNFTData.WithHandler(viewNFTData),
	ViewTotalAssets.WithHandler(viewTotalAssets),
)

Functions

func AccountNonce added in v1.0.3

func AccountNonce(state kv.KVStoreReader, callerAgentID isc.AgentID, chainID isc.ChainID) uint64

Nonce returns the "total request count" for an account (it's the AccountNonce that is expected in the next request)

func AdjustAccountBaseTokens added in v0.3.0

func AdjustAccountBaseTokens(state kv.KVStore, account isc.AgentID, adjustment int64, chainID isc.ChainID)

func AgentIDFromKey added in v1.0.3

func AgentIDFromKey(key kv.Key, chainID isc.ChainID) (isc.AgentID, error)

converts an account key from the accounts contract (shortform without chainID) to an AgentID

func AllFoundriesMap added in v1.0.3

func AllFoundriesMap(state kv.KVStore) *collections.Map

func BaseTokensKey added in v1.0.3

func BaseTokensKey(accountKey kv.Key) kv.Key

func CheckLedger added in v0.3.7

func CheckLedger(state kv.KVStoreReader, checkpoint string)

only used in internal tests and solo

func CommonAccount added in v1.0.3

func CommonAccount() isc.AgentID

func CreditNFTToAccount added in v0.3.0

func CreditNFTToAccount(state kv.KVStore, agentID isc.AgentID, nftOutput *iotago.NFTOutput, chainID isc.ChainID)

CreditNFTToAccount credits an NFT to the on chain ledger

func CreditToAccount

func CreditToAccount(state kv.KVStore, agentID isc.AgentID, assets *isc.Assets, chainID isc.ChainID)

CreditToAccount brings new funds to the on chain ledger NOTE: this function does not take NFTs into account

func CreditToAccountFullDecimals added in v1.0.3

func CreditToAccountFullDecimals(state kv.KVStore, agentID isc.AgentID, amount *big.Int, chainID isc.ChainID)

func DebitFromAccount

func DebitFromAccount(state kv.KVStore, agentID isc.AgentID, assets *isc.Assets, chainID isc.ChainID)

DebitFromAccount takes out assets balance the on chain ledger. If not enough it panics NOTE: this function does not take NFTs into account

func DebitFromAccountFullDecimals added in v1.0.3

func DebitFromAccountFullDecimals(state kv.KVStore, agentID isc.AgentID, amount *big.Int, chainID isc.ChainID)

DebitFromAccountFullDecimals removes the amount from the chain ledger. If not enough it panics

func DebitNFTFromAccount added in v0.3.0

func DebitNFTFromAccount(state kv.KVStore, agentID isc.AgentID, nftID iotago.NFTID, chainID isc.ChainID)

DebitNFTFromAccount removes an NFT from an account. If the account does not own the nft, it panics.

func DeleteFoundryOutput added in v0.3.0

func DeleteFoundryOutput(state kv.KVStore, sn uint32)

DeleteFoundryOutput deletes foundry output from the map of all foundries

func DeleteNFTOutput added in v0.3.0

func DeleteNFTOutput(state kv.KVStore, nftID iotago.NFTID)

func DeleteNativeTokenOutput added in v0.3.0

func DeleteNativeTokenOutput(state kv.KVStore, nativeTokenID iotago.NativeTokenID)

func GetAccountFungibleTokens added in v1.0.3

func GetAccountFungibleTokens(state kv.KVStoreReader, agentID isc.AgentID, chainID isc.ChainID) *isc.Assets

GetAccountFungibleTokens returns all fungible tokens belonging to the agentID on the state

func GetAccountNFTs added in v0.3.0

func GetAccountNFTs(state kv.KVStoreReader, agentID isc.AgentID) []iotago.NFTID

GetAccountNFTs returns all NFTs belonging to the agentID on the state

func GetBaseTokensBalance added in v0.3.0

func GetBaseTokensBalance(state kv.KVStoreReader, agentID isc.AgentID, chainID isc.ChainID) uint64

func GetFoundryOutput added in v0.3.0

func GetFoundryOutput(state kv.KVStoreReader, sn uint32, chainID isc.ChainID) (*iotago.FoundryOutput, iotago.OutputID)

GetFoundryOutput returns foundry output, its block number and output index

func GetNFTData added in v0.3.0

func GetNFTData(state kv.KVStoreReader, nftID iotago.NFTID) *isc.NFT

func GetNFTOutput added in v0.3.0

func GetNFTOutput(state kv.KVStoreReader, nftID iotago.NFTID) (*iotago.NFTOutput, iotago.OutputID)

func GetNativeTokenBalance added in v0.3.0

func GetNativeTokenBalance(state kv.KVStoreReader, agentID isc.AgentID, nativeTokenID iotago.NativeTokenID, chainID isc.ChainID) *big.Int

func GetNativeTokenBalanceTotal added in v0.3.0

func GetNativeTokenBalanceTotal(state kv.KVStoreReader, nativeTokenID iotago.NativeTokenID) *big.Int

func GetNativeTokenOutput added in v0.3.0

func GetNativeTokenOutput(state kv.KVStoreReader, nativeTokenID iotago.NativeTokenID, chainID isc.ChainID) (*iotago.BasicOutput, iotago.OutputID)

func GetNativeTokens added in v1.0.3

func GetNativeTokens(state kv.KVStoreReader, agentID isc.AgentID, chainID isc.ChainID) iotago.NativeTokens

func GetTotalL2FungibleTokens added in v1.0.3

func GetTotalL2FungibleTokens(state kv.KVStoreReader) *isc.Assets

func GetTotalL2NFTs added in v0.3.0

func GetTotalL2NFTs(state kv.KVStoreReader) []iotago.NFTID

func HasEnoughForAllowance added in v0.3.0

func HasEnoughForAllowance(state kv.KVStoreReader, agentID isc.AgentID, allowance *isc.Assets, chainID isc.ChainID) bool

HasEnoughForAllowance checks whether an account has enough balance to cover for the allowance

func IncrementNonce added in v1.0.3

func IncrementNonce(state kv.KVStore, callerAgentID isc.AgentID, chainID isc.ChainID)

func MoveBetweenAccounts

func MoveBetweenAccounts(state kv.KVStore, fromAgentID, toAgentID isc.AgentID, assets *isc.Assets, chainID isc.ChainID) error

MoveBetweenAccounts moves assets between on-chain accounts

func MoveFoundryBetweenAccounts added in v0.3.0

func MoveFoundryBetweenAccounts(state kv.KVStore, agentIDFrom, agentIDTo isc.AgentID, sn uint32)

MoveFoundryBetweenAccounts changes ownership of the foundry

func MustMoveBetweenAccounts added in v0.3.0

func MustMoveBetweenAccounts(state kv.KVStore, fromAgentID, toAgentID isc.AgentID, assets *isc.Assets, chainID isc.ChainID)

func NFTOutputMap added in v1.0.3

func NFTOutputMap(state kv.KVStore) *collections.Map

func NFTToOwnerMap

func NFTToOwnerMap(state kv.KVStore) *collections.Map

func NFTToOwnerMapR

func NFTToOwnerMapR(state kv.KVStoreReader) *collections.ImmutableMap

func NativeTokenOutputMap added in v1.0.3

func NativeTokenOutputMap(state kv.KVStore) *collections.Map

func SaveFoundryOutput added in v0.3.0

func SaveFoundryOutput(state kv.KVStore, f *iotago.FoundryOutput, outputIndex uint16)

SaveFoundryOutput stores foundry output into the map of all foundry outputs (compressed form)

func SaveMintedNFTOutput added in v1.0.3

func SaveMintedNFTOutput(state kv.KVStore, positionInMintedList, outputIndex uint16)

func SaveNFTOutput added in v0.3.0

func SaveNFTOutput(state kv.KVStore, out *iotago.NFTOutput, outputIndex uint16)

func SaveNativeTokenOutput added in v0.3.0

func SaveNativeTokenOutput(state kv.KVStore, out *iotago.BasicOutput, outputIndex uint16)

SaveNativeTokenOutput map nativeTokenID -> foundryRec

func SetInitialState added in v1.0.3

func SetInitialState(state kv.KVStore, baseTokensOnAnchor uint64)

this expects the origin amount minus SD

func UpdateLatestOutputID added in v1.0.3

func UpdateLatestOutputID(state kv.KVStore, anchorTxID iotago.TransactionID, blockIndex uint32)

Types

type NFTOutputRec added in v0.3.0

type NFTOutputRec struct {
	OutputID iotago.OutputID
	Output   *iotago.NFTOutput
}

func (*NFTOutputRec) Bytes added in v0.3.0

func (rec *NFTOutputRec) Bytes() []byte

func (*NFTOutputRec) Read added in v1.0.3

func (rec *NFTOutputRec) Read(r io.Reader) error

func (*NFTOutputRec) String added in v0.3.0

func (rec *NFTOutputRec) String() string

func (*NFTOutputRec) Write added in v1.0.3

func (rec *NFTOutputRec) Write(w io.Writer) error

type StateAccess added in v1.0.3

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

func NewStateAccess added in v1.0.3

func NewStateAccess(store kv.KVStoreReader) *StateAccess

func (*StateAccess) AccountExists added in v1.0.3

func (sa *StateAccess) AccountExists(agentID isc.AgentID, chainID isc.ChainID) bool

func (*StateAccess) Nonce added in v1.0.3

func (sa *StateAccess) Nonce(agentID isc.AgentID, chainID isc.ChainID) uint64

Jump to

Keyboard shortcuts

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