How to increase the bulk transaction size limit

By default, the Ledger has a maximum bulk transaction size of 100 items.

This limitation has been introduced to avoid timeouts when huge bulk are sent.

To make larger bulk, we recommend to use stream mode now.

📄 How to Use Bulk Operations with Streaming in the Ledger API

You can increase this limit using one of two methods, depending on your deployment:

Using Command Line Flags

When running the Ledger directly, use the --bulk-max-size flag to specify a larger bulk size limit:

ledger --bulk-max-size 1000

Using Environment Variables in Docker

When running with Docker Compose, set the bulk size limit using the BULK_MAX_SIZE environment variable in your docker-compose.yml file:

services:
  ledger:
    environment:
      - BULK_MAX_SIZE=1000