An all-in-one tool for Polkadot development.
You can install Pop CLI as follows:
cargo install --locked --git https://github.com/r0gue-io/pop-cli
ℹ️ A crates.io version will be available soon!
Use pop
to create a new Parachain project:
# Create a minimal parachain
pop new parachain my-app
# Get a pallet-contracts enabled parachain
pop new parachain my-app cpt
# Get a evm compatible parachain
pop new parachain my-app fpt
Use pop
to build your Parachain:
# Build your parachain
pop build parachain -p ./my-app
or
cd my-app
pop build parachain
You can also customize your parachain by providing config options for token symbol (as it appears in chain metadata), token decimals, and the initial endowment for developer accounts. Here's how:
# Create a minimal parachain with "DOT" as token symbol, 6 token decimals and 1 billion tokens per dev account
pop new parachain my-app --symbol DOT --decimals 6 --endowment 1_000_000_000
There's also the shorter version:
pop new parachain my-app -s DOT -d 6 -i 1_000_000_000
Finally, to build your Parachain:
cd my-app
pop build parachain --release
You can spawn a local network using zombienet as follows:
pop up parachain -f ./tests/zombienet.toml -p https://github.com/r0gue-io/pop-node
ℹ️ Pop CLI will automatically source the necessary polkadot binaries. Currently, these will be built if on a non-linux system.
Use pop
to create a new Smart Contract project:
# Create a minimal Smart Contract
pop new contract my_contract
Test the Smart Contract:
# Test an existing Smart Contract
pop test contract -p ./my_contract
Build the Smart Contract:
# Build an existing Smart Contract
pop build contract -p ./my_contract
To deploy a Smart Contract you need a chain running. For testing purposes one option is to run substrate-contracts-node:
cargo install contracts-node
substrate-contracts-node
ℹ️ We plan to automate this in the future.
Deploy and instantiate the Smart Contract:
pop up contract -p ./my_contract --constructor new --args "false" --suri //Alice
Some of the options available are:
- Specify the contract
constructor
to use, which in this example isnew()
. - Specify the argument (
args
) to the constructor, which in this example isfalse
. - Specify the account uploading and instantiating the contract with
--suri
, which in this example is the default development account of//Alice
. For other accounts, the actual secret key must be provided e.g. an 0x prefixed 64 bit hex string, or the seed phrase.
⚠️ Use only for development: Use a safer method of signing here before using this feature with production projects. We will be looking to provide alternative solutions in the future!
- You also can specify the url of your node with
--url ws://your-endpoint
, by default it is usingws://localhost:9944
.
For more information about the options, check cargo-contract documentation
Interacting with the Smart Contract:
- Read-only Operations: For operations that only require reading from the blockchain state. This approach does not require to submit an extrinsic. Example using the get() message:
pop call contract -p ./my_contract --contract $INSTANTIATED_CONTRACT_ADDRESS --message get --suri //Alice
- State-modifying Operations: For operations that change a storage value, thus altering the blockchain state. Include
the
x / --execute
flag to submit an extrinsic on-chain.
Example executing the flip()
message:
pop call contract -p ./my_contract --contract $INSTANTIATED_CONTRACT_ADDRESS --message flip --suri //Alice -x
For end-to-end testing you will need to have a Substrate node with pallet contracts
.
You do not need to run it in the background since the node is started for each test independently.
To install the latest version:
cargo install contracts-node --git https://github.com/paritytech/substrate-contracts-node.git
If you want to run any other node with pallet-contracts
you need to change CONTRACTS_NODE
environment variable:
export CONTRACTS_NODE="YOUR_CONTRACTS_NODE_PATH"
Run e2e testing on the Smart Contract:
# Run e2e tests for an existing smart contract
pop test contract -p ./my_contract --features e2e-tests
To create a new Pallet, simply run pop new pallet
. You will have a new pallet ready for hacking.
To customize the new Pallet you can follow these options:
# create a pallet with name `pallet-awesome` in the current working directory
pop new pallet pallet-awesome
# or with options
pop new pallet pallet-awesome --authors Me --description "This pallet oozes awesomeness" --path my_app/pallets
Build the tool locally with all the features:
cargo build --all-features
Build the tool only for Parachain functionality:
cargo build --features parachain
Build the tool only for Smart Contracts functionality:
cargo build --features contract
To test the tool locally.
Run the unit tests:
cargo test
Due to the time it can take to build a Parachain or a Smart Contract, some tests have been separated from the normal testing flow.
To run the unit tests that involves building a Smart Contract:
cargo test --features unit_contract
To run the unit tests that involves building a Parachain:
cargo test --features unit_parachain
Then we have some tests that check all the flows are correct:
Run the e2e tests for Smart Contracts functionality:
cargo test --features e2e_contract
Run the e2e tests for Parachain functionality:
cargo test --features e2e_parachain
Run all tests:
cargo test --all-features
Pop CLI would not be possible without these awesome crates!
- Local network deployment powered by zombienet-sdk
- cargo contract a setup and deployment tool for developing Wasm based Smart Contracts via ink!
The entire code within this repository is licensed under the GPLv3.
Please contact us if you have questions about the licensing of our products.