Linera is a decentralized blockchain infrastructure designed for highly scalable, low-latency Web3 applications.
Visit our developer page and read our whitepaper to learn more about the Linera protocol.
The main crates and directories of this repository can be summarized as follows: (listed from low to high levels in the dependency graph)
-
linera-baseBase definitions, including cryptography. -
linera-versionA library to manage version info in binaries and services. -
linera-viewsA library mapping complex data structures onto a key-value store. The corresponding procedural macros are implemented inlinera-views-derive. -
linera-executionPersistent data and the corresponding logic for runtime and execution of Linera applications. -
linera-chainPersistent data and the corresponding logic for chains of blocks, certificates, and cross-chain messaging. -
linera-storageDefines the storage abstractions for the protocol on top oflinera-chain. -
linera-coreThe core Linera protocol, including client and server logic, node synchronization, etc. -
linera-rpcDefines the data-type for RPC messages (currently all client ↔ proxy ↔ chain ↔ chain interactions), and track the corresponding data schemas. -
linera-clientLibrary for writing Linera clients. Used for the command-line client and the node service inlinera-service, as well as the Web client inlinera-web. -
linera-serviceExecutable for clients (aka CLI wallets), proxy (aka validator frontend) and servers. -
linera-sdkThe library to develop Linera applications written in Rust for the Wasm virtual machine. The corresponding procedural macros are implemented inlinera-sdk-derive. -
examplesExamples of Linera applications written in Rust.
The following commands set up a local test network and run some transfers between the microchains owned by a single wallet.
# 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_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="User:${INFO1[3]}"
CHAIN2="${INFO2[0]}"
ACCOUNT2="User:${INFO2[3]}"
# 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:$ACCOUNT
6183
1"
linera transfer 2 --from "$CHAIN1:$ACCOUNT1" --to "$CHAIN2:$ACCOUNT2"
# Query user balances again.
linera query-balance "$CHAIN1:$ACCOUNT1"
linera query-balance "$CHAIN2:$ACCOUNT2"
# TODO(#1713): The syntax `User:$OWNER` for user accounts will change in the future.More complex examples may be found in our developer manual as well as the example applications in this repository.