# @gnosis\.pm/safe-service-client 中文文档

规范地址：https://npmcn.com/package/%40gnosis.pm/safe-service-client/

版本：1\.4\.0
npm 元数据更新时间：2023-04-11T11:05:56.276Z
中文译文更新时间：2026-11-16T17:33:10.871Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gnosis.pm/safe-service-client
原文对照：https://npmcn.com/package/%40gnosis.pm/safe-service-client/?lang=original
项目主页：https://github.com/safe-global/safe-core-sdk#readme
源码仓库：https://github.com/safe-global/safe-core-sdk

弃用说明：Package no longer supported\. It has been migrated to @safe-global/api-kit\. Please, update your dependencies\.

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：122 kB，22 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2021-06-03T12:26:40.982Z
- 最新版本发布：2022-11-23T12:09:30.773Z
- 近 30 天下载量：3714（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 0 个）

## 中文简介

安全服务客户端

## 安装

```sh
npm install @gnosis.pm/safe-service-client
```

也可以使用：`pnpm add @gnosis.pm/safe-service-client`、`yarn add @gnosis.pm/safe-service-client`、`bun add @gnosis.pm/safe-service-client`

## README

# 安全服务客户端

[![NPM Version](https://badge.fury.io/js/%40gnosis.pm%2Fsafe-service-client.svg)](https://badge.fury.io/js/%40gnosis.pm%2Fsafe-service-client) [![GitHub Release](https://img.shields.io/github/release/safe-global/safe-core-sdk.svg?style=flat)](https://github.com/safe-global/safe-core-sdk/releases) [![GitHub](https://img.shields.io/github/license/safe-global/safe-core-sdk)](https://github.com/safe-global/safe-core-sdk/blob/main/LICENSE.md)

软件开发包,便利与 [安全交易服务API](https://github.com/safe-global/safe-transaction-service)。 。 。 .

## 目录

-   [安装](https://npmcn.com/package/%40gnosis.pm/safe-service-client/#readme-installation)
-   [构建](https://npmcn.com/package/%40gnosis.pm/safe-service-client/#readme-build)
-   [初始化](https://npmcn.com/package/%40gnosis.pm/safe-service-client/#readme-initialization)
-   [API 参考](https://npmcn.com/package/%40gnosis.pm/safe-service-client/#readme-api-reference)
-   [许可证](https://npmcn.com/package/%40gnosis.pm/safe-service-client/#readme-license)
-   [贡献者](https://npmcn.com/package/%40gnosis.pm/safe-service-client/#readme-contributors)

## 安装

用纱线或npm安装软件包 :

```bash
yarn install
npm install
```

## 构建

用纱线或npm来构建软件包 :

```bash
yarn build
npm build
```

## 初始化

### 证明 EthAdapter

首先,我们需要创建一个 `EthAdapter`,包含SDKs与区块链互动所需的所有公用事业. 用来包装 [网络3.js](https://web3js.readthedocs.io/) 或者说 [乙醚(js)](https://docs.ethers.io/v5/) 伊特鲁姆图书馆.

根据Dapp所使用的库,有两个选项:

-   [创建一个 `EthersAdapter` 实例](https://github.com/safe-global/safe-core-sdk/tree/main/packages/safe-ethers-lib#initialization)
-   [创建一个 `Web3Adapter` 实例](https://github.com/safe-global/safe-core-sdk/tree/main/packages/safe-web3-lib#initialization)

一旦发生 `EthersAdapter` 或者说 `Web3Adapter` 被创建,可用于SDK初始化.

### 初始化安全服务客户端

```js
import SafeServiceClient from '@gnosis.pm/safe-service-client'

const safeService = new SafeServiceClient({
  txServiceUrl: 'https://safe-transaction-mainnet.safe.global',
  ethAdapter
})
```

## API 参考

### 获取服务信息

返回服务的信息和配置.

```js
const serviceInfo: SafeServiceInfoResponse = await safeService.getServiceInfo()
```

### 获取服务MasterCopiesInfo

返回安全主副本列表.

```js
const masterCopies: MasterCopyResponse = await safeService.getServiceMasterCopiesInfo()
```

### 解码数据

解码指定的安全交易数据.

```js
const decodedData = await safeService.decodeData(data)
```

### 获取SafesByOwner

返回地址为所有者的保险箱列表.

```js
const safes: OwnerResponse = await safeService.getSafesByOwner(ownerAddress)
```

### 获取SafesByMudule

返回启用模块地址的“安全”列表.

```js
const safes: ModulesResponse = await getSafesByModule(moduleAddress)
```

### 获取交易

返回安全交易的所有信息.

```js
const tx: SafeMultisigTransactionResponse = await safeService.getTransaction(safeTxHash)
```

### 获取交易确认

返回给定的安全交易的确认列表.

```js
const confirmations: SafeMultisigConfirmationListResponse = await safeService.getTransactionConfirmations(safeTxHash)
```

### 确认交易

添加安全交易的确认.

```js
const signature: SignatureResponse = await safeService.confirmTransaction(safeTxHash, signature)
```

### 获取安全信息

返回所提供安全地址的信息和配置.

```js
const safeInfo: SafeInfoResponse = await safeService.getSafeInfo(safeAddress)
```

### 获得安全代表

返回给定安全地址的代表名单.

```js
const delegates: SafeDelegateListResponse = await safeService.getSafeDelegates(safeAddress)
```

### 添加安全

为给定的安全地址添加新的代表.

```js
const delegateConfig: SafeDelegateConfig = {
  safe,
  delegate,
  label,
  signer
}
await safeService.addSafeDelegate(delegateConfig)
```

### 删除所有安全代表

删除给定的安全地址的所有代表.

```js
await safeService.removeAllSafeDelegates(safeAddress, signer)
```

### 删除安全

删除给定的安全地址的代表.

```js
const delegateConfig: SafeDelegateDeleteConfig = {
  safe,
  delegate,
  signer
}
await safeService.removeSafeDelegate(delegateConfig)
```

### 获取安全创建信息

返回安全器的创建信息.

```js
const safeCreationInfo: SafeCreationInfoResponse = await safeService.getSafeCreationInfo(safeAddress)
```

### 估计安全交易

估计特定安全多签名交易的安全性TxGas.

```js
const estimateTx: SafeMultisigTransactionEstimateResponse = await safeService.estimateSafeTransaction(
  safeAddress,
  safeTransaction
)
```

### 建议交易

创建新的多签名交易,并将其存储在安全交易处.

```js
const transactionConfig: ProposeTransactionProps = {
  safeAddress,
  safeTxHash,
  safeTransactionData,
  senderAddress,
  senderSignature,
  origin
}
await safeService.proposeTransaction(transactionConfig)
```

### 获取交易

返回安全账户的进账历史.

```js
const incomingTxs: TransferListResponse = await safeService.getIncomingTransactions(safeAddress)
```

### 获取模块交易

返回安全账户模块交易的历史.

```js
const moduleTxs: SafeModuleTransactionListResponse = await safeService.getModuleTransactions(safeAddress)
```

### 获得多相转换

返回安全账户多签名交易的历史.

```js
const multisigTxs: SafeMultisigTransactionListResponse = await safeService.getMultisigTransactions(safeAddress)
```

### 获取待定交易

返回正在等待安全所有人确认的多签名交易清单.

```js
const pendingTxs: SafeMultisigTransactionListResponse = await safeService.getPendingTransactions(safeAddress)
```

```js
const pendingTxs: SafeMultisigTransactionListResponse = await safeService.getPendingTransactions(
  safeAddress,
  currentNonce
)
```

### 获取全部交易

返回安全交易列表。 该列表根据交易类型有不同的结构.

```js
const allTxs: SafeMultisigTransactionListResponse = await safeService.getAllTransactions(safeAddress)
```

```js
const allTxsOptions: AllTransactionsOptions = {
  executed,
  queued,
  trusted
}
const allTxs: SafeMultisigTransactionListResponse = await safeService.getAllTransactions(
  safeAddress,
  allTxsOptions
)
```

### 获取下一个 Nonce

返回在上次待决交易后提出新交易的权利非ce.

```js
const nextNonce = await safeService.getNextNonce(safeAddress)
```

### 获取基准

返回 Ether 和 ERC20 安全符的余额.

```js
const balances: SafeBalanceResponse[] = await safeService.getBalances(safeAddress)
```

此方法可选择接受 `options` 参数 :

```js
const options: SafeBalancesOptions = {
  excludeSpamTokens  // Optional. Default value is `true`.
}
const balances: SafeBalanceResponse[] = await safeService.getBalances(safeAddress, options)
```

### 获取UsdBalances

返回保险箱以太和 ERC20 代号的余额,并转换为美元.

```js
const usdBalances: SafeBalanceUsdResponse[] = await safeService.getUsdBalances(safeAddress)
```

此方法可选择接受 `options` 参数 :

```js
const options: SafeBalancesUsdOptions = {
  excludeSpamTokens // Optional. Default value is `true`.
}
const usdBalances: SafeBalanceUsdResponse[] = await safeService.getUsdBalances(safeAddress, options)
```

### 获取可拼贴

返回给定的“安全”拥有的集体(ERC721)及其相关信息.

```js
const collectibles: SafeCollectibleResponse[] = await safeService.getCollectibles(safeAddress)
```

此方法可选择接受 `options` 参数 :

```js
const options: SafeCollectiblesOptions = {
  excludeSpamTokens // Optional. Default value is `true`.
}
const collectibles: SafeCollectibleResponse[] = await safeService.getCollectibles(safeAddress, options)
```

### 获取托肯列表

返回保险箱处理的所有 ERC20 令牌的列表 .

```js
const tokens: TokenInfoListResponse = await safeService.getTokenList()
```

### 获取托肯

返回给定的 ERC20 令牌的信息 .

```js
const token: TokenInfoResponse = await safeService.getToken(tokenAddress)
```

## 许可证

这个库在麻省理工学院下发行.

## 贡献者

-   热尔曼·马丁内斯(签名)[德国](https://github.com/germartinez)(中文(简体) )

## 常见问题

### @gnosis\.pm/safe-service-client 是什么？

安全服务客户端注意：该包已被作者标记为弃用——Package no longer supported\. It has been migrated to @safe-global/api-kit\. Please, update your dependencies\.

### 如何安装 @gnosis\.pm/safe-service-client？

在项目目录运行 npm install @gnosis\.pm/safe-service-client，或使用 pnpm add / yarn add / bun add。

### @gnosis\.pm/safe-service-client 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @gnosis\.pm/safe-service-client 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @gnosis\.pm/safe-service-client 可以商用吗？

@gnosis\.pm/safe-service-client 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gnosis\.pm/safe-service-client 的下载量有多少？

根据 npm 官方下载统计，@gnosis\.pm/safe-service-client 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,714 次，日均约 124 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gnosis\.pm/safe-service-client 还在维护吗？

最新版本 1\.4\.0 发布于 2022/11/23（3 年前）；至今共发布 12 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/06/03。作者已将其标记为弃用，新项目建议寻找替代方案。

