{"id":26034308,"url":"https://github.com/peopay/peochain-demo","last_synced_at":"2025-04-09T18:08:55.094Z","repository":{"id":278828621,"uuid":"936850677","full_name":"PeoPay/peochain-demo","owner":"PeoPay","description":"PeoChain Demo—a high-performance, Rust-driven test network.","archived":false,"fork":false,"pushed_at":"2025-03-17T22:46:55.000Z","size":28589,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T23:34:46.307Z","etag":null,"topics":["blockchain","ethereum","evm-blockchain","layer0"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/PeoPay.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-21T19:53:28.000Z","updated_at":"2025-03-17T22:45:19.000Z","dependencies_parsed_at":"2025-02-22T05:34:59.599Z","dependency_job_id":null,"html_url":"https://github.com/PeoPay/peochain-demo","commit_stats":null,"previous_names":["dkrizhanovskyi/peochain-demo","peopay/peochain-demo"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeoPay%2Fpeochain-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeoPay%2Fpeochain-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeoPay%2Fpeochain-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeoPay%2Fpeochain-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PeoPay","download_url":"https://codeload.github.com/PeoPay/peochain-demo/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248085133,"owners_count":21045135,"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":["blockchain","ethereum","evm-blockchain","layer0"],"created_at":"2025-03-07T02:57:16.497Z","updated_at":"2025-04-09T18:08:55.076Z","avatar_url":"https://github.com/PeoPay.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PeoChain \u0026 PeoPay\n\n\u003e **Next-Generation “Layer Meta” Blockchain + Mobile Financial Ecosystem**\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.14908526.svg)](https://doi.org/10.5281/zenodo.14908526)\n\n[![Bitcointalk Thread](https://img.shields.io/badge/Bitcointalk-Thread-blue?style=for-the-badge)](https://bitcointalk.org/index.php?topic=5532958.msg65092666#msg65092666)  \n\n\nPeoChain is an innovative blockchain designed with Rust for high performance, security, and sustainability. It features a unique **PoSyg + DCS** consensus mechanism and an **EVM** module (similar to Ethereum’s), making it easy for developers to deploy smart contracts. PeoPay complements PeoChain by offering a user-friendly, mobile-first platform targeting underbanked populations and anyone looking for fast, affordable finance solutions.\n\n**Key Highlights**\n- **Rust-Based Consensus**: High-speed, low-latency transactions with a synergy scoring system (DCS).\n- **EVM Compatibility**: Deploy or integrate with existing Ethereum smart contracts.\n- **Mobile Focus**: Seamless crypto-to-mobile money conversions, bridging the gap between decentralized blockchain technology and real-world usage.\n\n---\n\n## Repository Structure\n\n```plaintext\npeochain-demo/\n├── consensus/\n│   ├── src/\n│   │   └── main.rs\n│   ├── tests/\n│   ├── Cargo.toml\n│   └── Dockerfile\n├── evm/\n│   ├── src/\n│   ├── contracts/\n│   ├── tests/\n│   ├── Cargo.toml\n│   └── Dockerfile\n├── bridge/\n│   ├── src/\n│   ├── tests/\n│   ├── Cargo.toml\n│   └── Dockerfile\n├── api/\n│   ├── src/\n│   │   ├── main.go\n│   │   └── handlers.go\n│   ├── go.mod\n│   └── Dockerfile\n├── scripts/\n│   ├── deploy_testnet.sh\n│   ├── init_data.sh\n│   └── start_nodes.sh\n├── docs/\n│   ├── architecture.md\n│   ├── investor_pitch.md\n│   └── roadmap.md\n├── docker-compose.yml\n├── Makefile\n└── ci/\n    └── github-actions.yml\n```\n\n- **consensus/**: Rust code implementing the PoSyg + DCS algorithm.\n- **evm/**: EVM module for smart contract compatibility and execution.\n- **bridge/**: Cross-chain bridge logic to connect external blockchains to PeoChain.\n- **api/**: Go-based REST API providing services like node management, contract deployment, and user-facing endpoints.\n- **scripts/**: Shell scripts for deploying and managing the test network.\n- **docs/**: Contains architectural documentation, pitch decks, and project roadmaps.\n- **docker-compose.yml**: Orchestration file to run all containers for a demo network.\n- **Makefile**: Basic commands for build, test, and deploy.\n- **ci/**: GitHub Actions or other CI/CD configuration.\n\n---\n\n## Getting Started\n\n### Prerequisites\n- **Rust (1.68+ recommended)**  \n- **Go (1.19+ recommended)**  \n- **Docker \u0026 Docker Compose**  \n- **Fedora 41** (as a reference OS, though other platforms may work)\n\n### Building \u0026 Testing\n\n1. **Clone the Repository**:\n   ```bash\n   git clone https://github.com/dkrizhanovskyi/peochain-demo.git\n   cd peochain-demo\n   ```\n\n2. **Build All Services**:\n   ```bash\n   make build\n   ```\n   This compiles Rust modules (consensus, evm, bridge) and the Go API.\n\n3. **Run Tests**:\n   ```bash\n   make test\n   ```\n   Runs integration and unit tests for all modules.\n\n### Deployment\n\n1. **Deploy with Docker Compose**:\n   ```bash\n   ./scripts/deploy_testnet.sh\n   ```\n   This script builds and starts all containers (consensus-node, evm-node, bridge-service, api-service) in detached mode.\n\n2. **Initialize Data**:\n   ```bash\n   ./scripts/init_data.sh\n   ```\n   Sets up initial accounts, deploys example smart contracts, and configures validators.\n\n3. **Check Status**:\n   - Access the Go API at `http://localhost:8080/health` or `http://localhost:8080/status`.\n\n---\n\n## Contributing\n\nWe welcome contributions to improve PeoChain \u0026 PeoPay. Whether you’re adding new features, fixing bugs, or helping with documentation:\n\n1. **Fork** the repository  \n2. **Create** a new branch (`feature/my-new-feature`)  \n3. **Commit** your changes and push  \n4. **Open** a Pull Request, describing your modifications in detail.\n\n---\n\n## Community \u0026 Support\n\n- **Discussions**: [GitHub Discussions](https://github.com/orgs/PeoPay/discussions)  \n- **Bugs \u0026 Issues**: [GitHub Issues](https://github.com/orgs/PeoPay/issues)  \n- **Official Support**: [support@peopay.io](mailto:support@peopay.io)\n\n---\n\n## Author\n\nThis project is initially authored and maintained by **Daniil Krizhanovskyi** (Blockchain Cryptographer, Smart Contracts Auditor). Feel free to connect on [LinkedIn](https://www.linkedin.com/in/dkrizhanovskyi-seceng/), [GitHub](https://github.com/dkrizhanovskyi), or via email at [dk.arecibo@proton.me](mailto:dk.arecibo@proton.me) for inquiries related to security, audits, or blockchain architecture.\n\nThis project is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.\n\n---\n[\u003cblockquote class=\"twitter-tweet\"\u003e\u003cp lang=\"en\" dir=\"ltr\"\u003eLayer 2s are blockchain’s B-team—slow, shaky, and stuck. PeoChain’s synergy, speed, and scale bury them. The future’s here. Lead or bleed: \u003ca href=\"https://t.co/q08fs2yUEo\"\u003ehttps://t.co/q08fs2yUEo\u003c/a\u003e \u003ca href=\"https://twitter.com/hashtag/crypto?src=hash\u0026amp;ref_src=twsrc%5Etfw\"\u003e#crypto\u003c/a\u003e, \u003ca href=\"https://twitter.com/hashtag/blockchain?src=hash\u0026amp;ref_src=twsrc%5Etfw\"\u003e#blockchain\u003c/a\u003e, \u003ca href=\"https://twitter.com/hashtag/DeFi?src=hash\u0026amp;ref_src=twsrc%5Etfw\"\u003e#DeFi\u003c/a\u003e, \u003ca href=\"https://twitter.com/hashtag/PeoPay?src=hash\u0026amp;ref_src=twsrc%5Etfw\"\u003e#PeoPay\u003c/a\u003e, \u003ca href=\"https://twitter.com/hashtag/Layer2Dead?src=hash\u0026amp;ref_src=twsrc%5Etfw\"\u003e#Layer2Dead\u003c/a\u003e\u003c/p\u003e\u0026mdash; Daniil Krizhanovskyi (@arec1b0) \u003ca href=\"https://twitter.com/arec1b0/status/1893168863338021373?ref_src=twsrc%5Etfw\"\u003eFebruary 22, 2025\u003c/a\u003e\u003c/blockquote\u003e](https://twitter.com/arec1b0/status/1893168863338021373)\n\n## Linked Documents\n\n- [SynLedger White Paper](linked/SynLedger_White_Paper.pdf): Outlines the technical architecture and financial model for the SynLedger project, including advanced PoSyg consensus details and tokenomics considerations.\n- [PoSyg Consensus Mechanism](linked/PoSyg_Consensus_Mechanism.pdf): Explores the multi-dimensional Synergy Score, reward/penalty systems, and proof-of-stake integration used to incentivize honest participation and deter malicious activity.\n- [Dynamic Contribution Scoring Paper](linked/ssrn-5045954.pdf): Presents a formal mathematical model for the Dynamic Contribution Score (DCS), covering linearity, penalty dominance, and advanced extensions like time-varying weights and stochastic user behavior.\n\n---\n© 2025 PeoChain Demo Project\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeopay%2Fpeochain-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeopay%2Fpeochain-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeopay%2Fpeochain-demo/lists"}