Documentation

Messages All messages sent in the network are of type PeerMessage. A PeerMessage is encoded with Protocol Buffers , using the schema in network.proto . Some fields of that schema are bytes fields that

Receipt All cross-contract (we assume that each account lives in its own shard) communication in Near happens through Receipts. Receipts are stateful in a sense that they serve not only as messages be

Refunds When execution of a receipt fails or there is some unused amount of prepaid gas left after a function call, the Runtime generates refund receipts. The are 2 types of refunds: • Refunds for the

Runtime crate Runtime crate encapsulates the logic of how transactions and receipts should be handled. If it encounters a smart contract call within a transaction or a receipt it calls near-vm-runner,

RuntimeConfig The structure that holds the parameters of the runtime, mostly economics. It is not part of genesis. Each nearcore release contains the runtime config for every protocol version (core/pa

RuntimeFeesConfig Economic parameters for runtime actionreceiptcreationconfig type: Fee Describes the cost of creating an action receipt, ActionReceipt, excluding the actual cost of actions. datarecei

Selecting Chunk and Block Producers Background Note: this section describes the Simple Nightshade design as of March 2021. Since stateless validation (protocol version 69), block producers no longer t

StorageUsageConfig Describes how the storage that an account uses is counted for storage staking. numbytesaccount type: u64 Number of bytes counted for the account record, including rounding up for th

VMConfig Config of wasm operations. The fields from maxgasburnt to maxtotalloglength belong to the limit config. In the JSON view they are nested under the limitconfig key of wasmconfig. extcosts type

Backend HTTP API for AI agents that trade on NEAR Intents under an owner-signed policy. No SDK is needed: every call is plain JSON over HTTPS. Full schemas: https://api.agentsonintents.com/openapi.jso

POST /block Returns block details for given height or hash Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can be any string. - jsonrpc (string): JSON-RPC protocol

POST /blockeffects Returns changes in block for given block height or hash over all transactions for all the types. Includes changes like accounttouched, accesskeytouched, datatouched, contractcodetou

POST /broadcasttxasync [Deprecated] Sends a transaction and immediately returns transaction hash. Consider using sendtx instead. Request body (application/json): - id (string): JSON-RPC request id. Au

POST /broadcasttxcommit [Deprecated] Sends a transaction and waits until transaction is fully complete. (Has a 10 second timeout). Consider using sendtx instead. Request body (application/json): - id

POST /changes Returns changes for a given account, contract or contract code for given block height or hash. Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can be

POST /chunk Returns details of a specific chunk. You can run a block details query to get a valid chunk hash. Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can b

POST /clientconfig Queries client node configuration Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can be any string. - jsonrpc (string): JSON-RPC protocol versi

POST /EXPERIMENTALcallfunction Calls a view function on a contract and returns the result. Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can be any string. - jso

POST /EXPERIMENTALchanges [Deprecated] Returns changes for a given account, contract or contract code for given block height or hash. Consider using changes instead. Request body (application/json): -

POST /EXPERIMENTALchangesinblock [Deprecated] Returns changes in block for given block height or hash over all transactions for all the types. Includes changes like accounttouched, accesskeytouched, d

POST /EXPERIMENTALcongestionlevel Queries the congestion level of a shard. More info about congestion here Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can be a

POST /EXPERIMENTALgenesisconfig [Deprecated] Get initial state and parameters for the genesis block. Consider genesisconfig instead. Request body (application/json): - id (string): JSON-RPC request id

POST /EXPERIMENTALlightclientblockproof Returns the proofs for a transaction execution. Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can be any string. - jsonrp

POST /EXPERIMENTALlightclientproof Returns the proofs for a transaction execution. Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can be any string. - jsonrpc (st

POST /EXPERIMENTALmaintenancewindows [Deprecated] Returns the future windows for maintenance in current epoch for the specified account. In the maintenance windows, the node will not be block producer

POST /EXPERIMENTALprotocolconfig A configuration that defines the protocol-level parameters such as gas/storage costs, limits, feature flags, other settings Request body (application/json): - id (stri

POST /EXPERIMENTALreceipt Fetches a receipt by its ID (as is, without a status or execution outcome) Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can be any str

POST /EXPERIMENTALreceipttotx Resolves a receipt ID back to the originating transaction hash and sender account Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can

POST /EXPERIMENTALsplitstorageinfo Contains the split storage information. More info on split storage here Request body (application/json): - id (string): JSON-RPC request id. Auto-populated; can be a

POST /EXPERIMENTALtxstatus [Deprecated] Queries status of a transaction by hash, returning the final transaction result and details of all receipts. Consider using txstatus instead. Request body (appl