An R client for the NEAR Protocol JSON-RPC API
nearjsonrpc brings the full power of the NEAR Protocol JSON-RPC API directly into R, designed by an R developer, for R developers, data scientists, and blockchain analysts.
nearjsonrpc provides clean, type-safe, well-documented functions that return tidy data frames (tibbles) by default, making it seamless to integrate NEAR blockchain data with openssl, cyphr, sodium, digest, jsonlite, httr2, dplyr, tidyr, purrr and shiny R packages.
- Full coverage of essential NEAR JSON-RPC methods
- Automatic JSON parsing into tidy tibbles
- Support for mainnet, testnet, and custom RPC endpoints
- Built-in retry logic and clear error messages
- Comprehensive documentation + vignettes
- 100% open-source
| Function | Description |
|---|---|
near_query_account() |
Get account details and balance |
near_get_block() |
Fetch block by height or hash |
near_network_status() |
Current network info and node status |
near_broadcast_tx() |
Broadcast signed transactions (sync & async) |
near_get_transaction_status() |
Check status of a transaction |
near_call_view_function() |
Call read-only contract functions |
near_get_access_keys() |
List access keys for an account |
near_get_protocol_config() |
Current protocol configuration and version |
near_set_endpoint() |
Set the Active NEAR RPC Endpoint |
near_get_validators() |
Get Epoch Validators with Stake Amounts |
More functions coming soon!
# Install from CRAN (when available)
# install.packages("nearjsonrpc")
# Or the development version from GitHub
# install.packages("remotes")
remotes::install_github("sawsimeon/nearjsonrpc")
DO NOT run real transactions on mainnet without careful consideration. Regarding the function near_broadcast_tx(), sending a real sign transaction
on mainnet will:
- Transfer real NEAR tokens
- Call real contracts
- Cost real gas
- Be permanent and irreversible
For testing near_broadcast_tx(), always use testnet first.
To test functions that require transactions (like near_broadcast_tx()), you need test NEAR:
- Create a testnet account at wallet (e.g.
yourname.testnet) - Fund it using the faucet.
- You are ready to sign and broadcast transactions.
library(nearjsonrpc)
# Switch to testnet for safe testing
near_set_endpoint("testnet")
# ✔ NEAR RPC endpoint set to <https://rpc.testnet.near.org>
# Get account balance and details
near_query_account("sawsimeon.testnet")
# A tibble: 1 × 8
# account_id amount locked storage_usage code_hash block_height block_hash raw_response
# <chr> <chr> <chr> <int> <chr> <int> <chr> <list>
# 1 sawsimeon.testnet 16999958035… 0 264 11111111… 227350669 pBMdeieJn… <named list>
near_get_access_keys("sawsimeon.testnet")
# A tibble: 2 × 5
# public_key access_key block_height block_hash raw_response
# <chr> <list> <int> <chr> <list>
# 1 ed25519:3UrY38puh6TfaEs4QTDLCvshckE5XGgsLNm6WBb… <named list> 227350765 4fLxH8wez… <named list>
# 2 ed25519:4soD2KJ9cTn8ajZSCmbn37KJvWq27H7XHxrJSz6… <named list> 227350765 4fLxH8wez… <named list>near_network_status()
# A tibble: 1 × 8
# chain_id latest_block_height latest_block_hash syncing version protocol_version validators
# <chr> <int> <chr> <lgl> <chr> <int> <list>
# 1 testnet 227350841 4du3GRMcCZJWVr4C5bZpZ7X3… FALSE 2.10.2 82 <list>
# 1 more variable: raw_response <list>near_get_validators()
# A tibble: 36 × 13
# account_id public_key stake_yocto stake_near is_slashed shards blocks_produced blocks_expected
# <chr> <chr> <chr> <dbl> <lgl> <list> <int> <int>
# 1 node1 ed25519:B… 1060330659… 106033066. FALSE <list> 6458 6458
# 2 node2 ed25519:7… 9133714949… 91337150. FALSE <list> 5413 5413
# 3 kiln.pool.f8… ed25519:B… 8855238336… 88552383. FALSE <list> 5276 5276
# 4 node3 ed25519:J… 8357287174… 83572872. FALSE <list> 5132 5132
# 5 node0 ed25519:F… 7788726430… 77887264. FALSE <list> 4616 4616
# 6 aurora.pool.… ed25519:9… 2163384481… 21633845. FALSE <list> 1352 1352
# 7 01node.pool.… ed25519:3… 1844932878… 18449329. FALSE <list> 1074 1074
# 8 stakely_v2.p… ed25519:7… 1288718663… 12887187. FALSE <list> 798 798
# 9 legends.pool… ed25519:A… 1076379261… 10763793. FALSE <list> 610 610
# 10 chorusone.po… ed25519:3… 5995233509… 5995234. FALSE <list> 394 394
# ℹ 26 more rows
# ℹ 5 more variables: chunks_produced <int>, chunks_expected <int>, uptime_pct <dbl>,
# epoch_height <int>, raw_response <list>
# ℹ Use `print(n = ...)` to see more rowstx_hash <- "6CzRJwPqcAufsTztarbtG3wbAzeV6XRGVQvmSDQWvdXo"
sender <- "sawsimeon.testnet"
result <- near_get_transaction_status(tx_hash = tx_hash, sender_account_id = sender)
result
# A tibble: 1 × 5
# hash status transaction receipts_outcome raw_response
# <chr> <list> <list> <list> <list>
# 1 6CzRJwPqcAufsTztarbtG3wbAzeV6XRGVQvmSDQWv… <named list> <named list> <list [3]> <named list>
library(nearjsonrpc)
library(tidyr)
library(purrr)
# Use mainnet (or "testnet", "betanet")
near_set_endpoint("mainnet")
✔ NEAR RPC endpoint set to https://rpc.mainnet.near.org
# Get account balance and details
near_query_account("vitalik.near")
# # A tibble: 1 × 8
# account_id amount locked storage_usage code_hash block_height block_hash raw_response
# <chr> <chr> <chr> <int> <chr> <int> <chr> <list>
# 1 vitalik.near 5463293519585… 0 358058 55E7imni… 175996396 ECbLMFUSC… <named list>
# List all access keys
near_get_access_keys("vitalik.near")
# # A tibble: 7 × 5
# public_key access_key block_height block_hash raw_response
# <chr> <list> <int> <chr> <list>
# 1 ed25519:5a4CCWCJrnMGxSVtjMpxx3qUZ57qH9Tn1Ed8tKY… <named list> 175997459 9JDmQw9m3… <named list>
# 2 ed25519:6EBwyCYEjH1VsjJSUQo6jfH9yvowJ73bdzy9tAG… <named list> 175997459 9JDmQw9m3… <named list>
# 3 ed25519:77oj7oJGG3AoeRaKaAFoPdtZhxeDN3nDwAP3yC8… <named list> 175997459 9JDmQw9m3… <named list>
# 4 ed25519:7CH3JEY5abPhVcdPQxg8FmNnnHVF6E82tMzgFvo… <named list> 175997459 9JDmQw9m3… <named list>
# 5 ed25519:9ePBRZ3W1RpUKsaEripj55jiiREaoJG2Jn3UTBo… <named list> 175997459 9JDmQw9m3… <named list>
# 6 ed25519:Dr9NjCcEMvXEjECaJ9thavk8FQTnhLCgvC4vaft… <named list> 175997459 9JDmQw9m3… <named list>
# 7 ed25519:DyijRtwLRrSysLAgEAn5fdAfMdfYmSZez5HCLfh… <named list> 175997459 9JDmQw9m3… <named list>
# Network status + top validators
status <- near_network_status()
validators_vec <- map_chr(status$validators[[1]], "account_id")
validators_vec
# [1] "figment.poolv1.near" "bisontrails2.poolv1.near"
# [3] "epochrunner.poolv1.near" "astro-stakers.poolv1.near"
# [5] "zavodil.poolv1.near" "binancenode1.poolv1.near"
# [7] "bitwise_1.poolv1.near" "sumerian.poolv1.near"
# [9] "kiln-1.poolv1.near" "ledgerbyfigment.poolv1.near"
# [11] "sofarsonear.poolv1.near" "twinstake.poolv1.near"
# [13] "liver.pool.near" "p2p-org.poolv1.near"
# [15] "galaxydigital.poolv1.near" "epic.poolv1.near"
# [17] "nearvana.poolv1.near" "aca87218e28c41f5a693dee3dff12238.poolv1.near"
# [19] "foundry.poolv1.near" "nearone.pool.near"
# [21] "marcus.pool.near" "flipside.pool.near"
# [23] "stake1.poolv1.near" "macrodatarefinement.poolv1.near"
# [25] "dragonfly.poolv1.near" "d1.poolv1.near"
# [27] "rekt.poolv1.near" "here.poolv1.near"
# [29] "bisontrails.poolv1.near" "sweat_validator.poolv1.near"
# [31] "nansen.poolv1.near" "pandora.poolv1.near"
# [33] "republic.poolv1.near" "allnodes.poolv1.near"
# [35] "northernlights.poolv1.near" "x.poolv1.near"
# [37] "nearfans.poolv1.near" "stakin.poolv1.near"
# [39] "bodhiventures.poolv1.near" "everstake.poolv1.near"
# [41] "aurora.pool.near" "blockdaemon.poolv1.near"
# [43] "nodeasy.poolv1.near" "lux.poolv1.near"
# [45] "okx-earn.poolv1.near" "falcon.pool.near"
# [47] "kiln.poolv1.near" "chorusone.poolv1.near"
# [49] "buildlinks.poolv1.near" "erm.poolv1.near"
# [51] "bitcoinsuisse.poolv1.near" "anonymous.poolv1.near"
# [53] "baziliknear.poolv1.near" "npro.poolv1.near"
# [55] "luganodes.pool.near" "moonlet.poolv1.near"
# [57] "dsrvlabs.poolv1.near" "trust-nodes.poolv1.near"
# [59] "cryptium.poolv1.near" "openshards.poolv1.near"
# [61] "near-prime-public.poolv1.near" "stakesabai.poolv1.near"
# [63] "meteor.poolv1.near" "lunanova.poolv1.near"
# [65] "staked.poolv1.near" "masternode24.poolv1.near"
# [67] "dexagon.poolv1.near" "stardust.poolv1.near"
# [69] "northstakenear.poolv1.near" "polkachu.poolv1.near"
# [71] "hb436_pool.poolv1.near" "qbit.poolv1.near"
# [73] "smart-stake.poolv1.near" "autostake.poolv1.near"
# [75] "pandateam.poolv1.near" "hapi.poolv1.near"
# [77] "stakely_io.poolv1.near" "gtnode-0.poolv1.near"
# [79] "brea.poolv1.near" "lavenderfive.poolv1.near"
# [81] "staking4all.poolv1.near" "fresh.poolv1.near"
# [83] "01node.poolv1.near" "colossus.poolv1.near"
# [85] "avado.poolv1.near" "pairpoint.poolv1.near"
# [87] "optimusvalidatornetwork.poolv1.near" "sharpdarts.poolv1.near"
# [89] "readylayerone_staking.poolv1.near" "deutschetelekom.poolv1.near"
# [91] "atomic-nodes.poolv1.near" "blackdragon.pool.near"
# [93] "namdokmai.poolv1.near" "cryptogarik.poolv1.near"
# [95] "near-prime.poolv1.near" "gfi-validator.poolv1.near"
# [97] "lionstake.poolv1.near" "hashquark.poolv1.near"
# [99] "pangdao.poolv1.near" "oe.poolv1.near"
- NEAR blockchain analytics
- Building NEAR-based applications
- Automated monitoring of NEAR network status
- Smart contract development and testing
For full documentation and examples, see the package vignettes. Whether it's new RPC methods, bug fixes, documentation, or example dashboards.
Contributions are welcome! Please open issues or pull requests for any improvements or bug fixes.
MIT License: https://opensource.org/license/MIT
For questions or feedback, please contact Saw Simeon.