chainlist-rpcs 0.1.4 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,7 +4,7 @@ Installation: `npm install -S chainlist-rpcs`
4
4
 
5
5
  NOTE: This module is unofficial and not maintained by Chainlist. If you want to add RPC urls, please refer to the [DefiLlama/chainlist](https://github.com/DefiLlama/chainlist) repository.
6
6
 
7
- NOTE 2: Keep in mind these RPCs are public and may have rate limits and imperfedt uptimel Use them at your own risk.
7
+ NOTE 2: Keep in mind these RPCs are public and may have rate limits and imperfect uptime. Use them at your own risk.
8
8
 
9
9
  ## Usage of constants
10
10
 
@@ -13,8 +13,8 @@ The module exports constants that are objects you can access. The `rpcs` and `ch
13
13
  ```js
14
14
  import { rpcs, chains_by_id, chains_by_name } from 'chainlist-rpcs'
15
15
 
16
- console.log( chains[1] ) // Output: "ethereum"
17
- console.log( rpcs[1] ) // { rpcs: [ { url: String, tracking: String, trackingDetauls: String } ] }
16
+ console.log( chains[1] ) // Output: "ethereum". Note that this is by chain id and not by index. 1 here refers to chain id 1.
17
+ console.log( rpcs[1] ) // { rpcs: [ { url: String, tracking: String, trackingDetails: String } ] }.
18
18
  console.log( chains_by_name["ethereum"] ) // Output: 1
19
19
  ```
20
20
 
@@ -44,33 +44,33 @@ export function get_rpcs_for_chain( { chain_id, chain_name, allowed_tracking=[]
44
44
  * @param {Array} [params.allowed_tracking=[]] - An array of tracking objects. Options: none, limited, yes.
45
45
  * @returns {Array} An array of RPCs for the specified chains.
46
46
  */
47
- export function get_rcpcs_for_chains( { chain_ids=[], chain_names=[], allowed_tracking=[] } )
47
+ export function get_rpcs_for_chainss( { chain_ids=[], chain_names=[], allowed_tracking=[] } )
48
48
 
49
49
  ```
50
50
 
51
51
  Example usage:
52
52
 
53
53
  ```js
54
- import { get_rcpcs_for_chain, get_rcpcs_for_chains } from 'chainlist-rpcs'
54
+ import { get_rpcs_for_chains, get_rpcs_for_chainss } from 'chainlist-rpcs'
55
55
 
56
- const single_chain_by_id = get_rcpcs_for_chain( { chain_id: 1 } ) // Output: [ { url: String, tracking: String, trackingDetauls: String } ]
57
- const single_chain_by_name = get_rcpcs_for_chain( { chain_name: "ethereum" } ) // Output: [ { url: String, tracking: String, trackingDetauls: String } ]
56
+ const single_chain_by_id = get_rpcs_for_chains( { chain_id: 1 } ) // Output: [ { url: String, tracking: String, trackingDetails: String } ]
57
+ const single_chain_by_name = get_rpcs_for_chains( { chain_name: "ethereum" } ) // Output: [ { url: String, tracking: String, trackingDetails: String } ]
58
58
 
59
- const multiple_chains_by_id = get_rcpcs_for_chains( { chain_ids: [1, 42161] } ) // Output: { 1: [ { url: String, tracking: String, trackingDetauls: String } ], 42161: [ { url: String, tracking: String, trackingDetauls: String } ], ethereum: [ { url: String, tracking: String, trackingDetauls: String } ], arbitrum: [ { url: String, tracking: String, trackingDetauls: String } ] }
59
+ const multiple_chains_by_id = get_rpcs_for_chainss( { chain_ids: [1, 42161] } ) // Output: { 1: [ { url: String, tracking: String, trackingDetails: String } ], 42161: [ { url: String, tracking: String, trackingDetails: String } ], ethereum: [ { url: String, tracking: String, trackingDetails: String } ], arbitrum: [ { url: String, tracking: String, trackingDetails: String } ] }
60
60
 
61
- const multiple_chains_by_name = get_rcpcs_for_chains( { chain_names: ["ethereum", "arbitrum"] } ) // Output: { 1: [ { url: String, tracking: String, trackingDetauls: String } ], 42161: [ { url: String, tracking: String, trackingDetauls: String } ], ethereum: [ { url: String, tracking: String, trackingDetauls: String } ], arbitrum: [ { url: String, tracking: String, trackingDetauls: String } ] }
61
+ const multiple_chains_by_name = get_rpcs_for_chainss( { chain_names: ["ethereum", "arbitrum"] } ) // Output: { 1: [ { url: String, tracking: String, trackingDetails: String } ], 42161: [ { url: String, tracking: String, trackingDetails: String } ], ethereum: [ { url: String, tracking: String, trackingDetails: String } ], arbitrum: [ { url: String, tracking: String, trackingDetails: String } ] }
62
62
 
63
63
  ```
64
64
 
65
65
  ## Example usage with viem
66
66
 
67
67
  ```js
68
- import { get_rcpcs_for_chain, get_rcpcs_for_chains } from 'chainlist-rpc'
68
+ import { get_rpcs_for_chains, get_rpcs_for_chainss } from 'chainlist-rpc'
69
69
  import { arbitrum } from 'viem/chains'
70
70
  import { createPublicClient, fallback, http, formatEther } from 'viem'
71
71
 
72
72
  const your_private_rpc_endpoints = [ "https://your-private-rpc-endpoint.com", "https://your-private-rpc-endpoint-2.com" ]
73
- const chainlink_rpc_endpoints = get_rcpcs_for_chain( { chain_name: 'arbitrum' } )
73
+ const chainlink_rpc_endpoints = get_rpcs_for_chains( { chain_name: 'arbitrum' } )
74
74
  const rpc_endpoints = [ ...your_private_rpc_endpoints, ...chainlink_rpc_endpoints ]
75
75
 
76
76
  const public_client = createPublicClient( {
package/app.js CHANGED
@@ -4,4 +4,4 @@ export { default as chains_by_id } from './constants/chainIds'
4
4
 
5
5
  // Export the helper functions
6
6
  export { chains_by_name } from './modules/chains'
7
- export { get_rpcs_for_chain, get_rcpcs_for_chains } from './modules/filter'
7
+ export { get_rpcs_for_chain, get_rpcs_for_chains } from './modules/filter'
package/modules/filter.js CHANGED
@@ -49,7 +49,7 @@ export function get_rpcs_for_chain( { chain_id, chain_name, allowed_tracking=[]
49
49
  * @param {Array} [params.allowed_tracking=[]] - An array of tracking objects. Options: none, limited, yes.
50
50
  * @returns {Array} An array of RPCs for the specified chains.
51
51
  */
52
- export function get_rcpcs_for_chains( { chain_ids=[], chain_names=[], allowed_tracking=[] } ) {
52
+ export function get_rpcs_for_chains( { chain_ids=[], chain_names=[], allowed_tracking=[] } ) {
53
53
 
54
54
  // If chain names were specified, get the chain ids
55
55
  chain_ids = [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "chainlist-rpcs",
3
- "version": "0.1.4",
3
+ "version": "0.2.2",
4
4
  "type": "module",
5
5
  "description": "Wrapper around the rpcs as published by DefiLlama/chainlist.",
6
6
  "main": "app.js",
@@ -29,4 +29,4 @@
29
29
  "husky": "^9.1.6",
30
30
  "vitest": "^2.1.5"
31
31
  }
32
- }
32
+ }
@@ -1,6 +1,6 @@
1
1
  import { describe, it, expect } from 'vitest'
2
2
 
3
- import { get_rcpcs_for_chains, get_rpcs_for_chain } from '../modules/filter'
3
+ import { get_rpcs_for_chains, get_rpcs_for_chain } from '../modules/filter'
4
4
 
5
5
  describe( 'get_rpcs_for_chain', () => {
6
6
 
@@ -81,12 +81,12 @@ describe( 'get_rpcs_for_chain', () => {
81
81
 
82
82
  } )
83
83
 
84
- describe( 'get_rcpcs_for_chains', () => {
84
+ describe( 'get_rpcs_for_chains', () => {
85
85
 
86
86
  it( 'should return RPCs when called with valid chain_ids', () => {
87
87
 
88
88
  const chain_ids = [ 1, 42161 ]
89
- const result = get_rcpcs_for_chains( { chain_ids } )
89
+ const result = get_rpcs_for_chains( { chain_ids } )
90
90
  expect( result[1].length ).to.be.greaterThan( 1 )
91
91
  expect( result[42161].length ).to.be.greaterThan( 1 )
92
92
 
@@ -95,7 +95,7 @@ describe( 'get_rcpcs_for_chains', () => {
95
95
  it( 'should return RPCs when called with valid chain_names', () => {
96
96
 
97
97
  const chain_names = [ 'ethereum', 'arbitrum' ]
98
- const result = get_rcpcs_for_chains( { chain_names } )
98
+ const result = get_rpcs_for_chains( { chain_names } )
99
99
  expect( result[ 'ethereum' ].length ).to.be.greaterThan( 1 )
100
100
  expect( result[ 'arbitrum' ].length ).to.be.greaterThan( 1 )
101
101