Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
YancyParker committed Jul 7, 2024
1 parent d001c76 commit 7cab6d4
Show file tree
Hide file tree
Showing 3 changed files with 104 additions and 33 deletions.
61 changes: 61 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
![](https://github.com/fiamma-chain/fiamma/blob/main/banner.png)

# Fiamma

[![Version](https://img.shields.io/github/v/tag/fiamma-chain/fiamma.svg?sort=semver&style=flat-square)](https://github.com/fiamma-chain/fiamma/releases/latest)
[![GoDoc](https://img.shields.io/badge/godoc-reference-blue?style=flat-square&logo=go)](https://pkg.go.dev/github.com/fiamma-chain/fiamma)
[![Go Report Card](https://goreportcard.com/badge/github.com/fiamma-chain/fiamma)](https://goreportcard.com/report/github.com/fiamma-chain/fiamma)
[![codecov](https://codecov.io/gh/fiamma-chain/fiamma/branch/master/graph/badge.svg)](https://codecov.io/gh/fiamma-chain/fiamma)
[![License:Apache-2.0](https://img.shields.io/github/license/fiamma-chain/fiamma.svg?style=flat-square)](https://github.com/fiamma-chain/fiamma/LICENSE)

Fiamma is emerging as a verification network that specializes in zero-knowledge (ZK) proofs, striving to provide a secure, decentralized, and economically efficient solution for universal blockchain integration. At its heart, Fiamma is engineered to leverage the robust cryptoeconomic and network security value of Bitcoin via the integration with Babylon and implementation of BitVM2. This combination enables Fiamma to introduce ZK capabilities into the Bitcoin ecosystem and secure ZK use cases in Ethereum and beyond, enhancing the scope and effectiveness of ZK technology.


## System Requirements

The following specifications have been found to work well:

- Quad Core or larger AMD or Intel (amd64) CPU
- 32GB RAM;
- 1TB NVMe SSD Storage (disk i/o is crucial);
- 100Mbps bi-directional Internet connection;

## Software Dependencies

The following software should be installed on the target system:

- The Go Programming Language (<https://go.dev>)
- Git Distributed Version Control (<https://git-scm.com>)
- Docker (<https://www.docker.com>)
- GNU Make (<https://www.gnu.org/software/make>)
- Openssl <https://www.openssl.org/>
- jq (https://jqlang.github.io/jq/)


## Build from Source

[Clone the repository](https://github.com/fiamma-chain/fiamma), checkout the `<release version>` branch and install:

```sh
cd fiamma
git checkout <release version>
make install
```

This will install the `fiammad` binary to your `GOPATH`.

## Dockerized Containers

A docker image for production purposes (no shell access):

[Packages: fiammad](https://github.com/orgs/fiamma-chain/packages/container/package/fiammad)


## Joining the testnet

Please follow the instructions on the [User Guides](https://fiamma.gitbook.io/fiamma/).


## Documentation

To learn more, please [visit the official fiamma documentation](https://fiamma.gitbook.io/fiamma/).
Binary file added banner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
76 changes: 43 additions & 33 deletions readme.md
Original file line number Diff line number Diff line change
@@ -1,51 +1,61 @@
# fiamma
**fiamma** is a blockchain built using Cosmos SDK and Tendermint and created with [Ignite CLI](https://ignite.com/cli).
![](https://github.com/fiamma-chain/fiamma/blob/main/banner.png)

## Get started
# Fiamma

```
ignite chain serve
```
[![Version](https://img.shields.io/github/v/tag/fiamma-chain/fiamma.svg?sort=semver&style=flat-square)](https://github.com/fiamma-chain/fiamma/releases/latest)
[![GoDoc](https://img.shields.io/badge/godoc-reference-blue?style=flat-square&logo=go)](https://pkg.go.dev/github.com/fiamma-chain/fiamma)
[![Go Report Card](https://goreportcard.com/badge/github.com/fiamma-chain/fiamma)](https://goreportcard.com/report/github.com/fiamma-chain/fiamma)
[![codecov](https://codecov.io/gh/fiamma-chain/fiamma/branch/master/graph/badge.svg)](https://codecov.io/gh/fiamma-chain/fiamma)
[![License:Apache-2.0](https://img.shields.io/github/license/fiamma-chain/fiamma.svg?style=flat-square)](https://github.com/fiamma-chain/fiamma/LICENSE)

`serve` command installs dependencies, builds, initializes, and starts your blockchain in development.
Fiamma is emerging as a verification network that specializes in zero-knowledge (ZK) proofs, striving to provide a secure, decentralized, and economically efficient solution for universal blockchain integration. At its heart, Fiamma is engineered to leverage the robust cryptoeconomic and network security value of Bitcoin via the integration with Babylon and implementation of BitVM2. This combination enables Fiamma to introduce ZK capabilities into the Bitcoin ecosystem and secure ZK use cases in Ethereum and beyond, enhancing the scope and effectiveness of ZK technology.

### Configure

Your blockchain in development can be configured with `config.yml`. To learn more, see the [Ignite CLI docs](https://docs.ignite.com).
## System Requirements

### Web Frontend
The following specifications have been found to work well:

Additionally, Ignite CLI offers both Vue and React options for frontend scaffolding:
- Quad Core or larger AMD or Intel (amd64) CPU
- 32GB RAM;
- 1TB NVMe SSD Storage (disk i/o is crucial);
- 100Mbps bi-directional Internet connection;

For a Vue frontend, use: `ignite scaffold vue`
For a React frontend, use: `ignite scaffold react`
These commands can be run within your scaffolded blockchain project.
## Software Dependencies

The following software should be installed on the target system:

For more information see the [monorepo for Ignite front-end development](https://github.com/ignite/web).
- The Go Programming Language (<https://go.dev>)
- Git Distributed Version Control (<https://git-scm.com>)
- Docker (<https://www.docker.com>)
- GNU Make (<https://www.gnu.org/software/make>)
- Openssl <https://www.openssl.org/>
- jq (https://jqlang.github.io/jq/)

## Release
To release a new version of your blockchain, create and push a new tag with `v` prefix. A new draft release with the configured targets will be created.

```
git tag v0.1
git push origin v0.1
## Build from Source

[Clone the repository](https://github.com/fiamma-chain/fiamma), checkout the `<release version>` branch and install:

```sh
cd fiamma
git checkout <release version>
make install
```

After a draft release is created, make your final changes from the release page and publish it.
This will install the `fiammad` binary to your `GOPATH`.

### Install
To install the latest version of your blockchain node's binary, execute the following command on your machine:
## Dockerized Containers

A docker image for production purposes (no shell access):

[Packages: fiammad](https://github.com/orgs/fiamma-chain/packages/container/package/fiammad)


## Joining the testnet

Please follow the instructions on the [User Guides](https://fiamma.gitbook.io/fiamma/).

```
curl https://get.ignite.com/username/fiamma@latest! | sudo bash
```
`username/fiamma` should match the `username` and `repo_name` of the Github repository to which the source code was pushed. Learn more about [the install process](https://github.com/allinbits/starport-installer).

## Learn more
## Documentation

- [Ignite CLI](https://ignite.com/cli)
- [Tutorials](https://docs.ignite.com/guide)
- [Ignite CLI docs](https://docs.ignite.com)
- [Cosmos SDK docs](https://docs.cosmos.network)
- [Developer Chat](https://discord.gg/ignite)
To learn more, please [visit the official fiamma documentation](https://fiamma.gitbook.io/fiamma/).

0 comments on commit 7cab6d4

Please sign in to comment.