1
// Copyright 2012 The Closure Library Authors. All Rights Reserved.
2
//
3
// Licensed under the Apache License, Version 2.0 (the "License");
4
// you may not use this file except in compliance with the License.
5
// You may obtain a copy of the License at
6
//
7
//      http://www.apache.org/licenses/LICENSE-2.0
8
//
9
// Unless required by applicable law or agreed to in writing, software
10
// distributed under the License is distributed on an "AS-IS" BASIS,
11
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
// See the License for the specific language governing permissions and
13
// limitations under the License.
14

15
/**
16
 * @fileoverview Interface definition of a block cipher. A block cipher is a
17
 * pair of algorithms that implement encryption and decryption of input bytes.
18
 *
19
 * @see http://en.wikipedia.org/wiki/Block_cipher
20
 *
21
 * @author [email protected] (Nathan Naze)
22
 */
23

24
goog.provide('goog.crypt.BlockCipher');
25

26

27

28
/**
29
 * Interface definition for a block cipher.
30
 * @interface
31
 */
32
goog.crypt.BlockCipher = function() {};
33

34
/**
35
 * Block size, in bytes.
36
 * @type {number}
37
 * @const
38
 * @public
39
 */
40
goog.crypt.BlockCipher.prototype.BLOCK_SIZE;
41

42
/**
43
 * Encrypt a plaintext block.  The implementation may expect (and assert)
44
 * a particular block length.
45
 * @param {!Array<number>|!Uint8Array} input Plaintext array of input bytes.
46
 * @return {!Array<number>} Encrypted ciphertext array of bytes.  Should be the
47
 *     same length as input.
48
 */
49
goog.crypt.BlockCipher.prototype.encrypt;
50

51

52
/**
53
 * Decrypt a plaintext block.  The implementation may expect (and assert)
54
 * a particular block length.
55
 * @param {!Array<number>|!Uint8Array} input Ciphertext. Array of input bytes.
56
 * @return {!Array<number>} Decrypted plaintext array of bytes.  Should be the
57
 *     same length as input.
58
 */
59
goog.crypt.BlockCipher.prototype.decrypt;
60

61