Skip to content

Commit 4f4eb93

Browse files
change references to Besu prior to 25.1.0 (#203)
* change references to Besu prior to 25.1.0 Signed-off-by: Sally MacFarlane <[email protected]> * fixed links to privacy content Signed-off-by: Sally MacFarlane <[email protected]> * edits --------- Signed-off-by: Sally MacFarlane <[email protected]> Co-authored-by: Alexandra Tran <[email protected]>
1 parent e541ae1 commit 4f4eb93

File tree

9 files changed

+31
-19
lines changed

9 files changed

+31
-19
lines changed

docs/Concepts/Multitenancy.md

+5-2
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,10 @@ sidebar_position: 4
66

77
# Multi-tenancy
88

9-
In a typical [GoQuorum](https://consensys.net/docs/goquorum/en/stable/) or [Hyperledger Besu privacy-enabled](https://besu.hyperledger.org/en/stable/Concepts/Privacy/Privacy-Overview/) network, each participant (tenant) uses their own GoQuorum or Besu node and Tessera node. Tessera can be configured to manage multiple key pairs owned by one tenant. This model is costly to run and scale as more tenants join the network.
9+
In a typical [GoQuorum](https://consensys.net/docs/goquorum/en/stable/) network or
10+
[privacy-enabled Hyperledger Besu](https://besu.hyperledger.org/en/stable/Concepts/Privacy/Privacy-Overview/) network (versions earlier than 25.1.0),
11+
each participant (tenant) uses their own GoQuorum or Besu node and Tessera node.
12+
You can configure Tessera to manage multiple key pairs owned by one tenant. This model is costly to run and scale as more tenants join the network.
1013

1114
Multi-tenancy allows multiple tenants to use the same GoQuorum or Besu node, with each tenant having its own private state. Each tenant can perform all operations (create, read, and write) on any contract in its private state. Multi-tenancy provides a user experience similar to a user running their own managed node.
1215

@@ -33,6 +36,6 @@ To use GoQuorum multi-tenancy via MPS:
3336

3437
## Use Besu multi-tenancy
3538

36-
To use Besu multi-tenancy, you must [create a privacy-enabled network](https://besu.hyperledger.org/en/stable/Tutorials/Privacy/Configuring-Privacy/).
39+
To use Besu multi-tenancy, you must use a Besu version earlier than 25.1.0, and [create a privacy-enabled network](https://besu.hyperledger.org/en/stable/Tutorials/Privacy/Configuring-Privacy/).
3740

3841
Configure multi-tenant Besu and Tessera nodes according to the [Besu multi-tenancy configuration tutorial](https://besu.hyperledger.org/en/stable/Tutorials/Privacy/Configuring-Multi-Tenancy/).

docs/Concepts/Privacy-Groups.md

+4-2
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@ sidebar_position: 3
66

77
# Privacy groups
88

9-
Tessera supports operations related to [Hyperledger Besu privacy groups](https://besu.hyperledger.org/en/stable/Concepts/Privacy/Privacy-Groups/) and [resident groups for GoQuorum multiple private states (MPS)](https://consensys.net/docs/goquorum/en/latest/concepts/multi-tenancy/#tessera-resident-groups), such as managing privacy group data and handling transactions intended for a privacy group.
9+
Tessera supports operations related to [Hyperledger Besu privacy groups (versions earlier than 25.1.0)](https://besu.hyperledger.org/en/stable/Concepts/Privacy/Privacy-Groups/)
10+
and [resident groups for GoQuorum multiple private states (MPS)](https://consensys.net/docs/goquorum/en/latest/concepts/multi-tenancy/#tessera-resident-groups), such as managing privacy group data and handling transactions intended for a privacy group.
1011

1112
Behavior may differ depending on which [`mode`](../HowTo/Configure/Orion-Mode.md) Tessera is running on.
1213

@@ -45,7 +46,8 @@ The following is an example of a privacy group and its related data:
4546

4647
Tessera automatically creates a legacy privacy group when a private transaction is sent to a list of recipient public keys using `privateFor`.
4748

48-
When returning private transaction data to a Besu client (as part of a `/receive` response), the legacy `privacyGroupId` is also returned.
49+
When returning private transaction data to a Besu client (as part of a `/receive` response), the legacy `privacyGroupId`
50+
is also returned.
4951

5052
The legacy `privacyGroupId` is generated by hashing the list of recipient keys. For a given set of recipients, there can be only one legacy privacy group.
5153

docs/Concepts/Privacy-Manager/Privacy-manager.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar_position: 1
66

77
# Privacy manager
88

9-
Tessera is the privacy manager for the [GoQuorum](https://docs.goquorum.consensys.net) and [Hyperledger Besu](https://besu.hyperledger.org/en/stable/) Ethereum clients.
9+
Tessera is the privacy manager for [GoQuorum](https://docs.goquorum.consensys.net) and [Hyperledger Besu versions earlier than 25.1.0](https://besu.hyperledger.org/en/stable/).
1010

1111
A privacy manager consists of two components, each with their own responsibilities:
1212

docs/HowTo/Configure/Orion-Mode.md

+7-6
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar_position: 11
66

77
# Configure Hyperledger Besu support
88

9-
Tessera provides support for [Hyperledger Besu](https://besu.hyperledger.org/en/stable/HowTo/Use-Privacy/Privacy/).
9+
Tessera provides support for [Hyperledger Besu versions earlier than 25.1.0](https://besu.hyperledger.org/en/stable/HowTo/Use-Privacy/Privacy/).
1010

1111
To enable Besu support in Tessera, set [`mode`](../../Reference/SampleConfiguration.md#mode) in the Tessera [configuration file](Tessera.md) to `orion`.
1212

@@ -22,8 +22,9 @@ tessera --configfile config.json -o mode="orion"
2222

2323
If you enable `orion` mode, Tessera:
2424

25-
- Attempts to retrieve the [privacy group](../../Concepts/Privacy-Groups.md) and its associated members for transactions sent with `privacyGroupId`.
26-
- Creates a legacy privacy group for transactions sent with `privateFor` containing a list of recipient keys.
27-
- Uses SHA-512/256 to generate 32-byte hashes of encrypted payloads to be returned to Besu.
28-
- Adds support for `/receive` `POST` requests using the `application/json` media type.
29-
- Includes the `senderKey` (for Besu sender authentication) and the transaction's associated `privacyGroupId` in responses to `/receive` requests.
25+
* Attempts to retrieve the [privacy group](../../Concepts/Privacy-Groups.md) and its associated members for transactions
26+
sent with `privacyGroupId`.
27+
* Creates a legacy privacy group for transactions sent with `privateFor` containing a list of recipient keys.
28+
* Uses SHA-512/256 to generate 32-byte hashes of encrypted payloads to be returned to Besu.
29+
* Adds support for `/receive` `POST` requests using the `application/json` media type.
30+
* Includes the `senderKey` (for Besu sender authentication) and the transaction's associated `privacyGroupId` in responses to `/receive` requests.

docs/HowTo/Configure/Tessera.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ You can also configure:
2020
- An [external database](Database.md).
2121
- Support for [multiple private states](Multiple-private-state.md) and [resident groups](Multiple-private-state.md#resident-groups).
2222
- [Cryptographic elliptic curves](Cryptographic-elliptic-curves.md).
23-
- Support for [Hyperledger Besu](Orion-Mode.md).
23+
- Support for [Hyperledger Besu versions earlier than 25.1.0](Orion-Mode.md).
2424
- [High availability](High-availability.md).
2525

2626
You can [override configuration options](Override-config.md) using the command line.

docs/HowTo/Get-started/Use-GoQuorum-with-Tessera.md

+7-4
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,17 @@ sidebar_position: 3
66

77
# Use GoQuorum or Besu with Tessera
88

9-
You can use Tessera as the private transaction manager for [GoQuorum](https://consensys.net/docs/goquorum/en/stable/) or [Hyperledger Besu](https://besu.hyperledger.org/en/stable/). Get started with the following tutorials:
9+
You can use Tessera as the private transaction manager for [GoQuorum](https://consensys.net/docs/goquorum/en/stable/) or [Hyperledger Besu versions earlier than 25.1.0](https://besu.hyperledger.org).
10+
Get started with the following tutorials:
1011

1112
- [Create a privacy-enabled GoQuorum network](https://consensys.net/docs/goquorum/en/stable/tutorials/create-privacy-enabled-network/).
1213
- [Send a private transaction on GoQuorum](https://consensys.net/docs/goquorum/en/stable/tutorials/send-private-transaction/).
13-
- [Create a privacy-enabled Besu network](https://besu.hyperledger.org/en/stable/Tutorials/Privacy/Configuring-Privacy/).
14-
- [Configure a multi-tenant Besu network](https://besu.hyperledger.org/en/stable/Tutorials/Privacy/Configuring-Multi-Tenancy/).
15-
- [Use the Besu multi-node example in the web3js-quorum library](https://besu.hyperledger.org/en/stable/Tutorials/Privacy/web3js-quorum-Multinode-example/).
14+
- [Create a privacy-enabled Besu network](https://besu.hyperledger.org/private-networks/concepts/privacy).
15+
- [Configure a multi-tenant Besu network](https://besu.hyperledger.org/private-networks/concepts/privacy/multi-tenancy).
16+
- [Use the Besu multi-node example in the web3js-quorum library](https://besu.hyperledger.org/private-networks/tutorials/privacy/web3js-quorum).
1617

1718
:::note
1819

1920
All Tessera nodes included in a private transaction must be running when the private transaction is sent. Otherwise, the transaction doesn't propagate and an error is returned.
21+
22+
:::

docs/HowTo/Migrate/MigrateFromOrion.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@ sidebar_position: 1
66

77
# Migrating from Orion to Tessera
88

9-
A utility is included in Tessera which enables migration of an Orion configuration file and database to a Tessera configuration file and database for Hyperledger Besu users.
9+
Tessera includes a utility that enables migration of an Orion configuration file and database to a Tessera configuration file and database,
10+
for Hyperledger Besu (versions earlier than 25.1.0).
1011

1112
A full migration workflow would be as follows:
1213

docs/Reference/SampleConfiguration.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -152,7 +152,7 @@ Configuration items can be [overridden from the command line].
152152

153153
### `mode`
154154

155-
Set the `mode` to `orion` to use Tessera as the privacy manager when using [Hyperledger Besu in non-GoQuorum mode](https://besu.hyperledger.org/en/stable/HowTo/Use-Privacy/Use-GoQuorum-compatible-privacy/). [Enabling this mode](../HowTo/Configure/Orion-Mode.md) changes Tessera's behavior. This property is optional.
155+
Set the `mode` to `orion` to use Tessera as the privacy manager when using [Hyperledger Besu (versions earlier than 25.1.0) in non-GoQuorum mode](https://besu.hyperledger.org/en/stable/HowTo/Use-Privacy/Use-GoQuorum-compatible-privacy/). [Enabling this mode](../HowTo/Configure/Orion-Mode.md) changes Tessera's behavior. This property is optional.
156156

157157
### `useWhiteList`
158158

docs/index.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,9 @@ slug: overview
99

1010
## What is Tessera?
1111

12-
Tessera is an open-source private transaction manager developed under the Apache 2.0 license and written in Java. The primary application of Tessera is as the privacy manager for privacy-enabled Ethereum clients such as [GoQuorum](https://docs.goquorum.consensys.net) and [Hyperledger Besu](https://besu.hyperledger.org/en/stable/).
12+
Tessera is an open-source private transaction manager developed under the Apache 2.0 license and written in Java.
13+
The primary application of Tessera is as the privacy manager for privacy-enabled Ethereum clients such as
14+
[GoQuorum](https://docs.goquorum.consensys.net) and [Hyperledger Besu versions earlier than 25.1.0](https://besu.hyperledger.org/en/stable/).
1315

1416
## What can you do with Tessera?
1517

0 commit comments

Comments
 (0)