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

# Wallet & DeFi Tools

> Wallet state, DeFi positions, pools, routing, and execution tools.

## Balance and position tools

### `BalanceTool`

Input:

* `chainId: number`
* `account: string`
* `for_user: boolean`

```ts theme={null}
await sdk.executeTool("BalanceTool", { chainId: 1, account: "0xabc...", for_user: true });
```

### `DefiPositionsTool`

Input:

* `address: string`
* `chain: number`
* `provider: string`

```ts theme={null}
await sdk.executeTool("DefiPositionsTool", {
  address: "0xabc...",
  chain: 42161,
  provider: "aave",
});
```

### `PoolTool`

Input:

* `chainId: number`
* `provider: string`

```ts theme={null}
await sdk.executeTool("PoolTool", { chainId: 8453, provider: "uniswap" });
```

## Route planning and execution tools

### `ZapCallDataGeneratorTool`

Generates and caches route/calldata in session scope.

Required fields include:

* source and destination token/chain/decimals
* `account`, `recipient`
* `amount`, `decimalAmount`
* `sessionId`
* `type: "swap" | "bridge" | "zap"`

```ts theme={null}
await sdk.executeTool("ZapCallDataGeneratorTool", {
  srcToken: "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eB48",
  srcChainId: 1,
  srcDecimals: 6,
  destToken: "0xC02aaa39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  destChainId: 1,
  destDecimals: 18,
  account: "0xabc...",
  recipient: "0xabc...",
  amount: "1000000",
  decimalAmount: "1",
  sessionId: "session-1",
  type: "swap",
});
```

### `PerformZapTool` (interactive)

Input:

* `sessionId: string`

Behavior:

1. Loads cached route
2. Requests confirmation (when enabled)
3. Handles approvals and sends transaction
4. Waits for receipt and clears cached route

```ts theme={null}
await sdk.executeTool("PerformZapTool", { sessionId: "session-1" });
```

## Chain-change helpers

### `RequestChainChangeTool`

Queues chain-switch request context:

* `chainID: number`
* `sessionId: string`

### `ChangeChainTool` (interactive)

Waits for user confirmation (up to 120 seconds), then resolves via `confirmChainChange` or `POST /zap/chain/:sessionId`.

### `ShowBalanceUITool`

UI trigger tool that expects strict `tokens: TokenEntry[]` payload.