From 35e3b480c501885dd143c587c59240628d5fe347 Mon Sep 17 00:00:00 2001
From: jaeseung-bae <119839167+jaeseung-bae@users.noreply.github.com>
Date: Mon, 8 Jul 2024 15:05:17 +0900
Subject: [PATCH] docs: add latest finschia mainnet/testnet information (#400)

* 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 <41176085+tkxkd0159@users.noreply.github.com>

---------

Co-authored-by: Jaeseung Lee <41176085+tkxkd0159@users.noreply.github.com>
---
 CHANGELOG.md |   1 +
 README.md    | 105 +++++++++++++++++++++++++++++++++++++++++++++++++--
 2 files changed, 103 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 12b43008..da642777 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -64,6 +64,7 @@ Ref: https://keepachangelog.com/en/1.0.0/
 * (build) [\#395](https://github.com/Finschia/finschia/pull/395) Apply Go 1.22, finschia-sdk 0.49.1 and update outdated dependencies
 
 ### Docs
+* (docs) [\#400](https://github.com/Finschia/finschia/pull/400) Add  latest finschia mainnet, ebony testnet information
 
 ## [v3.0.0] - 2024-03-04
 
diff --git a/README.md b/README.md
index bdb09ba2..69f7756f 100644
--- a/README.md
+++ b/README.md
@@ -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
@@ -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)
+        * [finschia@v4.0.1](https://github.com/Finschia/finschia/releases/tag/v4.0.1)
+    * Ebony testnet (ebony-2)
+        * [finschia@v4.0.1](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!
-