#contracts #parachain #polkadot #run-time #substrate #pallet #rococo

no-std contracts-rococo-runtime

Parachain testnet runtime for FRAME Contracts pallet. (polkadot v1.9.0)

10 breaking releases

new 0.11.0 Mar 19, 2024
0.9.0 Feb 13, 2024
0.7.0 Dec 13, 2023
0.6.0 Nov 21, 2023
0.0.0 Nov 14, 2022

#235 in Magic Beans

Download history 5/week @ 2023-12-10 6/week @ 2024-01-21 30/week @ 2024-02-11 12/week @ 2024-02-18 179/week @ 2024-02-25 12/week @ 2024-03-03 29/week @ 2024-03-10

235 downloads per month
Used in polkadot-parachain-bin

Apache-2.0 and GPL-3.0-only

78KB
1K SLoC

Contracts 📝

This is a parachain node for smart contracts; it contains a default configuration of Substrate's module for smart contracts ‒ the pallet-contracts.

The node is only available on Rococo, a testnet for Polkadot and Kusama parachains. It has been configured as a common good parachain, as such it uses the Rococo relay chain's native token ROC instead of defining a token of its own. See the section Rococo Deployment below for more details.

If you have any questions, it's best to ask in the Substrate StackExchange.

Smart Contracts Development

This node contains Substrate's smart contracts module ‒ the pallet-contracts. This pallet takes smart contracts as WebAssembly blobs and defines an API for everything a smart contract needs (storage access, …). As long as a programming language compiles to WebAssembly and there exists an implementation of this API in it, you can write a smart contract for this pallet (and thus for this parachain) in that language.

This is a list of languages you can currently choose from:

There are also different user interfaces and command-line tools you can use to deploy or interact with contracts:

  • Contracts UI ‒ a beginner-friendly UI for smart contract developers.
  • polkadot-js ‒ the go-to expert UI for smart contract developers.
  • cargo-contract ‒ a CLI tool, ideal for scripting or your terminal workflow.

If you are looking for a quickstart, we can recommend ink!'s Guided Tutorial for Beginners.

Build & Launch a Node

To run a Contracts node that connects to Rococo you will need to compile the polkadot-parachain binary:

cargo build --release --locked --bin polkadot-parachain

Once the executable is built, launch the parachain node via:

./target/release/polkadot-parachain --chain contracts-rococo

Refer to the setup instructions to run a local network for development.

Rococo Deployment

We have a live deployment on Rococo ‒ a testnet for Polkadot and Kusama parachains.

You can interact with the network through Polkadot JS Apps, click here for a direct link to the parachain.

This parachain uses the Rococo relay chain's native token ROC instead of defining a token of its own. Due to this you'll need ROC in order to deploy contracts on this parachain.

As a first step, you should create an account. See here for a detailed guide.

As a second step, you have to get ROC testnet tokens through the Rococo Faucet. This is a chat room in which you'd need to post the following message:

!drip YOUR_SS_58_ADDRESS:1002

The number 1002 is the id of this parachain on Rococo, by supplying it the faucet will teleport ROC tokens directly to your account on the parachain.

If everything worked out, the teleported ROC tokens will show up under the "Accounts" tab.

Once you have ROC you can deploy a contract as you would normally. If you're unsure about this, our guided tutorial will clarify that for you in no time.

Dependencies

~38–60MB
~1M SLoC