doc: http

Author: iyarsius

site/pages/docs/clients/transports/http.md

@@ -59,6 +59,32 @@ const [blockNumber, balance, ensName] = await Promise.all([
 ])
 ```
 
+You can also use the `waitAsRateLimit` option to send one batch per `wait` milliseconds if the batch size is reached.
+
+```ts twoslash
+import { createPublicClient, http } from 'viem'
+import { mainnet } from 'viem/chains'
+
+const client = createPublicClient({
+  chain: mainnet,
+  transport: http('https://1.rpc.thirdweb.com/...', {
+    batch: {
+      batchSize: 3,
+      wait: 100,
+      waitAsRateLimit: true, // [!code focus]
+    },
+  }),
+})
+// ---cut---
+// Each batch will be sent at most once every 100 milliseconds.
+const [blockNumber, balance, ensName] = await Promise.all([
+  client.getBlockNumber(),
+  client.getBalance({ address: '0xd2135CfB216b74109775236E36d4b433F1DF507B' }),
+  client.getEnsName({ address: '0xd2135CfB216b74109775236E36d4b433F1DF507B' }),
+  // client.get....
+]);
+```
+
 ## Parameters
 
 ### url (optional)
@@ -123,6 +149,25 @@ const transport = http('https://1.rpc.thirdweb.com/...', {
 })
 ```
 
+### batch.waitAsRateLimit (optional)
+
+- **Type:** `boolean`
+- **Default:** `false`
+
+Send one batch per `wait` milliseconds if the batch size is reached. By default, multiple batches are sent at once each `wait` milliseconds.
+
+Warning: This can lead to a high number of pending requests if the batch size is constantly exceeded without enough time to clear the queue.
+
+```ts twoslash
+import { http } from 'viem'
+// ---cut---
+const transport = http('https://1.rpc.thirdweb.com/...', {
+  batch: {
+    waitAsRateLimit: true // [!code focus]
+  }
+})
+```
+
 ### fetchOptions (optional)
 
 - **Type:** [`RequestInit`](https://developer.mozilla.org/en-US/docs/Web/API/fetch)