Console

POSTall_access_key_changes

NEAR Mainnethttps://near-mainnet.nodit.io/

Returns, per block, the changes of all access keys owned by the given accounts. Each item holds the access key after the change (nonce and permission) and the cause of the change.

Call the changes method with changes_type: "all_access_key_changes" and the account IDs in account_ids. If no key changed in that block, changes is an empty array. If the block cannot be found, the UNKNOWN_BLOCK error is returned. EXPERIMENTAL_changes is the former name of this method.

Request Body
jsonrpcstringrequired
idstringrequired

Request ID. Any string; it is returned unchanged in the response.

methodstringrequired
changes_typestring (enum)required

Change query type. Fixed to all_access_key_changes.

finalitystring (enum)

Specifies the block finality. Cannot be used together with block_id.

  • optimistic: the latest block the node has received (may be reorganized)
  • near-final: a Doomslug-final block (not reverted in most cases)
  • final: a fully finalized block
block_idinteger

Specifies the block to query by block height (integer) or block hash (base58 string). Cannot be used together with finality.

account_idsstring[]required

Account IDs to get changes for

Responses
jsonrpcstring

JSON-RPC version

idstring

Request ID

block_hashstring

Hash of the queried block (base58)

changesobject[]

List of access key changes. Empty when nothing changed in that block.

causeobject

Cause of the change

typestring (enum)

Cause type

  • transaction_processing: transaction processing (includes tx_hash)
  • receipt_processing: receipt processing (includes receipt_hash)
  • action_receipt_processing_started: action receipt processing started (includes receipt_hash)
  • action_receipt_gas_reward: gas reward paid for receipt execution (includes receipt_hash)
  • postponed_receipt: receipt postponed while waiting for data (includes receipt_hash)
  • updated_delayed_receipts: delayed receipt queue updated
  • validator_accounts_update: validator accounts updated at an epoch change
  • migration: protocol migration
  • initial_state: genesis initial state
  • not_writable_to_disk: change that is not written to disk
  • bandwidth_scheduler_state_update: bandwidth scheduler state updated
tx_hashstring

Hash of the causing transaction. Present only when type is transaction_processing. (base58)

receipt_hashstring

Hash of the causing receipt. Present only for receipt-related causes. (base58)

typestring (enum)

Change type

  • access_key_update: access key added, or its nonce or permission changed
  • access_key_deletion: access key deleted
changeobject

The changed access key. For access_key_deletion, only account_id and public_key are present.

account_idstring

Account ID that owns the access key

public_keystring

Public key of the access key

access_keyobject

Access key after the change

nonceinteger

Current nonce of the access key. Transactions signed with this key must use a larger nonce.

permissionobject

Permission. Either the string "FullAccess", or an object with a FunctionCall key holding receiver_id (target contract), method_names (callable methods; empty means all), and allowance (fee allowance, yoctoNEAR).

namestring (enum)

Error class. REQUEST_VALIDATION_ERROR (invalid request), HANDLER_ERROR (processing error), INTERNAL_ERROR (node internal error)

causeobject

The specific cause of the error.

namestring

Name of the error cause (e.g. UNKNOWN_BLOCK, UNKNOWN_ACCOUNT, PARSE_ERROR)

infoobject

Additional information about the error (block hash, height, account ID, etc.)

codeinteger

Legacy JSON-RPC error code (e.g. -32000 server error, -32700 parse error, -32601 method not found)

messagestring

Legacy error message

datastring

Legacy error details

X-API-KEY
RequestCU30
cURL
curl -X POST "https://near-mainnet.nodit.io/" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "dontcare",
    "method": "changes",
    "params": {
      "changes_type": "all_access_key_changes",
      "finality": "final",
      "block_id": 220785385,
      "account_ids": [
        "wrap.near"
      ]
    }
  }'
Response
Example · 200
{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "result": {
    "block_hash": "8EjuQRnAJiWkRmqxfexQFJWXXonuSMbz5AZziJLCWnWS",
    "changes": []
  }
}

Last updated