Salt, a crypto library for Flutter

Build Status Coverage Status License

This is a simple and pure Dart library which adds support for cryptography in Flutter apps without having to use native C bindings. The goal for this project is to slowly adopt several crypto algorithms with proper tests.

Currently the following crypto algorithms are supported:

  • chacha20-poly1305

Getting started

First of all add the following dependencies to your pubspec.yaml:

dependencies:
  salt: ^0.1.1

Then you will find everything you need in the Salt class. Below is an example how to encrypt and decrypt a message using chacha20-poly1305:

import 'package:salt/binhex.dart';
import 'package:salt/salt.dart'

var key = BinHex.hex2bin('4290bcb154173531f314af57f3be3b5006da371ece272afa1b5dbdd1100a1007');
var input = BinHex.hex2bin('86d09974840bded2a5ca');
var nonce = BinHex.hex2bin('cd7cf67be39c794a');
var ad = BinHex.hex2bin('87e229d4500845a079c0');

var ciphertext = Salt.chacha20Poly1305Encrypt(input, ad, nonce, key);
var plaintext = Salt.chacha20Poly1305Decrypt(ciphertext, ad, nonce, key);

Notes

  • This library uses a lot of ported code from the following repository: https://github.com/devi/Salt
  • In this library we use List<int> instead of Uint8List

Libraries

binhex
chacha20
chacha20_poly1305
poly1305
salt

Dart

VM

dart:ffi
Foreign Function Interface for interoperability with the C programming language. [...]

Web

dart:html
HTML elements and other resources for web-based applications that need to interact with the browser and the DOM (Document Object Model). [...]
dart:js
Low-level support for interoperating with JavaScript. [...]
dart:js_util
Utility methods to efficiently manipulate typed JSInterop objects in cases where the name to call is not known at runtime. You should only use these methods when the same effect cannot be achieved with @JS annotations. These methods would be extension methods on JSObject if Dart supported extension methods.