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

# 网络与会话

> 读取能力、状态与会话，切换钱包网络。

示例使用 `createArksatClient(provider)`。

## getCapabilities

查询 API 版本、支持方法与网络。以实际返回能力判断可用功能。

**参数**

无参数。

**返回**

```ts theme={null}
Promise<ArksatCapabilities>
```

**示例**

```ts theme={null}
const capabilities = await client.getCapabilities()
```

## getProviderState

读取连接、解锁、账户与网络状态。

**参数**

无参数。

**返回**

```ts theme={null}
Promise<ArksatProviderState>
```

**示例**

```ts theme={null}
const state = await client.getProviderState()
```

## getNetwork

读取当前网络和 Arkade 服务信息。

**参数**

无参数。

**返回**

```ts theme={null}
Promise<ArksatNetworkInfo>
```

**示例**

```ts theme={null}
const network = await client.getNetwork()
```

## getWalletSession

取得当前公开会话快照。Bitcoin 链上入金地址读取 boardingAddress；没有独立 getBoardingAddress RPC。

**参数**

无参数。

**返回**

```ts theme={null}
Promise<ArksatWalletSession>
```

**示例**

```ts theme={null}
const session = await client.getWalletSession()
```

## switchNetwork

请求切换网络。成功后重新读取网络、账户、余额和会话。

**参数**

```ts theme={null}
{ network: 'mainnet' | 'mutinynet' }
```

**返回**

```ts theme={null}
Promise<void>
```

**示例**

```ts theme={null}
await client.switchNetwork({ network: 'mutinynet' })
```

## 会话校验

支持 `ArksatSessionGuard` 的操作可以传入 `expectedAddress`、`expectedNetwork`、`expectedSessionId`，避免用户切换账户或网络后继续使用旧上下文。[高级集成](https://docs.arksat.xyz/advanced.md)。

[错误处理](https://docs.arksat.xyz/errors.md) · [完整 TypeScript 类型](https://docs.arksat.xyz/reference/types.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.