https://github.com/fee1-dead/flow.rs

Rust SDK for the Flow blockchain network
https://github.com/fee1-dead/flow.rs

blockchain flow nft rust sdk

Last synced: about 2 months ago
JSON representation

Rust SDK for the Flow blockchain network

• Host: GitHub
• URL: https://github.com/fee1-dead/flow.rs
• Owner: fee1-dead
• Created: 2021-09-19T10:31:51.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2021-11-12T04:28:00.000Z (about 3 years ago)
• Last Synced: 2024-10-19T14:02:00.016Z (3 months ago)
• Topics: blockchain, flow, nft, rust, sdk
• Language: Rust
• Homepage:
• Size: 21.3 MB
• Stars: 8
• Watchers: 2
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Flow Rust SDK

[![CI](https://github.com/fee1-dead/flow.rs/actions/workflows/ci.yml/badge.svg)](https://github.com/fee1-dead/flow.rs/actions/workflows/ci.yml)

[![Crates.io](https://img.shields.io/crates/v/flow-sdk)](https://crates.io/crates/flow-sdk)

[![docs.rs](https://img.shields.io/docsrs/flow-sdk)](https://docs.rs/flow-sdk/)

![MIT OR Apache-2.0](https://img.shields.io/crates/l/flow-sdk)

The minimum supported Rust version (MSRV) of this project is 1.56.0.

To install Rust, visit the [rustup] website for information.

## Documentation

To see examples with definition of concepts as well as links to the API reference, see [docs/README.md](docs/README.md).

To see the latest API reference, go to https://fee1-dead.github.io/flow.rs/flow_sdk/. It uses unstable features that enable scraping the repository

for example usages.

[docs.rs](https://docs.rs/flow-sdk/) also hosts documentation of the latest published version, but does not have example snippets for functions.

## Examples

If you are looking for interactive examples, you can look at `flow-examples/`. Examples in the directory

runs an emulator and makes requests to the emulator.

To run examples in `flow-examples/`, make sure that you have [Flow CLI] installed and

run `cargo run -p flow-examples` in the project's root directory. I might ship prebuilt binaries for

flow-examples in the future.

Use `FLOW_CLI_EXTRA_ARGS` to control extra arguments passed to start the emulator. For example: use

`FLOW_CLI_EXTRA_ARGS="--http-port 8081"` if the 8080 port is in use.

If you are looking for examples that just fetches some information from the network without any input,

you can look at the `examples/` directory.

To run examples in `examples/`, run `cargo run --example file_name_without_rs`.

## Tests

The SDK has tests within [`src/tests`](./src/tests) and Cadence JSON tests are in [`cadence_json/src/tests`](./cadence_json/src/tests).

Examples inside the documentation are also tested.

## Cryptography and Hashing algorithms

Currently the library supports signing with secp256k1 and SHA3 hashing. Support for other algorithms

may be added in the near future.

secp256k1 signing is provided by the `secp256k1` crate, which is an FFI wrapper around [libsecp256k1],

a C library by Pieter Wuille that is used in many projects.

sha3 hashing is provided by the [`tiny-keccak`] crate, which claims to have [better performance] than

another crate by `RustCrypto`.

[rustup]: https://rustup.rs

[examples/]: ./examples/

[libsecp256k1]: https://github.com/bitcoin-core/secp256k1/

[`tiny-keccak`]: https://github.com/debris/tiny-keccak

[better performance]: https://github.com/debris/tiny-keccak#benchmarks

[Flow CLI]: https://docs.onflow.org/flow-cli/