From 819a5818284a96a5a5bd65ce67e69bab860d4534 Mon Sep 17 00:00:00 2001
From: eskimor <eskimor@users.noreply.github.com>
Date: Mon, 12 Aug 2024 22:34:22 +0200
Subject: [PATCH] Bump authoring duration for async backing to 2s. (#5195)

Should be safe on all production network.

I noticed that Paseo needs to be updated, it is lacking behind in a
couple of things.

Execution environment parameters should be updated to those of Polkadot:

```
[
      {
        MaxMemoryPages: 8,192
      }
      {
        PvfExecTimeout: [
          Backing
          2,500
        ]
      }
      {
        PvfExecTimeout: [
          Approval
          15,000
        ]
      }
    ]
  ]
  ```

---------

Co-authored-by: eskimor <eskimor@no-such-url.com>
---
 cumulus/polkadot-parachain/src/service.rs  |  2 +-
 docs/sdk/src/guides/async_backing_guide.rs |  4 ++--
 prdoc/pr_5195.prdoc                        | 15 +++++++++++++++
 3 files changed, 18 insertions(+), 3 deletions(-)
 create mode 100644 prdoc/pr_5195.prdoc

diff --git a/cumulus/polkadot-parachain/src/service.rs b/cumulus/polkadot-parachain/src/service.rs
index 80698a2d7115..3b9ae6bd4457 100644
--- a/cumulus/polkadot-parachain/src/service.rs
+++ b/cumulus/polkadot-parachain/src/service.rs
@@ -832,7 +832,7 @@ where
 				relay_chain_slot_duration,
 				proposer: Proposer::new(proposer_factory),
 				collator_service,
-				authoring_duration: Duration::from_millis(1500),
+				authoring_duration: Duration::from_millis(2000),
 				reinitialize: false,
 			},
 		};
diff --git a/docs/sdk/src/guides/async_backing_guide.rs b/docs/sdk/src/guides/async_backing_guide.rs
index a9fda2c3aa8a..25ef3a12cbf0 100644
--- a/docs/sdk/src/guides/async_backing_guide.rs
+++ b/docs/sdk/src/guides/async_backing_guide.rs
@@ -174,7 +174,7 @@
 //!    - In the `para_client` field, pass in a cloned para client rather than the original
 //!    - Add a `para_backend` parameter after `para_client`, passing in our para backend
 //!    - Provide a `code_hash_provider` closure like that shown below
-//!    - Increase `authoring_duration` from 500 milliseconds to 1500
+//!    - Increase `authoring_duration` from 500 milliseconds to 2000
 //! ```ignore
 //! let params = AuraParams {
 //!     ..
@@ -185,7 +185,7 @@
 //!         client.code_at(block_hash).ok().map(|c| ValidationCode::from(c).hash())
 //!     },
 //!     ..
-//!     authoring_duration: Duration::from_millis(1500),
+//!     authoring_duration: Duration::from_millis(2000),
 //!     ..
 //! };
 //! ```
diff --git a/prdoc/pr_5195.prdoc b/prdoc/pr_5195.prdoc
new file mode 100644
index 000000000000..cfd435fa289d
--- /dev/null
+++ b/prdoc/pr_5195.prdoc
@@ -0,0 +1,15 @@
+# Schema: Polkadot SDK PRDoc Schema (prdoc) v1.0.0
+# See doc at https://raw.githubusercontent.com/paritytech/polkadot-sdk/master/prdoc/schema_user.json
+
+title: Bump Aura authoring duration to 2s.
+
+doc:
+  - audience: Node Dev
+    description: |
+      This PR bumps the Aura authoring duration in the asynchronous backing
+      guide and the polkadot-parachain service file to 2s in order to make
+      better use of the provided coretime.
+
+crates:
+  - name: polkadot-parachain-bin
+    bump: patch