From ab762c9792d7eb49dd3ca33e0962d7c250f02fcd Mon Sep 17 00:00:00 2001 From: "jaeseung.bae" Date: Mon, 8 Jul 2024 16:03:28 +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> (cherry picked from commit 35e3b480c501885dd143c587c59240628d5fe347) # Conflicts: # CHANGELOG.md --- CHANGELOG.md | 20 +++++----- README.md | 105 +++++++++++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 112 insertions(+), 13 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 24b032a2..41ecc81a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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 @@ -107,17 +107,17 @@ Ref: https://keepachangelog.com/en/1.0.0/ ### Features * (finschia-sdk) Bump github.com/Finschia/finschia-sdk from v0.47.0 to v0.48.0 - * (feat) [\#243](https://github.com/Finschia/finschia/pull/243) Bump github.com/Finschia/finschia-sdk from v0.47.0 to v0.47.1-rc1 - * (feat) [\#255](https://github.com/Finschia/finschia/pull/255) Bump up finschia-sdk from v0.48.0-rc1 to da331c01fa - * (feat) [\#262](https://github.com/Finschia/finschia/pull/262) Bump up finschia-sdk from v0.48.0-rc2 to `0a27aef22921` and bump up ostracon from `449aa3148b12` to `fc29846c918d` - * (finschia-sdk) [\#264](https://github.com/Finschia/finschia/pull/264) Bump up finschia-sdk from `0a27aef22921` to `022614f80a0d` - * (finschia-sdk, ostracon, wasmd) [\#286](https://github.com/Finschia/finschia/pull/286) bump up fisnchia-sdk to v0.48.0 and Ostracon to v1.1.2 and wasmd to v0.2.0 + * (feat) [\#243](https://github.com/Finschia/finschia/pull/243) Bump github.com/Finschia/finschia-sdk from v0.47.0 to v0.47.1-rc1 + * (feat) [\#255](https://github.com/Finschia/finschia/pull/255) Bump up finschia-sdk from v0.48.0-rc1 to da331c01fa + * (feat) [\#262](https://github.com/Finschia/finschia/pull/262) Bump up finschia-sdk from v0.48.0-rc2 to `0a27aef22921` and bump up ostracon from `449aa3148b12` to `fc29846c918d` + * (finschia-sdk) [\#264](https://github.com/Finschia/finschia/pull/264) Bump up finschia-sdk from `0a27aef22921` to `022614f80a0d` + * (finschia-sdk, ostracon, wasmd) [\#286](https://github.com/Finschia/finschia/pull/286) bump up fisnchia-sdk to v0.48.0 and Ostracon to v1.1.2 and wasmd to v0.2.0 * (ostracon) Bump up Ostracon from v1.1.0 to v1.1.2 - * (feat) [\#262](https://github.com/Finschia/finschia/pull/262) Bump up finschia-sdk from v0.48.0-rc2 to `0a27aef22921` and bump up ostracon from `449aa3148b12` to `fc29846c918d` - * (finschia-sdk, ostracon, wasmd) [\#286](https://github.com/Finschia/finschia/pull/286) bump up fisnchia-sdk to v0.48.0 and Ostracon to v1.1.2 and wasmd to v0.2.0 + * (feat) [\#262](https://github.com/Finschia/finschia/pull/262) Bump up finschia-sdk from v0.48.0-rc2 to `0a27aef22921` and bump up ostracon from `449aa3148b12` to `fc29846c918d` + * (finschia-sdk, ostracon, wasmd) [\#286](https://github.com/Finschia/finschia/pull/286) bump up fisnchia-sdk to v0.48.0 and Ostracon to v1.1.2 and wasmd to v0.2.0 * (wasmd) bump up wasmd from v0.1.3 to v0.2.0 - * (wasm) [\#258](https://github.com/Finschia/finschia/pull/258) Bump up wasmd from dedcd9ec to 053c7e43 - * (finschia-sdk, ostracon, wasmd) [\#286](https://github.com/Finschia/finschia/pull/286) bump up fisnchia-sdk to v0.48.0 and Ostracon to v1.1.2 and wasmd to v0.2.0 + * (wasm) [\#258](https://github.com/Finschia/finschia/pull/258) Bump up wasmd from dedcd9ec to 053c7e43 + * (finschia-sdk, ostracon, wasmd) [\#286](https://github.com/Finschia/finschia/pull/286) bump up fisnchia-sdk to v0.48.0 and Ostracon to v1.1.2 and wasmd to v0.2.0 * (ibc) [\#246](https://github.com/Finschia/finschia/pull/246) Update ibc-go to v4 * (build) [\#248](https://github.com/Finschia/finschia/pull/248) Rename namespace to v2 * (app) [\#250](https://github.com/Finschia/finschia/pull/250) Set upgrade handler for v2-Daisy 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)
https://finschia-rpc.finschia.io/ (RPC)
finschia-grpc.finschia.io:443 (gRPC)
https://finschia-api.finschia.io/swagger/ (Swagger) | +| Ebony testnet | ebony-2 | https://ebony-api.finschia.io (REST)
https://ebony-rpc.finschia.io (RPC)
ebony-grpc.finschia.io:443 (gRPC)
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 ` +* Manage an account key + * Key information + * `fnsad keys show ` + * Address of validator node operator + * `fnsad keys show --bech=val` + * Available keys + * `fnsad keys list` + +### Transaction + +* Send coins Tx + * `fnsad tx bank send --chain-id=` + * example + * `fnsad tx bank send 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 ` + +### Query + +* Query an account + * `fnsad query account ` +* Check balance + * `fnsad query bank balances ` +* 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/
+``` + +* 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/
+``` # 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! -