https://github.com/tmthecoder/argon2swift
An Argon2 Wrapper for Swift
https://github.com/tmthecoder/argon2swift
argon2 swift
Last synced: 3 months ago
JSON representation
An Argon2 Wrapper for Swift
- Host: GitHub
- URL: https://github.com/tmthecoder/argon2swift
- Owner: tmthecoder
- License: mit
- Created: 2021-01-16T02:16:00.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-03-15T22:22:56.000Z (over 2 years ago)
- Last Synced: 2024-10-30T01:51:07.630Z (8 months ago)
- Topics: argon2, swift
- Language: Swift
- Homepage: https://docs.tmthecoder.dev/Argon2Swift/
- Size: 50.1 MB
- Stars: 27
- Watchers: 2
- Forks: 16
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Argon2Swift
[](https://github.com/tmthecoder/Argon2Swift/actions/workflows/Swift.yml)
[](https://opensource.org/licenses/MIT)
Swift bindings for the reference C implementation of [Argon2], the winner of the [Password Hash Competition].
[Argon2]: https://github.com/P-H-C/phc-winner-argon2
[Password Hash Competition]: https://password-hashing.net
## Installation (Cocoapods)
Argon2Swift can be installed via Cocoapods by adding the following to your `Podfile`:
```
pod Argon2Swift
```
## Installation (SPM)
Argon2Swift can be installed via SPM (Swift Package Manger) by adding the following to your depencencies:
```swift
.package(url: "https://github.com/tmthecoder/Argon2Swift.git", .branch("main"))
```
## Usage
High-level hashing and verification (for direct hashing & verification of byte arrays, check the example)
```swift
import Argon2Swift
// Create a password and a salt
let password = "password"
let s = Salt.newSalt()
//Hash with pre-set params (iterations: 32, memory: 256, parallelism: 2, length: 32, type: Argon2Type.i, version: Argon2Version.V13)
let result = try! Argon2Swift.hashPasswordString(password: password, salt: s)
//Raw hash values available as int list, base 64 string, and hex string
let hashData = result.hashData()
let base64Hash = result.base64String()
let hexHash = result.hexString()
//Encoded hash values available as int list and encoded string
let encodedData = result.encodedData()
let encodedString = result.encodedString()
//Verify password (returns true/false), uses default type (Argon2Type.i)
let verified = try! Argon2Swift.verifyHashString(password: password, hash: stringEncoded);
```
## Features and bugs
Please file feature requests and bugs at the [issue tracker].
[issue tracker]: https://github.com/tmthecoder/Argon2Swift/issues
## Licensing
- Argon2Swift is Licensed under the [MIT License]
- The C implementation of [Argon2] is licensed under a dual [Apache and CC0 License]
[MIT License]: https://github.com/tmthecoder/Argon2Swift/blob/main/LICENSE
[Argon2]: https://github.com/P-H-C/phc-winner-argon2
[Apache and CC0 License]: https://github.com/P-H-C/phc-winner-argon2/blob/master/LICENSE