exonum-api
cargo install exonum-api

exonum-api

An extensible open-source framework for creating private/permissioned blockchain applications

by exonum

1.0.0 (see all)License:Apache-2.0
cargo install exonum-api
Readme

HTTP API engine for Exonum

Travis Build Status License: Apache-2.0 rust 1.42.0+ required

exonum-api crate provides an extensible interface for building backend-agnostic HTTP APIs. Within Exonum, this crate is used by Rust services and in plugins for the Exonum node.

Under the hood exonum-api uses actix.

Consult the crate docs for more details.

Examples

Providing HTTP API for a plugin:

use exonum_api::{ApiBuilder};
use serde_derive::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
pub struct SomeQuery {
    pub first: u64,
    pub second: u64,
}

fn create_api() -> ApiBuilder {
    let mut builder = ApiBuilder::new();
    builder
        .public_scope()
        .endpoint("some", |query: SomeQuery| {
            Ok(query.first + query.second)
        });
    builder
}

let builder = create_api();
// `builder` can now be passed to the node via plugin interface
// or via node channel.

Usage

Include exonum-api as a dependency in your Cargo.toml:

[dependencies]
exonum-api = "1.0.0"

Note that the crate rarely needs to be imported directly; it is re-exported by the exonum crate.

License

exonum-api is licensed under the Apache License (Version 2.0). See LICENSE for details.

GitHub Stars

1.1K

LAST COMMIT

9mos ago

MAINTAINERS

1

CONTRIBUTORS

85

OPEN ISSUES

35

OPEN PRs

14
VersionTagPublished
1.0.0
2yrs ago
1.0.0-rc.3
2yrs ago
1.0.0-rc.2
2yrs ago
1.0.0-rc.1
2yrs ago
No alternatives found
No tutorials found
Add a tutorial