Getting Started

Set up your development environment, connect to BelizeChain, and deploy your first smart contract in under 15 minutes.

Prerequisites

RustLatest stableRuntime and contract development

cargo-contractLatestink! smart contract toolchain

Node.js24.x LTSSDK and tooling

BelizeChain NodeLatestLocal development blockchain

Clone the BelizeChain repository and build the node binary. This compiles the Substrate runtime with all 19 custom pallets.

git clone https://github.com/BelizeChain/belizechain.git
cd belizechain && cargo build --release

Launch a single-node development chain with temporary storage. The node will produce blocks on demand when transactions are submitted.

./target/release/belizechain-node --dev --tmp

Install cargo-contract to compile, deploy, and interact with ink! smart contracts on BelizeChain.

cargo install cargo-contract --force

Scaffold a new ink! contract, build it, and deploy to your local node. The hello-belizechain example shows the basic pattern.

cargo contract new hello_belize
cd hello_belize && cargo contract build --release

Install the GEM SDK to interact with contracts from JavaScript or TypeScript.

npm install @belizechain/gem-sdk @polkadot/api @polkadot/api-contract

Default ports for local development.

WebSocket RPCws://localhost:9944

HTTP RPChttp://localhost:9944