4 releases (2 breaking)

0.3.0 May 28, 2020
0.2.0 May 7, 2020
0.1.1 Jan 2, 2020
0.1.0 Dec 2, 2019

#4 in #gwasm

GPL-3.0 license

41KB
654 lines

gwasm-api

A Rust library for interfacing your native apps with gWasm.

Crates.io version Download docs.rs docs

Guide

gWasm is Golem's new meta use-case which allows Golem's developers/users to deploy their Wasm apps on Golem Network. This API providers convenience structures and functions for creating a gWasm task and connecting with Golem Network all from native Rust code.

# Cargo.toml
gwasm-api = "0.3"

Example

use gwasm_api::prelude::*;
use anyhow::Result;
use std::path::PathBuf;

struct ProgressTracker;

impl ProgressUpdate for ProgressTracker {
    fn update(&self, progress: f64) {
        println!("Current progress = {}", progress);
    }
}

fn main() -> Result<()> {
    let binary = GWasmBinary {
        js: &[0u8; 100],   // JavaScript file generated by Emscripten
        wasm: &[0u8; 100], // Wasm binary generated by Emscripten
    };
    let task = TaskBuilder::try_new("workspace", binary)?
        .push_subtask_data(vec![0u8; 100])
        .build()?;
    let computed_task = compute(
        PathBuf::from("datadir"),
        "127.0.0.1".to_string(),
        61000,
        Net::TestNet,
        task,
        ProgressTracker,
    )?;

    for subtask in computed_task.subtasks {
        for (_, reader) in subtask.data {
            assert!(!reader.buffer().is_empty());
        }
    }

    Ok(())
}

More examples

  • g-flite is a CLI which uses gwasm-api internally

License

Licensed under GPLv3

Dependencies

~32–44MB
~813K SLoC