What is Ideology?
Ideology 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 Ideology's Bitcoin-like UTXO blockchain. For more general information about Ideology as well as links to join our community, go to https://ideo.org
Welcome to the Ideology Ignition 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 Ideology, we highly recommend using either testnet or regtest mode.
The major features of the Ideology network include:
- 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 Ideology.
- A Proof of Stake consensus system which is optimized for Ideology'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 Ideology that have created blocks in the past. Staking from smart contracts is under development.
- 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.
- Uses the UTXO transaction model and is compatible with Bitcoin, allowing for existing tooling and workflows to be used with Ideology. This allows for the infamous SPV protocol to be used which is ideal for light wallets on mobile phones and IoT devices.
Note: Ideology Core is considered beta software. We make no warranties or guarantees of its security or stability.
Ideology Documentation and Usage Resources
These are some resources that might be helpful in understanding Ideology.
Basic usage resources:
- User guide
- Ideology-Qt Wallet Tutorial
- Ideology staking tutorial
- Ideology tutorial on Raspberry Pi
- Running Ideology on Amazon AWS using Ideology AMI
- Encrypting and unlocking wallet
- Testnet guide
- Block explorer, Older explorer
- Ideology Book - A Developer's Guide To IDEO
- Ideology contract usage
- Deploying a custom token to Ideology
- IdeologyJS document
- Smart contract ICO example
- Early example faucet contract
General Info about Ideology:
- CIRCLERESEARCH Ideology Primer
- Ideology's PoS vs CASPER
- Technical article explaining Ideology's PoS model in depth
- Smart contract deployment tool
- A toolkit for building ideo light wallets
- CORS ideod RPC proxy for DApp
- Docker images for running ideo services
- ideo.info API that powers the block explorer and the IDEO Web wallet
What is Ideology Core?
Ideology Core is our primary mainnet wallet. It implements a full node and is capable of storing, validating, and distributing all history of the Ideology network. Ideology Core is considered the reference implementation for the Ideology network.
Ideology Core currently implements the following:
- Sending/Receiving IDEO coins
- Sending/Receiving QRC20 tokens on the Ideology network
- Staking and creating blocks for the Ideology network
- Creating and interacting with smart contracts
- Running a full node for distributing the blockchain to other users
- "Prune" mode, which minimizes disk usage
- Regtest mode, which enables developers to very quickly build their own private Ideology network for Dapp testing
- Testnet mode, using the public Ideology Testnet, with faucet available
- Compatibility with the Bitcoin Core set of RPC commands and APIs
- Full SegWit capability with p2sh-segwit (legacy) and bech32 (native) addresses
Ideology 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.
Ideology Web Wallet
A browser wallet that supports the Ledger hardware wallet, offline cold wallet, and restoration from mobile wallets.
Web site https://ideowallet.org
User documentation https://github.com/ideoproject/documents/tree/master/en/IDEO-WebWallet-usage
A light wallet that supports the Ledger and Trezor hardware wallets and is based on the well-known Electrum wallet software.
iOS and Android Wallets
These wallets run on mobile devices and synchronize quickly.
Android Download: https://play.google.com/store/apps/details?id=org.ideo.wallet
iOS Download: https://github.com/ideoproject/ideo-ios (open source, we are still working with Apple to get approval for their app store)
Ledger Chrome Wallet
This light wallet runs in your Chrome browser as a browser extension. This wallet requires a Ledger device to use.
Make sure to check out these resources as well for more information and to keep up to date with all the latest news about Ideology. At least 1 developer is always around, so if you're developing on Ideology and need help, we'd love to welcome you to our community.
- @IdeologyOfficial on Twitter https://twitter.com/ideoofficial
- Ideology blog https://blog.ideo.org/
- Ideology Telegram Group https://t.me/ideoofficial, other languages available
- Ideology Discord https://discordapp.com/invite/wRfmkQ9
- /r/Ideology on Reddit https://www.reddit.com/r/Ideology/
- Ideology.org https://ideo.org
- Ideology on Facebook https://www.facebook.com/IdeologyOfficial/
- Ideology Forum https://forum.ideo.org
Ideology Smart Contract Limitations
- EVM 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
- Contracts 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.
- Although all of the infrastructure is present, Ideology Core does not currently parse Solidity event data. You must parse this yourself using either searchlogs or -record-log-opcodes features.
- It 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. We hope to reenable this feature with release of the x86 virtual machine in 2020.
- In Ideology 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 500 blocks).
Building Ideology Core
Validate and Reproduce Binaries
Ideology uses a tool called Gitian to make reproducible builds that can be verified by anyone. Instructions on setting up a Gitian VM and building Ideology are provided in Gitan Building
Build on Ubuntu
This is a quick start script for compiling Ideology on Ubuntu
sudo apt-get install build-essential libtool autotools-dev automake pkg-config libssl-dev libevent-dev bsdmainutils git cmake libboost-all-dev sudo apt-get install software-properties-common sudo add-apt-repository ppa:bitcoin/bitcoin sudo apt-get update sudo apt-get install libdb4.8-dev libdb4.8++-dev # If you want to build the Qt GUI: sudo apt-get install libqt5gui5 libqt5core5a libqt5dbus5 qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler qrencode git clone https://github.com/ideoproject/ideo --recursive cd ideo # Note autogen will prompt to install some more dependencies if needed ./autogen.sh ./configure make -j2
Build on CentOS
Here is a brief description for compiling Ideology on CentOS, for more details please refer to the specific document
# Compiling boost manually sudo yum install python-devel bzip2-devel git clone https://github.com/boostorg/boost.git cd boost git checkout boost-1.66.0 git submodule update --init --recursive ./bootstrap.sh --prefix=/usr --libdir=/usr/lib64 ./b2 headers sudo ./b2 -j4 install # Installing Dependencies for Ideology sudo yum install epel-release sudo yum install libtool libdb4-cxx-devel openssl-devel libevent-devel # If you want to build the Qt GUI: sudo yum install qt5-qttools-devel protobuf-devel qrencode-devel # Building Ideology git clone --recursive https://github.com/ideoproject/ideo.git cd ideo ./autogen.sh ./configure make -j4
Build on OSX
The commands in this guide should be executed in a Terminal application.
The built-in one is located in
Install the OS X command line tools:
When the popup appears, click
Then install Homebrew.
brew install cmake automake berkeley-db4 libtool boost --c++11 --without-single --without-static miniupnpc openssl pkg-config protobuf qt5 libevent imagemagick --with-librsvg qrencode
NOTE: Building with Qt4 is still supported, however, could result in a broken UI. Building with Qt5 is recommended.
Build Ideology Core
Clone the ideo source code and cd into
git clone --recursive https://github.com/ideoproject/ideo.git cd ideo
Configure and build the headless ideo binaries as well as the GUI (if Qt is found).
You can disable the GUI build by passing
./autogen.sh ./configure make
It is recommended to build and run the unit tests:
Then you can either run the command-line daemon using
src/ideo-cli, or you can run the Qt GUI using
Ideology is GPLv3 licensed.
master branch is regularly built and tested, but is not guaranteed to be
completely stable. Tags are created
regularly to indicate new official, stable release versions of Ideology.
The contribution workflow is described in CONTRIBUTING.md.
Testing and code review is the bottleneck for development; we get more pull requests than we can review and test on short notice. Please be patient and help out by testing other people's pull requests, and remember this is a security-critical project where any mistake might cost people lots of money.
Developers are strongly encouraged to write unit tests for new code, and to
submit new unit tests for old code. Unit tests can be compiled and run
(assuming they weren't disabled in configure) with:
make check. Further details on running
and extending unit tests can be found in /src/test/README.md.
There are also regression and integration tests, written
in Python, that are run automatically on the build server.
These tests can be run (if the test dependencies are installed) with:
Manual Quality Assurance (QA) Testing
Changes should be tested by somebody other than the developer who wrote the code. This is especially important for large or high-risk changes. It is useful to add a test plan to the pull request description if testing the changes is not straightforward.