{"id":13511547,"url":"https://github.com/qtumproject/qtum","last_synced_at":"2025-05-14T05:05:31.360Z","repository":{"id":38484439,"uuid":"83774906","full_name":"qtumproject/qtum","owner":"qtumproject","description":"Qtum Core Wallet","archived":false,"fork":false,"pushed_at":"2025-05-12T14:14:29.000Z","size":224422,"stargazers_count":1214,"open_issues_count":38,"forks_count":403,"subscribers_count":183,"default_branch":"master","last_synced_at":"2025-05-12T15:33:37.735Z","etag":null,"topics":["bitcoin","c-plus-plus","cryptocurrency","cryptography","ethereum","p2p","qtum"],"latest_commit_sha":null,"homepage":"https://qtum.org","language":"C++","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/qtumproject.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","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}},"created_at":"2017-03-03T08:17:11.000Z","updated_at":"2025-04-19T03:54:49.000Z","dependencies_parsed_at":"2023-02-19T08:00:42.814Z","dependency_job_id":"39724464-f728-4af6-93c0-733f0820dc8a","html_url":"https://github.com/qtumproject/qtum","commit_stats":{"total_commits":29184,"total_committers":1188,"mean_commits":"24.565656565656564","dds":0.9175575657894737,"last_synced_commit":"cc653144df6cb90dab20564e4263f0d8377a499d"},"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtumproject%2Fqtum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtumproject%2Fqtum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtumproject%2Fqtum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtumproject%2Fqtum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qtumproject","download_url":"https://codeload.github.com/qtumproject/qtum/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254076543,"owners_count":22010611,"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":["bitcoin","c-plus-plus","cryptocurrency","cryptography","ethereum","p2p","qtum"],"created_at":"2024-08-01T03:00:55.161Z","updated_at":"2025-05-14T05:05:31.317Z","avatar_url":"https://github.com/qtumproject.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"What is Qtum?\n-------------\n\nQtum is a decentralized blockchain project built on Bitcoin's UTXO model, with support for Ethereum Virtual Machine based smart contracts, and secured by a proof of stake consensus model. It achieves this through the revolutionary Account Abstraction Layer which allows the EVM to communicate with Qtum's Bitcoin-like UTXO blockchain. For more general information about Qtum as well as links to join our community, go to https://qtum.org\n\nWelcome to the Qtum Fastlane Main Network. This is the main network where the tokens hold value and should be guarded very carefully. If you are testing the network, or developing unstable software on Qtum, we highly recommend using either testnet or regtest mode. \n\nThe major features of the Qtum network include:\n\n1. Compatibility with the Ethereum Virtual Machine, which allows for compatibility with most existing Solidity based smart contracts. No special solidity compiler is required to deploy your smart contract to Qtum. \n2. A Proof of Stake consensus system which is optimized for Qtum's contract model. Any user can stake and help to secure the network. There is no voting, master nodes, or minimum amount required. There have been transactions as small as 2 Qtum that have created blocks in the past. Staking from smart contracts is under development.\n3. The Decentralized Governance Protocol is completely implemented and functional, which allows certain network parameters to be modified without a fork or other network disruption. This currently controls parameters like block size, gas prices, etc. \n4. Uses the UTXO transaction model and is compatible with Bitcoin, allowing for existing tooling and workflows to be used with Qtum. This allows for the infamous SPV protocol to be used which is ideal for light wallets on mobile phones and IoT devices.\n\nNote: Qtum Core is considered beta software. We make no warranties or guarantees of its security or stability.\n\nQtum Documentation and Usage Resources\n---------------\n\nThese are some resources that might be helpful in understanding Qtum.\n\nBasic usage resources:\n\n* [User guide](https://docs.qtum.site/en/)\n* [Qtum-Qt Wallet Tutorial](https://github.com/qtumproject/documents/tree/master/en/Qtum-Wallet-Tutorial#qtum-qt-wallet-tutorial)\n* [Qtum staking tutorial](https://github.com/qtumproject/documents/tree/master/en/How-to-Stake-with-Qtum)\n* [Qtum tutorial on Raspberry Pi](https://github.com/qtumproject/documents/tree/master/en/Qtum-on-Raspberry-Pi)\n* [Running Qtum on Amazon AWS using Qtum AMI](https://github.com/qtumproject/documents/tree/master/en/Qtum-AWS)\n* [Encrypting and unlocking wallet](https://github.com/qtumproject/documents/tree/master/en/Encrypt-and-Unlock-Qtum-Wallet)\n* [Testnet guide](https://github.com/qtumproject/documents/blob/master/en/Testnet-User-Guide.md)\n* [Block explorer](https://qtum.info), [Older explorer](https://explorer.qtum.org)\n\n\nDevelopment resources:\n\n* [Qtum Book - A Developer's Guide To QTUM](http://book.qtum.site/en/)\n* [Qtum contract usage](https://docs.qtum.site/en/QRC20-Token-Introduce.html)\n* [Deploying a custom token to Qtum](https://blog.qtum.org/qtum-custom-token-walkthrough-467d725fa27d)\n* [QtumJS document](https://qtumproject.github.io/qtumjs-doc/)\n* [Smart contract ICO example](http://book.qtum.site/en/part3/ico.htm)\n* [Early example faucet contract](http://earlz.net/view/2017/06/30/2144/the-qtum-sparknet-faucet)\n\nGeneral Info about Qtum:\n\n* [CIRCLERESEARCH Qtum Primer](https://www.circle.com/marketing/pdfs/research/circle-research-qtum.pdf)\n* [Qtum's PoS vs CASPER](https://www.reddit.com/r/Qtum/comments/788oa5/qtums_pos_vs_casper_and_the_nothingatstake_problem/)\n* [Technical article explaining Qtum's PoS model in depth](http://earlz.net/view/2017/07/27/1904/the-missing-explanation-of-proof-of-stake-version)\n\n\nDeveloper's Tools\n-----------------\n\n* Smart contract deployment tool\n  * https://github.com/qtumproject/solar\n* DApp JavaScript Library\n  * https://github.com/qtumproject/qtumjs\n* A toolkit for building qtum light wallets\n  * https://github.com/qtumproject/qtumjs-wallet\n* CORS qtumd RPC proxy for DApp\n  * https://github.com/qtumproject/qtumportal\n* Docker images for running qtum services\n  * https://github.com/qtumproject/qtum-docker\n* qtum.info API that powers the block explorer and the QTUM Web wallet\n  * https://github.com/qtumproject/qtuminfo-api#qtuminfo-api-documentation\n\n\nWhat is Qtum Core?\n------------------\n\nQtum Core is our primary mainnet wallet. It implements a full node and is capable of storing, validating, and distributing all history of the Qtum network. Qtum Core is considered the reference implementation for the Qtum network. \n\nQtum Core currently implements the following:\n\n* Sending/Receiving QTUM coins\n* Sending/Receiving QRC20 tokens on the Qtum network\n* Staking and creating blocks for the Qtum network\n* Creating and interacting with smart contracts\n* Running a full node for distributing the blockchain to other users\n* \"Prune\" mode, which minimizes disk usage\n* Regtest mode, which enables developers to very quickly build their own private Qtum network for Dapp testing\n* Testnet mode, using the public Qtum Testnet, with faucet available\n* Compatibility with the Bitcoin Core set of RPC commands and APIs\n* Full SegWit capability with p2sh-segwit (legacy) and bech32 (native) addresses\n\nAlternative Wallets\n-------------------\n\nQtum Core uses a full node model, and thus requires downloading the entire blockchain. If you do not need the entire blockchain, and do not intend on developing smart contracts, it may be more ideal to use an alternative wallet such as one of our light wallets that can be synchronized in a matter of seconds. \n\n### Qtum Web Wallet\n\nA browser wallet that supports the Ledger hardware wallet, offline cold wallet, restoration from mobile wallets, creation of QRC20 tokens and QRC1155 NFTs.\n\nWeb site https://qtumwallet.org\n\nUser documentation https://github.com/qtumproject/documents/tree/master/en/QTUM-WebWallet-usage\n\n### Qtum Electrum\n\nA light wallet that supports the Ledger and Trezor hardware wallets and is based on the well-known Electrum wallet software. \n\nDownload: https://github.com/qtumproject/qtum-electrum/releases\n\n### iOS and Android Wallets\n\nThese wallets run on mobile devices and synchronize quickly. \n\nAndroid Download: https://play.google.com/store/apps/details?id=org.qtum.newwallet\n\niOS Download: https://github.com/qtumproject/qtum-ios (open source, deprecated)\n\n### Qnekt Chrome Wallet\n\nThis light wallet runs in your Chrome browser as a browser extension, based on the popular MetaMask wallet.\n\n\n### Community Resources\n\nMake sure to check out these resources as well for more information and to keep up to date with all the latest news about Qtum. At least 1 developer is always around, so if you're developing on Qtum and need help, we'd love to welcome you to our community.\n\n*\t@Qtum on Twitter https://twitter.com/qtum\n* Qtum blog https://blog.qtum.org/\n*\tQtum Telegram Group https://t.me/qtumofficial, other languages available\n* Qtum Discord https://discord.com/invite/DCPGvUCms5\n*\t/r/Qtum on Reddit https://www.reddit.com/r/Qtum/\n*\tQtum.org https://qtum.org\n*\tQtum on Facebook https://www.facebook.com/QtumOfficial/\n\n### Qtum Smart Contract Limitations\n\n*\tEVM smart contracts cannot receive coins from or send coins to any address type other than pay-to-pubkeyhash (starts with Q) addresses. This is due to a limitation in the EVM\n*\tContracts are not allowed to create contracts with an initial endowment of coins. The contract must first be created, and then be sent coins in a separate transaction. Humans are also not allowed to create contracts with an initial endowment of coins.\n*\tAlthough all of the infrastructure is present, Qtum Core does not currently parse Solidity event data. You must parse this yourself using either searchlogs or -record-log-opcodes features.\n*\tIt is not possible to send a contract coins without also executing the contract. This is also the case of Ethereum. This was promised in earlier discussions and technically does work, but due to lack of time for testing this feature was disabled.\n*\tIn Qtum there can be multiple addresses used to create a proof-of-stake block. However, the EVM can only see the first output using the coinbase operation in Solidity (this address is also the one registered for the continuous staker rewards after 2000 blocks).\n\n----------\n\n# Building Qtum Core\n\n### Validate and Reproduce Binaries\n\nQtum uses a tool called Gitian to make reproducible builds that can be verified by anyone. Instructions on setting up a Gitian VM and building Qtum are provided in [Gitan Building](https://github.com/qtumproject/qtum/blob/master/doc/gitian-building.md)\n\n### Build on Ubuntu\n\nThis is a quick start script for compiling Qtum on Ubuntu\n\n```bash\n    sudo apt-get install build-essential libtool autotools-dev automake pkg-config libssl-dev libevent-dev bsdmainutils git cmake libboost-all-dev libgmp3-dev bison libtool-bin\n    sudo apt-get install software-properties-common\n    \n    # If you want to build the Qt GUI:\n    sudo apt-get install libqt5gui5 libqt5core5a libqt5dbus5 qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler qrencode\n    \n    git clone https://github.com/qtumproject/qtum\n    cd qtum\n    git submodule update --init --recursive\n\n    ./contrib/install_db4.sh `pwd`\n    export BDB_PREFIX='/path/to/qtum/db4'\n\n    cd depends\n    make\n\n    # replace x86_64-pc-linux-gnu with the appropriate folder name for your system\n    libtool --finish depends/x86_64-pc-linux-gnu/lib \n    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:`pwd`/x86_64-pc-linux-gnu/lib\n    \n    # Note: autogen will prompt to install some more dependencies if needed\n    ./contrib/install_db4.sh `pwd`\n    ./autogen.sh\n    ./configure --prefix=`pwd`/depends/x86_64-pc-linux-gnu\n    make -j$(nproc)\n```\n\n### Build on CentOS\n\nHere is a brief description for compiling Qtum on CentOS, for more details please refer to [the specific document](https://github.com/qtumproject/qtum/blob/master/doc/build-unix.md)\n\n    # Compiling boost manually\n    sudo yum install python-devel bzip2-devel\n    git clone https://github.com/boostorg/boost.git\n    cd boost\n    git checkout boost-1.66.0\n    git submodule update --init --recursive\n    ./bootstrap.sh --prefix=/usr --libdir=/usr/lib64\n    ./b2 headers\n    sudo ./b2 -j4 install\n    \n    # Installing Dependencies for Qtum\n    sudo yum install epel-release\n    sudo yum install libtool libdb4-cxx-devel openssl-devel libevent-devel gmp-devel\n    \n    # If you want to build the Qt GUI:\n    sudo yum install qt5-qttools-devel protobuf-devel qrencode-devel\n    \n    # Building Qtum\n    git clone --recursive https://github.com/qtumproject/qtum.git\n    cd qtum\n    ./autogen.sh\n    ./configure\n    make -j4\n\n### Build on Mac OS\n\nThe commands in this guide should be executed in a Terminal application.\nThe built-in one is located in `/Applications/Utilities/Terminal.app`.\n\n#### Preparation\n\nInstall the Mac OS command line tools:\n\n`xcode-select --install`\n\nWhen the popup appears, click `Install`.\n\nThen install [Homebrew](https://brew.sh).\n\n#### Dependencies\n\n    brew install cmake automake berkeley-db@4 libtool boost miniupnpc openssl pkg-config protobuf qt@5 libevent imagemagick librsvg qrencode gmp\n\nNOTE: This will work for building on Intel Macs and Apple Silicon Macs\n\nNOTE: Building with Qt4 is still supported, however, could result in a broken UI. Building with Qt5 is recommended.\n\n#### Build Qtum Core\n\n1. Clone the qtum source code and cd into `qtum`\n\n        git clone --recursive https://github.com/qtumproject/qtum.git\n        cd qtum\n\n2.  Build qtum-core:\n\n    Configure and build the headless qtum binaries as well as the GUI (if Qt is found).\n\n    You can disable the GUI build by passing `--without-gui` to configure.\n\n        ./autogen.sh\n        ./configure\n        make\n\n3.  It is recommended to build and run the unit tests:\n\n        make check\n\n### Run\n\nThen you can either run the command-line daemon using `src/qtumd` and `src/qtum-cli`, or you can run the Qt GUI using `src/qt/qtum-qt`\n\nLicense\n-------\n\nQtum is GPLv3 licensed.\n\nDevelopment Process\n-------------------\n\nThe `master` branch is regularly built and tested, but is not guaranteed to be\ncompletely stable. [Tags](https://github.com/qtumproject/qtum/tags) are created\nregularly to indicate new official, stable release versions of Qtum.\n\nThe contribution workflow is described in [CONTRIBUTING.md](https://github.com/qtumproject/qtum/blob/master/CONTRIBUTING.md)\nand useful hints for developers can be found in [doc/developer-notes.md](doc/developer-notes.md).\n\nTesting\n-------\n\nTesting and code review is the bottleneck for development; we get more pull\nrequests than we can review and test on short notice. Please be patient and help out by testing\nother people's pull requests, and remember this is a security-critical project where any mistake might cost people\nlots of money.\n\n### Automated Testing\n\nDevelopers are strongly encouraged to write [unit tests](src/test/README.md) for new code, and to\nsubmit new unit tests for old code. Unit tests can be compiled and run\n(assuming they weren't disabled in configure) with: `make check`. Further details on running\nand extending unit tests can be found in [/src/test/README.md](/src/test/README.md).\n\nThere are also [regression and integration tests](/test), written\nin Python.\nThese tests can be run (if the [test dependencies](/test) are installed) with: `test/functional/test_runner.py`\n\nThe CI (Continuous Integration) systems make sure that every pull request is built for Windows, Linux, and macOS,\nand that unit/sanity tests are run automatically.\n\n### Manual Quality Assurance (QA) Testing\n\nChanges should be tested by somebody other than the developer who wrote the\ncode. This is especially important for large or high-risk changes. It is useful\nto add a test plan to the pull request description if testing the changes is\nnot straightforward.\n\nTranslations\n------------\n\nChanges to translations as well as new translations can be submitted to\n[Bitcoin Core's Transifex page](https://www.transifex.com/bitcoin/bitcoin/).\n\nTranslations are periodically pulled from Transifex and merged into the git repository. See the\n[translation process](doc/translation_process.md) for details on how this works.\n\n**Important**: We do not accept translation changes as GitHub pull requests because the next\npull from Transifex would automatically overwrite them again.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqtumproject%2Fqtum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqtumproject%2Fqtum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqtumproject%2Fqtum/lists"}