Converts an Alice-initiated pattern to a Bob-initiated
-XX pattern. Original PSK modifiers will not be preserved.
@@ -233,17 +234,15 @@ Parameters
- CipherFunction |
- cipher |
- The cipher function (AESGCM or ChaChaPoly).
-If it's null, the original cipher function will be used.
+ | Protocol |
+ protocol |
+ A concrete Noise protocol (e.g. Noise_XXfallback_25519_AESGCM_BLAKE2b).
|
- HashFunction |
- hash |
- The hash function (SHA256, SHA512, BLAKE2s, or BLAKE2b).
-If it's null, the original hash function will be used.
+ | ProtocolConfig |
+ config |
+ A set of parameters used to instantiate a HandshakeState.
|
@@ -260,13 +259,23 @@ Exceptions
System.ObjectDisposedException |
Thrown if the current instance has already been disposed.
+ |
+
+
+ System.ArgumentNullException |
+ Thrown if either protocol or config is null.
+ |
+
+
+ System.ArgumentException |
+ Thrown if protocol is not XXfallback,
+or if the provided local static private key is empty.
|
System.InvalidOperationException |
- Throw if the handshake pattern is Bob-initiated or one-way, if this
-method was not called immediately after the first handshake message,
-or if the local static private key is empty.
+ | Throw if the initial handshake pattern is Bob-initiated, or if this
+method was not called immediately after the first handshake message.
|
@@ -276,7 +285,7 @@ Exceptions
Improve this Doc
- View Source
+ View Source
ReadMessage(ReadOnlySpan<Byte>, Span<Byte>)
@@ -373,7 +382,7 @@ Exceptions
Improve this Doc
- View Source
+ View Source
WriteMessage(ReadOnlySpan<Byte>, Span<Byte>)
diff --git a/docs/api/Noise.Protocol.html b/docs/api/Noise.Protocol.html
index 417bd9a..876b61d 100644
--- a/docs/api/Noise.Protocol.html
+++ b/docs/api/Noise.Protocol.html
@@ -677,7 +677,7 @@ Exceptions
- One or more pre-shared keys are not 32 bytes in length.
- Number of pre-shared keys does not match the number of PSK modifiers.
- Fallback modifier is present (fallback can only be applied by calling
-the Fallback(CipherFunction, HashFunction) method on existing handshake state).
+the Fallback(Protocol, ProtocolConfig) method on existing handshake state).
diff --git a/docs/index.html b/docs/index.html
index b3aaa07..ad71c47 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -129,7 +129,7 @@ Usage
See Noise.Examples
for the complete example.
Installation
-> dotnet add package Noise.NET --version 0.9.7-rc
+> dotnet add package Noise.NET --version 0.9.8-rc
diff --git a/docs/manifest.json b/docs/manifest.json
index 9858fd4..d093510 100644
--- a/docs/manifest.json
+++ b/docs/manifest.json
@@ -56,7 +56,7 @@
"output": {
".html": {
"relative_path": "api/Noise.HandshakeState.html",
- "hash": "3k3ST6YBH7af+z3aU/WAlQ=="
+ "hash": "wUnJPR0qrmQcBx90Rzlg7A=="
}
},
"is_incremental": false,
@@ -107,7 +107,7 @@
"hash": "mJzYaUqJMvMqPxYVCVdSLQ=="
}
},
- "is_incremental": false,
+ "is_incremental": true,
"version": ""
},
{
@@ -128,7 +128,7 @@
"output": {
".html": {
"relative_path": "api/Noise.Protocol.html",
- "hash": "fBqwGYm8uj2jWyDop57P0g=="
+ "hash": "YSCcflaUGh0j93212oGf7w=="
}
},
"is_incremental": false,
@@ -188,7 +188,7 @@
"output": {
".html": {
"relative_path": "index.html",
- "hash": "co/gfFUvbwc3mBLAegJhyQ=="
+ "hash": "cbs0Q336z93wg8Xy72jbcQ=="
}
},
"is_incremental": false,
@@ -202,21 +202,21 @@
"incrementalPhase": "build"
},
"processors": {
- "TocDocumentProcessor": {
+ "ResourceDocumentProcessor": {
"can_incremental": false,
- "details": "Processor TocDocumentProcessor cannot suppport incremental build because the processor doesn't implement ISupportIncrementalDocumentProcessor interface.",
+ "details": "Processor ResourceDocumentProcessor cannot suppport incremental build because the processor doesn't implement ISupportIncrementalDocumentProcessor interface.",
"incrementalPhase": "build"
},
- "ResourceDocumentProcessor": {
+ "TocDocumentProcessor": {
"can_incremental": false,
- "details": "Processor ResourceDocumentProcessor cannot suppport incremental build because the processor doesn't implement ISupportIncrementalDocumentProcessor interface.",
+ "details": "Processor TocDocumentProcessor cannot suppport incremental build because the processor doesn't implement ISupportIncrementalDocumentProcessor interface.",
"incrementalPhase": "build"
},
- "ConceptualDocumentProcessor": {
+ "ManagedReferenceDocumentProcessor": {
"can_incremental": true,
"incrementalPhase": "build"
},
- "ManagedReferenceDocumentProcessor": {
+ "ConceptualDocumentProcessor": {
"can_incremental": true,
"incrementalPhase": "build"
}
diff --git a/docs/xrefmap.yml b/docs/xrefmap.yml
index 659f8fc..8a63abc 100644
--- a/docs/xrefmap.yml
+++ b/docs/xrefmap.yml
@@ -217,12 +217,12 @@ references:
commentId: T:Noise.HandshakeState
fullName: Noise.HandshakeState
nameWithType: HandshakeState
-- uid: Noise.HandshakeState.Fallback(Noise.CipherFunction,Noise.HashFunction)
- name: Fallback(CipherFunction, HashFunction)
- href: api/Noise.HandshakeState.html#Noise_HandshakeState_Fallback_Noise_CipherFunction_Noise_HashFunction_
- commentId: M:Noise.HandshakeState.Fallback(Noise.CipherFunction,Noise.HashFunction)
- fullName: Noise.HandshakeState.Fallback(Noise.CipherFunction, Noise.HashFunction)
- nameWithType: HandshakeState.Fallback(CipherFunction, HashFunction)
+- uid: Noise.HandshakeState.Fallback(Noise.Protocol,Noise.ProtocolConfig)
+ name: Fallback(Protocol, ProtocolConfig)
+ href: api/Noise.HandshakeState.html#Noise_HandshakeState_Fallback_Noise_Protocol_Noise_ProtocolConfig_
+ commentId: M:Noise.HandshakeState.Fallback(Noise.Protocol,Noise.ProtocolConfig)
+ fullName: Noise.HandshakeState.Fallback(Noise.Protocol, Noise.ProtocolConfig)
+ nameWithType: HandshakeState.Fallback(Protocol, ProtocolConfig)
- uid: Noise.HandshakeState.Fallback*
name: Fallback
href: api/Noise.HandshakeState.html#Noise_HandshakeState_Fallback_
diff --git a/index.md b/index.md
index 2eee8ab..dadbabf 100644
--- a/index.md
+++ b/index.md
@@ -77,5 +77,5 @@ for the complete example.
## Installation
```
-> dotnet add package Noise.NET --version 0.9.7-rc
+> dotnet add package Noise.NET --version 0.9.8-rc
```