From 01a3a6d581bd60b288de8ed473be6b82c9f1b561 Mon Sep 17 00:00:00 2001 From: Byron Gravenorst Date: Mon, 3 Feb 2020 14:15:13 +1000 Subject: [PATCH 1/5] Add Besu Plugin information. Signed-off-by: Byron Gravenorst --- docs/Concepts/Plugins.md | 44 ++++++++++++++++++++ docs/Reference/Plugin-API-Interfaces.md | 19 +++++++++ docs/images/Hyperledger-Besu-Plugin-API.png | Bin 0 -> 130407 bytes mkdocs.yml | 2 + 4 files changed, 65 insertions(+) create mode 100644 docs/Concepts/Plugins.md create mode 100644 docs/Reference/Plugin-API-Interfaces.md create mode 100644 docs/images/Hyperledger-Besu-Plugin-API.png diff --git a/docs/Concepts/Plugins.md b/docs/Concepts/Plugins.md new file mode 100644 index 00000000000..a79b7e0f425 --- /dev/null +++ b/docs/Concepts/Plugins.md @@ -0,0 +1,44 @@ +description: Plugins + + +# Plugins + +You can extend Hyperledger Besu functionality by building Java plugins. The +Plugin API allows you to take data from any Besu network, public or +permissioned, and feed it into an application or system. + +For example, a plugin can add additional monitoring functionality or stream +event data to a third-party application. The API exposes data about the +following components: + +* Blocks +* Balances +* Transactions +* Smart contracts +* Execution results +* Logs +* Syncing state + +![Besu Plugin API](../images/Hyperledger-Besu-Plugin-API.png) + +The Plugin API provides access to [interfaces](../Reference/Plugin-API-Interfaces.md) that allow you to build the plugin. + +!!! tip + Use the [Besu example plugin](https://github.com/PegaSysEng/PluginsAPIDemo) and view the webinar for an example of how to build a plugin. + +## Install Plugins + +The plugin (`.jar`) must be copied to the `plugins` directory to allow Besu +access and use the plugin. + +!!! important + If not already present, the `plugins` directory must be created one level below (`../`) the besu executable. + +Each plugin in the directory has the following lifecycle events: + +* **Register** - Executed when Besu starts. Besu checks plugin compatibility and registers plugins. +* **Start** - Plugins are started after being successfully registered. +* **Stop** - Plugins are stopped by Besu. + +!!! note + Besu does not guarantee the order of the lifecycle events. diff --git a/docs/Reference/Plugin-API-Interfaces.md b/docs/Reference/Plugin-API-Interfaces.md new file mode 100644 index 00000000000..428374a4ee8 --- /dev/null +++ b/docs/Reference/Plugin-API-Interfaces.md @@ -0,0 +1,19 @@ +description: Plugin interfaces + + +Hyperledger Besu provides API interfaces to allow users to [build plugins](../Concepts/Plugins.md) to +extend Besu functionality. + + + +| Interface | Description | +|--------------------|----------------------------------------------------------| +| **BesuContext** | Allows plugins to access Besu services. | +| **BesuEvents** | Allows plugins to attach to various events during Besu operation. | +| **BesuPlugin** | Used to manage the plugin lifecycle. | +| **PicoCLIOptions** | Adds CLI commands to the Besu command line. | +| **StorageService** | Allows plugins to register as a storage engine. | + +To use the interfaces in your plugin, ensure the [Gradle build file](https://github.com/PegaSysEng/PluginsAPIDemo/blob/master/build.gradle) contains +the `https://hyperledger-org.bintray.com/besu-repo` repository and the +`plugin-api` dependency. \ No newline at end of file diff --git a/docs/images/Hyperledger-Besu-Plugin-API.png b/docs/images/Hyperledger-Besu-Plugin-API.png new file mode 100644 index 0000000000000000000000000000000000000000..b5c4e56ac9807be74d973c9f714b62fc8da4cef1 GIT binary patch literal 130407 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 literal 0 HcmV?d00001 diff --git a/mkdocs.yml b/mkdocs.yml index 45b331b583f..53ce48140b3 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -146,6 +146,7 @@ nav: - Overview: Concepts/Consensus-Protocols/Overview-Consensus.md - Comparing PoA Consensus Protocols: Concepts/Consensus-Protocols/Comparing-PoA.md - Client Libraries: Concepts/Client-Libraries.md + - Plugins: Concepts/Plugins.md - Privacy: - Overview: Concepts/Privacy/Privacy-Overview.md - Private Transactions: Concepts/Privacy/Private-Transactions.md @@ -173,6 +174,7 @@ nav: - Besu API Objects: Reference/API-Objects.md - Genesis File Items: Reference/Config-Items.md - web3.js-eaa Methods: Reference/web3js-eea-Methods.md + - Plugin API Interfaces: Reference/Plugin-API-Interfaces.md - Accounts for Testing: Reference/Accounts-for-Testing.md - Security Disclosure Policy: Reference/Responsible-Disclosure.md - Blog Posts and Webinars: Reference/Resources.md From 8c3bc7766bc6c97848ee969ac33bc9768d954eb5 Mon Sep 17 00:00:00 2001 From: Byron Gravenorst Date: Fri, 7 Feb 2020 12:36:37 +1000 Subject: [PATCH 2/5] Added webinar link. Signed-off-by: Byron Gravenorst --- docs/Concepts/Plugins.md | 8 +++++--- docs/Reference/Resources.md | 2 ++ 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/Concepts/Plugins.md b/docs/Concepts/Plugins.md index a79b7e0f425..f5bf20d7926 100644 --- a/docs/Concepts/Plugins.md +++ b/docs/Concepts/Plugins.md @@ -21,10 +21,11 @@ following components: ![Besu Plugin API](../images/Hyperledger-Besu-Plugin-API.png) -The Plugin API provides access to [interfaces](../Reference/Plugin-API-Interfaces.md) that allow you to build the plugin. +The Plugin API provides access to [interfaces](../Reference/Plugin-API-Interfaces.md) that allow you to build +the plugin. !!! tip - Use the [Besu example plugin](https://github.com/PegaSysEng/PluginsAPIDemo) and view the webinar for an example of how to build a plugin. + View the [Plugin API webinar](https://youtu.be/78sa2WuA1rg) for an example of how to build a plugin. ## Install Plugins @@ -32,7 +33,8 @@ The plugin (`.jar`) must be copied to the `plugins` directory to allow Besu access and use the plugin. !!! important - If not already present, the `plugins` directory must be created one level below (`../`) the besu executable. + If not already present, the `plugins` directory must be created one directory + level below (`../`) the besu executable. Each plugin in the directory has the following lifecycle events: diff --git a/docs/Reference/Resources.md b/docs/Reference/Resources.md index 987b0037422..58b34d23d2c 100644 --- a/docs/Reference/Resources.md +++ b/docs/Reference/Resources.md @@ -17,6 +17,8 @@ description: Hyperledger Besu resources including blog posts, webinars, and meet ## Webinars +[Besu Plugin API: Learn How to Leverage Plugin APIs on Hyperledger Besu](https://youtu.be/78sa2WuA1rg) + [Permissioning in Blockchain: A Technical Look at Benefits and Best Practices](https://www.youtube.com/watch?v=CD0pHtNDqZs) [Privacy in Besu: How PegaSys Redefined Blockchain for Enterprises](https://www.youtube.com/watch?v=8l7SSZLyFL8) From a016dfd82016eddf104eb31cd57482a0bf09cac1 Mon Sep 17 00:00:00 2001 From: Byron Gravenorst Date: Thu, 20 Feb 2020 17:25:48 +1000 Subject: [PATCH 3/5] Address Tech Review comments. Signed-off-by: Byron Gravenorst --- docs/Concepts/Plugins.md | 2 +- docs/Reference/Plugin-API-Interfaces.md | 19 ++++++++++++++++++- 2 files changed, 19 insertions(+), 2 deletions(-) diff --git a/docs/Concepts/Plugins.md b/docs/Concepts/Plugins.md index f5bf20d7926..d186156ffb9 100644 --- a/docs/Concepts/Plugins.md +++ b/docs/Concepts/Plugins.md @@ -43,4 +43,4 @@ Each plugin in the directory has the following lifecycle events: * **Stop** - Plugins are stopped by Besu. !!! note - Besu does not guarantee the order of the lifecycle events. + Besu does not guarantee the order plugins are called during lifecycle events. diff --git a/docs/Reference/Plugin-API-Interfaces.md b/docs/Reference/Plugin-API-Interfaces.md index 428374a4ee8..6581e0c2ea0 100644 --- a/docs/Reference/Plugin-API-Interfaces.md +++ b/docs/Reference/Plugin-API-Interfaces.md @@ -1,16 +1,33 @@ description: Plugin interfaces +# Plugin API Interfaces + Hyperledger Besu provides API interfaces to allow users to [build plugins](../Concepts/Plugins.md) to extend Besu functionality. +## Core Plugin Classes +The following interfaces provide core plugin classes. | Interface | Description | |--------------------|----------------------------------------------------------| | **BesuContext** | Allows plugins to access Besu services. | -| **BesuEvents** | Allows plugins to attach to various events during Besu operation. | | **BesuPlugin** | Used to manage the plugin lifecycle. | + + +## Plugin Services + +The following interfaces provide services that can be retrieved. + +| Interface | Description | +|--------------------|----------------------------------------------------------| +| **BesuEvents** | Allows plugins to attach to various events during Besu operation. | +| **BesuConfiguration** | Provides file system locations of Besu's storage. | +| **IbftQueryService** | Allows IBFT 2.0 aspects of the blockchain to be queried. | +| **MetricCategoryRegistry** | Adds a new metrics category to the CLI. | +| **MetricsSystem** | Register metrics with the Prometheus endpoint. | +| **PoAQueryService** | Query the current state of Clique and IBFT consensus protocols. | | **PicoCLIOptions** | Adds CLI commands to the Besu command line. | | **StorageService** | Allows plugins to register as a storage engine. | From d7e72e0f427a775ea5587432c0edbb1f539a8b5b Mon Sep 17 00:00:00 2001 From: Byron Gravenorst Date: Mon, 24 Feb 2020 13:29:17 +1000 Subject: [PATCH 4/5] Address review feedback. Signed-off-by: Byron Gravenorst --- docs/Concepts/Plugins.md | 12 ++++++------ docs/Reference/Plugin-API-Interfaces.md | 4 ++-- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/Concepts/Plugins.md b/docs/Concepts/Plugins.md index d186156ffb9..b3d331f7d6a 100644 --- a/docs/Concepts/Plugins.md +++ b/docs/Concepts/Plugins.md @@ -3,12 +3,12 @@ description: Plugins # Plugins -You can extend Hyperledger Besu functionality by building Java plugins. The -Plugin API allows you to take data from any Besu network, public or -permissioned, and feed it into an application or system. +You can extend Hyperledger Besu functionality by building Java plugins. Use the +Plugin API to take data from any Besu network, public or permissioned, and feed +it into an application or system. -For example, a plugin can add additional monitoring functionality or stream -event data to a third-party application. The API exposes data about the +For example, create a plugin to add additional monitoring functionality or +stream event data to a third-party application. The API exposes data about the following components: * Blocks @@ -34,7 +34,7 @@ access and use the plugin. !!! important If not already present, the `plugins` directory must be created one directory - level below (`../`) the besu executable. + level below (`../`) the `besu` executable. Each plugin in the directory has the following lifecycle events: diff --git a/docs/Reference/Plugin-API-Interfaces.md b/docs/Reference/Plugin-API-Interfaces.md index 6581e0c2ea0..61f57f48a77 100644 --- a/docs/Reference/Plugin-API-Interfaces.md +++ b/docs/Reference/Plugin-API-Interfaces.md @@ -3,7 +3,7 @@ description: Plugin interfaces # Plugin API Interfaces -Hyperledger Besu provides API interfaces to allow users to [build plugins](../Concepts/Plugins.md) to +API interfaces in Hyperledger Besu allow users to [build plugins](../Concepts/Plugins.md) to extend Besu functionality. ## Core Plugin Classes @@ -27,7 +27,7 @@ The following interfaces provide services that can be retrieved. | **IbftQueryService** | Allows IBFT 2.0 aspects of the blockchain to be queried. | | **MetricCategoryRegistry** | Adds a new metrics category to the CLI. | | **MetricsSystem** | Register metrics with the Prometheus endpoint. | -| **PoAQueryService** | Query the current state of Clique and IBFT consensus protocols. | +| **PoAQueryService** | Query the current state of Clique and IBFT 2.0 consensus protocols. | | **PicoCLIOptions** | Adds CLI commands to the Besu command line. | | **StorageService** | Allows plugins to register as a storage engine. | From 4cf551c529f7ac24c136b4e43688e87e4bd8270d Mon Sep 17 00:00:00 2001 From: Byron Gravenorst Date: Wed, 26 Feb 2020 13:53:38 +1000 Subject: [PATCH 5/5] Add javadoc links. Signed-off-by: Byron Gravenorst --- docs/Concepts/Plugins.md | 2 ++ docs/Reference/Plugin-API-Interfaces.md | 22 ++++++++++++---------- 2 files changed, 14 insertions(+), 10 deletions(-) diff --git a/docs/Concepts/Plugins.md b/docs/Concepts/Plugins.md index b3d331f7d6a..798118a89fc 100644 --- a/docs/Concepts/Plugins.md +++ b/docs/Concepts/Plugins.md @@ -26,6 +26,8 @@ the plugin. !!! tip View the [Plugin API webinar](https://youtu.be/78sa2WuA1rg) for an example of how to build a plugin. + + The [Plugin API Javadoc](https://javadoc.io/doc/org.hyperledger.besu/plugin-api/latest/index.html) provides additional information about the available interfaces. ## Install Plugins diff --git a/docs/Reference/Plugin-API-Interfaces.md b/docs/Reference/Plugin-API-Interfaces.md index 61f57f48a77..05e685cce26 100644 --- a/docs/Reference/Plugin-API-Interfaces.md +++ b/docs/Reference/Plugin-API-Interfaces.md @@ -6,14 +6,16 @@ description: Plugin interfaces API interfaces in Hyperledger Besu allow users to [build plugins](../Concepts/Plugins.md) to extend Besu functionality. +The [Plugin API Javadoc](https://javadoc.io/doc/org.hyperledger.besu/plugin-api/latest/index.html) provides additional information about the available interfaces. + ## Core Plugin Classes The following interfaces provide core plugin classes. | Interface | Description | |--------------------|----------------------------------------------------------| -| **BesuContext** | Allows plugins to access Besu services. | -| **BesuPlugin** | Used to manage the plugin lifecycle. | +| [**BesuContext**](https://javadoc.io/doc/org.hyperledger.besu/plugin-api/latest/org/hyperledger/besu/plugin/BesuContext.html) | Allows plugins to access Besu services. | +| [**BesuPlugin**](https://javadoc.io/doc/org.hyperledger.besu/plugin-api/latest/org/hyperledger/besu/plugin/BesuPlugin.html) | Used to manage the plugin lifecycle. | ## Plugin Services @@ -22,14 +24,14 @@ The following interfaces provide services that can be retrieved. | Interface | Description | |--------------------|----------------------------------------------------------| -| **BesuEvents** | Allows plugins to attach to various events during Besu operation. | -| **BesuConfiguration** | Provides file system locations of Besu's storage. | -| **IbftQueryService** | Allows IBFT 2.0 aspects of the blockchain to be queried. | -| **MetricCategoryRegistry** | Adds a new metrics category to the CLI. | -| **MetricsSystem** | Register metrics with the Prometheus endpoint. | -| **PoAQueryService** | Query the current state of Clique and IBFT 2.0 consensus protocols. | -| **PicoCLIOptions** | Adds CLI commands to the Besu command line. | -| **StorageService** | Allows plugins to register as a storage engine. | +| [**BesuEvents**](https://javadoc.io/doc/org.hyperledger.besu/plugin-api/latest/org/hyperledger/besu/plugin/services/BesuEvents.html) | Allows plugins to attach to various events during Besu operation. | +| [**BesuConfiguration**](https://javadoc.io/doc/org.hyperledger.besu/plugin-api/latest/org/hyperledger/besu/plugin/services/BesuConfiguration.html) | Provides file system locations of Besu's storage. | +| [**IbftQueryService**](https://javadoc.io/doc/org.hyperledger.besu/plugin-api/latest/org/hyperledger/besu/plugin/services/query/IbftQueryService.html) | Allows IBFT 2.0 aspects of the blockchain to be queried. | +| [**MetricCategoryRegistry**](https://javadoc.io/static/org.hyperledger.besu/plugin-api/1.3.4/org/hyperledger/besu/plugin/services/metrics/MetricCategoryRegistry.html) | Adds a new metrics category to the CLI. | +| [**MetricsSystem**](https://javadoc.io/doc/org.hyperledger.besu/plugin-api/latest/org/hyperledger/besu/plugin/services/MetricsSystem.html) | Register metrics with the Prometheus endpoint. | +| [**PoaQueryService**](https://javadoc.io/static/org.hyperledger.besu/plugin-api/1.3.4/org/hyperledger/besu/plugin/services/query/PoaQueryService.html) | Query the current state of Clique and IBFT 2.0 consensus protocols. | +| [**PicoCLIOptions**](https://javadoc.io/static/org.hyperledger.besu/plugin-api/1.3.4/org/hyperledger/besu/plugin/services/PicoCLIOptions.html) | Adds CLI commands to the Besu command line. | +| [**StorageService**](https://javadoc.io/static/org.hyperledger.besu/plugin-api/1.3.4/org/hyperledger/besu/plugin/services/StorageService.html) | Allows plugins to register as a storage engine. | To use the interfaces in your plugin, ensure the [Gradle build file](https://github.com/PegaSysEng/PluginsAPIDemo/blob/master/build.gradle) contains the `https://hyperledger-org.bintray.com/besu-repo` repository and the