README.md 1.55 KiB
Newer Older
Squirrel's avatar
Squirrel committed
# SS58 Registry

[![GitHub license](https://img.shields.io/badge/license-Apache2-green)](#LICENSE) [![GitLab Status](https://gitlab.parity.io/parity/ss58-registry/badges/main/pipeline.svg)](https://gitlab.parity.io/parity/ss58-registry/pipelines)
Squirrel's avatar
Squirrel committed

IkerAlus's avatar
IkerAlus committed
A list of known [SS58](https://docs.substrate.io/reference/address-formats/) account types as an enum, typically used by the Polkadot, Kusama or Substrate ecosystems.
Squirrel's avatar
Squirrel committed

Sacha Lansky's avatar
Sacha Lansky committed
These are derived from the [json data file](ss58-registry.json) in this repository which contains entries like this:
Squirrel's avatar
Squirrel committed

```js
Sacha Lansky's avatar
Sacha Lansky committed
	"prefix": 5,                       // unique u16
	"network": "astar",                // unique no spaces
	"displayName": "Astar Network",    //
	"symbols": ["ASTR"],               // symbol for each instance of the Balances pallet (usually one)
	"decimals": [18],                  // decimals for each symbol listed
	"standardAccount": "*25519",       // Sr25519, Ed25519 or secp256k1
	"website": "https://astar.network" // website or code repository of network
Squirrel's avatar
Squirrel committed
```

Sacha Lansky's avatar
Sacha Lansky committed
## Process
Squirrel's avatar
Squirrel committed

Sacha Lansky's avatar
Sacha Lansky committed
1. Fork and clone this repo.
Squirrel's avatar
Squirrel committed

Sacha Lansky's avatar
Sacha Lansky committed
2. Add an additional account type to `ss58-registry.json` (contiguous prefixes are better).
Squirrel's avatar
Squirrel committed

3. Bump the minor (middle) version number of the `Cargo.toml` by running:
```
cargo install cargo-bump && cargo bump minor
```
Sacha Lansky's avatar
Sacha Lansky committed
4. Run git stage, commit, push and then raise a pull request.
Squirrel's avatar
Squirrel committed

5. Once the PR has landed, one of the admins can
[create a new release](https://github.com/paritytech/ss58-registry/releases/new).
This will release the new version to [crates.io](https://crates.io/crates/ss58-registry)
Squirrel's avatar
Squirrel committed

Sacha Lansky's avatar
Sacha Lansky committed
## Licensing
Squirrel's avatar
Squirrel committed

Squirrel's avatar
Squirrel committed
Apache-2.0