Skip to content

Commit 8ec8284

Browse files
authored
Merge pull request #185 from hyperweb-io/v2-readme
readme
2 parents 305d26d + c6afc5c commit 8ec8284

File tree

2 files changed

+68
-37
lines changed

2 files changed

+68
-37
lines changed

README.md

Lines changed: 26 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616
</a>
1717
<br />
1818
<a href="https://github.com/hyperweb-io/chain-registry/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
19-
<a href="https://www.npmjs.com/package/chain-registry"><img height="20" src="https://img.shields.io/github/package-json/v/hyperweb-io/chain-registry?filename=v1/packages%2Fchain-registry%2Fpackage.json"></a>
19+
<a href="https://www.npmjs.com/package/chain-registry"><img height="20" src="https://img.shields.io/github/package-json/v/hyperweb-io/chain-registry?filename=v2%2Fpackages%2Fchain-registry%2Fpackage.json"></a>
2020
</p>
2121

2222
The npm package for the Official Cosmos [chain registry](https://github.com/cosmos/chain-registry)
@@ -30,11 +30,11 @@ A unified store of chains info, assets, asset lists, and IBC channels for the Co
3030

3131
## Features
3232

33-
- 🌐 **Dynamic Loading via [ChainRegistryClient](https://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/client)** - Utilize the client for dynamic data fetching.
33+
- 🌐 **Dynamic Loading via [ChainRegistryClient](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/client)** - Utilize the client for dynamic data fetching.
3434
- 📦 **Tree-Shaking Support** - Optimize your bundles and [include only what you need](#tree-shaking-imports-from-chain-registry).
3535
- 🔌 **Module Compatibility** - Supports both CommonJS and ES Module formats, ensuring compatibility with various JavaScript environments and tools.
36-
- 🛠 **Utilities for Working with Assets and Chains** - [Comprehensive tools](https://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/client) to manage assets and chains efficiently.
37-
- 🌎 **Pre-generated Asset Lists with IBC Denominations for All Chains** - Access ready-to-use [asset lists](ttps://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/assets) across all chains.
36+
- 🛠 **Utilities for Working with Assets and Chains** - [Comprehensive tools](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/client) to manage assets and chains efficiently.
37+
- 🌎 **Pre-generated Asset Lists with IBC Denominations for All Chains** - Access ready-to-use [asset lists](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/assets) across all chains.
3838
- 🔄 **Conversions for Keplr, Cosmostation** - Easily convert data for use with Keplr and Cosmostation wallets.
3939

4040
## Versions
@@ -46,14 +46,6 @@ A unified store of chains info, assets, asset lists, and IBC channels for the Co
4646

4747
*We encourage developers to migrate to v2 for improved consistency and readability.
4848

49-
## Developing
50-
51-
First ensure you have the submodules initialized out before developing:
52-
53-
```
54-
make init-submodules
55-
```
56-
5749
## Usage
5850

5951
### Using the `chain-registry`
@@ -73,26 +65,26 @@ will output:
7365
```js
7466
{
7567
'$schema': '../assetlist.schema.json',
76-
chain_name: 'osmosis',
68+
chainName: 'osmosis',
7769
assets: [
7870
{
7971
description: 'The native token of Osmosis',
80-
denom_units: [Array],
72+
denomUnits: [Array],
8173
base: 'uosmo',
8274
name: 'Osmosis',
8375
display: 'osmo',
8476
symbol: 'OSMO',
85-
logo_URIs: [Object],
86-
coingecko_id: 'osmosis'
77+
logoURIs: [Object],
78+
coingeckoId: 'osmosis'
8779
},
8880
{
89-
denom_units: [Array],
81+
denomUnits: [Array],
9082
base: 'uion',
9183
name: 'Ion',
9284
display: 'ion',
9385
symbol: 'ION',
94-
logo_URIs: [Object],
95-
coingecko_id: 'ion'
86+
logoURIs: [Object],
87+
coingeckoId: 'ion'
9688
}
9789
]
9890
}
@@ -179,35 +171,35 @@ import { assets } from 'chain-registry/noncosmos';
179171

180172
## Packages
181173

182-
#### [chain-registry](https://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/chain-registry)
174+
#### [chain-registry](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/chain-registry)
183175

184176
An npm module for the Official `chain-registry` for the Cosmos ⚛️
185177

186-
#### [@chain-registry/client](https://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/client)
178+
#### [@chain-registry/client](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/client)
187179

188180
A Client for `chain-registry` that allows you to dynamically fetch data.
189181

190-
#### [@chain-registry/types](https://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/types)
182+
#### [@chain-registry/types](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/types)
191183

192184
Types for `chain-registry`.
193185

194-
#### [@chain-registry/keplr](https://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/keplr)
186+
#### [@chain-registry/keplr](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/keplr)
195187

196188
Keplr integration for the chain-registry returning keplr's `ChainInfo` type from `@chain-registry/types` `Chain` type.
197189

198-
#### [@chain-registry/assets](https://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/assets)
190+
#### [@chain-registry/assets](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/assets)
199191

200192
Asset lists for the Cosmos ⚛️
201193

202-
#### [@chain-registry/osmosis](https://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/osmosis)
194+
#### [@chain-registry/osmosis](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/osmosis)
203195

204196
Chain Registry info for Osmosis, including asset lists.
205197

206-
#### [@chain-registry/juno](https://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/juno)
198+
#### [@chain-registry/juno](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/juno)
207199

208200
Chain Registry info for Juno, including asset lists.
209201

210-
#### [@chain-registry/utils](https://github.com/hyperweb-io/chain-registry/tree/main/v1/packages/utils)
202+
#### [@chain-registry/utils](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/utils)
211203

212204
Utility functions for `chain-registry`.
213205

@@ -220,6 +212,13 @@ Checkout the repository run yarn to initialize the workspace:
220212
git clone https://github.com/hyperweb-io/chain-registry
221213
yarn
222214
```
215+
216+
First ensure you have the submodules initialized out before developing:
217+
218+
```
219+
make init-submodules
220+
```
221+
223222
### Building
224223

225224
```sh

v2/packages/chain-registry/README.md

Lines changed: 42 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,15 @@ A unified store of chains info, assets, asset lists, and IBC channels for the Co
3737
- 🌎 **Pre-generated Asset Lists with IBC Denominations for All Chains** - Access ready-to-use [asset lists](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/assets) across all chains.
3838
- 🔄 **Conversions for Keplr, Cosmostation** - Easily convert data for use with Keplr and Cosmostation wallets.
3939

40+
## Versions
41+
42+
⚠️ This repository now contains two versions of the chain-registry:
43+
44+
- **v1**: The original version using `snake_case` naming conventions.
45+
- **v2**: The new, updated version using `camelCase` naming conventions based on developer feedback.
46+
47+
*We encourage developers to migrate to v2 for improved consistency and readability.
48+
4049
## Usage
4150

4251
### Using the `chain-registry`
@@ -65,7 +74,7 @@ will output:
6574
name: 'Osmosis',
6675
display: 'osmo',
6776
symbol: 'OSMO',
68-
logoUris: [Object],
77+
logoURIs: [Object],
6978
coingeckoId: 'osmosis'
7079
},
7180
{
@@ -74,7 +83,7 @@ will output:
7483
name: 'Ion',
7584
display: 'ion',
7685
symbol: 'ION',
77-
logoUris: [Object],
86+
logoURIs: [Object],
7887
coingeckoId: 'ion'
7988
}
8089
]
@@ -162,35 +171,35 @@ import { assets } from 'chain-registry/noncosmos';
162171

163172
## Packages
164173

165-
#### [chain-registry](../chain-registry)
174+
#### [chain-registry](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/chain-registry)
166175

167176
An npm module for the Official `chain-registry` for the Cosmos ⚛️
168177

169-
#### [@chain-registry/client](../client)
178+
#### [@chain-registry/client](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/client)
170179

171180
A Client for `chain-registry` that allows you to dynamically fetch data.
172181

173-
#### [@chain-registry/types](../types)
182+
#### [@chain-registry/types](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/types)
174183

175184
Types for `chain-registry`.
176185

177-
#### [@chain-registry/keplr](../../legacy/keplr)
186+
#### [@chain-registry/keplr](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/keplr)
178187

179188
Keplr integration for the chain-registry returning keplr's `ChainInfo` type from `@chain-registry/types` `Chain` type.
180189

181-
#### [@chain-registry/assets](../../legacy/assets)
190+
#### [@chain-registry/assets](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/assets)
182191

183192
Asset lists for the Cosmos ⚛️
184193

185-
#### [@chain-registry/osmosis](../../legacy/osmosis)
194+
#### [@chain-registry/osmosis](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/osmosis)
186195

187196
Chain Registry info for Osmosis, including asset lists.
188197

189-
#### [@chain-registry/juno](../../legacy/juno)
198+
#### [@chain-registry/juno](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/juno)
190199

191200
Chain Registry info for Juno, including asset lists.
192201

193-
#### [@chain-registry/utils](../utils)
202+
#### [@chain-registry/utils](https://github.com/hyperweb-io/chain-registry/tree/main/v2/packages/utils)
194203

195204
Utility functions for `chain-registry`.
196205

@@ -203,6 +212,13 @@ Checkout the repository run yarn to initialize the workspace:
203212
git clone https://github.com/hyperweb-io/chain-registry
204213
yarn
205214
```
215+
216+
First ensure you have the submodules initialized out before developing:
217+
218+
```
219+
make init-submodules
220+
```
221+
206222
### Building
207223

208224
```sh
@@ -236,6 +252,22 @@ git commit -am "new registry updates"
236252
lerna publish
237253
```
238254

255+
### Updating Submodule Data
256+
257+
Use the following Makefile commands to update the data in the submodules. These commands will ensure that your submodules are synchronized with their respective remote repositories.
258+
259+
- **update-registry**: Updates the submodule to the latest commits of the `cosmos/chain-registry` repository. This should be used to pull the most current production data into your local environment.
260+
261+
```
262+
make update-registry
263+
```
264+
265+
- **update-fixtures**: Updates the submodule to the latest commits of the `hyperweb-io/chain-registry-fixtures` repository. Use this for testing purposes to ensure that your tests are running against stable, controlled data sets.
266+
267+
```
268+
make update-fixtures
269+
```
270+
239271
## Interchain JavaScript Stack ⚛️
240272

241273
A unified toolkit for building applications and smart contracts in the Interchain ecosystem

0 commit comments

Comments
 (0)