init

杨锴

2024-08-14 909e20941e45f8712c012db602034b47da0bfdb0

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
//
//  CryptoSwift
//
//  Copyright (C) 2014-2022 Marcin Krzyżanowski <marcin@krzyzanowskim.com>
//  This software is provided 'as-is', without any express or implied warranty.
//
//  In no event will the authors be held liable for any damages arising from the use of this software.
//
//  Permission is granted to anyone to use this software for any purpose,including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
//
//  - The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation is required.
//  - Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
//  - This notice may not be removed or altered from any source or binary distribution.
//
 
public protocol CipherModeWorker {
  var cipherOperation: CipherOperationOnBlock { get }
 
  // Additional space needed when incrementally process data
  // eg. for GCM combined mode
  var additionalBufferSize: Int { get }
 
  @inlinable
  mutating func encrypt(block plaintext: ArraySlice<UInt8>) -> Array<UInt8>
 
  @inlinable
  mutating func decrypt(block ciphertext: ArraySlice<UInt8>) -> Array<UInt8>
}
 
/// Block workers use `BlockEncryptor`
public protocol BlockModeWorker: CipherModeWorker {
  var blockSize: Int { get }
}
 
public protocol CounterModeWorker: CipherModeWorker {
  associatedtype Counter
  var counter: Counter { get set }
}
 
public protocol SeekableModeWorker: CipherModeWorker {
  mutating func seek(to position: Int) throws
}
 
/// Stream workers use `StreamEncryptor`
public protocol StreamModeWorker: CipherModeWorker {
}
 
public protocol FinalizingEncryptModeWorker: CipherModeWorker {
  // Any final calculations, eg. calculate tag
  // Called after the last block is encrypted
  mutating func finalize(encrypt ciphertext: ArraySlice<UInt8>) throws -> ArraySlice<UInt8>
}
 
public protocol FinalizingDecryptModeWorker: CipherModeWorker {
  // Called before decryption, hence input is ciphertext.
  // ciphertext is either a last block, or a tag (for stream workers)
  @discardableResult
  mutating func willDecryptLast(bytes ciphertext: ArraySlice<UInt8>) throws -> ArraySlice<UInt8>
  // Called after decryption, hence input is ciphertext
  mutating func didDecryptLast(bytes plaintext: ArraySlice<UInt8>) throws -> ArraySlice<UInt8>
  // Any final calculations, eg. calculate tag
  // Called after the last block is encrypted
  mutating func finalize(decrypt plaintext: ArraySlice<UInt8>) throws -> ArraySlice<UInt8>
}