diff --git a/CHANGELOG.md b/CHANGELOG.md index 24b032a2..3b555e04 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 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! -