6b21ad9922
Everywhere including examples, external interop APIs, bindings generators
code and in other valuable places. A couple of `interface{}` usages are
intentionally left in the CHANGELOG.md, documentation and tests.
232 lines
11 KiB
Go
232 lines
11 KiB
Go
// Package nextoken contains RPC wrappers for NEX Token contract.
|
|
package nextoken
|
|
|
|
import (
|
|
"github.com/nspcc-dev/neo-go/pkg/core/transaction"
|
|
"github.com/nspcc-dev/neo-go/pkg/crypto/keys"
|
|
"github.com/nspcc-dev/neo-go/pkg/rpcclient/nep17"
|
|
"github.com/nspcc-dev/neo-go/pkg/rpcclient/unwrap"
|
|
"github.com/nspcc-dev/neo-go/pkg/util"
|
|
"math/big"
|
|
)
|
|
|
|
// Hash contains contract hash.
|
|
var Hash = util.Uint160{0xa8, 0x1a, 0xa1, 0xf0, 0x4b, 0xf, 0xdc, 0x4a, 0xa2, 0xce, 0xd5, 0xbf, 0xc6, 0x22, 0xcf, 0xe8, 0x9, 0x7f, 0xa6, 0xa2}
|
|
|
|
// Invoker is used by ContractReader to call various safe methods.
|
|
type Invoker interface {
|
|
nep17.Invoker
|
|
}
|
|
|
|
// Actor is used by Contract to call state-changing methods.
|
|
type Actor interface {
|
|
Invoker
|
|
|
|
nep17.Actor
|
|
|
|
MakeCall(contract util.Uint160, method string, params ...any) (*transaction.Transaction, error)
|
|
MakeRun(script []byte) (*transaction.Transaction, error)
|
|
MakeUnsignedCall(contract util.Uint160, method string, attrs []transaction.Attribute, params ...any) (*transaction.Transaction, error)
|
|
MakeUnsignedRun(script []byte, attrs []transaction.Attribute) (*transaction.Transaction, error)
|
|
SendCall(contract util.Uint160, method string, params ...any) (util.Uint256, uint32, error)
|
|
SendRun(script []byte) (util.Uint256, uint32, error)
|
|
}
|
|
|
|
// ContractReader implements safe contract methods.
|
|
type ContractReader struct {
|
|
nep17.TokenReader
|
|
invoker Invoker
|
|
}
|
|
|
|
// Contract implements all contract methods.
|
|
type Contract struct {
|
|
ContractReader
|
|
nep17.TokenWriter
|
|
actor Actor
|
|
}
|
|
|
|
// NewReader creates an instance of ContractReader using Hash and the given Invoker.
|
|
func NewReader(invoker Invoker) *ContractReader {
|
|
return &ContractReader{*nep17.NewReader(invoker, Hash), invoker}
|
|
}
|
|
|
|
// New creates an instance of Contract using Hash and the given Actor.
|
|
func New(actor Actor) *Contract {
|
|
var nep17t = nep17.New(actor, Hash)
|
|
return &Contract{ContractReader{nep17t.TokenReader, actor}, nep17t.TokenWriter, actor}
|
|
}
|
|
|
|
|
|
// Cap invokes `cap` method of contract.
|
|
func (c *ContractReader) Cap() (*big.Int, error) {
|
|
return unwrap.BigInt(c.invoker.Call(Hash, "cap"))
|
|
}
|
|
|
|
// GetMinter invokes `getMinter` method of contract.
|
|
func (c *ContractReader) GetMinter() (*keys.PublicKey, error) {
|
|
return unwrap.PublicKey(c.invoker.Call(Hash, "getMinter"))
|
|
}
|
|
|
|
// GetOwner invokes `getOwner` method of contract.
|
|
func (c *ContractReader) GetOwner() (util.Uint160, error) {
|
|
return unwrap.Uint160(c.invoker.Call(Hash, "getOwner"))
|
|
}
|
|
|
|
// TotalMinted invokes `totalMinted` method of contract.
|
|
func (c *ContractReader) TotalMinted() (*big.Int, error) {
|
|
return unwrap.BigInt(c.invoker.Call(Hash, "totalMinted"))
|
|
}
|
|
|
|
// ChangeMinter creates a transaction invoking `changeMinter` method of the contract.
|
|
// This transaction is signed and immediately sent to the network.
|
|
// The values returned are its hash, ValidUntilBlock value and error if any.
|
|
func (c *Contract) ChangeMinter(newMinter *keys.PublicKey) (util.Uint256, uint32, error) {
|
|
return c.actor.SendCall(Hash, "changeMinter", newMinter)
|
|
}
|
|
|
|
// ChangeMinterTransaction creates a transaction invoking `changeMinter` method of the contract.
|
|
// This transaction is signed, but not sent to the network, instead it's
|
|
// returned to the caller.
|
|
func (c *Contract) ChangeMinterTransaction(newMinter *keys.PublicKey) (*transaction.Transaction, error) {
|
|
return c.actor.MakeCall(Hash, "changeMinter", newMinter)
|
|
}
|
|
|
|
// ChangeMinterUnsigned creates a transaction invoking `changeMinter` method of the contract.
|
|
// This transaction is not signed, it's simply returned to the caller.
|
|
// Any fields of it that do not affect fees can be changed (ValidUntilBlock,
|
|
// Nonce), fee values (NetworkFee, SystemFee) can be increased as well.
|
|
func (c *Contract) ChangeMinterUnsigned(newMinter *keys.PublicKey) (*transaction.Transaction, error) {
|
|
return c.actor.MakeUnsignedCall(Hash, "changeMinter", nil, newMinter)
|
|
}
|
|
|
|
// ChangeOwner creates a transaction invoking `changeOwner` method of the contract.
|
|
// This transaction is signed and immediately sent to the network.
|
|
// The values returned are its hash, ValidUntilBlock value and error if any.
|
|
func (c *Contract) ChangeOwner(newOwner util.Uint160) (util.Uint256, uint32, error) {
|
|
return c.actor.SendCall(Hash, "changeOwner", newOwner)
|
|
}
|
|
|
|
// ChangeOwnerTransaction creates a transaction invoking `changeOwner` method of the contract.
|
|
// This transaction is signed, but not sent to the network, instead it's
|
|
// returned to the caller.
|
|
func (c *Contract) ChangeOwnerTransaction(newOwner util.Uint160) (*transaction.Transaction, error) {
|
|
return c.actor.MakeCall(Hash, "changeOwner", newOwner)
|
|
}
|
|
|
|
// ChangeOwnerUnsigned creates a transaction invoking `changeOwner` method of the contract.
|
|
// This transaction is not signed, it's simply returned to the caller.
|
|
// Any fields of it that do not affect fees can be changed (ValidUntilBlock,
|
|
// Nonce), fee values (NetworkFee, SystemFee) can be increased as well.
|
|
func (c *Contract) ChangeOwnerUnsigned(newOwner util.Uint160) (*transaction.Transaction, error) {
|
|
return c.actor.MakeUnsignedCall(Hash, "changeOwner", nil, newOwner)
|
|
}
|
|
|
|
// Destroy creates a transaction invoking `destroy` method of the contract.
|
|
// This transaction is signed and immediately sent to the network.
|
|
// The values returned are its hash, ValidUntilBlock value and error if any.
|
|
func (c *Contract) Destroy() (util.Uint256, uint32, error) {
|
|
return c.actor.SendCall(Hash, "destroy")
|
|
}
|
|
|
|
// DestroyTransaction creates a transaction invoking `destroy` method of the contract.
|
|
// This transaction is signed, but not sent to the network, instead it's
|
|
// returned to the caller.
|
|
func (c *Contract) DestroyTransaction() (*transaction.Transaction, error) {
|
|
return c.actor.MakeCall(Hash, "destroy")
|
|
}
|
|
|
|
// DestroyUnsigned creates a transaction invoking `destroy` method of the contract.
|
|
// This transaction is not signed, it's simply returned to the caller.
|
|
// Any fields of it that do not affect fees can be changed (ValidUntilBlock,
|
|
// Nonce), fee values (NetworkFee, SystemFee) can be increased as well.
|
|
func (c *Contract) DestroyUnsigned() (*transaction.Transaction, error) {
|
|
return c.actor.MakeUnsignedCall(Hash, "destroy", nil)
|
|
}
|
|
|
|
// MaxSupply creates a transaction invoking `maxSupply` method of the contract.
|
|
// This transaction is signed and immediately sent to the network.
|
|
// The values returned are its hash, ValidUntilBlock value and error if any.
|
|
func (c *Contract) MaxSupply() (util.Uint256, uint32, error) {
|
|
return c.actor.SendCall(Hash, "maxSupply")
|
|
}
|
|
|
|
// MaxSupplyTransaction creates a transaction invoking `maxSupply` method of the contract.
|
|
// This transaction is signed, but not sent to the network, instead it's
|
|
// returned to the caller.
|
|
func (c *Contract) MaxSupplyTransaction() (*transaction.Transaction, error) {
|
|
return c.actor.MakeCall(Hash, "maxSupply")
|
|
}
|
|
|
|
// MaxSupplyUnsigned creates a transaction invoking `maxSupply` method of the contract.
|
|
// This transaction is not signed, it's simply returned to the caller.
|
|
// Any fields of it that do not affect fees can be changed (ValidUntilBlock,
|
|
// Nonce), fee values (NetworkFee, SystemFee) can be increased as well.
|
|
func (c *Contract) MaxSupplyUnsigned() (*transaction.Transaction, error) {
|
|
return c.actor.MakeUnsignedCall(Hash, "maxSupply", nil)
|
|
}
|
|
|
|
// Mint creates a transaction invoking `mint` method of the contract.
|
|
// This transaction is signed and immediately sent to the network.
|
|
// The values returned are its hash, ValidUntilBlock value and error if any.
|
|
func (c *Contract) Mint(from util.Uint160, to util.Uint160, amount *big.Int, swapId *big.Int, signature []byte, data any) (util.Uint256, uint32, error) {
|
|
return c.actor.SendCall(Hash, "mint", from, to, amount, swapId, signature, data)
|
|
}
|
|
|
|
// MintTransaction creates a transaction invoking `mint` method of the contract.
|
|
// This transaction is signed, but not sent to the network, instead it's
|
|
// returned to the caller.
|
|
func (c *Contract) MintTransaction(from util.Uint160, to util.Uint160, amount *big.Int, swapId *big.Int, signature []byte, data any) (*transaction.Transaction, error) {
|
|
return c.actor.MakeCall(Hash, "mint", from, to, amount, swapId, signature, data)
|
|
}
|
|
|
|
// MintUnsigned creates a transaction invoking `mint` method of the contract.
|
|
// This transaction is not signed, it's simply returned to the caller.
|
|
// Any fields of it that do not affect fees can be changed (ValidUntilBlock,
|
|
// Nonce), fee values (NetworkFee, SystemFee) can be increased as well.
|
|
func (c *Contract) MintUnsigned(from util.Uint160, to util.Uint160, amount *big.Int, swapId *big.Int, signature []byte, data any) (*transaction.Transaction, error) {
|
|
return c.actor.MakeUnsignedCall(Hash, "mint", nil, from, to, amount, swapId, signature, data)
|
|
}
|
|
|
|
// Update creates a transaction invoking `update` method of the contract.
|
|
// This transaction is signed and immediately sent to the network.
|
|
// The values returned are its hash, ValidUntilBlock value and error if any.
|
|
func (c *Contract) Update(nef []byte, manifest []byte) (util.Uint256, uint32, error) {
|
|
return c.actor.SendCall(Hash, "update", nef, manifest)
|
|
}
|
|
|
|
// UpdateTransaction creates a transaction invoking `update` method of the contract.
|
|
// This transaction is signed, but not sent to the network, instead it's
|
|
// returned to the caller.
|
|
func (c *Contract) UpdateTransaction(nef []byte, manifest []byte) (*transaction.Transaction, error) {
|
|
return c.actor.MakeCall(Hash, "update", nef, manifest)
|
|
}
|
|
|
|
// UpdateUnsigned creates a transaction invoking `update` method of the contract.
|
|
// This transaction is not signed, it's simply returned to the caller.
|
|
// Any fields of it that do not affect fees can be changed (ValidUntilBlock,
|
|
// Nonce), fee values (NetworkFee, SystemFee) can be increased as well.
|
|
func (c *Contract) UpdateUnsigned(nef []byte, manifest []byte) (*transaction.Transaction, error) {
|
|
return c.actor.MakeUnsignedCall(Hash, "update", nil, nef, manifest)
|
|
}
|
|
|
|
// UpdateCap creates a transaction invoking `updateCap` method of the contract.
|
|
// This transaction is signed and immediately sent to the network.
|
|
// The values returned are its hash, ValidUntilBlock value and error if any.
|
|
func (c *Contract) UpdateCap(newCap *big.Int) (util.Uint256, uint32, error) {
|
|
return c.actor.SendCall(Hash, "updateCap", newCap)
|
|
}
|
|
|
|
// UpdateCapTransaction creates a transaction invoking `updateCap` method of the contract.
|
|
// This transaction is signed, but not sent to the network, instead it's
|
|
// returned to the caller.
|
|
func (c *Contract) UpdateCapTransaction(newCap *big.Int) (*transaction.Transaction, error) {
|
|
return c.actor.MakeCall(Hash, "updateCap", newCap)
|
|
}
|
|
|
|
// UpdateCapUnsigned creates a transaction invoking `updateCap` method of the contract.
|
|
// This transaction is not signed, it's simply returned to the caller.
|
|
// Any fields of it that do not affect fees can be changed (ValidUntilBlock,
|
|
// Nonce), fee values (NetworkFee, SystemFee) can be increased as well.
|
|
func (c *Contract) UpdateCapUnsigned(newCap *big.Int) (*transaction.Transaction, error) {
|
|
return c.actor.MakeUnsignedCall(Hash, "updateCap", nil, newCap)
|
|
}
|