Skip to content

Commit

Permalink
docs: add README for zinniad (#203)
Browse files Browse the repository at this point in the history
* docs: add README for `zinniad`
* docs: add zinnia-linux-arm64 to the download table

---------

Signed-off-by: Miroslav Bajtoš <[email protected]>
  • Loading branch information
bajtos authored May 10, 2023
1 parent fd0983b commit e4e37c1
Show file tree
Hide file tree
Showing 2 changed files with 64 additions and 6 deletions.
13 changes: 7 additions & 6 deletions cli/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,12 +19,13 @@ executable.
You can download the `zinnia` binary from
[our GitHub Releases](https://github.com/filecoin-station/zinnia/releases/latest).

| OS | Platform | Filename |
| ------- | ------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Windows | Intel, 64bit | [zinnia-windows-x64.zip](https://github.com/filecoin-station/zinnia/releases/latest/download/zinnia-windows-x64.zip) |
| macOS | Intel, 64bit | [zinnia-macos-x64.zip](https://github.com/filecoin-station/zinnia/releases/latest/download/zinnia-macos-x64.zip) |
| macOS | Apple Silicon | [zinnia-macos-arm64.zip](https://github.com/filecoin-station/zinnia/releases/latest/download/zinnia-macos-arm64.zip) |
| Linux | Intel, 64bit | [zinnia-linux-x64.tar.gz](https://github.com/filecoin-station/zinnia/releases/latest/download/zinnia-linux-x64.tar.gz) |
| OS | Platform | Filename |
| ------- | ------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Windows | Intel, 64bit | [zinnia-windows-x64.zip](https://github.com/filecoin-station/zinnia/releases/latest/download/zinnia-windows-x64.zip) |
| macOS | Intel, 64bit | [zinnia-macos-x64.zip](https://github.com/filecoin-station/zinnia/releases/latest/download/zinnia-macos-x64.zip) |
| macOS | Apple Silicon | [zinnia-macos-arm64.zip](https://github.com/filecoin-station/zinnia/releases/latest/download/zinnia-macos-arm64.zip) |
| Linux | Intel, 64bit | [zinnia-linux-x64.tar.gz](https://github.com/filecoin-station/zinnia/releases/latest/download/zinnia-linux-x64.tar.gz) |
| Linux | ARM, 64bit | [zinnia-linux-arm64.tar.gz](https://github.com/filecoin-station/zinnia/releases/latest/download/zinnia-linux-arm64.tar.gz) |

### Build from source

Expand Down
57 changes: 57 additions & 0 deletions daemon/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
<h1 align="center">
<br>
🌼
<br>
<br>
Zinnia Daemon
<br>
<br>
<br>
</h1>

[![crates](https://img.shields.io/crates/v/zinnia.svg)](https://crates.io/crates/zinnia)

Zinnia is a runtime for Filecoin Station modules. This crate provides a daemon to run Zinnia Modules
inside Filecoin Station.

## Installation

You can download the `zinniad` binary from
[our GitHub Releases](https://github.com/filecoin-station/zinnia/releases/latest).

| OS | Platform | Filename |
| ------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Windows | Intel, 64bit | [zinniad-windows-x64.zip](https://github.com/filecoin-station/zinnia/releases/latest/download/zinniad-windows-x64.zip) |
| macOS | Intel, 64bit | [zinniad-macos-x64.zip](https://github.com/filecoin-station/zinnia/releases/latest/download/zinniad-macos-x64.zip) |
| macOS | Apple Silicon | [zinniad-macos-arm64.zip](https://github.com/filecoin-station/zinnia/releases/latest/download/zinniad-macos-arm64.zip) |
| Linux | Intel, 64bit | [zinniad-linux-x64.tar.gz](https://github.com/filecoin-station/zinnia/releases/latest/download/zinniad-linux-x64.tar.gz) |
| Linux | ARM, 64bit | [zinniad-linux-arm64.tar.gz](https://github.com/filecoin-station/zinnia/releases/latest/download/zinniad-linux-arm64.tar.gz) |

### Build from source

If you have Rust tooling installed on your machine (see
[Install Rust](https://www.rust-lang.org/tools/install)), you can build & install Zinnia from the
source code.

```sh
$ cargo install zinniad
```

## Basic use

### Run a JavaScript module

```
FIL_WALLET_ADDRESS=f1... \
zinniad my-module/main.js
```

See [Building Modules](./docs/building-modules.md) for how to write new modules for Filecoin
Station.

> Note: We don't support running more than one Zinnia module in the Filecoin Station yet. Tracking
> issue: [zinnia#144](https://github.com/filecoin-station/zinnia/issues/144)
### Run a Rust module

We have decided to put Rust/WASM modules on hold for now.

0 comments on commit e4e37c1

Please sign in to comment.