{"id":13562179,"url":"https://github.com/Finschia/finschia","last_synced_at":"2025-04-03T18:32:56.731Z","repository":{"id":153671769,"uuid":"404998909","full_name":"Finschia/finschia","owner":"Finschia","description":"Finschia is a mainnet app implementation using finschia-sdk, ostracon, wasmd and ibc-go.","archived":false,"fork":false,"pushed_at":"2024-11-25T08:33:15.000Z","size":48586,"stargazers_count":22,"open_issues_count":16,"forks_count":14,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-03T13:06:03.685Z","etag":null,"topics":["blockchain","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Finschia.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-10T07:45:51.000Z","updated_at":"2024-11-28T08:45:42.000Z","dependencies_parsed_at":"2023-09-05T03:08:03.453Z","dependency_job_id":"40e0bcdd-feca-4eab-a155-af9e219426d5","html_url":"https://github.com/Finschia/finschia","commit_stats":null,"previous_names":["line/finschia","line/lbm"],"tags_count":56,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Finschia%2Ffinschia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Finschia%2Ffinschia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Finschia%2Ffinschia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Finschia%2Ffinschia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Finschia","download_url":"https://codeload.github.com/Finschia/finschia/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247056933,"owners_count":20876481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","golang"],"created_at":"2024-08-01T13:01:05.439Z","updated_at":"2025-04-03T18:32:51.717Z","avatar_url":"https://github.com/Finschia.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Finschia\n\n[![codecov](https://codecov.io/gh/Finschia/finschia/branch/main/graph/badge.svg?token=JFFuUevpzJ)](https://codecov.io/gh/Finschia/finschia)\n[![license](https://img.shields.io/github/license/Finschia/finschia.svg)](https://github.com/Finschia/finschia/blob/main/LICENSE)\n[![LoC](https://tokei.rs/b1/github/Finschia/finschia)](https://github.com/Finschia/finschia)\n[![Go Report Card](https://goreportcard.com/badge/github.com/Finschia/finschia)](https://goreportcard.com/report/github.com/Finschia/finschia)\n[![GolangCI](https://golangci.com/badges/github.com/Finschia/finschia.svg)](https://golangci.com/r/github.com/Finschia/finschia)\n\n\nThis repository hosts `Finschia`. This repository is forked from [gaia](https://github.com/cosmos/gaia) at 2021-03-15. Finschia is a mainnet app implementation using [finschia-sdk](https://github.com/Finschia/finschia-sdk), [ostracon](https://github.com/Finschia/ostracon), [wasmd](https://github.com/Finschia/wasmd) and [ibc-go](https://github.com/Finschia/ibc-go).\n\n**Node**: Requires [Go 1.22+](https://golang.org/dl/)\n\n# Quick Start\n\n## Docker\n**Build Docker Image**\n```\nmake docker-build                # build docker image\n```\nor\n```\nmake docker-build WITH_CLEVELDB=yes GITHUB_TOKEN=${YOUR_GITHUB_TOKEN}  # build docker image with cleveldb\n```\n\n_Note1_\n\nIf you are using M1 mac, you need to specify build args like this:\n```\nmake docker-build ARCH=arm64\n```\n\n**Configure**\n```\nsh init_single.sh docker          # prepare keys, validators, initial state, etc.\n```\nor\n```\nsh init_single.sh docker testnet  # prepare keys, validators, initial state, etc. for testnet\n```\n\n**Run**\n```\ndocker run -i -p 26656:26656 -p 26657:26657 -v ${HOME}/.finschia:/root/.finschia finschia/finschianode fnsad start\n```\n\n## Local\n\n**Build**\n```\nmake build\nmake install \n```\n\n**Configure**\n```\nsh init_single.sh\n```\nor\n```\nsh init_single.sh testnet  # for testnet\n```\n\n**Run**\n```\nfnsad start                # Run a node\n```\n\n**visit with your browser**\n* Node: http://localhost:26657/\n\n## Localnet with 4 nodes\n\n**Run**\n```\nmake localnet-start\n```\n\n**Stop**\n```\nmake localnet-stop\n```\n\n# Finschia Mainnet/Testnet\n\n## Public endpoints\n\n| Chain            | Chain ID   | Endpoint                                                                                                                                                                          |\n| ---------------- | ---------- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Finschia mainnet | finschia-2 | https://finschia-api.finschia.io (REST)\u003cbr\u003ehttps://finschia-rpc.finschia.io/ (RPC)\u003cbr\u003efinschia-grpc.finschia.io:443 (gRPC)\u003cbr\u003ehttps://finschia-api.finschia.io/swagger/ (Swagger) |\n| Ebony testnet    | ebony-2    | https://ebony-api.finschia.io (REST)\u003cbr\u003ehttps://ebony-rpc.finschia.io (RPC)\u003cbr\u003eebony-grpc.finschia.io:443 (gRPC)\u003cbr\u003ehttps://ebony-api.finschia.io/swagger/  (Swagger)             |\n\n## Genesis/Snapshot files for Finschia mainnet/testnet\n\n* Genesis file\n    * Finschia mainnet\n        * [finschia-genesis.tgz](https://vos.line-scdn.net/finschia-2-fileshare/datafile/finschia-prod-2/finschia-2-genesis.tgz)\n    * Ebony testnet\n        * [ebony-genesis.tgz](https://vos.line-scdn.net/finschia-2-fileshare/ebony-prod-2/genesis-file.tgz)\n* Snapshot file\n    * Finschia mainnet (pruned)\n        * [finschia-2-pruned.tgz](https://finschia-quicksync.line-scdn.net/finschia-2/pruned/finschia-2-pruned.tgz)\n    * Ebony testnet (pruned)\n        * [ebony-2-pruned.tgz](https://finschia-quicksync.line-scdn.net/ebony-2/pruned/ebony-2-pruned.tgz)\n\n## Current Finschia mainnet/testent environment\n\n* Required binary versions\n    * Finschia mainnet (finschia-2)\n        * [finschia@v4.0.1](https://github.com/Finschia/finschia/releases/tag/v4.0.1)\n    * Ebony testnet (ebony-2)\n        * [finschia@v4.0.1](https://github.com/Finschia/finschia/releases/tag/v4.0.1)\n    * Docker container image\n      * [finschia/finschianode:4.0.1](https://hub.docker.com/layers/finschia/finschianode/4.0.1/images/sha256-73a25e3e1f4343d5a048c8709977335caa1d3b32234b7d5b39217ef237a61649?context=explore)\n\n## Testnet Faucet\n\n* Check faucet status\n\n```shell\ncurl -X GET https://faucet-ebonynw.line-apps.com/status\n```\n* How to get coins for Ebony testnet\n\n```shell\ncurl --header \"Content-Type: application/json\" \\\n     --request POST \\\n     --data '{\"denom\":\"tcony\",\"address\":\"REPLACE WITH YOUR ADDRESS tlink1...\"}' \\\n     https://faucet-ebonynw.line-apps.com/credit\n```\n\n## CLI Examples\n\n### Account\n\n* Create an account\n    * `fnsad keys add \u003caccount_name\u003e`\n* Manage an account key\n    * Key information\n        * `fnsad keys show \u003caccount_name\u003e`\n    * Address of validator node operator\n        * `fnsad keys show \u003caccount_name\u003e --bech=val`\n    * Available keys\n        * `fnsad keys list`\n\n### Transaction\n\n* Send coins Tx\n    * `fnsad tx bank send \u003cfrom_address\u003e \u003cto_address\u003e \u003camount\u003e \u003cflags\u003e --chain-id=\u003cchain_id\u003e`\n    * example\n        * `fnsad tx bank send \u003cfrom_address\u003e \u003cto_address\u003e 1000000cony --chain-id finschia-2 --gas-prices=0.015cony --gas auto --gas-adjustment 1.3`\n* Query Tx\n    * Search a transaction matching a hash\n        * `fnsad query tx \u003ctx_hash\u003e`\n\n### Query\n\n* Query an account\n    * `fnsad query account \u003caccount_address\u003e`\n* Check balance\n    * `fnsad query bank balances \u003caccount_address\u003e`\n* Check module parameters\n    * `fnsad query gov params`\n\n## REST API Examples\n\n* Query the current state\n\n```shell\ncurl \\\n    -X GET \\\n    -H \"Content-Type: application/json\" \\\n    http://localhost:1317/cosmos/bank/v1beta1/balances/\u003caddress\u003e\n```\n\n* Query the past state\n    * Use the HTTP header x-cosmos-block-height to make a query for the past state.\n\n```shell\ncurl \\\n    -X GET \\\n    -H \"Content-Type: application/json\" \\\n    -H \"x-cosmos-block-height: 279256\"\n    http://localhost:1317/cosmos/bank/v1beta1/balances/\u003caddress\u003e\n```\n\n# How to contribute\ncheck out [CONTRIBUTING.md](CONTRIBUTING.md) for our guidelines \u0026 policies for how we develop Finschia. Thank you to all those who have contributed!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFinschia%2Ffinschia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFinschia%2Ffinschia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFinschia%2Ffinschia/lists"}