Documentation ¶
Index ¶
- func NewCodecs(fxs []Fx) (codec.Manager, codec.Manager, error)
- func NewPubSubFilterer(tx *Tx) pubsub.Filterer
- type AssetDefinition
- type AssetIDChangeAddr
- type Balance
- type BaseTx
- func (t *BaseTx) ExecuteWithSideEffects(_ *VM, batch database.Batch) error
- func (t *BaseTx) Init(vm *VM) error
- func (t *BaseTx) SemanticVerify(vm *VM, tx UnsignedTx, creds []verify.Verifiable) error
- func (t *BaseTx) SyntacticVerify(ctx *snow.Context, c codec.Manager, txFeeAssetID ids.ID, txFee uint64, ...) error
- type BuildGenesisArgs
- type BuildGenesisReply
- type Client
- type Config
- type CreateAssetArgs
- type CreateAssetTx
- type CreateNFTAssetArgs
- type ExportArgs
- type ExportKeyArgs
- type ExportKeyReply
- type ExportTx
- func (t *ExportTx) ExecuteWithSideEffects(vm *VM, batch database.Batch) error
- func (t *ExportTx) Init(vm *VM) error
- func (t *ExportTx) SemanticVerify(vm *VM, tx UnsignedTx, creds []verify.Verifiable) error
- func (t *ExportTx) SyntacticVerify(ctx *snow.Context, c codec.Manager, txFeeAssetID ids.ID, txFee uint64, ...) error
- type Factory
- type FormattedAssetID
- type Fx
- type FxCredential
- type FxOperation
- type Genesis
- type GenesisAsset
- type GetAddressTxsArgs
- type GetAddressTxsReply
- type GetAllBalancesArgs
- type GetAllBalancesReply
- type GetAssetDescriptionArgs
- type GetAssetDescriptionReply
- type GetBalanceArgs
- type GetBalanceReply
- type GetTxStatusReply
- type Holder
- type ImportArgs
- type ImportKeyArgs
- type ImportKeyReply
- type ImportTx
- func (t *ImportTx) AssetIDs() ids.Set
- func (t *ImportTx) ConsumedAssetIDs() ids.Set
- func (t *ImportTx) ExecuteWithSideEffects(vm *VM, batch database.Batch) error
- func (t *ImportTx) Init(vm *VM) error
- func (t *ImportTx) InputUTXOs() []*avax.UTXOID
- func (t *ImportTx) NumCredentials() int
- func (t *ImportTx) SemanticVerify(vm *VM, tx UnsignedTx, creds []verify.Verifiable) error
- func (t *ImportTx) SyntacticVerify(ctx *snow.Context, c codec.Manager, txFeeAssetID ids.ID, txFee uint64, ...) error
- type InitialState
- type MintArgs
- type MintNFTArgs
- type Operation
- type OperationTx
- func (t *OperationTx) AssetIDs() ids.Set
- func (t *OperationTx) ConsumedAssetIDs() ids.Set
- func (t *OperationTx) Init(vm *VM) error
- func (t *OperationTx) InputUTXOs() []*avax.UTXOID
- func (t *OperationTx) NumCredentials() int
- func (t *OperationTx) Operations() []*Operation
- func (t *OperationTx) SemanticVerify(vm *VM, tx UnsignedTx, creds []verify.Verifiable) error
- func (t *OperationTx) SyntacticVerify(ctx *snow.Context, c codec.Manager, txFeeAssetID ids.ID, txFee uint64, ...) error
- func (t *OperationTx) UTXOs() []*avax.UTXO
- type Owners
- type SendArgs
- type SendMultipleArgs
- type SendNFTArgs
- type SendOutput
- type Service
- func (service *Service) CreateAddress(r *http.Request, args *api.UserPass, reply *api.JSONAddress) error
- func (service *Service) CreateAsset(r *http.Request, args *CreateAssetArgs, reply *AssetIDChangeAddr) error
- func (service *Service) CreateFixedCapAsset(r *http.Request, args *CreateAssetArgs, reply *AssetIDChangeAddr) error
- func (service *Service) CreateNFTAsset(r *http.Request, args *CreateNFTAssetArgs, reply *AssetIDChangeAddr) error
- func (service *Service) CreateVariableCapAsset(r *http.Request, args *CreateAssetArgs, reply *AssetIDChangeAddr) error
- func (service *Service) Export(_ *http.Request, args *ExportArgs, reply *api.JSONTxIDChangeAddr) error
- func (service *Service) ExportKey(r *http.Request, args *ExportKeyArgs, reply *ExportKeyReply) error
- func (service *Service) GetAddressTxs(r *http.Request, args *GetAddressTxsArgs, reply *GetAddressTxsReply) error
- func (service *Service) GetAllBalances(r *http.Request, args *GetAllBalancesArgs, reply *GetAllBalancesReply) error
- func (service *Service) GetAssetDescription(_ *http.Request, args *GetAssetDescriptionArgs, ...) error
- func (service *Service) GetBalance(r *http.Request, args *GetBalanceArgs, reply *GetBalanceReply) error
- func (service *Service) GetTx(r *http.Request, args *api.GetTxArgs, reply *api.GetTxReply) error
- func (service *Service) GetTxStatus(r *http.Request, args *api.JSONTxID, reply *GetTxStatusReply) error
- func (service *Service) GetUTXOs(r *http.Request, args *api.GetUTXOsArgs, reply *api.GetUTXOsReply) error
- func (service *Service) Import(_ *http.Request, args *ImportArgs, reply *api.JSONTxID) error
- func (service *Service) ImportKey(r *http.Request, args *ImportKeyArgs, reply *api.JSONAddress) error
- func (service *Service) IssueTx(r *http.Request, args *api.FormattedTx, reply *api.JSONTxID) error
- func (service *Service) ListAddresses(_ *http.Request, args *api.UserPass, response *api.JSONAddresses) error
- func (service *Service) Mint(r *http.Request, args *MintArgs, reply *api.JSONTxIDChangeAddr) error
- func (service *Service) MintNFT(r *http.Request, args *MintNFTArgs, reply *api.JSONTxIDChangeAddr) error
- func (service *Service) Send(r *http.Request, args *SendArgs, reply *api.JSONTxIDChangeAddr) error
- func (service *Service) SendMultiple(r *http.Request, args *SendMultipleArgs, reply *api.JSONTxIDChangeAddr) error
- func (service *Service) SendNFT(r *http.Request, args *SendNFTArgs, reply *api.JSONTxIDChangeAddr) error
- type State
- type StaticService
- type Tx
- func (t *Tx) Credentials() []verify.Verifiable
- func (t *Tx) Init(vm *VM) error
- func (t *Tx) SemanticVerify(vm *VM, tx UnsignedTx) error
- func (t *Tx) SignNFTFx(c codec.Manager, signers [][]*crypto.PrivateKeySECP256K1R) error
- func (t *Tx) SignPropertyFx(c codec.Manager, signers [][]*crypto.PrivateKeySECP256K1R) error
- func (t *Tx) SignSECP256K1Fx(c codec.Manager, signers [][]*crypto.PrivateKeySECP256K1R) error
- func (t *Tx) SyntacticVerify(ctx *snow.Context, c codec.Manager, txFeeAssetID ids.ID, txFee uint64, ...) error
- type TxCachedState
- type TxState
- type UniqueTx
- func (tx *UniqueTx) Accept() error
- func (tx *UniqueTx) Bytes() []byte
- func (tx *UniqueTx) Dependencies() ([]snowstorm.Tx, error)
- func (tx *UniqueTx) Evict()
- func (tx *UniqueTx) ID() ids.ID
- func (tx *UniqueTx) InputIDs() []ids.ID
- func (tx *UniqueTx) InputUTXOs() []*avax.UTXOID
- func (tx *UniqueTx) Key() interface{}
- func (tx *UniqueTx) Reject() error
- func (tx *UniqueTx) SemanticVerify() error
- func (tx *UniqueTx) Status() choices.Status
- func (tx *UniqueTx) SyntacticVerify() error
- func (tx *UniqueTx) UTXOs() []*avax.UTXO
- func (tx *UniqueTx) Verify() error
- func (tx *UniqueTx) Whitelist() (ids.Set, bool, error)
- type UnsignedTx
- type VM
- func (vm *VM) AppGossip(nodeID ids.ShortID, msg []byte) error
- func (vm *VM) AppRequest(nodeID ids.ShortID, requestID uint32, deadline time.Time, request []byte) error
- func (vm *VM) AppRequestFailed(nodeID ids.ShortID, requestID uint32) error
- func (vm *VM) AppResponse(nodeID ids.ShortID, requestID uint32, response []byte) error
- func (vm *VM) Connected(nodeID ids.ShortID, nodeVersion version.Application) error
- func (vm *VM) CreateHandlers() (map[string]*common.HTTPHandler, error)
- func (vm *VM) CreateStaticHandlers() (map[string]*common.HTTPHandler, error)
- func (vm *VM) Disconnected(nodeID ids.ShortID) error
- func (vm *VM) FlushTxs()
- func (vm *VM) GetTx(txID ids.ID) (snowstorm.Tx, error)
- func (vm *VM) HealthCheck() (interface{}, error)
- func (vm *VM) Initialize(ctx *snow.Context, dbManager manager.Manager, genesisBytes []byte, ...) error
- func (vm *VM) IssueTx(b []byte) (ids.ID, error)
- func (vm *VM) LoadUser(username string, password string, addrsToUse ids.ShortSet) ([]*avax.UTXO, *secp256k1fx.Keychain, error)
- func (vm *VM) Mint(utxos []*avax.UTXO, kc *secp256k1fx.Keychain, amounts map[ids.ID]uint64, ...) ([]*Operation, [][]*crypto.PrivateKeySECP256K1R, error)
- func (vm *VM) MintNFT(utxos []*avax.UTXO, kc *secp256k1fx.Keychain, assetID ids.ID, payload []byte, ...) ([]*Operation, [][]*crypto.PrivateKeySECP256K1R, error)
- func (vm *VM) ParseTx(b []byte) (snowstorm.Tx, error)
- func (vm *VM) PendingTxs() []snowstorm.Tx
- func (vm *VM) SetState(state snow.State) error
- func (vm *VM) Shutdown() error
- func (vm *VM) Spend(utxos []*avax.UTXO, kc *secp256k1fx.Keychain, amounts map[ids.ID]uint64) (map[ids.ID]uint64, []*avax.TransferableInput, [][]*crypto.PrivateKeySECP256K1R, ...)
- func (vm *VM) SpendAll(utxos []*avax.UTXO, kc *secp256k1fx.Keychain) (map[ids.ID]uint64, []*avax.TransferableInput, [][]*crypto.PrivateKeySECP256K1R, ...)
- func (vm *VM) SpendNFT(utxos []*avax.UTXO, kc *secp256k1fx.Keychain, assetID ids.ID, groupID uint32, ...) ([]*Operation, [][]*crypto.PrivateKeySECP256K1R, error)
- func (vm *VM) Version() (string, error)
- type WalletClient
- type WalletService
- func (w *WalletService) IssueTx(r *http.Request, args *api.FormattedTx, reply *api.JSONTxID) error
- func (w *WalletService) Send(r *http.Request, args *SendArgs, reply *api.JSONTxIDChangeAddr) error
- func (w *WalletService) SendMultiple(r *http.Request, args *SendMultipleArgs, reply *api.JSONTxIDChangeAddr) error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewCodecs ¶ added in v1.7.6
NewCodecs returns the genesis codec and the normal codec for the provided feature extensions.
func NewPubSubFilterer ¶ added in v1.7.6
Types ¶
type AssetDefinition ¶
type AssetIDChangeAddr ¶ added in v1.7.6
type AssetIDChangeAddr struct { FormattedAssetID api.JSONChangeAddr }
AssetIDChangeAddr is an asset ID and a change address
type BaseTx ¶
BaseTx is the basis of all transactions.
func (*BaseTx) ExecuteWithSideEffects ¶
ExecuteWithSideEffects writes the batch with any additional side effects
func (*BaseTx) Init ¶ added in v1.7.6
Init sets the FxID fields in the inputs and outputs of this BaseTx Also sets the [ctx] in the OutputOwners to the given [vm.ctx] so that the addresses can be json marshalled into human readable format
func (*BaseTx) SemanticVerify ¶
func (t *BaseTx) SemanticVerify(vm *VM, tx UnsignedTx, creds []verify.Verifiable) error
SemanticVerify that this transaction is valid to be spent.
type BuildGenesisArgs ¶
type BuildGenesisArgs struct { NetworkID cjson.Uint32 `json:"networkID"` GenesisData map[string]AssetDefinition `json:"genesisData"` Encoding formatting.Encoding `json:"encoding"` }
BuildGenesisArgs are arguments for BuildGenesis
type BuildGenesisReply ¶
type BuildGenesisReply struct { Bytes string `json:"bytes"` Encoding formatting.Encoding `json:"encoding"` }
BuildGenesisReply is the reply from BuildGenesis
type Client ¶ added in v1.7.6
type Client interface { WalletClient // GetTxStatus returns the status of [txID] GetTxStatus(ctx context.Context, txID ids.ID) (choices.Status, error) // ConfirmTx attempts to confirm [txID] by checking its status [numChecks] times // with [checkFreq] between each attempt. If the transaction has not been decided // by the final attempt, it returns the status of the last attempt. // Note: ConfirmTx will block until either the last attempt finishes or the client // returns a decided status. ConfirmTx(ctx context.Context, txID ids.ID, numChecks int, checkFreq time.Duration) (choices.Status, error) // GetTx returns the byte representation of [txID] GetTx(ctx context.Context, txID ids.ID) ([]byte, error) // GetUTXOs returns the byte representation of the UTXOs controlled by [addrs] GetUTXOs( ctx context.Context, addrs []string, limit uint32, startAddress, startUTXOID string, ) ([][]byte, api.Index, error) // GetAtomicUTXOs returns the byte representation of the atomic UTXOs controlled by [addresses] // from [sourceChain] GetAtomicUTXOs( ctx context.Context, addrs []string, sourceChain string, limit uint32, startAddress, startUTXOID string, ) ([][]byte, api.Index, error) // GetAssetDescription returns a description of [assetID] GetAssetDescription(ctx context.Context, assetID string) (*GetAssetDescriptionReply, error) // GetBalance returns the balance of [assetID] held by [addr]. // If [includePartial], balance includes partial owned (i.e. in a multisig) funds. GetBalance(ctx context.Context, addr string, assetID string, includePartial bool) (*GetBalanceReply, error) // GetAllBalances returns all asset balances for [addr] // CreateAsset creates a new asset and returns its assetID GetAllBalances(context.Context, string, bool) (*GetAllBalancesReply, error) CreateAsset( ctx context.Context, user api.UserPass, from []string, changeAddr, name, symbol string, denomination byte, holders []*Holder, minters []Owners, ) (ids.ID, error) // CreateFixedCapAsset creates a new fixed cap asset and returns its assetID CreateFixedCapAsset( ctx context.Context, user api.UserPass, from []string, changeAddr, name, symbol string, denomination byte, holders []*Holder, ) (ids.ID, error) // CreateVariableCapAsset creates a new variable cap asset and returns its assetID CreateVariableCapAsset( ctx context.Context, user api.UserPass, from []string, changeAddr, name, symbol string, denomination byte, minters []Owners, ) (ids.ID, error) // CreateNFTAsset creates a new NFT asset and returns its assetID CreateNFTAsset( ctx context.Context, user api.UserPass, from []string, changeAddr, name, symbol string, minters []Owners, ) (ids.ID, error) // CreateAddress creates a new address controlled by [user] CreateAddress(ctx context.Context, user api.UserPass) (string, error) // ListAddresses returns all addresses on this chain controlled by [user] ListAddresses(ctx context.Context, user api.UserPass) ([]string, error) // ExportKey returns the private key corresponding to [addr] controlled by [user] ExportKey(ctx context.Context, user api.UserPass, addr string) (string, error) // ImportKey imports [privateKey] to [user] ImportKey(ctx context.Context, user api.UserPass, privateKey string) (string, error) // Mint [amount] of [assetID] to be owned by [to] Mint( ctx context.Context, user api.UserPass, from []string, changeAddr string, amount uint64, assetID, to string, ) (ids.ID, error) // SendNFT sends an NFT and returns the ID of the newly created transaction SendNFT( ctx context.Context, user api.UserPass, from []string, changeAddr string, assetID string, groupID uint32, to string, ) (ids.ID, error) // MintNFT issues a MintNFT transaction and returns the ID of the newly created transaction MintNFT( ctx context.Context, user api.UserPass, from []string, changeAddr string, assetID string, payload []byte, to string, ) (ids.ID, error) // Import sends an import transaction to import funds from [sourceChain] and // returns the ID of the newly created transaction Import(ctx context.Context, user api.UserPass, to, sourceChain string) (ids.ID, error) // Export sends an asset from this chain to the P/C-Chain. // After this tx is accepted, the AVAX must be imported to the P/C-chain with an importTx. // Returns the ID of the newly created atomic transaction Export( ctx context.Context, user api.UserPass, from []string, changeAddr string, amount uint64, to string, assetID string, ) (ids.ID, error) }
Client for interacting with an AVM (X-Chain) instance
type CreateAssetArgs ¶ added in v1.7.6
type CreateAssetArgs struct { api.JSONSpendHeader // User, password, from addrs, change addr Name string `json:"name"` Symbol string `json:"symbol"` Denomination byte `json:"denomination"` InitialHolders []*Holder `json:"initialHolders"` MinterSets []Owners `json:"minterSets"` }
CreateAssetArgs are arguments for passing into CreateAsset
type CreateAssetTx ¶
type CreateAssetTx struct { BaseTx `serialize:"true"` Name string `serialize:"true" json:"name"` Symbol string `serialize:"true" json:"symbol"` Denomination byte `serialize:"true" json:"denomination"` States []*InitialState `serialize:"true" json:"initialStates"` }
CreateAssetTx is a transaction that creates a new asset.
func (*CreateAssetTx) Init ¶ added in v1.7.6
func (t *CreateAssetTx) Init(vm *VM) error
func (*CreateAssetTx) InitialStates ¶
func (t *CreateAssetTx) InitialStates() []*InitialState
InitialStates track which virtual machines, and the initial state of these machines, this asset uses. The returned array should not be modified.
func (*CreateAssetTx) Sort ¶
func (t *CreateAssetTx) Sort()
func (*CreateAssetTx) SyntacticVerify ¶
func (t *CreateAssetTx) SyntacticVerify( ctx *snow.Context, c codec.Manager, txFeeAssetID ids.ID, _ uint64, txFee uint64, numFxs int, ) error
SyntacticVerify that this transaction is well-formed.
func (*CreateAssetTx) UTXOs ¶
func (t *CreateAssetTx) UTXOs() []*avax.UTXO
UTXOs returns the UTXOs transaction is producing.
type CreateNFTAssetArgs ¶ added in v1.7.6
type CreateNFTAssetArgs struct { api.JSONSpendHeader // User, password, from addrs, change addr Name string `json:"name"` Symbol string `json:"symbol"` MinterSets []Owners `json:"minterSets"` }
CreateNFTAssetArgs are arguments for passing into CreateNFTAsset requests
type ExportArgs ¶ added in v1.7.6
type ExportArgs struct { // User, password, from addrs, change addr api.JSONSpendHeader // Amount of nAVAX to send Amount json.Uint64 `json:"amount"` // ID of the address that will receive the AVAX. This address includes the // chainID, which is used to determine what the destination chain is. To string `json:"to"` AssetID string `json:"assetID"` }
ExportArgs are arguments for passing into ExportAVA requests
type ExportKeyArgs ¶
ExportKeyArgs are arguments for ExportKey
type ExportKeyReply ¶
type ExportKeyReply struct { // The decrypted PrivateKey for the Address provided in the arguments PrivateKey string `json:"privateKey"` }
ExportKeyReply is the response for ExportKey
type ExportTx ¶
type ExportTx struct { BaseTx `serialize:"true"` // Which chain to send the funds to DestinationChain ids.ID `serialize:"true" json:"destinationChain"` // The outputs this transaction is sending to the other chain ExportedOuts []*avax.TransferableOutput `serialize:"true" json:"exportedOutputs"` }
ExportTx is a transaction that exports an asset to another blockchain.
func (*ExportTx) ExecuteWithSideEffects ¶
ExecuteWithSideEffects writes the batch with any additional side effects
func (*ExportTx) SemanticVerify ¶
func (t *ExportTx) SemanticVerify(vm *VM, tx UnsignedTx, creds []verify.Verifiable) error
SemanticVerify that this transaction is valid to be spent.
type FormattedAssetID ¶ added in v1.7.6
FormattedAssetID defines a JSON formatted struct containing an assetID as a string
type Fx ¶
type Fx interface { // Initialize this feature extension to be running under this VM. Should // return an error if the VM is incompatible. Initialize(vm interface{}) error // Notify this Fx that the VM is in bootstrapping Bootstrapping() error // Notify this Fx that the VM is bootstrapped Bootstrapped() error // VerifyTransfer verifies that the specified transaction can spend the // provided utxo with no restrictions on the destination. If the transaction // can't spend the output based on the input and credential, a non-nil error // should be returned. VerifyTransfer(tx, in, cred, utxo interface{}) error // VerifyOperation verifies that the specified transaction can spend the // provided utxos conditioned on the result being restricted to the provided // outputs. If the transaction can't spend the output based on the input and // credential, a non-nil error should be returned. VerifyOperation(tx, op, cred interface{}, utxos []interface{}) error }
Fx is the interface a feature extension must implement to support the AVM.
type FxCredential ¶ added in v1.7.6
type FxCredential struct { FxID ids.ID `serialize:"false" json:"fxID"` verify.Verifiable `serialize:"true" json:"credential"` }
type FxOperation ¶
type FxOperation interface { verify.Verifiable snow.ContextInitializable avax.Coster Outs() []verify.State }
type Genesis ¶
type Genesis struct {
Txs []*GenesisAsset `serialize:"true"`
}
func (*Genesis) IsSortedAndUnique ¶
type GenesisAsset ¶
type GenesisAsset struct { Alias string `serialize:"true"` CreateAssetTx `serialize:"true"` }
type GetAddressTxsArgs ¶ added in v1.7.6
type GetAddressTxsReply ¶ added in v1.7.6
type GetAllBalancesArgs ¶ added in v1.7.6
type GetAllBalancesArgs struct { api.JSONAddress IncludePartial bool `json:"includePartial"` }
type GetAllBalancesReply ¶ added in v1.7.6
type GetAllBalancesReply struct {
Balances []Balance `json:"balances"`
}
GetAllBalancesReply is the response from a call to GetAllBalances
type GetAssetDescriptionArgs ¶
type GetAssetDescriptionArgs struct {
AssetID string `json:"assetID"`
}
GetAssetDescriptionArgs are arguments for passing into GetAssetDescription requests
type GetAssetDescriptionReply ¶
type GetAssetDescriptionReply struct { FormattedAssetID Name string `json:"name"` Symbol string `json:"symbol"` Denomination json.Uint8 `json:"denomination"` }
GetAssetDescriptionReply defines the GetAssetDescription replies returned from the API
type GetBalanceArgs ¶
type GetBalanceArgs struct { Address string `json:"address"` AssetID string `json:"assetID"` IncludePartial bool `json:"includePartial"` }
GetBalanceArgs are arguments for passing into GetBalance requests
type GetBalanceReply ¶
type GetBalanceReply struct { Balance json.Uint64 `json:"balance"` UTXOIDs []avax.UTXOID `json:"utxoIDs"` }
GetBalanceReply defines the GetBalance replies returned from the API
type GetTxStatusReply ¶
GetTxStatusReply defines the GetTxStatus replies returned from the API
type ImportArgs ¶ added in v1.7.6
type ImportArgs struct { // User that controls To api.UserPass // Chain the funds are coming from SourceChain string `json:"sourceChain"` // Address receiving the imported AVAX To string `json:"to"` }
ImportArgs are arguments for passing into Import requests
type ImportKeyArgs ¶
ImportKeyArgs are arguments for ImportKey
type ImportKeyReply ¶
type ImportKeyReply struct { // The address controlled by the PrivateKey provided in the arguments Address string `json:"address"` }
ImportKeyReply is the response for ImportKey
type ImportTx ¶
type ImportTx struct { BaseTx `serialize:"true"` // Which chain to consume the funds from SourceChain ids.ID `serialize:"true" json:"sourceChain"` // The inputs to this transaction ImportedIns []*avax.TransferableInput `serialize:"true" json:"importedInputs"` }
ImportTx is a transaction that imports an asset from another blockchain.
func (*ImportTx) ConsumedAssetIDs ¶ added in v1.7.6
ConsumedAssetIDs returns the IDs of the assets this transaction consumes
func (*ImportTx) ExecuteWithSideEffects ¶
ExecuteWithSideEffects writes the batch with any additional side effects
func (*ImportTx) InputUTXOs ¶
InputUTXOs track which UTXOs this transaction is consuming.
func (*ImportTx) NumCredentials ¶
NumCredentials returns the number of expected credentials
func (*ImportTx) SemanticVerify ¶
func (t *ImportTx) SemanticVerify(vm *VM, tx UnsignedTx, creds []verify.Verifiable) error
SemanticVerify that this transaction is well-formed.
type InitialState ¶
type InitialState struct { FxIndex uint32 `serialize:"true" json:"fxIndex"` FxID ids.ID `serialize:"false" json:"fxID"` Outs []verify.State `serialize:"true" json:"outputs"` }
func (*InitialState) InitCtx ¶ added in v1.7.6
func (is *InitialState) InitCtx(ctx *snow.Context)
func (*InitialState) Sort ¶
func (is *InitialState) Sort(c codec.Manager)
type MintArgs ¶ added in v1.7.6
type MintArgs struct { api.JSONSpendHeader // User, password, from addrs, change addr Amount json.Uint64 `json:"amount"` AssetID string `json:"assetID"` To string `json:"to"` }
MintArgs are arguments for passing into Mint requests
type MintNFTArgs ¶ added in v1.7.6
type MintNFTArgs struct { api.JSONSpendHeader // User, password, from addrs, change addr AssetID string `json:"assetID"` Payload string `json:"payload"` To string `json:"to"` Encoding formatting.Encoding `json:"encoding"` }
MintNFTArgs are arguments for passing into MintNFT requests
type Operation ¶
type OperationTx ¶
type OperationTx struct { BaseTx `serialize:"true"` Ops []*Operation `serialize:"true" json:"operations"` }
OperationTx is a transaction with no credentials.
func (*OperationTx) AssetIDs ¶
func (t *OperationTx) AssetIDs() ids.Set
AssetIDs returns the IDs of the assets this transaction depends on
func (*OperationTx) ConsumedAssetIDs ¶ added in v1.7.6
func (t *OperationTx) ConsumedAssetIDs() ids.Set
ConsumedAssetIDs returns the IDs of the assets this transaction consumes
func (*OperationTx) Init ¶ added in v1.7.6
func (t *OperationTx) Init(vm *VM) error
func (*OperationTx) InputUTXOs ¶
func (t *OperationTx) InputUTXOs() []*avax.UTXOID
InputUTXOs track which UTXOs this transaction is consuming.
func (*OperationTx) NumCredentials ¶
func (t *OperationTx) NumCredentials() int
NumCredentials returns the number of expected credentials
func (*OperationTx) Operations ¶
func (t *OperationTx) Operations() []*Operation
Operations track which ops this transaction is performing. The returned array should not be modified.
func (*OperationTx) SemanticVerify ¶
func (t *OperationTx) SemanticVerify(vm *VM, tx UnsignedTx, creds []verify.Verifiable) error
SemanticVerify that this transaction is well-formed.
func (*OperationTx) SyntacticVerify ¶
func (t *OperationTx) SyntacticVerify( ctx *snow.Context, c codec.Manager, txFeeAssetID ids.ID, txFee uint64, _ uint64, numFxs int, ) error
SyntacticVerify that this transaction is well-formed.
func (*OperationTx) UTXOs ¶
func (t *OperationTx) UTXOs() []*avax.UTXO
UTXOs returns the UTXOs transaction is producing.
type SendArgs ¶
type SendArgs struct { // User, password, from addrs, change addr api.JSONSpendHeader // The amount, assetID, and destination to send funds to SendOutput // Memo field Memo string `json:"memo"` }
SendArgs are arguments for passing into Send requests
type SendMultipleArgs ¶ added in v1.7.6
type SendMultipleArgs struct { // User, password, from addrs, change addr api.JSONSpendHeader // The outputs of the transaction Outputs []SendOutput `json:"outputs"` // Memo field Memo string `json:"memo"` }
SendMultipleArgs are arguments for passing into SendMultiple requests
type SendNFTArgs ¶ added in v1.7.6
type SendNFTArgs struct { api.JSONSpendHeader // User, password, from addrs, change addr AssetID string `json:"assetID"` GroupID json.Uint32 `json:"groupID"` To string `json:"to"` }
SendNFTArgs are arguments for passing into SendNFT requests
type SendOutput ¶ added in v1.7.6
type SendOutput struct { // The amount of funds to send Amount json.Uint64 `json:"amount"` // ID of the asset being sent AssetID string `json:"assetID"` // Address of the recipient To string `json:"to"` }
SendOutput specifies that [Amount] of asset [AssetID] be sent to [To]
type Service ¶
type Service struct {
// contains filtered or unexported fields
}
Service defines the base service for the asset vm
func (*Service) CreateAddress ¶
func (service *Service) CreateAddress(r *http.Request, args *api.UserPass, reply *api.JSONAddress) error
CreateAddress creates an address for the user [args.Username]
func (*Service) CreateAsset ¶ added in v1.7.6
func (service *Service) CreateAsset(r *http.Request, args *CreateAssetArgs, reply *AssetIDChangeAddr) error
CreateAsset returns ID of the newly created asset
func (*Service) CreateFixedCapAsset ¶
func (service *Service) CreateFixedCapAsset(r *http.Request, args *CreateAssetArgs, reply *AssetIDChangeAddr) error
CreateFixedCapAsset returns ID of the newly created asset
func (*Service) CreateNFTAsset ¶ added in v1.7.6
func (service *Service) CreateNFTAsset(r *http.Request, args *CreateNFTAssetArgs, reply *AssetIDChangeAddr) error
CreateNFTAsset returns ID of the newly created asset
func (*Service) CreateVariableCapAsset ¶
func (service *Service) CreateVariableCapAsset(r *http.Request, args *CreateAssetArgs, reply *AssetIDChangeAddr) error
CreateVariableCapAsset returns ID of the newly created asset
func (*Service) Export ¶ added in v1.7.6
func (service *Service) Export(_ *http.Request, args *ExportArgs, reply *api.JSONTxIDChangeAddr) error
Export sends an asset from this chain to the P/C-Chain. After this tx is accepted, the AVAX must be imported to the P/C-chain with an importTx. Returns the ID of the newly created atomic transaction
func (*Service) ExportKey ¶
func (service *Service) ExportKey(r *http.Request, args *ExportKeyArgs, reply *ExportKeyReply) error
ExportKey returns a private key from the provided user
func (*Service) GetAddressTxs ¶ added in v1.7.6
func (service *Service) GetAddressTxs(r *http.Request, args *GetAddressTxsArgs, reply *GetAddressTxsReply) error
GetAddressTxs returns list of transactions for a given address
func (*Service) GetAllBalances ¶ added in v1.7.6
func (service *Service) GetAllBalances(r *http.Request, args *GetAllBalancesArgs, reply *GetAllBalancesReply) error
GetAllBalances returns a map where:
Key: ID of an asset such that [args.Address] has a non-zero balance of the asset Value: The balance of the asset held by the address
If ![args.IncludePartial], returns only unlocked balance/UTXOs with a 1-out-of-1 multisig. Otherwise, returned balance/UTXOs includes assets held only partially by the address, and includes balances with locktime in the future.
func (*Service) GetAssetDescription ¶
func (service *Service) GetAssetDescription(_ *http.Request, args *GetAssetDescriptionArgs, reply *GetAssetDescriptionReply) error
GetAssetDescription creates an empty account with the name passed in
func (*Service) GetBalance ¶
func (service *Service) GetBalance(r *http.Request, args *GetBalanceArgs, reply *GetBalanceReply) error
GetBalance returns the balance of an asset held by an address. If ![args.IncludePartial], returns only the balance held solely (1 out of 1 multisig) by the address and with a locktime in the past. Otherwise, returned balance includes assets held only partially by the address, and includes balances with locktime in the future.
func (*Service) GetTxStatus ¶
func (service *Service) GetTxStatus(r *http.Request, args *api.JSONTxID, reply *GetTxStatusReply) error
GetTxStatus returns the status of the specified transaction
func (*Service) GetUTXOs ¶
func (service *Service) GetUTXOs(r *http.Request, args *api.GetUTXOsArgs, reply *api.GetUTXOsReply) error
GetUTXOs gets all utxos for passed in addresses
func (*Service) Import ¶ added in v1.7.6
Import imports an asset to this chain from the P/C-Chain. The AVAX must have already been exported from the P/C-Chain. Returns the ID of the newly created atomic transaction
func (*Service) ImportKey ¶
func (service *Service) ImportKey(r *http.Request, args *ImportKeyArgs, reply *api.JSONAddress) error
ImportKey adds a private key to the provided user
func (*Service) ListAddresses ¶ added in v1.7.6
func (service *Service) ListAddresses(_ *http.Request, args *api.UserPass, response *api.JSONAddresses) error
ListAddresses returns all of the addresses controlled by user [args.Username]
func (*Service) MintNFT ¶ added in v1.7.6
func (service *Service) MintNFT(r *http.Request, args *MintNFTArgs, reply *api.JSONTxIDChangeAddr) error
MintNFT issues a MintNFT transaction and returns the ID of the newly created transaction
func (*Service) SendMultiple ¶ added in v1.7.6
func (service *Service) SendMultiple(r *http.Request, args *SendMultipleArgs, reply *api.JSONTxIDChangeAddr) error
SendMultiple sends a transaction with multiple outputs.
func (*Service) SendNFT ¶ added in v1.7.6
func (service *Service) SendNFT(r *http.Request, args *SendNFTArgs, reply *api.JSONTxIDChangeAddr) error
SendNFT sends an NFT
type State ¶ added in v1.7.6
type State interface { avax.UTXOState avax.StatusState avax.SingletonState TxState DeduplicateTx(tx *UniqueTx) *UniqueTx }
State persistently maintains a set of UTXOs, transaction, statuses, and singletons.
func NewMeteredState ¶ added in v1.7.6
func NewMeteredState(db database.Database, genesisCodec, codec codec.Manager, metrics prometheus.Registerer) (State, error)
type StaticService ¶
type StaticService struct{}
StaticService defines the base service for the asset vm
func CreateStaticService ¶ added in v1.7.6
func CreateStaticService() *StaticService
func (*StaticService) BuildGenesis ¶
func (ss *StaticService) BuildGenesis(_ *http.Request, args *BuildGenesisArgs, reply *BuildGenesisReply) error
BuildGenesis returns the UTXOs such that at least one address in [args.Addresses] is referenced in the UTXO.
type Tx ¶
type Tx struct { UnsignedTx `serialize:"true" json:"unsignedTx"` Creds []*FxCredential `serialize:"true" json:"credentials"` // The credentials of this transaction }
Tx is the core operation that can be performed. The tx uses the UTXO model. Specifically, a txs inputs will consume previous txs outputs. A tx will be valid if the inputs have the authority to consume the outputs they are attempting to consume and the inputs consume sufficient state to produce the outputs.
func (*Tx) Credentials ¶
func (t *Tx) Credentials() []verify.Verifiable
Credentials describes the authorization that allows the Inputs to consume the specified UTXOs. The returned array should not be modified.
func (*Tx) Init ¶ added in v1.7.6
Init initializes FxID where required Used for JSON marshaling of data
func (*Tx) SemanticVerify ¶
func (t *Tx) SemanticVerify(vm *VM, tx UnsignedTx) error
SemanticVerify verifies that this transaction is well-formed.
func (*Tx) SignPropertyFx ¶ added in v1.7.6
func (*Tx) SignSECP256K1Fx ¶ added in v1.7.6
type TxCachedState ¶ added in v1.7.6
type TxCachedState struct { *Tx // contains filtered or unexported fields }
type TxState ¶
type TxState interface { // Tx attempts to load a transaction from storage. GetTx(txID ids.ID) (*Tx, error) // PutTx saves the provided transaction to storage. PutTx(txID ids.ID, tx *Tx) error // DeleteTx removes the provided transaction from storage. DeleteTx(txID ids.ID) error }
TxState is a thin wrapper around a database to provide, caching, serialization, and de-serialization of transactions.
func NewMeteredTxState ¶ added in v1.7.6
func NewMeteredTxState(db database.Database, codec codec.Manager, metrics prometheus.Registerer) (TxState, error)
type UniqueTx ¶
type UniqueTx struct { *TxCachedState // contains filtered or unexported fields }
UniqueTx provides a de-duplication service for txs. This only provides a performance boost
func (*UniqueTx) Accept ¶
Accept is called when the transaction was finalized as accepted by consensus
func (*UniqueTx) Dependencies ¶
Dependencies returns the set of transactions this transaction builds on
func (*UniqueTx) Evict ¶
func (tx *UniqueTx) Evict()
Evict is called when this UniqueTx will no longer be returned from a cache lookup
func (*UniqueTx) InputUTXOs ¶
InputUTXOs returns the utxos that will be consumed on tx acceptance
func (*UniqueTx) Reject ¶
Reject is called when the transaction was finalized as rejected by consensus
func (*UniqueTx) SemanticVerify ¶
SemanticVerify the validity of this transaction
func (*UniqueTx) SyntacticVerify ¶
SyntacticVerify verifies that this transaction is well formed
func (*UniqueTx) UTXOs ¶
UTXOs returns the utxos that will be added to the UTXO set on tx acceptance
type UnsignedTx ¶
type UnsignedTx interface { Init(*VM) error Initialize(unsignedBytes, bytes []byte) ID() ids.ID UnsignedBytes() []byte Bytes() []byte ConsumedAssetIDs() ids.Set AssetIDs() ids.Set NumCredentials() int InputUTXOs() []*avax.UTXOID UTXOs() []*avax.UTXO SyntacticVerify( ctx *snow.Context, c codec.Manager, txFeeAssetID ids.ID, txFee uint64, creationTxFee uint64, numFxs int, ) error SemanticVerify(vm *VM, tx UnsignedTx, creds []verify.Verifiable) error ExecuteWithSideEffects(vm *VM, batch database.Batch) error }
type VM ¶
type VM struct { Factory avax.AddressManager avax.AtomicUTXOManager ids.Aliaser // contains filtered or unexported fields }
VM implements the avalanche.DAGVM interface
func (*VM) AppRequest ¶ added in v1.7.6
func (vm *VM) AppRequest(nodeID ids.ShortID, requestID uint32, deadline time.Time, request []byte) error
This VM doesn't (currently) have any app-specific messages
func (*VM) AppRequestFailed ¶ added in v1.7.6
This VM doesn't (currently) have any app-specific messages
func (*VM) AppResponse ¶ added in v1.7.6
This VM doesn't (currently) have any app-specific messages
func (*VM) CreateHandlers ¶
func (vm *VM) CreateHandlers() (map[string]*common.HTTPHandler, error)
CreateHandlers implements the avalanche.DAGVM interface
func (*VM) CreateStaticHandlers ¶
func (vm *VM) CreateStaticHandlers() (map[string]*common.HTTPHandler, error)
CreateStaticHandlers implements the common.StaticVM interface
func (*VM) HealthCheck ¶ added in v1.7.6
Health implements the common.VM interface TODO add health checks
func (*VM) Initialize ¶
func (vm *VM) Initialize( ctx *snow.Context, dbManager manager.Manager, genesisBytes []byte, upgradeBytes []byte, configBytes []byte, toEngine chan<- common.Message, fxs []*common.Fx, _ common.AppSender, ) error
Initialize implements the avalanche.DAGVM interface
func (*VM) IssueTx ¶
IssueTx attempts to send a transaction to consensus. If onDecide is specified, the function will be called when the transaction is either accepted or rejected with the appropriate status. This function will go out of scope when the transaction is removed from memory.
func (*VM) LoadUser ¶ added in v1.7.6
func (vm *VM) LoadUser( username string, password string, addrsToUse ids.ShortSet, ) ( []*avax.UTXO, *secp256k1fx.Keychain, error, )
LoadUser returns: 1) The UTXOs that reference one or more addresses controlled by the given user 2) A keychain that contains this user's keys If [addrsToUse] has positive length, returns UTXOs that reference one or more addresses controlled by the given user that are also in [addrsToUse].
func (*VM) PendingTxs ¶
Pending implements the avalanche.DAGVM interface
func (*VM) SpendAll ¶ added in v1.7.6
func (vm *VM) SpendAll( utxos []*avax.UTXO, kc *secp256k1fx.Keychain, ) ( map[ids.ID]uint64, []*avax.TransferableInput, [][]*crypto.PrivateKeySECP256K1R, error, )
type WalletClient ¶ added in v1.7.6
type WalletClient interface { // IssueTx issues a transaction to a node and returns the TxID IssueTx(ctx context.Context, tx []byte) (ids.ID, error) // Send [amount] of [assetID] to address [to] Send( ctx context.Context, user api.UserPass, from []string, changeAddr string, amount uint64, assetID, to, memo string, ) (ids.ID, error) // SendMultiple sends a transaction from [user] funding all [outputs] SendMultiple( ctx context.Context, user api.UserPass, from []string, changeAddr string, outputs []SendOutput, memo string, ) (ids.ID, error) }
interface of an AVM wallet client for interacting with avm managed wallet on [chain]
func NewWalletClient ¶ added in v1.7.6
func NewWalletClient(uri, chain string) WalletClient
NewWalletClient returns an AVM wallet client for interacting with avm managed wallet on [chain]
type WalletService ¶ added in v1.7.6
type WalletService struct {
// contains filtered or unexported fields
}
func (*WalletService) IssueTx ¶ added in v1.7.6
func (w *WalletService) IssueTx(r *http.Request, args *api.FormattedTx, reply *api.JSONTxID) error
IssueTx attempts to issue a transaction into consensus
func (*WalletService) Send ¶ added in v1.7.6
func (w *WalletService) Send(r *http.Request, args *SendArgs, reply *api.JSONTxIDChangeAddr) error
Send returns the ID of the newly created transaction
func (*WalletService) SendMultiple ¶ added in v1.7.6
func (w *WalletService) SendMultiple(r *http.Request, args *SendMultipleArgs, reply *api.JSONTxIDChangeAddr) error
SendMultiple sends a transaction with multiple outputs.
Source Files ¶
- base_tx.go
- client.go
- codec_registry.go
- create_asset_tx.go
- export_tx.go
- factory.go
- fx.go
- genesis.go
- health.go
- import_tx.go
- initial_state.go
- metrics.go
- operation.go
- operation_tx.go
- pubsub_filterer.go
- service.go
- state.go
- static_service.go
- tx.go
- tx_state.go
- unique_tx.go
- vm.go
- wallet_client.go
- wallet_service.go