Linera Protocol: Scalable Decentralized Blockchain Infrastructure

Introduction

The linera-protocol repository houses the core components of Linera, a cutting-edge decentralized blockchain infrastructure. Designed for highly scalable, secure, and low-latency Web3 applications, Linera aims to redefine the capabilities of decentralized systems. Leveraging Rust and WebAssembly (Wasm), it offers a robust and performant environment for decentralized application development. With over 31,000 stars on GitHub, it's a project gaining significant traction in the blockchain community. For a deeper dive, explore their developer page and whitepaper.

Installation

To get started with Linera Protocol, you'll need to set up your development environment. Refer to the official INSTALL.md guide within the repository for detailed software requirements. Once prerequisites are met, you can quickly set up a local test network using the Linera CLI tool:

# Make sure to compile the Linera binaries and add them in the $PATH.
# cargo build -p linera-storage-service -p linera-service --bins
export PATH="$PWD/target/debug:$PATH"

# Import the optional helper function `linera_spawn`.
source /dev/stdin <<<"$(linera net helper 2>/dev/null)"

# Run a local test network with the default parameters and a number of microchains
# owned by the default wallet. This also defines `LINERA_TMP_DIR`.
linera_spawn \
linera net up --with-faucet --faucet-port 8080

# Remember the URL of the faucet.
FAUCET_URL=http://localhost:8080

# If you're using a testnet, start here and run this instead:
#   LINERA_TMP_DIR=$(mktemp -d)
#   FAUCET_URL=https://faucet.testnet-XXX.linera.net  # for some value XXX

# Set the path of the future wallet.
export LINERA_WALLET="$LINERA_TMP_DIR/wallet.json"
export LINERA_KEYSTORE="$LINERA_TMP_DIR/keystore.json"
export LINERA_STORAGE="rocksdb:$LINERA_TMP_DIR/client.db"

# Initialize a new user wallet.
linera wallet init --faucet $FAUCET_URL

# Request chains.
INFO1=($(linera wallet request-chain --faucet $FAUCET_URL))
INFO2=($(linera wallet request-chain --faucet $FAUCET_URL))
CHAIN1="${INFO1[0]}"
ACCOUNT1="${INFO1[1]}"
CHAIN2="${INFO2[0]}"
ACCOUNT2="${INFO2[1]}"

# Show the different chains tracked by the wallet.
linera wallet show

# Query the chain balance of some of the chains.
linera query-balance "$CHAIN1"
linera query-balance "$CHAIN2"

# Transfer 10 units then 5 back.
linera transfer 10 --from "$CHAIN1" --to "$CHAIN2"
linera transfer 5 --from "$CHAIN2" --to "$CHAIN1"

# Query balances again.
linera query-balance "$CHAIN1"
linera query-balance "$CHAIN2"

# Now let's fund the user balances.
linera transfer 5 --from "$CHAIN1" --to "$CHAIN1:$ACCOUNT1"
linera transfer 2 --from "$CHAIN1:$ACCOUNT1" --to "$CHAIN2:$ACCOUNT2"

# Query user balances again.
linera query-balance "$CHAIN1:$ACCOUNT1"
linera query-balance "$CHAIN2:$ACCOUNT2"

These commands will help you compile the necessary binaries, set up a local test network, and initialize a wallet to perform transfers between microchains.

Examples

The linera-protocol repository includes a comprehensive quickstart guide to demonstrate its core functionalities. The provided example walks you through setting up a local Linera network, initializing a user wallet, requesting new chains, and performing token transfers. You can observe how to query chain balances and manage user accounts, showcasing the protocol's basic operations. For more complex use cases and application examples, refer to the examples directory in the repository and the developer manual.

Why Use Linera Protocol

Linera Protocol stands out as a powerful solution for developers building decentralized applications that demand high performance and scalability. Its architecture is specifically designed to handle a large volume of transactions with low latency, making it suitable for demanding Web3 use cases. The use of Rust ensures memory safety and performance, while Wasm support allows for flexible and secure smart contract execution. Its decentralized nature and focus on security provide a trustworthy foundation for innovative blockchain applications.