// Code generated by neo-go contract generate-rpcwrapper --manifest --out [--hash ] [--config ]; DO NOT EDIT. // Package nameservice contains RPC wrappers for NameService contract. package nameservice import ( "errors" "fmt" "github.com/google/uuid" "github.com/nspcc-dev/neo-go/pkg/core/transaction" "github.com/nspcc-dev/neo-go/pkg/neorpc/result" "github.com/nspcc-dev/neo-go/pkg/rpcclient/nep11" "github.com/nspcc-dev/neo-go/pkg/rpcclient/unwrap" "github.com/nspcc-dev/neo-go/pkg/smartcontract" "github.com/nspcc-dev/neo-go/pkg/util" "github.com/nspcc-dev/neo-go/pkg/vm/stackitem" "math/big" "unicode/utf8" ) // RegisterDomainEvent represents "RegisterDomain" event emitted by the contract. type RegisterDomainEvent struct { Name string } // AddRecordEvent represents "AddRecord" event emitted by the contract. type AddRecordEvent struct { Name string Type *big.Int } // DeleteRecordsEvent represents "DeleteRecords" event emitted by the contract. type DeleteRecordsEvent struct { Name string Type *big.Int } // DeleteDomainEvent represents "DeleteDomain" event emitted by the contract. type DeleteDomainEvent struct { Name string } // Invoker is used by ContractReader to call various safe methods. type Invoker interface { nep11.Invoker } // Actor is used by Contract to call state-changing methods. type Actor interface { Invoker nep11.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 { nep11.NonDivisibleReader invoker Invoker hash util.Uint160 } // Contract implements all contract methods. type Contract struct { ContractReader nep11.BaseWriter actor Actor hash util.Uint160 } // NewReader creates an instance of ContractReader using provided contract hash and the given Invoker. func NewReader(invoker Invoker, hash util.Uint160) *ContractReader { return &ContractReader{*nep11.NewNonDivisibleReader(invoker, hash), invoker, hash} } // New creates an instance of Contract using provided contract hash and the given Actor. func New(actor Actor, hash util.Uint160) *Contract { var nep11ndt = nep11.NewNonDivisible(actor, hash) return &Contract{ContractReader{nep11ndt.NonDivisibleReader, actor, hash}, nep11ndt.BaseWriter, actor, hash} } // GetPrice invokes `getPrice` method of contract. func (c *ContractReader) GetPrice() (*big.Int, error) { return unwrap.BigInt(c.invoker.Call(c.hash, "getPrice")) } // GetRecords invokes `getRecords` method of contract. func (c *ContractReader) GetRecords(name string, typ *big.Int) ([]stackitem.Item, error) { return unwrap.Array(c.invoker.Call(c.hash, "getRecords", name, typ)) } // IsAvailable invokes `isAvailable` method of contract. func (c *ContractReader) IsAvailable(name string) (bool, error) { return unwrap.Bool(c.invoker.Call(c.hash, "isAvailable", name)) } // Resolve invokes `resolve` method of contract. func (c *ContractReader) Resolve(name string, typ *big.Int) ([]stackitem.Item, error) { return unwrap.Array(c.invoker.Call(c.hash, "resolve", name, typ)) } // Roots invokes `roots` method of contract. func (c *ContractReader) Roots() (uuid.UUID, result.Iterator, error) { return unwrap.SessionIterator(c.invoker.Call(c.hash, "roots")) } // RootsExpanded is similar to Roots (uses the same contract // method), but can be useful if the server used doesn't support sessions and // doesn't expand iterators. It creates a script that will get the specified // number of result items from the iterator right in the VM and return them to // you. It's only limited by VM stack and GAS available for RPC invocations. func (c *ContractReader) RootsExpanded(_numOfIteratorItems int) ([]stackitem.Item, error) { return unwrap.Array(c.invoker.CallAndExpandIterator(c.hash, "roots", _numOfIteratorItems)) } // Version invokes `version` method of contract. func (c *ContractReader) Version() (*big.Int, error) { return unwrap.BigInt(c.invoker.Call(c.hash, "version")) } // AddRecord creates a transaction invoking `addRecord` 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) AddRecord(name string, typ *big.Int, data string) (util.Uint256, uint32, error) { return c.actor.SendCall(c.hash, "addRecord", name, typ, data) } // AddRecordTransaction creates a transaction invoking `addRecord` method of the contract. // This transaction is signed, but not sent to the network, instead it's // returned to the caller. func (c *Contract) AddRecordTransaction(name string, typ *big.Int, data string) (*transaction.Transaction, error) { return c.actor.MakeCall(c.hash, "addRecord", name, typ, data) } // AddRecordUnsigned creates a transaction invoking `addRecord` 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) AddRecordUnsigned(name string, typ *big.Int, data string) (*transaction.Transaction, error) { return c.actor.MakeUnsignedCall(c.hash, "addRecord", nil, name, typ, data) } // DeleteDomain creates a transaction invoking `deleteDomain` 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) DeleteDomain(name string) (util.Uint256, uint32, error) { return c.actor.SendCall(c.hash, "deleteDomain", name) } // DeleteDomainTransaction creates a transaction invoking `deleteDomain` method of the contract. // This transaction is signed, but not sent to the network, instead it's // returned to the caller. func (c *Contract) DeleteDomainTransaction(name string) (*transaction.Transaction, error) { return c.actor.MakeCall(c.hash, "deleteDomain", name) } // DeleteDomainUnsigned creates a transaction invoking `deleteDomain` 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) DeleteDomainUnsigned(name string) (*transaction.Transaction, error) { return c.actor.MakeUnsignedCall(c.hash, "deleteDomain", nil, name) } // DeleteRecords creates a transaction invoking `deleteRecords` 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) DeleteRecords(name string, typ *big.Int) (util.Uint256, uint32, error) { return c.actor.SendCall(c.hash, "deleteRecords", name, typ) } // DeleteRecordsTransaction creates a transaction invoking `deleteRecords` method of the contract. // This transaction is signed, but not sent to the network, instead it's // returned to the caller. func (c *Contract) DeleteRecordsTransaction(name string, typ *big.Int) (*transaction.Transaction, error) { return c.actor.MakeCall(c.hash, "deleteRecords", name, typ) } // DeleteRecordsUnsigned creates a transaction invoking `deleteRecords` 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) DeleteRecordsUnsigned(name string, typ *big.Int) (*transaction.Transaction, error) { return c.actor.MakeUnsignedCall(c.hash, "deleteRecords", nil, name, typ) } // GetAllRecords creates a transaction invoking `getAllRecords` 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) GetAllRecords(name string) (util.Uint256, uint32, error) { return c.actor.SendCall(c.hash, "getAllRecords", name) } // GetAllRecordsTransaction creates a transaction invoking `getAllRecords` method of the contract. // This transaction is signed, but not sent to the network, instead it's // returned to the caller. func (c *Contract) GetAllRecordsTransaction(name string) (*transaction.Transaction, error) { return c.actor.MakeCall(c.hash, "getAllRecords", name) } // GetAllRecordsUnsigned creates a transaction invoking `getAllRecords` 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) GetAllRecordsUnsigned(name string) (*transaction.Transaction, error) { return c.actor.MakeUnsignedCall(c.hash, "getAllRecords", nil, name) } func (c *Contract) scriptForRegister(name string, owner util.Uint160, email string, refresh *big.Int, retry *big.Int, expire *big.Int, ttl *big.Int) ([]byte, error) { return smartcontract.CreateCallWithAssertScript(c.hash, "register", name, owner, email, refresh, retry, expire, ttl) } // Register creates a transaction invoking `register` 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) Register(name string, owner util.Uint160, email string, refresh *big.Int, retry *big.Int, expire *big.Int, ttl *big.Int) (util.Uint256, uint32, error) { script, err := c.scriptForRegister(name, owner, email, refresh, retry, expire, ttl) if err != nil { return util.Uint256{}, 0, err } return c.actor.SendRun(script) } // RegisterTransaction creates a transaction invoking `register` method of the contract. // This transaction is signed, but not sent to the network, instead it's // returned to the caller. func (c *Contract) RegisterTransaction(name string, owner util.Uint160, email string, refresh *big.Int, retry *big.Int, expire *big.Int, ttl *big.Int) (*transaction.Transaction, error) { script, err := c.scriptForRegister(name, owner, email, refresh, retry, expire, ttl) if err != nil { return nil, err } return c.actor.MakeRun(script) } // RegisterUnsigned creates a transaction invoking `register` 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) RegisterUnsigned(name string, owner util.Uint160, email string, refresh *big.Int, retry *big.Int, expire *big.Int, ttl *big.Int) (*transaction.Transaction, error) { script, err := c.scriptForRegister(name, owner, email, refresh, retry, expire, ttl) if err != nil { return nil, err } return c.actor.MakeUnsignedRun(script, nil) } // Renew creates a transaction invoking `renew` 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) Renew(name string) (util.Uint256, uint32, error) { return c.actor.SendCall(c.hash, "renew", name) } // RenewTransaction creates a transaction invoking `renew` method of the contract. // This transaction is signed, but not sent to the network, instead it's // returned to the caller. func (c *Contract) RenewTransaction(name string) (*transaction.Transaction, error) { return c.actor.MakeCall(c.hash, "renew", name) } // RenewUnsigned creates a transaction invoking `renew` 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) RenewUnsigned(name string) (*transaction.Transaction, error) { return c.actor.MakeUnsignedCall(c.hash, "renew", nil, name) } // SetAdmin creates a transaction invoking `setAdmin` 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) SetAdmin(name string, admin util.Uint160) (util.Uint256, uint32, error) { return c.actor.SendCall(c.hash, "setAdmin", name, admin) } // SetAdminTransaction creates a transaction invoking `setAdmin` method of the contract. // This transaction is signed, but not sent to the network, instead it's // returned to the caller. func (c *Contract) SetAdminTransaction(name string, admin util.Uint160) (*transaction.Transaction, error) { return c.actor.MakeCall(c.hash, "setAdmin", name, admin) } // SetAdminUnsigned creates a transaction invoking `setAdmin` 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) SetAdminUnsigned(name string, admin util.Uint160) (*transaction.Transaction, error) { return c.actor.MakeUnsignedCall(c.hash, "setAdmin", nil, name, admin) } // SetPrice creates a transaction invoking `setPrice` 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) SetPrice(price *big.Int) (util.Uint256, uint32, error) { return c.actor.SendCall(c.hash, "setPrice", price) } // SetPriceTransaction creates a transaction invoking `setPrice` method of the contract. // This transaction is signed, but not sent to the network, instead it's // returned to the caller. func (c *Contract) SetPriceTransaction(price *big.Int) (*transaction.Transaction, error) { return c.actor.MakeCall(c.hash, "setPrice", price) } // SetPriceUnsigned creates a transaction invoking `setPrice` 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) SetPriceUnsigned(price *big.Int) (*transaction.Transaction, error) { return c.actor.MakeUnsignedCall(c.hash, "setPrice", nil, price) } // SetRecord creates a transaction invoking `setRecord` 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) SetRecord(name string, typ *big.Int, id *big.Int, data string) (util.Uint256, uint32, error) { return c.actor.SendCall(c.hash, "setRecord", name, typ, id, data) } // SetRecordTransaction creates a transaction invoking `setRecord` method of the contract. // This transaction is signed, but not sent to the network, instead it's // returned to the caller. func (c *Contract) SetRecordTransaction(name string, typ *big.Int, id *big.Int, data string) (*transaction.Transaction, error) { return c.actor.MakeCall(c.hash, "setRecord", name, typ, id, data) } // SetRecordUnsigned creates a transaction invoking `setRecord` 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) SetRecordUnsigned(name string, typ *big.Int, id *big.Int, data string) (*transaction.Transaction, error) { return c.actor.MakeUnsignedCall(c.hash, "setRecord", nil, name, typ, id, 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 string, data any) (util.Uint256, uint32, error) { return c.actor.SendCall(c.hash, "update", nef, manifest, data) } // 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 string, data any) (*transaction.Transaction, error) { return c.actor.MakeCall(c.hash, "update", nef, manifest, data) } // 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 string, data any) (*transaction.Transaction, error) { return c.actor.MakeUnsignedCall(c.hash, "update", nil, nef, manifest, data) } // UpdateSOA creates a transaction invoking `updateSOA` 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) UpdateSOA(name string, email string, refresh *big.Int, retry *big.Int, expire *big.Int, ttl *big.Int) (util.Uint256, uint32, error) { return c.actor.SendCall(c.hash, "updateSOA", name, email, refresh, retry, expire, ttl) } // UpdateSOATransaction creates a transaction invoking `updateSOA` method of the contract. // This transaction is signed, but not sent to the network, instead it's // returned to the caller. func (c *Contract) UpdateSOATransaction(name string, email string, refresh *big.Int, retry *big.Int, expire *big.Int, ttl *big.Int) (*transaction.Transaction, error) { return c.actor.MakeCall(c.hash, "updateSOA", name, email, refresh, retry, expire, ttl) } // UpdateSOAUnsigned creates a transaction invoking `updateSOA` 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) UpdateSOAUnsigned(name string, email string, refresh *big.Int, retry *big.Int, expire *big.Int, ttl *big.Int) (*transaction.Transaction, error) { return c.actor.MakeUnsignedCall(c.hash, "updateSOA", nil, name, email, refresh, retry, expire, ttl) } // RegisterDomainEventsFromApplicationLog retrieves a set of all emitted events // with "RegisterDomain" name from the provided [result.ApplicationLog]. func RegisterDomainEventsFromApplicationLog(log *result.ApplicationLog) ([]*RegisterDomainEvent, error) { if log == nil { return nil, errors.New("nil application log") } var res []*RegisterDomainEvent for i, ex := range log.Executions { for j, e := range ex.Events { if e.Name != "RegisterDomain" { continue } event := new(RegisterDomainEvent) err := event.FromStackItem(e.Item) if err != nil { return nil, fmt.Errorf("failed to deserialize RegisterDomainEvent from stackitem (execution #%d, event #%d): %w", i, j, err) } res = append(res, event) } } return res, nil } // FromStackItem converts provided [stackitem.Array] to RegisterDomainEvent or // returns an error if it's not possible to do to so. func (e *RegisterDomainEvent) FromStackItem(item *stackitem.Array) error { if item == nil { return errors.New("nil item") } arr, ok := item.Value().([]stackitem.Item) if !ok { return errors.New("not an array") } if len(arr) != 1 { return errors.New("wrong number of structure elements") } var ( index = -1 err error ) index++ e.Name, err = func(item stackitem.Item) (string, error) { b, err := item.TryBytes() if err != nil { return "", err } if !utf8.Valid(b) { return "", errors.New("not a UTF-8 string") } return string(b), nil }(arr[index]) if err != nil { return fmt.Errorf("field Name: %w", err) } return nil } // AddRecordEventsFromApplicationLog retrieves a set of all emitted events // with "AddRecord" name from the provided [result.ApplicationLog]. func AddRecordEventsFromApplicationLog(log *result.ApplicationLog) ([]*AddRecordEvent, error) { if log == nil { return nil, errors.New("nil application log") } var res []*AddRecordEvent for i, ex := range log.Executions { for j, e := range ex.Events { if e.Name != "AddRecord" { continue } event := new(AddRecordEvent) err := event.FromStackItem(e.Item) if err != nil { return nil, fmt.Errorf("failed to deserialize AddRecordEvent from stackitem (execution #%d, event #%d): %w", i, j, err) } res = append(res, event) } } return res, nil } // FromStackItem converts provided [stackitem.Array] to AddRecordEvent or // returns an error if it's not possible to do to so. func (e *AddRecordEvent) FromStackItem(item *stackitem.Array) error { if item == nil { return errors.New("nil item") } arr, ok := item.Value().([]stackitem.Item) if !ok { return errors.New("not an array") } if len(arr) != 2 { return errors.New("wrong number of structure elements") } var ( index = -1 err error ) index++ e.Name, err = func(item stackitem.Item) (string, error) { b, err := item.TryBytes() if err != nil { return "", err } if !utf8.Valid(b) { return "", errors.New("not a UTF-8 string") } return string(b), nil }(arr[index]) if err != nil { return fmt.Errorf("field Name: %w", err) } index++ e.Type, err = arr[index].TryInteger() if err != nil { return fmt.Errorf("field Type: %w", err) } return nil } // DeleteRecordsEventsFromApplicationLog retrieves a set of all emitted events // with "DeleteRecords" name from the provided [result.ApplicationLog]. func DeleteRecordsEventsFromApplicationLog(log *result.ApplicationLog) ([]*DeleteRecordsEvent, error) { if log == nil { return nil, errors.New("nil application log") } var res []*DeleteRecordsEvent for i, ex := range log.Executions { for j, e := range ex.Events { if e.Name != "DeleteRecords" { continue } event := new(DeleteRecordsEvent) err := event.FromStackItem(e.Item) if err != nil { return nil, fmt.Errorf("failed to deserialize DeleteRecordsEvent from stackitem (execution #%d, event #%d): %w", i, j, err) } res = append(res, event) } } return res, nil } // FromStackItem converts provided [stackitem.Array] to DeleteRecordsEvent or // returns an error if it's not possible to do to so. func (e *DeleteRecordsEvent) FromStackItem(item *stackitem.Array) error { if item == nil { return errors.New("nil item") } arr, ok := item.Value().([]stackitem.Item) if !ok { return errors.New("not an array") } if len(arr) != 2 { return errors.New("wrong number of structure elements") } var ( index = -1 err error ) index++ e.Name, err = func(item stackitem.Item) (string, error) { b, err := item.TryBytes() if err != nil { return "", err } if !utf8.Valid(b) { return "", errors.New("not a UTF-8 string") } return string(b), nil }(arr[index]) if err != nil { return fmt.Errorf("field Name: %w", err) } index++ e.Type, err = arr[index].TryInteger() if err != nil { return fmt.Errorf("field Type: %w", err) } return nil } // DeleteDomainEventsFromApplicationLog retrieves a set of all emitted events // with "DeleteDomain" name from the provided [result.ApplicationLog]. func DeleteDomainEventsFromApplicationLog(log *result.ApplicationLog) ([]*DeleteDomainEvent, error) { if log == nil { return nil, errors.New("nil application log") } var res []*DeleteDomainEvent for i, ex := range log.Executions { for j, e := range ex.Events { if e.Name != "DeleteDomain" { continue } event := new(DeleteDomainEvent) err := event.FromStackItem(e.Item) if err != nil { return nil, fmt.Errorf("failed to deserialize DeleteDomainEvent from stackitem (execution #%d, event #%d): %w", i, j, err) } res = append(res, event) } } return res, nil } // FromStackItem converts provided [stackitem.Array] to DeleteDomainEvent or // returns an error if it's not possible to do to so. func (e *DeleteDomainEvent) FromStackItem(item *stackitem.Array) error { if item == nil { return errors.New("nil item") } arr, ok := item.Value().([]stackitem.Item) if !ok { return errors.New("not an array") } if len(arr) != 1 { return errors.New("wrong number of structure elements") } var ( index = -1 err error ) index++ e.Name, err = func(item stackitem.Item) (string, error) { b, err := item.TryBytes() if err != nil { return "", err } if !utf8.Valid(b) { return "", errors.New("not a UTF-8 string") } return string(b), nil }(arr[index]) if err != nil { return fmt.Errorf("field Name: %w", err) } return nil }