2 * Copyright (c) 2017 Apple Inc. All Rights Reserved.
4 * @APPLE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
21 * @APPLE_LICENSE_HEADER_END@
26 #import <Foundation/Foundation.h>
27 #import <SecurityFoundation/SFKey.h>
28 #import <SecurityFoundation/SFKey_Private.h>
30 NS_ASSUME_NONNULL_BEGIN
32 // ==== Peer protocols ====
34 @protocol CKKSPeer
<NSObject
>
35 @
property (readonly
) NSString
* peerID
;
36 @
property (nullable
, readonly
) SFECPublicKey
* publicEncryptionKey
;
37 @
property (nullable
, readonly
) SFECPublicKey
* publicSigningKey
;
39 // Not exactly isEqual, since this only compares peerID
40 - (bool)matchesPeer
:(id
<CKKSPeer
>)peer
;
43 @protocol CKKSRemotePeerProtocol
<CKKSPeer
>
44 - (BOOL
)shouldHaveView
:(NSString
*)viewName
;
47 @protocol CKKSSelfPeer
<CKKSPeer
>
48 @
property (readonly
) SFECKeyPair
* encryptionKey
;
49 @
property (readonly
) SFECKeyPair
* signingKey
;
52 // ==== Peer collection protocols ====
54 @interface CKKSSelves
: NSObject
55 @property id
<CKKSSelfPeer
> currentSelf
;
56 @
property (nullable
) NSSet
<id
<CKKSSelfPeer
>>* allSelves
;
57 - (instancetype
)initWithCurrent
:(id
<CKKSSelfPeer
>)selfPeer allSelves
:(NSSet
<id
<CKKSSelfPeer
>>* _Nullable
)allSelves
;
60 extern NSString
* const CKKSSOSPeerPrefix
;
62 @interface CKKSActualPeer
: NSObject
<CKKSPeer
, CKKSRemotePeerProtocol
, NSSecureCoding
>
63 @
property (readonly
) NSString
* peerID
;
64 @
property (nullable
, readonly
) SFECPublicKey
* publicEncryptionKey
;
65 @
property (nullable
, readonly
) SFECPublicKey
* publicSigningKey
;
66 @
property (nullable
, readonly
) NSSet
<NSString
*>* viewList
;
68 - (instancetype
)initWithPeerID
:(NSString
*)syncingPeerID
69 encryptionPublicKey
:(SFECPublicKey
* _Nullable
)encryptionKey
70 signingPublicKey
:(SFECPublicKey
* _Nullable
)signingKey
71 viewList
:(NSSet
<NSString
*>* _Nullable
)viewList
;
74 @protocol CKKSSOSPeerProtocol
<NSObject
, CKKSRemotePeerProtocol
>
77 @interface CKKSSOSPeer
: NSObject
<CKKSPeer
, CKKSSOSPeerProtocol
, CKKSRemotePeerProtocol
, NSSecureCoding
>
78 - (instancetype
)initWithSOSPeerID
:(NSString
*)syncingPeerID
79 encryptionPublicKey
:(SFECPublicKey
* _Nullable
)encryptionKey
80 signingPublicKey
:(SFECPublicKey
* _Nullable
)signingKey
81 viewList
:(NSSet
<NSString
*>* _Nullable
)viewList
;
84 @interface CKKSSOSSelfPeer
: NSObject
<CKKSPeer
, CKKSSOSPeerProtocol
, CKKSRemotePeerProtocol
, CKKSSelfPeer
>
85 @
property (readonly
) NSString
* peerID
;
86 @
property (nullable
, readonly
) NSSet
<NSString
*>* viewList
;
88 @
property (readonly
) SFECPublicKey
* publicEncryptionKey
;
89 @
property (readonly
) SFECPublicKey
* publicSigningKey
;
91 @property SFECKeyPair
* encryptionKey
;
92 @property SFECKeyPair
* signingKey
;
94 - (instancetype
)initWithSOSPeerID
:(NSString
*)syncingPeerID
95 encryptionKey
:(SFECKeyPair
*)encryptionKey
96 signingKey
:(SFECKeyPair
*)signingKey
97 viewList
:(NSSet
<NSString
*>* _Nullable
)viewList
;
100 NSSet
<Class
>* CKKSPeerClasses(void);
102 NS_ASSUME_NONNULL_END