> ## Documentation Index
> Fetch the complete documentation index at: https://docs.therootnetwork.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Utility

## Calls

### asDerivative

Send a call through an indexed pseudonym of the sender.

Filter from origin are passed along. The call will be dispatched with an origin which use the same filter as the origin of this call.

**NOTE**:

* If you need to ensure that any account-based filtering is not honored (i.e. because you expect `proxy` to have been used prior in the call stack and you do not want the call restrictions to apply to any sub-accounts), then use `as_multi_threshold_1` in the Multisig pallet instead.

* Prior to version \*12, this was called `as_limited_sub`.

The dispatch origin for this call must be *Signed*.

**Namespace**

```
api.tx.utility.asDerivative
```

**Type**

```
function asDerivative(
  index: u16,
  call: Call
)
```

### batch

Send a batch of dispatch calls.

May be called from any origin.

* `calls`: The calls to be dispatched from the same origin. The number of call must not exceed the constant: `batched_calls_limit` (available in constant metadata).

If origin is root then call are dispatch without checking origin filter. (This includes bypassing `frame_system::Config::BaseCallFilter`).

This will return `Ok` in all circumstances. To determine the success of the batch, an event is deposited. If a call failed and the batch was interrupted, then the `BatchInterrupted` event is deposited, along with the number of successful calls made and the error of the failed call. If all were successful, then the `BatchCompleted` event is deposited.

**Namespace**

```
api.tx.utility.batch
```

**Type**

```
function batch(
  calls: Vec<Call>
)
```

### batchAll

Send a batch of dispatch calls and atomically execute them. The whole transaction will rollback and fail if any of the calls failed.

May be called from any origin.

* `calls`: The calls to be dispatched from the same origin. The number of call must not exceed the constant: `batched_calls_limit` (available in constant metadata).

If origin is root then call are dispatch without checking origin filter. (This includes bypassing `frame_system::Config::BaseCallFilter`).

**Namespace**

```
api.tx.utility.batchAll
```

**Type**

```
function batchAll(
  calls: Vec<Call>
)
```

### dispatchAs

Dispatches a function call with a provided origin.

The dispatch origin for this call must be *Root*.

**Namespace**

```
api.tx.utility.dispatchAs
```

**Type**

```
function dispatchAs(
  as_origin: SeedRuntimeOriginCaller,
  call: Call
)
```

### forceBatch

Send a batch of dispatch calls. Unlike `batch`, it allows errors and won't interrupt.

May be called from any origin.

* `calls`: The calls to be dispatched from the same origin. The number of call must not exceed the constant: `batched_calls_limit` (available in constant metadata).

If origin is root then call are dispatch without checking origin filter. (This includes bypassing `frame_system::Config::BaseCallFilter`).

**Namespace**

```
api.tx.utility.forceBatch
```

**Type**

```
function forceBatch(
  calls: Vec<Call>
)
```

undefined## Events

### BatchCompleted

Batch of dispatches completed fully with no error.

**Namespace**

```
api.events.utility.BatchCompleted
```

**Type**

```
type BatchCompleted = {

}
```

### BatchCompletedWithErrors

Batch of dispatches completed but has errors.

**Namespace**

```
api.events.utility.BatchCompletedWithErrors
```

**Type**

```
type BatchCompletedWithErrors = {

}
```

### BatchInterrupted

Batch of dispatches did not complete fully. Index of first failing dispatch given, as well as the error.

**Namespace**

```
api.events.utility.BatchInterrupted
```

**Type**

```
type BatchInterrupted = {
  index: u32,
  error: SpRuntimeDispatchError
}
```

### DispatchedAs

A call was dispatched.

**Namespace**

```
api.events.utility.DispatchedAs
```

**Type**

```
type DispatchedAs = {
  result: Result<Null, SpRuntimeDispatchError>
}
```

### ItemCompleted

A single item within a Batch of dispatches has completed with no error.

**Namespace**

```
api.events.utility.ItemCompleted
```

**Type**

```
type ItemCompleted = {

}
```

### ItemFailed

A single item within a Batch of dispatches has been completed with error.

**Namespace**

```
api.events.utility.ItemFailed
```

**Type**

```
type ItemFailed = {
  error: SpRuntimeDispatchError
}
```

## Errors

### TooManyCalls

Too many calls batched.

**Namespace**

```
api.errors.utility.TooManyCalls
```

## Constants

### batchedCallsLimit

The limit on the number of batched calls.

**Namespace**

```
api.consts.utility.batchedCallsLimit
```

**Type**

```
type batchedCallsLimit = u32
```
