Skip to content

Latest commit

 

History

History
57 lines (40 loc) · 2.41 KB

README.md

File metadata and controls

57 lines (40 loc) · 2.41 KB

Noir base64

License: MIT Nargo Test 🌌

Noir base64 contains functions for base64 string and u8 array encoding for Aztec's Noir language

Installation

In your Nargo.toml file, add the following dependency:

[dependencies]
base64 = { tag = "v0.1.2", git = "https://github.com/zkworks-xyz/noir-base64" }

Usage

use dep::base64;

fn main() {
    let result: [u8; 8] = base64::encode_str("foobar", [0; 8]);
}

API

Library exposes two functions:

pub fn encode_str<N, M>(input: str<N>, mut result: [u8; M]) -> [u8; M]
  • input - string to encode. Max string length is 600.
  • result - array of bytes to store result in. It should have a proper size otherwise function will fail on assert. Due to Noir language limitations result size need to be known at compile time and should be calculated by user. Value of this parameter are irrelevant, only size matters.
  • Returns result array with encoded string. Function result is also stored in mutable result array argument.
pub fn encode<N, M>(input: [u8; N], mut result: [u8; M], url_safe: bool) -> [u8; M]
  • input - array of bytes to encode. Max array size is 600.
  • result - array of bytes to store result in. It should have a proper size otherwise function will fail on assert. Due to Noir language limitations result size need to be known at compile time and should be calculated by user. Values in this array are irrelevant, only size matters.
  • url_safe - if true then + and / characters will be replaced with - and _ respectively (RFC4648)
  • Returns result array with encoded string. Function result is also stored in mutable result array argument.

Base64 decoding is not supported yet. Will be implemented in future releases.

Example project

Directory examples/base64_example/ contains example Noir project with base64 library as dependency.

License

This project is licensed under the MIT License. See the LICENSE file for details.