# batch (/docs/tx/batch)

Wraps the child calls in `Utility.batch_all`: they run in order and if
any one fails the whole extrinsic reverts, so there is never a
partially-applied result. Use it for multi-step operations that must land
together (e.g. move funds then act on them) instead of submitting the
steps separately and risking a half-done state. All children must share
one signer — an extrinsic has a single signature — and batches cannot
contain other batches. Spend limits and policy checks aggregate across
every child, and the transaction plan lists each child's effects.

| Signer    | Pallet  | Wraps               |
| --------- | ------- | ------------------- |
| `coldkey` | Utility | `Utility.batch_all` |

## Parameters [#parameters]

| Parameter | Type  | Required | Description                                                                                                                                             |
| --------- | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `intents` | array | yes      | The calls to execute, in order, as a JSON list of objects \{"op": \<intent name>, ...args}. At least one; all must share a signer; batches cannot nest. |

Address parameters (`--hotkey`, `--coldkey`, `--dest`, ...) accept a raw ss58
address, an address-book or proxy-book name, or a local wallet/hotkey name.

## CLI [#cli]

Preview with `--dry-run` (shows fee, effects, and policy result without
submitting), then submit:

```bash
btcli tx batch \
  --intents <a,b,c> --dry-run
btcli tx batch \
  --intents <a,b,c> -w my_coldkey
```

## Python [#python]

```python
import bittensor as sub
from bittensor.wallet import Wallet

wallet = Wallet(name="my_coldkey", hotkey="my_hotkey")
intent = sub.Batch(intents=[...])

async with sub.Client("finney") as client:
    plan = await client.plan(intent, wallet)   # fee, effects, policy — no submission
    result = await client.execute(intent, wallet)
    if not result.success:
        print(result.error.code, result.error.remediation)
```

Or build it by op name, as an agent would:

```python
await client.execute_tool("batch", {...}, wallet)
```