Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/linera-io/linera-protocol

Main repository for the Linera protocol
https://github.com/linera-io/linera-protocol

blockchain rust wasm

Last synced: about 2 months ago
JSON representation

Main repository for the Linera protocol

Host: GitHub
URL: https://github.com/linera-io/linera-protocol
Owner: linera-io
License: apache-2.0
Created: 2021-12-19T04:09:21.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2024-11-26T16:05:50.000Z (about 2 months ago)
Last Synced: 2024-11-26T16:24:09.229Z (about 2 months ago)
Topics: blockchain, rust, wasm
Language: Rust
Homepage:
Size: 141 MB
Stars: 1,443
Watchers: 16
Forks: 169
Open Issues: 404
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

        # 

[![License](https://img.shields.io/badge/license-Apache-green.svg)](LICENSE)

[![Build Status for Rust](https://github.com/linera-io/linera-protocol/actions/workflows/rust.yml/badge.svg)](https://github.com/linera-io/linera-protocol/actions/workflows/rust.yml)

[![Build Status for Documentation](https://github.com/linera-io/linera-protocol/actions/workflows/documentation.yml/badge.svg)](https://github.com/linera-io/linera-protocol/actions/workflows/documentation.yml)

[![Build Status for DynamoDB](https://github.com/linera-io/linera-protocol/actions/workflows/dynamodb.yml/badge.svg)](https://github.com/linera-io/linera-protocol/actions/workflows/dynamodb.yml)

[Linera](https://linera.io) is a decentralized blockchain infrastructure designed for highly scalable,

low-latency Web3 applications.

Visit our [developer page](https://linera.dev) and read our

[whitepaper](https://linera.io/whitepaper) to learn more about the Linera protocol.

## Repository Structure

The main crates and directories of this repository can be summarized as follows: (listed

from low to high levels in the dependency graph)

* [`linera-base`](https://linera-io.github.io/linera-protocol/linera_base/index.html) Base

  definitions, including cryptography.

* [`linera-version`](https://linera-io.github.io/linera-protocol/linera_version/index.html)

  A library to manage version infos in binaries and services.

* [`linera-views`](https://linera-io.github.io/linera-protocol/linera_views/index.html) A

  library mapping complex data structures onto a key-value store. The corresponding

  procedural macros are implemented in `linera-views-derive`.

* [`linera-execution`](https://linera-io.github.io/linera-protocol/linera_execution/index.html)

  Persistent data and the corresponding logics for runtime and execution of Linera

  applications.

* [`linera-chain`](https://linera-io.github.io/linera-protocol/linera_chain/index.html)

  Persistent data and the corresponding logics for chains of blocks, certificates, and

  cross-chain messaging.

* [`linera-storage`](https://linera-io.github.io/linera-protocol/linera_storage/index.html)

  Defines the storage abstractions for the protocol on top of `linera-chain`.

* [`linera-core`](https://linera-io.github.io/linera-protocol/linera_core/index.html) The

  core Linera protocol, including client and server logic, node synchronization, etc.

* [`linera-rpc`](https://linera-io.github.io/linera-protocol/linera_rpc/index.html)

  Defines the data-type for RPC messages (currently all client ↔ proxy ↔

  chain ↔ chain interactions), and track the corresponding data schemas.

* [`linera-client`](https://linera-io.github.io/linera-protocol/linera_client/index.html)

  Library for writing Linera clients.  Used for the command-line

  client and the node service in `linera-service`, as well as the Web

  client in [`linera-web`](https://github.com/linera-io/linera-web/).

* [`linera-service`](https://linera-io.github.io/linera-protocol/linera_service/index.html)

  Executable for clients (aka CLI wallets), proxy (aka validator frontend) and servers.

* [`linera-sdk`](https://linera-io.github.io/linera-protocol/linera_sdk/index.html) The

  library to develop Linera applications written in Rust for the Wasm virtual machine. The

  corresponding procedural macros are implemented in `linera-sdk-derive`.

* [`examples`](./examples) Examples of Linera applications written in Rust.

## Quickstart with the Linera service CLI

The following commands set up a local test network and run some transfers between the

microchains owned by a single wallet.

```bash

# Make sure to compile the Linera binaries and add them in the $PATH.

# cargo build -p linera-storage-service -p linera-service --bins --features storage-service

export PATH="$PWD/target/debug:$PATH"

# Import the optional helper function `linera_spawn_and_read_wallet_variables`.

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. (The helper function `linera_spawn_and_read_wallet_variables`

# is used to set the two environment variables LINERA_{WALLET,STORAGE}.)

linera_spawn_and_read_wallet_variables \

linera net up

# Print the set of validators.

linera query-validators

# Query the chain balance of some of the chains.

CHAIN1="e476187f6ddfeb9d588c7b45d3df334d5501d6499b3f9ad5595cae86cce16a65"

CHAIN2="69705f85ac4c9fef6c02b4d83426aaaf05154c645ec1c61665f8e450f0468bc0"

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"

```

More complex examples may be found in our [developer manual](https://linera.dev) as well

as the [example applications](./examples) in this repository.