[Account] kaia_getAccount
Returns the account information of a given address. There are two different account types in Kaia: Externally Owned Account (EOA) and Smart Contract Account. See Kaia Accounts.
NOTE: In versions earlier than Kaia v1.7.0, only integer block number, the string "earliest" and "latest" are available.`
JSONRPC: kaia_getAccount
Request
- application/json
Body
Array [
- IntegerBlockNumber
- HexadecimalBlockNumber
- BlockTag
- BlockHash
]
params
undefined[]
required
Address
BlockNumberOrHashOrTag
object
oneOf
the block number with type integer
number
the block number with type hexadecimal
string
the block tag [latest, pending, earliest]
string
the block hash
string
Responses
- 200
Returns the account information of a given address.
- application/json
- Schema
- Example (from schema)
Schema
- AccountKeyLegacy
- AccountKeyNil
- AccountKeyPublic
- AccountKeyFail
- AccountKeyWeightedMultiSig
- AccountKeyRoleBased
Array [
]
Array [
- AccountKeyNil
- AccountKeyLegacy
- AccountKeyPublic
- AccountKeyFail
- AccountKeyWeightedMultiSig
Array [
]
]
error
object
A Number that indicates the error type that occurred. This MUST be an integer.
code | message | description |
---|---|---|
-32700 | Parse error | invalid JSON was received by the server. An error occurred on the server while parsing the JSON text. |
-32602 | Invalid params | Invalid method parameter(s). |
A String providing a short description of the error. The message SHOULD be limited to a concise single sentence.
A Primitive or Structured value that contains additional information about the error. This may be omitted. The value of this member is defined by the Server (e.g. detailed error information, nested errors etc.).
result
object
Each account type has different attributes.
Default value: 1
account
object
required
key
object
key
object
oneOf
AccountKeyLegacy is used for the account having an address derived from the corresponding key pair
The type of AccountKeyLegacy. This must be 0x01.
string
AccountKeyPublic is used for accounts having one public key.
key
object
required
Key should be a compressed public key on S256 curve.
The x coordinate of the public key.
The y coordinate of the public key.
The type of AccountKeyPublic. This must be 0x02.
If an account has the key AccountKeyFail, the transaction validation process always fails. It can be used for smart contract accounts so that a transaction sent from the smart contract account always fails.
The type of AccountKeyFail. This must be 0x03.
AccountKeyWeightedMultiSig is an account key type containing a threshold and WeightedPublicKeys which contains a list consisting of a public key and its weight.
The type of AccountKeyWeightedMultiSig. This must be 0x04.
Validation threshold. To be a valid transaction, the weight sum of signatures should be larger than or equal to the threshold.
WeightedPublicKeys
object[]
required
A list of weighted public keys. A weighted public key contains a compressed public key and its weight.
PublicKey
object
required
The x coordinate of the public key.
The y coordinate of the public key.
AccountKeyRoleBased represents a role-based key
key
object[]
required
A list of keys. A key can be any of AccountKeyNil, AccountKeyLegacy, AccountKeyPublic, AccountKeyFail, and AccountKeyWeightedMultiSig
anyOf
string
AccountKeyLegacy is used for the account having an address derived from the corresponding key pair
The type of AccountKeyLegacy. This must be 0x01.
AccountKeyPublic is used for accounts having one public key.
key
object
required
Key should be a compressed public key on S256 curve.
The x coordinate of the public key.
The y coordinate of the public key.
The type of AccountKeyPublic. This must be 0x02.
If an account has the key AccountKeyFail, the transaction validation process always fails. It can be used for smart contract accounts so that a transaction sent from the smart contract account always fails.
The type of AccountKeyFail. This must be 0x03.
AccountKeyWeightedMultiSig is an account key type containing a threshold and WeightedPublicKeys which contains a list consisting of a public key and its weight.
The type of AccountKeyWeightedMultiSig. This must be 0x04.
Validation threshold. To be a valid transaction, the weight sum of signatures should be larger than or equal to the threshold.
WeightedPublicKeys
object[]
required
A list of weighted public keys. A weighted public key contains a compressed public key and its weight.
PublicKey
object
required
The x coordinate of the public key.
The y coordinate of the public key.
The type of AccountKeyRoleBased. This must be 0x05.
{
"jsonrpc": "2.0",
"id": 0,
"error": {
"code": -32700,
"message": "Parse error",
"data": "string"
},
"result": {
"accType": 1,
"account": {
"balance": 4985316100000000000,
"humanReadable": false,
"key": {
"key": {
"x": "0x230037a99462acd829f317d0ce5c8e2321ac2951de1c1b1a18f9af5cff66f0d7",
"y": "0x18a7fb1b9012d2ac87bc291cbf1b3b2339356f1ce7669ae68405389be7f8b3b6"
},
"keyType": 2
},
"nonce": 11
}
}
}