{"id":13699653,"url":"https://github.com/Zilliqa/Zilliqa","last_synced_at":"2025-05-04T16:35:44.796Z","repository":{"id":37251599,"uuid":"115495630","full_name":"Zilliqa/Zilliqa","owner":"Zilliqa","description":"Zilliqa is the world's first high-throughput public blockchain platform - designed to scale to thousands ​of transactions per second.","archived":false,"fork":false,"pushed_at":"2024-11-09T05:35:57.000Z","size":54141,"stargazers_count":1125,"open_issues_count":130,"forks_count":280,"subscribers_count":106,"default_branch":"master","last_synced_at":"2024-11-09T06:23:58.204Z","etag":null,"topics":["zilliqa"],"latest_commit_sha":null,"homepage":"https://www.zilliqa.com","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zilliqa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-27T07:42:33.000Z","updated_at":"2024-11-02T16:27:42.000Z","dependencies_parsed_at":"2023-10-02T03:51:48.583Z","dependency_job_id":"0aec4889-b62f-43bd-a200-2ee36f7252a5","html_url":"https://github.com/Zilliqa/Zilliqa","commit_stats":null,"previous_names":[],"tags_count":222,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zilliqa%2FZilliqa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zilliqa%2FZilliqa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zilliqa%2FZilliqa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zilliqa%2FZilliqa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zilliqa","download_url":"https://codeload.github.com/Zilliqa/Zilliqa/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224398825,"owners_count":17304661,"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":["zilliqa"],"created_at":"2024-08-02T20:00:40.787Z","updated_at":"2024-11-13T05:32:02.319Z","avatar_url":"https://github.com/Zilliqa.png","language":"C++","readme":"# Zilliqa\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/Zilliqa/Zilliqa/blob/master/img/zilliqa-logo-color.png\" width=\"200\" height=\"200\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://travis-ci.com/Zilliqa/Zilliqa\" target=\"_blank\"\u003e\u003cimg src=\"https://travis-ci.com/Zilliqa/Zilliqa.svg?branch=master\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://codecov.io/gh/Zilliqa/Zilliqa\" target=\"_blank\"\u003e\u003cimg src=\"https://codecov.io/gh/Zilliqa/Zilliqa/branch/master/graph/badge.svg\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/Zilliqa/zilliqa/blob/master/LICENSE\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-GPL%20v3-green.svg\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Overview\n\nZilliqa is a scalable smart contract platform that aims to tackle the congestion issue plaguing the blockchain industry. Zilliqa utilises a unique sharded architecture to achieve parallel processing of transactions while maintaining a large number of public nodes. Hence, Zilliqa is a blockchain capable of reaching high throughput and processing more complex computations while remaining decentralised and secure.\n\n* If you’re interested in mining Zilliqa, see here: https://dev.zilliqa.com/docs/miners/mining-getting-started/.\n* If you’d like to use the interface with Zilliqa nodes to transfer ZIL and deploy/call smart contracts, see here: https://dev.zilliqa.com/docs/apis/api-introduction.\n* If you’re interested more about the core protocol, see the [developer portal](https://dev.zilliqa.com/docs/contributors/contribute-buildzil).\n* If you’re interested in hacking on the Zilliqa code base, see the [Coding Guidelines](https://github.com/Zilliqa/Zilliqa/wiki/Coding-Guidelines).\n\n\u003e **NOTE**: The `master` branch is not for production as development is currently being worked constantly, please use the `tag` releases if you wish to work on the version of Zilliqa client that is running live on the Zilliqa blockchain.\n\n## Zilliqa Mainnet\n\nThe current live version on the Zilliqa Mainnet is Zilliqa [v9.2.3](https://github.com/Zilliqa/Zilliqa/releases/tag/v9.2.3) and Scilla [v0.13.3](https://github.com/Zilliqa/scilla/releases/tag/v0.13.3).\n\n|          | URL(s) |\n|:---------|:-------|\n| **API URL** | `https://api.zilliqa.com/` |\n| **Block Explorer** | [**Viewblock**](https://viewblock.io/zilliqa) \u003cbr\u003e [**DEVEX**](https://devex.zilliqa.com/) |\n\n## Developer Testnet\n\nThe current live version on the Developer Testnet is Zilliqa [v9.2.5](https://github.com/Zilliqa/Zilliqa/releases/tag/v9.2.5) and Scilla [v0.13.3](https://github.com/Zilliqa/scilla/releases/tag/v0.13.3).\n\n|          | URL(s) |\n|:---------|:-------|\n| **API URL** | `https://dev-api.zilliqa.com/` |\n| **Block Explorer** | [**Viewblock**](https://dev-explorer.zilliqa.com) \u003cbr\u003e [**DEVEX**](https://devex.zilliqa.com/?network=https%3A%2F%2Fdev-api.zilliqa.com) |\n| **Faucet** | [**Link**](https://dev-wallet.zilliqa.com) |\n\n## Zilliqa Improvement Proposal (ZIP)\n\nThe Zilliqa Improvement Proposals (ZIPs) are the core protocol standards for the Zilliqa platform.To view or contribute to ZIP, please visit https://github.com/Zilliqa/zip\n\n## Available Features\n\nThe current release has the following features implemented:\n\n* [Network sharding](https://dev.zilliqa.com/docs/basics/basics-zil-sharding#network-sharding)\n* [Transaction sharding](https://dev.zilliqa.com/docs/basics/basics-zil-sharding#transaction-sharding)\n* [Ethash Proof of Work (PoW) for joining the network](https://dev.zilliqa.com/docs/contributors/core-gossip)\n* [GPU (OpenCL and CUDA) for PoW](https://dev.zilliqa.com/docs/contributors/core-pow#gpu-mine)\n* [Block rewarding mechanism](https://dev.zilliqa.com/docs/basics/basics-zil-reward/)\n* [Gas pricer](https://dev.zilliqa.com/docs/contributors/core-global-gas-price)\n* [Coinbase rewards](https://dev.zilliqa.com/docs/contributors/core-coinbase)\n* [EC-Schnorr signature](https://github.com/Zilliqa/schnorr)\n* [pBFT Consensus mechanism](https://dev.zilliqa.com/docs/contributors/core-consensus)\n* Data layer and accounts store\n* [Smart contract layer](https://scilla.readthedocs.io)\n* State delta forwarding\n* Lookup nodes and Seed nodes for receiving and dispatching transactions\n* Persistent storage for transactions and state\n* S3 storage retrieval from archival nodes.\n* [View change mechanism](https://dev.zilliqa.com/docs/contributors/core-view-change)\n* Node recovery mechanism\n* Protocol upgrade mechanism\n* [Gossip protocol for network message broadcasting](https://dev.zilliqa.com/docs/contributors/core-gossip)\n* [Seed Node Staking](https://dev.zilliqa.com/docs/staking/staking-overview)\n\nIn the coming months, we plan to have the following features:\n\n* Further unit and integration tests\n* Enhancement of existing features\n* More operating system support\n* And much more...\n\n## Minimum System Requirements\n\nTo run Zilliqa, we recommend the minimum system requirements specified in our [Mining](https://dev.zilliqa.com/docs/miners/mining-zilclient#hardware-requirements) page.\n\n## Build from Source Code\n\nStarting with Zilliqa [v8.6.0](https://github.com/Zilliqa/Zilliqa/releases/tag/v8.6.0), the officially supported operating system is **Ubuntu 22.04**.\n\nIf you'd like to experiment with a different distro (including the previously supported Ubuntu 18.04), please make sure to install gcc \u003e= 11.\n\nRun the following to install the build dependencies:\n\n```bash\nsudo apt-get update\nsudo apt-get install autoconf \\\n    build-essential \\\n    ccache \\\n    clang-format \\\n    clang-tidy \\\n    git \\\n    lcov \\\n    libcurl4-openssl-dev \\\n    libssl-dev \\\n    libtool \\\n    libxml2-utils \\\n    ninja-build \\\n    ocl-icd-opencl-dev \\\n    pkg-config \\\n    python3-dev \\\n    python3-pip \\\n    libgmp-dev \\\n    bison \\\n    gawk\ngit submodule update --init --recursive\n```\nRun the following to install latest version of cmake. CMake version \u003e= 3.19 must be used:\n\n```\nwget https://github.com/Kitware/CMake/releases/download/v3.19.3/cmake-3.19.3-Linux-x86_64.sh\nmkdir -p \"${HOME}\"/.local\nbash ./cmake-3.19.3-Linux-x86_64.sh --skip-license --prefix=\"${HOME}\"/.local/\nexport PATH=$HOME/.local/bin:$PATH\ncmake --version\nrm cmake-3.19.3-Linux-x86_64.sh\n```\n\nTo install, clone vcpkg to a separate location (do not use brew on macos):\n\n```shell\n$ git clone https://github.com/Microsoft/vcpkg.git /path/to/vcpkg\n$ cd /path/to/vcpkg \u0026\u0026 git checkout 2022.09.27 \u0026\u0026 ./bootstrap-vcpkg.sh\n$ cd /path/to/zilliqa\n$ export VCPKG_ROOT=/path/to/vcpkg\n```\nAs part of building our source code, we patch websocketpp 0.8.2 to compile on C++20; please\nsee the license: https://github.com/zaphoyd/websocketpp/blob/master/COPYING.\n\nBuild Zilliqa from the source:\n\n```shell\n# build Zilliqa binary\n$ ./build.sh\n```\n\nIf you want to contribute by submitting code changes in a pull request perform the build with `clang-format` and `clang-tidy` enabled by doing:\n\n```shell\n$ ./build.sh style\n```\n\n## Build Scilla for Smart Contract Execution\n\nThe Zilliqa client works together with Scilla for executing smart contracts. Please refer to the [Scilla repository](https://github.com/Zilliqa/scilla) for build and installation instructions.\n\n## Boot Up a Local Testnet for Development\n\n1. Run the local testnet script in `build` directory:\n\n    ```shell\n    $ cd build \u0026\u0026 ./tests/Node/pre_run.sh \u0026\u0026 ./tests/Node/test_node_lookup.sh \u0026\u0026 ./tests/Node/test_node_simple.sh\n    ```\n\n2. Logs of each node can be found at `./local_run`\n\n3. To terminate Zilliqa:\n\n    ```shell\n    $ pkill zilliqa\n    ```\n\n## Start a local network development environment\n\nThis is similar to the above, but deploys a local testnet to a local minikube cluster.\n\nYou can find documentation on how to do this on your local machine in `docs/localdev.md`.\n\nYou can find scripts which will set up an Ubuntu 22.04 machine in the cloud (or install necessary dependencies on your machine) in `docs/setup/README.md`.\n\n## Further Enquiries\n\n|          | Link(s) |\n|:---------|:-------|\n| **Development discussion (discord)** | \u003ca href=\"https://discord.gg/XMRE9tt\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/discord/370992535725932544.svg\" /\u003e\u003c/a\u003e |\n| **Bug report** | \u003ca href=\"https://github.com/Zilliqa/zilliqa/issues\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/Zilliqa/zilliqa.svg\" /\u003e\u003c/a\u003e |\n| **Security contact** | `security` :globe_with_meridians: `zilliqa.com` |\n| **Security bug bounty** | \u003ca href=\"https://hackerone.com/zilliqa\" target=\"_blank\"\u003eHackerOne bug bounty\u003c/a\u003e |\n","funding_links":[],"categories":["Smart Contract Platforms","C++"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZilliqa%2FZilliqa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZilliqa%2FZilliqa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZilliqa%2FZilliqa/lists"}