Skip to main content

cfx_getAccount

Return account related states of the given account

Params

(2)

1. address (required)

string
Match pattern:
^(NET\d+|CFX|CFXTEST)(:TYPE\..*|):[ABCDEFGHJKMNPRSTUVWXYZ0123456789]{42}$

2. epoch_num (required)

(one of)
string or null
Match pattern:
^0x([1-9a-f][0-9a-f]{0,15}|0)$

Result

(cfx_getAccount_result)
accumulatedInterestReturn
string
Match pattern:
^0x([1-9a-f][0-9a-f]{0,63}|0)$
address
string
Match pattern:
^(NET\d+|CFX|CFXTEST)(:TYPE\..*|):[ABCDEFGHJKMNPRSTUVWXYZ0123456789]{42}$
admin
string
Match pattern:
^(NET\d+|CFX|CFXTEST)(:TYPE\..*|):[ABCDEFGHJKMNPRSTUVWXYZ0123456789]{42}$
balance
string
Match pattern:
^0x([1-9a-f][0-9a-f]{0,63}|0)$
codeHash
string
Match pattern:
^0x[0-9,a-f,A-F]{64}$
collateralForStorage
string
Match pattern:
^0x([1-9a-f][0-9a-f]{0,63}|0)$
nonce
string
Match pattern:
^0x([1-9a-f][0-9a-f]{0,63}|0)$
stakingBalance
string
Match pattern:
^0x([1-9a-f][0-9a-f]{0,63}|0)$

Examples

Request

curl -X POST --data \
'{
    "method": "cfx_getAccount",
    "params": [
        "CFXTEST:TYPE.USER:AATGGCS6J4VMKE5M10WY04SKDZ7D27RDX2CZXKDMY3"
    ],
    "jsonrpc": "2.0",
    "id": 1
}' \
-H "Content-Type: application/json" \
localhost:12539

Result

{
  "accumulatedInterestReturn": "0x0",
  "address": "CFXTEST:TYPE.USER:AATGGCS6J4VMKE5M10WY04SKDZ7D27RDX2CZXKDMY3",
  "admin": "CFXTEST:TYPE.NULL:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA6F0VRCSW",
  "balance": "0x3576f7dd9fa08e0514",
  "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
  "collateralForStorage": "0xbed1d0263d9f0000",
  "nonce": "0xd",
  "stakingBalance": "0x0"
}

Endpoint

Params

address

epoch_num


Request

curl -X POST --data \
'{
    "method": "cfx_getAccount",
    "params": [
        null,
        null
    ],
    "jsonrpc": "2.0",
    "id": 1
}' \
-H "Content-Type: application/json" \
https://test.confluxrpc.com