> ## 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.

# 高级 Arkade 集成

> 可选 Arkade 协议集成。

普通网站使用主入口即可。构建 Arkade 协议交易时可使用可选适配器，签名交给插件。

```sh theme={null}
npm install @arkade-os/sdk@0.4.79 @scure/base@2
```

```ts theme={null}
import { createArksatSdkWallet } from '@arksat/wallet-sdk/arkade'
import type { ArksatProvider } from '@arksat/wallet-sdk'
import type { StorageConfig } from '@arkade-os/sdk'

// storage 由应用按 origin、账户地址和网络隔离后传入。
export async function openProtocolWallet(provider: ArksatProvider, storage: StorageConfig) {
  const adapter = await createArksatSdkWallet(provider, {
    expectedNetwork: 'mainnet',
    expectedArkServerUrl: 'https://arkade.computer',
    storage,
  })
  await adapter.assertActive()
  return adapter
}
```

先连接并获得所需授权。服务地址须与你支持的部署一致，示例固定为主网，不能直接用于测试网。适配器检查插件会话和 SDK 地址一致性。

存储仓库按网站、账户、网络隔离。协议操作前调用 assertActive；锁定、断连、切换账户 / 网络时停止工作并 dispose，重新建立适配器。

返回 wallet、identity、session、assertActive、dispose。适配器关闭自动 settlement / renewal，不要另行启动自动结算。私钥保留在插件，交互签名由用户确认。

只有 `/arkade` 加载可选依赖，主入口不加载 Arkade 或 Chrome API。目前按 Arkade 0.4.79 验证，升级依赖应重新做兼容性测试。


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