docs: add AccountBatchCloneStep documentation and update changelog

Updates:
- docs/source/user_documentation/steps.md: Add full AccountBatchCloneStep section with YAML example, feature bullets, and 4-phase execution description
- docs/source/dev_documentation/changelog.md: Added AccountBatchCloneStep, set_states_batched, _set_state_with_retry to Unreleased Added section; added Changed section for config updates and extracted functions
- CLAUDE.md: Updated step count from 28 to 29, added AccountBatchClone to Setup list

Author: EtienneWallet

CLAUDE.md

@@ -53,11 +53,11 @@ YAML Scene -> Steps -> Transactions/Queries -> MultiversX Network
 | `tests/` | Unit tests (pytest) |
 | `integration_tests/` | Chain-simulator/devnet integration tests |
 
-### All Step Types (28)
+### All Step Types (29)
 **Contracts**: `ContractDeploy`, `ContractUpgrade`, `ContractCall`, `ContractQuery`, `FileFuzzer`
 **Transfers**: `Transfer`
 **Tokens**: `FungibleIssue`, `NonFungibleIssue`, `SemiFungibleIssue`, `MetaIssue`, `FungibleMint`, `NonFungibleMint`, `ManageFungibleTokenRoles`, `ManageNonFungibleTokenRoles`, `ManageSemiFungibleTokenRoles`, `ManageMetaTokenRoles`
-**Setup**: `GenerateWallets`, `ChainSimulatorFaucet`, `R3D4Faucet`, `AccountClone`
+**Setup**: `GenerateWallets`, `ChainSimulatorFaucet`, `R3D4Faucet`, `AccountClone`, `AccountBatchClone`
 **Control**: `Loop`, `Scene`, `SetVars`, `SetSeed`, `Assert`, `Wait`, `Log`, `Python`
 
 ### Smart Values Syntax

docs/source/dev_documentation/changelog.md

@@ -4,10 +4,18 @@
 
 ### Added
 
+- `AccountBatchCloneStep` for optimized bulk account cloning: collects all data first, then pushes with single ESDT module reconciliation, single Elasticsearch bulk insert, and smart payload-sized batched `set_state` calls
 - `ChainSimulatorSetStateStep` to set specific hex-encoded storage key-value pairs for an address on the chain simulator
 - Explicit test for variadic counted values
 - Dynamic batch size recovery: after a timeout reduces the batch size, subsequent successful requests with smaller payloads automatically double the batch size back toward the original (for both storage fetch and push operations)
 - Tests verifying batch size resets between accounts
+- `set_states_batched` helper for pushing multiple account states with automatic payload-size grouping
+- `_set_state_with_retry` helper for transient failure resilience on `set_state` calls
+
+### Changed
+
+- Chain simulator default `API_RATE_LIMIT` increased to 100 (from 2) and `STORAGE_ITERATION_BATCH_SIZE` to 5000 (from 1000) for faster localhost operations
+- `AccountCloneStep` internal methods extracted into reusable module-level functions
 
 ### Fixed
 

docs/source/user_documentation/steps.md

@@ -713,6 +713,39 @@ caching_period: "10 days"  # optional, default to 10 days
 
 Account cloning can lead to huge data requests. If you are using the public proxy, please use a high caching period.
 
+(account_batch_clone_target)=
+### Account Batch Clone Step
+
+Exclusive to the chain simulator.
+This step allows you to clone multiple accounts from another network in an optimized batch fashion. Unlike running multiple `AccountClone` steps sequentially, `AccountBatchClone` collects all data first and then pushes it efficiently:
+
+- **Single ESDT module reconciliation** instead of one per account (avoids O(n²) growing fetches)
+- **Single Elasticsearch bulk insert** for all tokens across all accounts
+- **Smart batched `set_state` calls** grouped by payload size
+
+This is recommended when cloning many accounts (e.g. all pools from a DEX).
+
+```yaml
+type: AccountBatchClone
+addresses:
+  - "erd1qqq..."
+  - "erd1qqq..."
+  - "%my_contract.address"
+source_network: mainnet
+clone_balance: true  # optional, default to true
+clone_code: true  # optional, default to true
+clone_storage: true  # optional, default to true
+clone_esdts: true  # optional, default to true
+overwrite: true  # optional, default to true
+caching_period: "10 days"  # optional, default to 10 days
+```
+
+The step logs per-phase timing so you can see where time is spent:
+- **Phase 1**: Collecting account and storage data (cached after first run)
+- **Phase 2**: Reconciling ESDT identifiers with the chain simulator
+- **Phase 3**: Inserting token data into Elasticsearch
+- **Phase 4**: Pushing all account states to the chain simulator
+
 ## Miscellaneous Steps
 
 (loop_step_target)=