NEAR Protocol RPC: View Contract State (1.0.0)

Query contract state data for a NEAR account

Download OpenAPI description
view_state.json
view_state.yaml
Languages
Servers
Mainnet
https://rpc.mainnet.fastnear.com/
Testnet
https://rpc.testnet.fastnear.com/

View contract state

Request

Retrieves the state (key-value pairs) stored for a contract account

Bodyapplication/jsonrequired
jsonrpcstringrequired
Value"2.0"
idstringrequired
Example: "fastnear"
methodstringrequired
Value"query"
paramsobjectrequired
params.​request_typestringrequired
Value"view_state"
params.​account_idstringrequired

NEAR account ID

params.​prefix_base64stringrequired

Base64-encoded storage key

params.​finalitystringrequired

Block finality

Enum"final""optimistic"
params.​include_proofboolean
curl -i -X POST \
  https://rpc.mainnet.fastnear.com/ \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "fastnear",
    "method": "query",
    "params": {
      "request_type": "view_state",
      "finality": "final",
      "account_id": "contract.near",
      "prefix_base64": ""
    }
  }'

Responses

Successful response

Bodyapplication/json
jsonrpcstringrequired
Value"2.0"
idstring or numberrequired
One of:
string
resultobject

Resulting state values for a view state query request

errorobject
Response
application/json
{
  "jsonrpc": "2.0",
  "id": "string",
  "result": {
    "proof": [ … ],
    "values": [ … ]
  },
  "error": {
    "code": 0,
    "message": "string",
    "data": {}
  }
}