setAdmin

Sets the administrator for a second-level domain. Owners and administrators control the domains and subdomains. A second-level domain owner can specify an administrator to manage domains. Invoking this API emits the setAdmin event.
This API requires both the owner and administrator's signatures. If the admin is not specified, the admin record will be cleaned. If the domain has expired, it's not allowed to set admin.

Parameters

Name
Type
Description
Required
name
String
The second-level domain, e.g. "test.neo"
Required
admin
Address
The administrator that the owner specifies
Required

Example

Example #1 Set the admin record
Request body #1
curl --request POST \
--url http://seed1t4.neo.org:20332/ \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "invokefunction",
"params": [ "0x538355b776538a5da0b2a08c139b9900b9c0cbb6", "setAdmin",
[
{
"type":"String","value":"flamincome.neo"
},
{
"type":"Hash160","value":"0xc6b7765ce19d382b1af0894c226eee133713fa96"
}
],
[
{
"account": "NV1butKWMZSpWhBGU7PyP5Qe81Wq3zDkHP",
"scopes": "CalledByEntry"
},
{
"account": "NZgG83sFer1ciTy2LCjft4A4fiDuWg4XaB",
"scopes": "CalledByEntry"
}
]
],
"id": 1
}
'
Response body #1
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"script": "DBSW+hM3E+5uIkyJ8BorOJ3hXHa3xgwOZmxhbWluY29tZS5uZW8SwB8MCHNldEFkbWluDBS2y8C5AJmbE4ygsqBdilN2t1WDU0FifVtS",
"state": "HALT",
"gasconsumed": "1348018",
"exception": null,
"stack": [
{
"type": "Any"
}
]
}
}
Example #2 Clear the admin record
Request body #2
curl --request POST \
--url http://seed1t4.neo.org:20332/ \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "invokefunction",
"params": [ "0x538355b776538a5da0b2a08c139b9900b9c0cbb6", "setAdmin",
[
{
"type":"String","value":"flamincome.neo"
},
{
"type":"Hash160","value":null
}
],
[
{
"account": "NV1butKWMZSpWhBGU7PyP5Qe81Wq3zDkHP",
"scopes": "CalledByEntry"
},
{
"account": "NZgG83sFer1ciTy2LCjft4A4fiDuWg4XaB",
"scopes": "CalledByEntry"
}
]
],
"id": 1
}
'
Response body #2
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"script": "CwwOZmxhbWluY29tZS5uZW8SwB8MCHNldEFkbWluDBS2y8C5AJmbE4ygsqBdilN2t1WDU0FifVtS",
"state": "HALT",
"gasconsumed": "1159492",
"exception": null,
"stack": [
{
"type": "Any"
}
]
}
}
Example #3 Set admin for expired domain
Request body #3
curl --request POST \
--url http://seed1t4.neo.org:20332/ \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "invokefunction",
"params": [ "0x538355b776538a5da0b2a08c139b9900b9c0cbb6", "setAdmin",
[
{
"type":"String","value":"expired.neo"
},
{
"type":"Hash160","value":"0xc6b7765ce19d382b1af0894c226eee133713fa96"
}
],
[
{
"account": "NV1butKWMZSpWhBGU7PyP5Qe81Wq3zDkHP",
"scopes": "CalledByEntry"
},
{
"account": "NZgG83sFer1ciTy2LCjft4A4fiDuWg4XaB",
"scopes": "CalledByEntry"
}
]
],
"id": 1
}
'
Response body #3
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"script": "DBSW+hM3E+5uIkyJ8BorOJ3hXHa3xgwLZXhwaXJlZC5uZW8SwB8MCHNldEFkbWluDBS2y8C5AJmbE4ygsqBdilN2t1WDU0FifVtS",
"state": "FAULT",
"gasconsumed": "593841",
"exception": "An unhandled exception was thrown. The name has expired.",
"stack": []
}
}
Last modified 1yr ago