Skip to content

Commit

Permalink
docs: add latest finschia mainnet/testnet information (#400)
Browse files Browse the repository at this point in the history
* docs: finschia mainnet/testnet information

* chore: move finschia readme contents to main README.md

* chore: update tbd links

* chore: update changelog

* chore: remove unnecessary new lines

* Update CHANGELOG.md

Co-authored-by: Jaeseung Lee <[email protected]>

---------

Co-authored-by: Jaeseung Lee <[email protected]>
(cherry picked from commit 35e3b48)

# Conflicts:
#	CHANGELOG.md
  • Loading branch information
jaeseung-bae committed Jul 8, 2024
1 parent 1f30e48 commit c281edf
Show file tree
Hide file tree
Showing 2 changed files with 103 additions and 4 deletions.
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Ref: https://keepachangelog.com/en/1.0.0/
### Build, CI

### Docs

* (docs) [\#400](https://github.com/Finschia/finschia/pull/400) Add latest finschia mainnet, ebony testnet information

## [v4.0.1] - 2024-06-25

Expand Down
105 changes: 102 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,6 @@ This repository hosts `Finschia`. This repository is forked from [gaia](https://

**Node**: Requires [Go 1.22+](https://golang.org/dl/)

**Warnings**: Initial development is in progress, but there has not yet been a stable.

# Quick Start

## Docker
Expand Down Expand Up @@ -83,7 +81,108 @@ make localnet-start
make localnet-stop
```

# Finschia Mainnet/Testnet

## Public endpoints

| Chain | Chain ID | Endpoint |
| ---------------- | ---------- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Finschia mainnet | finschia-2 | https://finschia-api.finschia.io (REST)<br>https://finschia-rpc.finschia.io/ (RPC)<br>finschia-grpc.finschia.io:443 (gRPC)<br>https://finschia-api.finschia.io/swagger/ (Swagger) |
| Ebony testnet | ebony-2 | https://ebony-api.finschia.io (REST)<br>https://ebony-rpc.finschia.io (RPC)<br>ebony-grpc.finschia.io:443 (gRPC)<br>https://ebony-api.finschia.io/swagger/ (Swagger) |

## Genesis/Snapshot files for Finschia mainnet/testnet

* Genesis file
* Finschia mainnet
* [finschia-genesis.tgz](https://vos.line-scdn.net/finschia-2-fileshare/datafile/finschia-prod-2/finschia-2-genesis.tgz)
* Ebony testnet
* [ebony-genesis.tgz](https://vos.line-scdn.net/finschia-2-fileshare/ebony-prod-2/genesis-file.tgz)
* Snapshot file
* Finschia mainnet (pruned)
* [finschia-2-pruned.tgz](https://finschia-quicksync.line-scdn.net/finschia-2/pruned/finschia-2-pruned.tgz)
* Ebony testnet (pruned)
* [ebony-2-pruned.tgz](https://finschia-quicksync.line-scdn.net/ebony-2/pruned/ebony-2-pruned.tgz)

## Current Finschia mainnet/testent environment

* Required binary versions
* Finschia mainnet (finschia-2)
* [[email protected]](https://github.com/Finschia/finschia/releases/tag/v4.0.1)
* Ebony testnet (ebony-2)
* [[email protected]](https://github.com/Finschia/finschia/releases/tag/v4.0.1)
* Docker container image
* [finschia/finschianode:4.0.1](https://hub.docker.com/layers/finschia/finschianode/4.0.1/images/sha256-73a25e3e1f4343d5a048c8709977335caa1d3b32234b7d5b39217ef237a61649?context=explore)

## Testnet Faucet

* Check faucet status

```shell
curl -X GET https://faucet-ebonynw.line-apps.com/status
```
* How to get coins for Ebony testnet

```shell
curl --header "Content-Type: application/json" \
--request POST \
--data '{"denom":"tcony","address":"REPLACE WITH YOUR ADDRESS tlink1..."}' \
https://faucet-ebonynw.line-apps.com/credit
```

## CLI Examples

### Account

* Create an account
* `fnsad keys add <account_name>`
* Manage an account key
* Key information
* `fnsad keys show <account_name>`
* Address of validator node operator
* `fnsad keys show <account_name> --bech=val`
* Available keys
* `fnsad keys list`

### Transaction

* Send coins Tx
* `fnsad tx bank send <from_address> <to_address> <amount> <flags> --chain-id=<chain_id>`
* example
* `fnsad tx bank send <from_address> <to_address> 1000000cony --chain-id finschia-2 --gas-prices=0.015cony --gas auto --gas-adjustment 1.3`
* Query Tx
* Search a transaction matching a hash
* `fnsad query tx <tx_hash>`

### Query

* Query an account
* `fnsad query account <account_address>`
* Check balance
* `fnsad query bank balances <account_address>`
* Check module parameters
* `fnsad query gov params`

## REST API Examples

* Query the current state

```shell
curl \
-X GET \
-H "Content-Type: application/json" \
http://localhost:1317/cosmos/bank/v1beta1/balances/<address>
```

* Query the past state
* Use the HTTP header x-cosmos-block-height to make a query for the past state.

```shell
curl \
-X GET \
-H "Content-Type: application/json" \
-H "x-cosmos-block-height: 279256"
http://localhost:1317/cosmos/bank/v1beta1/balances/<address>
```

# How to contribute
check out [CONTRIBUTING.md](CONTRIBUTING.md) for our guidelines & policies for how we develop Finschia. Thank you to all those who have contributed!

0 comments on commit c281edf

Please sign in to comment.