{"id":43171877,"url":"https://github.com/fuseio/fuse-network","last_synced_at":"2026-02-01T02:35:32.067Z","repository":{"id":35923952,"uuid":"199279615","full_name":"fuseio/fuse-network","owner":"fuseio","description":"Fuse network engine; Contains instructions to connect as a node","archived":false,"fork":false,"pushed_at":"2025-09-04T15:39:21.000Z","size":5091,"stargazers_count":89,"open_issues_count":27,"forks_count":44,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-09-04T16:38:35.772Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fuseio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audits/zokyo.pdf","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-07-28T11:37:19.000Z","updated_at":"2025-09-04T15:39:25.000Z","dependencies_parsed_at":"2024-06-24T12:28:28.070Z","dependency_job_id":"8fc4fdf9-a833-45ee-91bc-553c46c13ca2","html_url":"https://github.com/fuseio/fuse-network","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/fuseio/fuse-network","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fuseio%2Ffuse-network","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fuseio%2Ffuse-network/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fuseio%2Ffuse-network/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fuseio%2Ffuse-network/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fuseio","download_url":"https://codeload.github.com/fuseio/fuse-network/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fuseio%2Ffuse-network/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28965430,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T02:14:24.993Z","status":"ssl_error","status_checked_at":"2026-02-01T02:13:55.706Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-02-01T02:35:31.371Z","updated_at":"2026-02-01T02:35:32.058Z","avatar_url":"https://github.com/fuseio.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fuse Network\n\n- [Fuse Network](#fuse-network)\n  - [General](#general)\n    - [Clone Repository](#clone-repository)\n    - [Install Dependencies](#install-dependencies)\n    - [Run Unit Tests](#run-unit-tests)\n  - [Contracts](#contracts)\n    - [Compile](#compile)\n    - [ABIs](#abis)\n    - [Flatten](#flatten)\n    - [Deploy](#deploy)\n  - [Run Local Node](#run-local-node)\n    - [Pre-Requisites](#pre-requisites)\n    - [Hardware](#hardware)\n    - [Networking](#networking)\n    - [Using Quickstart](#using-quickstart)\n      - [Nethermind](#nethermind)\n\n## General\n\n### Clone Repository\n\n```\n$ git clone https://github.com/fuseio/fuse-network.git ~/Dev/fuse-network\n```\n\n### Install Dependencies\n\n```\n$ yarn install\n```\n\n### Run Unit Tests\n\n```\n$ yarn test\n```\n\n## Contracts\n\n### Compile\n\n```\n$ yarn compile\n```\n\n### Flatten\n\n```\n$ yarn flatten\n```\n\n### Deploy\n\nMake sure `NETWORK_NAME` is defined in [`hardhat.config`](https://github.com/fuseio/fuse-network/blob/master/hardhat.config.js)\n\nMake sure you've created an `.env` using the template [`env.example`](https://github.com/fuseio/fuse-network/blob/master/.env.example)\n\nRun:\n\n```\nnpx hardhat run scripts/\u003cSCRIPT_NAME\u003e --network \u003cNETWORK_NAME\u003e\n```\n\n## Run Local Node\n\nPlease make sure you have access to a continuously running machine, if you like to participate as a network validator.\n\n### Pre-Requisites\n\nA complete [Docker](https://docs.docker.com) environment is needed to be installed on your system, as well as [Docker-Compose](https://docs.docker.com/compose/)\n\nMake sure that your user is added to the `docker` user-group on _Unix_ systems, if you can't access root permissions to run containers.\n\n### Hardware\n\n\u003e Note:\n\u003e\n\u003e - Specified for [AWS](https://console.aws.amazon.com), but similar on other providers as well\n\u003e - Depending on your node purpose (shared RPC endpoint with hight load) system requirements could be different\n\u003e - `-` in each column means that role has the same parameters like previous\n\n| Node role          | Bootnode                                                  | Node | Validator | Archival                                                 |\n| ------------------ | --------------------------------------------------------- | ---- | --------- | -------------------------------------------------------- |\n| Operating system   | Ubuntu (18.04 and higher) or any other Linux distribution | -    | -         | -                                                        |\n| Runtime            | On - Premise, Docker, Kubernetes                          | -    | -         | -                                                        |\n| Compute            | Minimal: 2vCPU, 8GB RAM; Recommended: 4vCPU, 16GB RAM     | -    | -         |                                                          |\n| Disk type and size | 150GB SSD; Read/Write IOPS - 5000, Throughput - 125 MB/s  | -    | -         | 2TB SSD; Read / Write IOPS - 5000, Throughput - 125 MB/s |\n\n### Networking\n\n| Name | Port  | Protocol | Action       | Description                                                   | Notes                          |\n| ---- | ----- | -------- | ------------ | ------------------------------------------------------------- | ------------------------------ |\n| P2P  | 30303 | TCP      | Allow        | Port used for communication with the network peers            | Should be openned for everyone |\n| P2P  | 30303 | UDP      | Allow        | -                                                             | -                              |\n| RPC  | 8545  | TCP      | Allow / Deny | Port used for communication with the node with HTTP JSON RPC  | Please, see notes below        |\n| WS   | 8546  | TCP      | Allow / Deny | Port used for communication with the node with HTTP WebSocket | Please, see notes below        |\n\n\u003e Note:\n\u003e\n\u003e - Outbound traffic should be opened for all IP addresses\n\u003e - For Bootnode node role not necessary to open RPC and WebSocket ports, only P2P are required; for Validator node role WebSocket and RPC ports should be opened on `localhost` and granted restricted access through IP whitelists\n\n### Snapshot\n\n To speed up node sync there are the snapshot download links.\n\n | Endpoint                       | Network | Type      | Direct link (latest)                                |\n | ------------------------------ | ------- | --------- | --------------------------------------------------- |\n | https://snapshot.fuse.io       | Fuse    | FastSync  | https://snapshot.fuse.io/openethereum/database.zip  |\n\n The archive file contains `database` folder, blockchain ledger, with n blocks depending on the snapshot date.\n\n \u003e Note: Fuse snapshot compatible with OpenEthereum v3.3.5, Docker image `fusenet/node:2.0.2`.\n\n### Using Quickstart\n\n#### Nethermind\n\nSince **08.2022** Fuse is moving from OE client to [Nethermind](https://nethermind.io). To bootstrap your own Fuse (Spark) node on Nethermind client you could use [quickstart.sh](./nethermind/quickstart.sh) script.\n\n```bash\n# Download\nwget -O quickstart.sh https://raw.githubusercontent.com/fuseio/fuse-network/master/nethermind/quickstart.sh\n\n# Gain needed permissions\nchmod 755 quickstart.sh\n\n# Run\n./quickstart.sh -r [node_role] -n [network_name] -k [node_key]\n```\n\nFull example provided [here](./nethermind/README.md).\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuseio%2Ffuse-network","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffuseio%2Ffuse-network","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuseio%2Ffuse-network/lists"}