{"id":47943574,"url":"https://github.com/unicornultrafoundation/go-u2u","last_synced_at":"2026-04-04T08:17:04.275Z","repository":{"id":196431963,"uuid":"664166570","full_name":"unicornultrafoundation/go-u2u","owner":"unicornultrafoundation","description":"Implementation of U2U Network in Golang","archived":false,"fork":false,"pushed_at":"2025-12-16T09:57:56.000Z","size":36591,"stargazers_count":12,"open_issues_count":22,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-12-19T22:54:35.341Z","etag":null,"topics":["blockchain","byzantine-fault-tolerance","dag","decentralized","distributed","ledger","network","proof-of-stake"],"latest_commit_sha":null,"homepage":"https://u2u.xyz","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unicornultrafoundation.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING.LESSER","code_of_conduct":null,"threat_model":null,"audit":null,"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":"2023-07-09T05:26:00.000Z","updated_at":"2025-11-26T15:43:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"c4855ca2-1c2c-44a1-968c-8f749ef65c6d","html_url":"https://github.com/unicornultrafoundation/go-u2u","commit_stats":null,"previous_names":["unicornultrafoundation/go-u2u"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/unicornultrafoundation/go-u2u","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unicornultrafoundation%2Fgo-u2u","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unicornultrafoundation%2Fgo-u2u/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unicornultrafoundation%2Fgo-u2u/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unicornultrafoundation%2Fgo-u2u/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unicornultrafoundation","download_url":"https://codeload.github.com/unicornultrafoundation/go-u2u/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unicornultrafoundation%2Fgo-u2u/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31392536,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T04:26:24.776Z","status":"ssl_error","status_checked_at":"2026-04-04T04:23:34.147Z","response_time":60,"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":["blockchain","byzantine-fault-tolerance","dag","decentralized","distributed","ledger","network","proof-of-stake"],"created_at":"2026-04-04T08:17:03.653Z","updated_at":"2026-04-04T08:17:04.253Z","avatar_url":"https://github.com/unicornultrafoundation.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# go-u2u\n\nGolang implementation of Unicorn Ultra Distributed Network followed by this [Whitepaper](https://uniultra.xyz/docs/UnicornUltraWhitepaper.pdf) based on various open-source and documentations:\n- [Hashgraph](https://arxiv.org/pdf/1907.02900.pdf)\n- [Hashgraph Sharding](https://www.mdpi.com/2076-3417/13/15/8726)\n- [TEE Directed Acyclic Graph](https://www.mdpi.com/2079-9292/12/11/2393)\n- [Lachesis](https://arxiv.org/abs/2108.01900)\n- [Delegated Proof-of-Stake](https://www.mdpi.com/1099-4300/25/9/1320)\n- [Proof-of-Elapsed-Time](https://ieeexplore.ieee.org/document/9472787)\n- [Ethereum](https://github.com/ethereum/go-ethereum)\n- [Hedera](https://github.com/hashgraph/hedera-services)\n- [Opera](https://github.com/Fantom-foundation/go-opera)\n- [Erigon](https://github.com/ledgerwatch/erigon)\n\n## Building the source\n\nBuilding `u2u` requires both a Go (version 1.14 or later) and a C compiler. You can install\nthem using your favourite package manager. Once the dependencies are installed, run\n\n```shell\nmake u2u\n```\nThe build output is ```build/u2u``` executable.\n\n## Running `u2u`\n\nGoing through all the possible command line flags is out of scope here,\nbut we've enumerated a few common parameter combos to get you up to speed quickly\non how you can run your own `u2u` instance.\n\n### Launching a network\n\nLaunching `u2u` readonly (non-validator) node for network specified by the genesis file:\n\n```shell\n$ u2u --genesis file.g\n```\n\n### Configuration\n\nAs an alternative to passing the numerous flags to the `u2u` binary, you can also pass a\nconfiguration file via:\n\n```shell\n$ u2u --config /path/to/your_config.toml\n```\n\nTo get an idea how the file should look like you can use the `dumpconfig` subcommand to\nexport your existing configuration:\n\n```shell\n$ u2u --your-favourite-flags dumpconfig\n```\n\n#### Validator\n\nNew validator private key may be created with `u2u validator new` command.\n\nTo launch a validator, you have to use `--validator.id` and `--validator.pubkey` flags to enable events emitter.\n\n```shell\n$ u2u --nousb --validator.id YOUR_ID --validator.pubkey 0xYOUR_PUBKEY\n```\n\n`u2u` will prompt you for a password to decrypt your validator private key. Optionally, you can\nspecify password with a file using `--validator.password` flag.\n\n#### Participation in discovery\n\nOptionally you can specify your public IP to straighten connectivity of the network.\nEnsure your TCP/UDP p2p port (5050 by default) isn't blocked by your firewall.\n\n```shell\n$ u2u --nat extip:1.2.3.4\n```\n\n## Dev\n\n### Running testnet\n\nThe network is specified only by its genesis file, so running a testnet node is equivalent to\nusing a testnet genesis file instead of a mainnet genesis file:\n```shell\n$ u2u --genesis /path/to/testnet.g # launch node\n```\n\nIt may be convenient to use a separate datadir for your testnet node to avoid collisions with other networks:\n```shell\n$ u2u --genesis /path/to/testnet.g --datadir /path/to/datadir # launch node\n$ u2u --datadir /path/to/datadir account new # create new account\n$ u2u --datadir /path/to/datadir attach # attach to IPC\n```\n\n### Testing\n\nClient has extensive unit-testing. Use the Go tool to run tests:\n```shell\ngo test ./...\n```\n\nIf everything goes well, it should output something along these lines:\n```\nok  \tgithub.com/unicornultrafoundation/go-u2u/app\t0.033s\n?   \tgithub.com/unicornultrafoundation/go-u2u/cmd/cmdtest\t[no test files]\nok  \tgithub.com/unicornultrafoundation/go-u2u/cmd/u2u\t13.890s\n?   \tgithub.com/unicornultrafoundation/go-u2u/cmd/u2u/metrics\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/cmd/u2u/tracing\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/crypto\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/debug\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/ethapi\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/eventcheck\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/eventcheck/basiccheck\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/eventcheck/gaspowercheck\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/eventcheck/heavycheck\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/eventcheck/parentscheck\t[no test files]\nok  \tgithub.com/unicornultrafoundation/go-u2u/evmcore\t6.322s\n?   \tgithub.com/unicornultrafoundation/go-u2u/gossip\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/gossip/emitter\t[no test files]\nok  \tgithub.com/unicornultrafoundation/go-u2u/gossip/filters\t1.250s\n?   \tgithub.com/unicornultrafoundation/go-u2u/gossip/gasprice\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/gossip/occuredtxs\t[no test files]\n?   \tgithub.com/unicornultrafoundation/go-u2u/gossip/piecefunc\t[no test files]\nok  \tgithub.com/unicornultrafoundation/go-u2u/integration\t21.640s\n```\n\nAlso it is tested with [fuzzing](./FUZZING.md).\n\n\n### Operating a private network (fakenet)\n\nFakenet is a private network optimized for your private testing.\nIt'll generate a genesis containing N validators with equal stakes.\nTo launch a validator in this network, all you need to do is specify a validator ID you're willing to launch.\n\nPay attention that validator's private keys are deterministically generated in this network, so you must use it only for private testing.\n\nMaintaining your own private network is more involved as a lot of configurations taken for\ngranted in the official networks need to be manually set up.\n\nTo run the fakenet with just one validator (which will work practically as a PoA blockchain), use:\n```shell\n$ u2u --fakenet 1/1\n```\n\nTo run the fakenet with 5 validators, run the command for each validator:\n```shell\n$ u2u --fakenet 1/5 # first node, use 2/5 for second node\n```\n\nIf you have to launch a non-validator node in fakenet, use 0 as ID:\n```shell\n$ u2u --fakenet 0/5\n```\n\nAfter that, you have to connect your nodes. Either connect them statically or specify a bootnode:\n```shell\n$ u2u --fakenet 1/5 --bootnodes \"enode://verylonghex@1.2.3.4:5050\"\n```\n\n### Running the demo\n\nFor the testing purposes, the full demo may be launched using:\n```shell\ncd demo/\n./start.sh # start the u2u processes\n./stop.sh # stop the demo\n./clean.sh # erase the chain data\n```\nCheck README.md in the demo directory for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funicornultrafoundation%2Fgo-u2u","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funicornultrafoundation%2Fgo-u2u","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funicornultrafoundation%2Fgo-u2u/lists"}