{"id":33046170,"url":"https://github.com/microstack-tech/parallax","last_synced_at":"2025-11-14T00:01:11.706Z","repository":{"id":315407080,"uuid":"1054661177","full_name":"microstack-tech/parallax","owner":"microstack-tech","description":"Parallax Protocol - Reference client","archived":false,"fork":false,"pushed_at":"2025-11-03T08:06:55.000Z","size":13800,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-03T09:22:09.475Z","etag":null,"topics":["bitcoin","crypto","cryptocurrency","ethereum","geth","go-ethereum","proof-of-work","protocol","xhash"],"latest_commit_sha":null,"homepage":"https://parallaxchain.org","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/microstack-tech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"COPYING","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":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-11T06:48:43.000Z","updated_at":"2025-11-03T07:59:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"d16f356d-e836-41b1-8ea9-71afc429f5a2","html_url":"https://github.com/microstack-tech/parallax","commit_stats":null,"previous_names":["microstack-tech/parallax"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/microstack-tech/parallax","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microstack-tech%2Fparallax","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microstack-tech%2Fparallax/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microstack-tech%2Fparallax/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microstack-tech%2Fparallax/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microstack-tech","download_url":"https://codeload.github.com/microstack-tech/parallax/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microstack-tech%2Fparallax/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":284310377,"owners_count":26983182,"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","status":"online","status_checked_at":"2025-11-13T02:00:06.582Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["bitcoin","crypto","cryptocurrency","ethereum","geth","go-ethereum","proof-of-work","protocol","xhash"],"created_at":"2025-11-14T00:01:03.691Z","updated_at":"2025-11-14T00:01:11.687Z","avatar_url":"https://github.com/microstack-tech.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Parallax\n\nOfficial Golang implementation of the **Parallax protocol**.\n\n\u003e **Parallax** is a Proof-of-Work timechain protocol designed to merge the security model of Bitcoin with the programmability of the EVM. It combines Bitcoin’s fixed monetary rules with Ethereum’s virtual machine to deliver a scarce, decentralized, and programmable timechain.\n\n---\n\n## More on Parallax\n\n- Website: [https://parallaxchain.org](https://parallaxchain.org)\n- Technical Documentation: [https://docs.parallaxchain.org](https://docs.parallaxchain.org)\n- Whitepaper: [https://parallaxchain.org/introduction/whitepaper](https://parallaxchain.org/introduction/whitepaper)\n\nWe have beginner guides on how to run a Parallax node and mining. These can be found [here](https://docs.parallaxchain.org/guides).\n\n---\n\n## Building from Source\n\nParallax requires **Go 1.25+** and a C compiler.\n\n```bash\nmake prlx\n```\n\nBuild the full suite:\n\n```bash\nmake all\n```\n\n---\n\n## Executables\n\nBinaries are located under `build/bin`:\n\n| Command        | Description |\n|----------------|-------------|\n| **`prlx`** | Main CLI client. Runs full, archive, or light nodes; exposes JSON-RPC over HTTP, WS, and IPC. |\n| `clef`         | Stand-alone signer for secure account operations. |\n| `devp2p`       | Networking utilities to inspect and interact at the P2P layer. |\n| `abigen`       | Generates type-safe Go bindings from contract ABIs. |\n| `bootnode`     | Lightweight discovery node to bootstrap networks. |\n| `pvm`          | Execute and debug PVM bytecode snippets in isolation. |\n| `rlpdump`      | Decode RLP structures into a human-readable form. |\n\n---\n\n## Running a Node\n\nMainnet (interactive console):\n\n```bash\nprlx console\n```\n\nTestnet:\n\n```bash\nprlx --testnet console\n```\n\n### Hardware Recommendations\n\n- **Minimum**: 2 cores, 4 GB RAM, 250 GB SSD, 8 Mbps  \n- **Recommended**: 4+ cores, 8 GB RAM, 500 TB SSD, 25+ Mbps\n\n---\n\n## Mining Parallax coins\n\nParallax miner can be started with:\n\n```\nprlx --miner.coinbase \u003cYOUR_WALLET_ADDRESS\u003e --miner.threads 1 --mine\n```\n\nYou can use your existing web3 wallet address from MetaMask or any other Ethereum based wallet. Or create a new wallet address using either `clef` or `parallaxkey`:\n\n```\nparallaxkey generate\n```\n\n```\nclef newaccount\n```\n\nWe have beginner guides on how to run a Parallax node and mining. These can be found [here](https://docs.parallaxchain.org/guides).\n\n---\n\n## JSON-RPC (Developers)\n\nIPC is enabled by default. Enable HTTP/WS explicitly:\n\n```\n--http --http.addr 0.0.0.0 --http.port 8545 --http.api eth,net,web3\n--ws   --ws.addr   0.0.0.0 --ws.port   8546 --ws.api   eth,net,web3\n```\n\n\u003e ⚠️ **Security**: Do **not** expose RPC to the public Internet. Use firewalls, auth proxies, and restricted origins.\n\n---\n\n## Contribution\n\nWe welcome contributions aligned with **neutrality, openness, and decentralization**.\n\n1. Fork the repo\n2. Implement your changes\n3. Open a PR against `main`\n\n**Guidelines**\n\n- Format with `gofmt`; document public symbols following Go conventions.  \n- Keep commits focused; prefix messages with affected packages (e.g., `prlx, rpc:`).  \n\n---\n\n## License\n\n- **Library code** (`/` excluding `cmd/`): [LGPL v3](https://www.gnu.org/licenses/lgpl-3.0.en.html)  \n- **Executables** (`/cmd/*`): [GPL v3](https://www.gnu.org/licenses/gpl-3.0.en.html)\n\n### Attribution Notice\n\nParallax Client is a derivative work of [go-ethereum](https://github.com/ethereum/go-ethereum) originally developed by the go-ethereum authors and licensed under the GNU LGPL-3.0.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrostack-tech%2Fparallax","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrostack-tech%2Fparallax","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrostack-tech%2Fparallax/lists"}