{"id":50141647,"url":"https://github.com/alanruno/mxd","last_synced_at":"2026-05-24T02:00:24.655Z","repository":{"id":359113265,"uuid":"1244069605","full_name":"AlanRuno/mxd","owner":"AlanRuno","description":"MXD — Post-Quantum Blockchain with one-way bridge to BNB Smart Chain. Hybrid Ed25519 + Dilithium5 (FIPS 204 ML-DSA-87) at the address, transaction, and consensus layers.","archived":false,"fork":false,"pushed_at":"2026-05-20T12:23:12.000Z","size":722,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-20T16:44:29.994Z","etag":null,"topics":["agpl-3","blockchain","bnb-bridge","bnb-chain","consensus","cryptography","dilithium5","fips-204","ml-dsa-87","post-quantum"],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlanRuno.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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":"2026-05-20T00:01:38.000Z","updated_at":"2026-05-20T13:00:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AlanRuno/mxd","commit_stats":null,"previous_names":["alanruno/mxd"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AlanRuno/mxd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanRuno%2Fmxd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanRuno%2Fmxd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanRuno%2Fmxd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanRuno%2Fmxd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlanRuno","download_url":"https://codeload.github.com/AlanRuno/mxd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanRuno%2Fmxd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33418550,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"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":["agpl-3","blockchain","bnb-bridge","bnb-chain","consensus","cryptography","dilithium5","fips-204","ml-dsa-87","post-quantum"],"created_at":"2026-05-24T02:00:18.941Z","updated_at":"2026-05-24T02:00:24.621Z","avatar_url":"https://github.com/AlanRuno.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MXD - Mexican Denarius\n\nA UTXO-based blockchain with Rapid Stake Consensus (RSC), hybrid post-quantum cryptography, and zero mandatory transaction fees. Written in C.\n\n## Overview\n\nMXD is a layer-1 cryptocurrency designed for efficient, secure, and accessible digital transactions. The network runs Protocol v4, which embeds on-chain validator scoring directly into block headers for transparent, deterministic proposer selection.\n\nKey design choices:\n\n- **UTXO transaction model** with voluntary tips (no mandatory fees)\n- **Hybrid cryptography**: Ed25519 (default) + Dilithium5 (post-quantum), selectable per node at runtime via `algo_id`\n- **Rapid Stake Consensus (RSC)**: round-robin block proposal with score-weighted fallback and validation chain signatures from 50%+ of the Rapid Table\n- **RocksDB** storage for blocks, UTXOs, and address indexes\n- **Bridge support**: native BNB-to-MXD bridge with v3 bridge mint transactions\n\nThe project builds into two artifacts: `libmxd.so` (shared library) and `mxd_node` (standalone node binary).\n\n## Features\n\n- Zero mandatory fees -- users may attach voluntary tips\n- Hybrid Ed25519 / Dilithium5 signatures on the same network\n- Protocol v4 on-chain validator scoring (stake 30%, proposals 25%, participation 25%, latency 20%)\n- Deterministic total supply tracking per block\n- WASM3-based smart contracts (basic support, disabled by default)\n- HTTP JSON API for wallets, explorers, and bridge integrations\n- P2P networking with DHT-based node discovery\n- Cross-platform: Linux, macOS, Windows (MSYS2)\n\n## Building\n\n### Prerequisites\n\n```bash\n# Automated (recommended)\n./install_dependencies.sh [--force_build]\n\n# Manual -- Ubuntu/Debian\nsudo apt-get install -y build-essential cmake libssl-dev libsodium-dev libgmp-dev\n```\n\nAdditional libraries built from source by the install script: **wasm3**, **libuv**, **uvwasi**, **RocksDB**.\n\n### Compile\n\n```bash\ngit clone https://github.com/AlanRuno/mxdlib.git\ncd mxdlib\nmkdir build \u0026\u0026 cd build\ncmake ..\ncmake --build . --parallel\n```\n\nThis produces `lib/libmxd.so` and `lib/mxd_node`.\n\n## Running\n\n```bash\n# Start with defaults (loads default_config.json)\n./mxd_node\n\n# Custom config and algorithm override\n./mxd_node --config testnet.json --algo dilithium5\n\n# Override port / register as bootstrap\n./mxd_node --port 9000 --bootstrap\n```\n\nConfiguration is via a JSON file. Key fields: `node_id`, `network_type`, `port`, `data_dir`, `initial_stake`, `preferred_sign_algo` (1 = Ed25519, 2 = Dilithium5), `bootstrap_nodes`. See the `default_config.json` file for all options.\n\n### Testnet\n\nCurrently deployed on 5 GCP nodes (`mxd-test-node-testing-0` through `4`) in `us-central1-a`. HTTP API listens on port **8080**, P2P on port **8000**.\n\n## API Endpoints (summary)\n\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | `/status` | Node status and chain height |\n| GET | `/block/{height}` | Block by height |\n| GET | `/tx/{hash}` | Transaction by hash |\n| GET | `/balance/{address}` | Address balance (UTXO sum) |\n| POST | `/tx/submit` | Submit a signed transaction |\n| POST | `/bridge/submit` | Submit a bridge mint transaction |\n| GET | `/validators` | Current validator set and scores |\n| GET | `/mempool` | Pending transactions |\n\nSee source (`mxd_http_api.c`) for the full endpoint list and request/response formats.\n\n## Bridge Support\n\nMXD includes a native bridge endpoint (`/bridge/submit`) for cross-chain transfers between BNB and MXD. Bridge mint transactions use the v3 transaction format and are validated against the bridge oracle before inclusion in a block.\n\nDetailed documentation:\n\n- [Bridge Transactions](docs/BRIDGE_TRANSACTIONS.md)\n- [Bridge Deployment](docs/BRIDGE_DEPLOYMENT.md)\n- [Bridge System Technical Documentation](docs/MXD_Bridge_System_Technical_Documentation.html)\n\n## Documentation\n\nThe `docs/` directory contains detailed guides:\n\n- [Build Instructions](docs/BUILD.md)\n- [Hybrid Cryptography Guide](docs/HYBRID_CRYPTO.md)\n- [Module Documentation](docs/MODULES.md)\n- [Integration Guide](docs/INTEGRATION.md)\n- [Serialization Spec v4](docs/serialization_spec_v4.md)\n- [Smart Contracts Roadmap](docs/SMART_CONTRACTS_ROADMAP.md)\n- [Security Guidelines](docs/SECURITY_GUIDELINES.md)\n- [Platform Quirks](docs/PLATFORM_QUIRKS.md)\n- [Determinism](docs/DETERMINISM.md)\n- [MXD Whitepaper (English)](https://mxd.com.mx/WhitePaper_En.pdf)\n\n## License\n\nThis project is licensed under the MIT License. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falanruno%2Fmxd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falanruno%2Fmxd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falanruno%2Fmxd/lists"}