# @bagsfm/bags-sdk 中文文档

规范地址：https://npmcn.com/package/%40bagsfm/bags-sdk/

版本：1\.4\.4
npm 元数据更新时间：2026-08-23T23:04:58.208Z
中文译文更新时间：2026-11-07T20:57:45.334Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40bagsfm/bags-sdk
原文对照：https://npmcn.com/package/%40bagsfm/bags-sdk/?lang=original
项目主页：https://bags.fm/
源码仓库：https://github.com/bagsfm/bags-public-api-sdk

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

- 包体积（解压后）：1.7 MB，163 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：8 个
- 首次发布：2025-08-06T21:35:29.090Z
- 最新版本发布：2026-08-23T23:04:58.015Z
- 近 30 天下载量：2588（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：37（近 12 个月 24 个）

## 中文简介

袋的脚本 SDK 类型

## 安装

```sh
npm install @bagsfm/bags-sdk
```

也可以使用：`pnpm add @bagsfm/bags-sdk`、`yarn add @bagsfm/bags-sdk`、`bun add @bagsfm/bags-sdk`

## README

# @ bagsfm/ bags- sdk

[![npm version](https://badge.fury.io/js/@bagsfm%2Fbags-sdk.svg)](https://badge.fury.io/js/@bagsfm%2Fbags-sdk) [![npm downloads](https://img.shields.io/npm/dm/@bagsfm/bags-sdk.svg)](https://www.npmjs.com/package/@bagsfm/bags-sdk) [![license](https://img.shields.io/npm/l/@bagsfm/bags-sdk.svg)](https://github.com/bagsfm/bags-public-api-sdk/blob/main/LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![Solana](https://img.shields.io/badge/Solana-9945FF?logo=solana&logoColor=white)](https://solana.com/)

一个用于与 Bags Public API 互动的TypeScript SDK - 索拉纳令牌发布和管理平台.

详细的API文件、指南和实例,访问 [文件.bags.fm](https://docs.bags.fm/)。 。 。 .

## 安装

```bash
npm install @bagsfm/bags-sdk
```

## 使用量

```typescript
import { BagsSDK } from '@bagsfm/bags-sdk';
import { Connection, PublicKey } from '@solana/web3.js';

// Initialize the SDK
const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=your-helius-api-key'); // Or any other RPC provider
const sdk = new BagsSDK('your-bags-api-key', connection, 'processed');

// Query token creators
const tokenMint = new PublicKey('your-token-mint-address');
const creators = await sdk.state.getTokenCreators(tokenMint);
console.log('Token creators:', creators);

// Get a swap quote
const quote = await sdk.trade.getQuote({
  inputMint: 'So11111111111111111111111111111111111111112',
  outputMint: 'your-token-mint-address',
  amount: 1_000_000_000, // 1 SOL in lamports
  slippageMode: 'dynamic',
});
console.log('Swap quote:', quote);

// Claim fees
const claimable = await sdk.fee.getAllClaimablePositions(walletPublicKey);
console.log('Claimable positions:', claimable);
```

## API 参考

### BagsSDK 软件

提供所有服务的SDK主课.

#### 构造器

```typescript
new BagsSDK(apiKey: string, connection: Connection, commitment?: Commitment)
```

**参数:**

-   `apiKey`: 您的 Bags API 密钥
-   `connection`: 索拉纳网3.js 连接实例
-   `commitment`: (可选)交易承诺级别(默认: `'processed'`(中文(简体) )

### 服务

| 服务 | 财产 | 说明 |
| --- | --- | --- |
| **API 客户端** | `sdk.bagsApiClient` | 用于直接 Bags API 呼叫的低级 HTTP 客户端 |
| **托肯启动** | `sdk.tokenLaunch` | 创建令牌启动并上传令牌元数据 |
| **状态** | `sdk.state` | 查询象征性创建者、终身费用、领导板、发射钱包和索赔数据 |
| **配置** | `sdk.config` | 创建和管理费用分摊配置和查询表 |
| **收费** | `sdk.fee` | 列出可索赔的手续费和建筑索赔交易 |
| **合伙人** | `sdk.partner` | 阅读/创建伙伴配置和索赔伙伴费用 |
| **贸易** | `sdk.trade` | 获取互换报价并构建互换交易 |
| **索拉纳** | `sdk.solana` | 提交 Jito 捆绑, 检查捆绑状态, 并查询 Jito 小费 |
| **收费共享管理员** | `sdk.feeShareAdmin` | 传输管理员角色、 列出管理员薄荷并更新共享配置 |
| **屏幕** | `sdk.dexscreener` | 检查订单可用性、创建订单并提交Dexscreener列表的付款 |
| **认证** | `sdk.auth` | 获取 API 密钥所有者的用户配置 |
| **罗宾** | `sdk.robinhood` | 列出Robinhood Chain可索赔的据点和未签字的索赔交易 |

### 出口公用事业

SDK 也导出您可以直接导入的辅助函数和类型 :

```typescript
import {
  sleep,
  chunkArray,
  signAndSendTransaction,
  sendBundleAndConfirm,
  createTipTransaction,
  serializeVersionedTransaction,
  prepareImageForFormData,
  detectImageInputType,
  sortKeys,
} from '@bagsfm/bags-sdk';
```

### 导出常数

常见的程序ID和地址为已命名的导出:

```typescript
import {
  BAGS_FEE_SHARE_V1_PROGRAM_ID,
  BAGS_FEE_SHARE_V2_PROGRAM_ID,
  METEORA_DBC_PROGRAM_ID,
  METEORA_DAMM_V2_PROGRAM_ID,
  BAGS_GLOBAL_LUT,
  WRAPPED_SOL_MINT,
  JITO_TIP_ACCOUNTS,
} from '@bagsfm/bags-sdk';
```

## 所需资源

-   节点.js 18.0.0
-   一个 Bags API 密钥( 在 [https://dev.bags.fm (英语)](https://dev.bags.fm/)(中文(简体) )
-   Solana RPC 供应商(我们建议 [赫利乌斯](https://helius.dev/) - 他们提供免费等级)

## 发展

```bash
# Install dependencies
npm install

# Build the project
npm run build

# Watch mode for development
npm run dev

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

# Lint source files
npm run lint

# Lint and auto-fix
npm run lint:fix

# Format source files
npm run format

# Check formatting
npm run format:check

# Clean build artifacts
npm run clean
```

## 许可证

麻省理工学院

## 支助

问题请访问 [GitHub 问题](https://github.com/bagsfm/bags-public-api-sdk/issues)。 。 。 .

## 常见问题

### @bagsfm/bags-sdk 是什么？

袋的脚本 SDK 类型

### 如何安装 @bagsfm/bags-sdk？

在项目目录运行 npm install @bagsfm/bags-sdk，或使用 pnpm add / yarn add / bun add。

### @bagsfm/bags-sdk 支持 TypeScript 吗？

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

### @bagsfm/bags-sdk 支持 ESM 还是 CommonJS？

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

### @bagsfm/bags-sdk 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @bagsfm/bags-sdk 可以商用吗？

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

### @bagsfm/bags-sdk 的下载量有多少？

根据 npm 官方下载统计，@bagsfm/bags-sdk 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,588 次，日均约 86 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bagsfm/bags-sdk 还在维护吗？

最新版本 1\.4\.4 发布于 2026/08/24（2 个月前）；至今共发布 37 个版本，其中过去 12 个月发布了 24 个；首次发布于 2025/08/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。