# @avalanche-sdk/client 中文文档

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

版本：0\.1\.4
npm 元数据更新时间：2026-10-27T13:56:33.757Z
中文译文更新时间：2026-11-07T07:36:09.288Z
软件包许可：BSD-3-Clause

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

原始 npm 页面：https://www.npmjs.com/package/%40avalanche-sdk/client
原文对照：https://npmcn.com/package/%40avalanche-sdk/client/?lang=original
项目主页：https://github.com/ava-labs/avalanche-sdk-typescript/tree/main/client#readme
源码仓库：https://github.com/ava-labs/avalanche-sdk-typescript

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

- 包体积（解压后）：5.3 MB，2085 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：5 个
- 首次发布：2025-08-13T08:40:50.627Z
- 最新版本发布：2026-10-27T13:56:33.293Z
- 近 30 天下载量：2234（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 9 个）

## 中文简介

一个TypeScript SDK用于通过JSON-RPC API与Avalanche网络互动. 这个SDK提供了一整套工具,可以与所有Avalanche链(P-Chain,X-Chain,C-Chain)和各种API交互,包括tranca的钱包功能

## 安装

```sh
npm install @avalanche-sdk/client
```

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

## README

# 雪崩 SDK 客户端

一个TypeScript SDK用于通过JSON-RPC API与Avalanche网络互动. 这个SDK提供了一套全面的工具,可以与所有Avalanche链(P-Chain,X-Chain,C-Chain)和各种API交互,包括交易签名和管理的钱包功能.

## 安装

```bash
npm install @avalanche-sdk/client
# or
yarn add @avalanche-sdk/client
# or
pnpm add @avalanche-sdk/client
```

## 快速启动

### 使用雪崩客户端

```typescript
import { createAvalancheClient } from '@avalanche-sdk/client'
import { avalanche } from '@avalanche-sdk/client/chains'

// Create an Avalanche client
const client = createAvalancheClient({
  chain: avalanche,
  transport: {
    type: "http",
  },
})

// Access different chain clients
const pChainClient = client.pChain
const xChainClient = client.xChain
const cChainClient = client.cChain

// Access API clients
const adminClient = client.admin
const infoClient = client.info
const healthClient = client.health
const indexPChainBlockClient = client.indexBlock.pChain  
const proposervmCChainClient = client.proposervm

// Example: Get the latest block number
const blockNumber = await pChainClient.getBlockNumber()

// Example: Get base fee
const baseFee = await client.getBaseFee()
```

### 钱包客户端使用

```typescript
import { createAvalancheWalletClient, privateKeyToAvalancheAccount } from '@avalanche-sdk/client'
import { avalanche } from '@avalanche-sdk/client/chains'
import { avaxToNanoAvax } from '@avalanche-sdk/client/utils'

// Create an account from private key
const account = privateKeyToAvalancheAccount("0x1234567890123456789012345678901234567890123456789012345678901234")

// Get P chain Address and Evm Address
const evmAddress = account.getEVMAddress()
const pchainAddress = account.getXPAddress("P", "fuji")

// Create a wallet client
const walletClient = createAvalancheWalletClient({
  account,
  chain: avalanche,
  transport: {
    type: "http",
  },
})

// Prepare a txn request
const xChainExportTxnRequest = await walletClient.xChain.prepareExportTxn({
  exportedOutputs: [
    {
      addresses: [account.getXPAddress("X", "fuji")], // X-fuji19fc97zn3mzmwr827j4d3n45refkksgms4y2yzz
      amount: avaxToNanoAvax(0.001),
    },
  ],
  destinationChain: "P",
});

// Send an XP transaction
const result = await walletClient.sendXPTransaction(xChainExportTxnRequest)

// Sign a message
const signedMessage = await walletClient.signXPMessage({
  message: "Hello Avalanche",
})

// Get account public key
const pubKey = await walletClient.getAccountPubKey()

// Wait for transaction confirmation
await walletClient.waitForTxn({
  txID: "2QouvMUbQ6oy7yQ9tLvL3L8tGQG2QK1wJ1q1wJ1q1wJ1q1wJ1q1wJ1q1wJ1",
  chainAlias: "X"
})
```

### 链状钱包操作

```typescript
// P-Chain wallet operations
const pChainWallet = walletClient.pChain

// Prepare add validator transaction
const validatorTx = await pChainWallet.prepareAddPermissionlessValidatorTxn({
  nodeId: "NodeID-7Xhw2mDxuDS44j42TCB6U5579esbSt3Lg",
  stakeInAvax: avaxToNanoAvax(1),
  end: 1716441600,
  rewardAddresses: ["P-fuji19fc97zn3mzmwr827j4d3n45refkksgms4y2yzz"],
  threshold: 1,
  publicKey: "0x1234567890123456789012345678901234567890",
  signature: "0x1234567890123456789012345678901234567890",
  locktime: 1716441600,
  delegatorRewardPercentage: 2.5,
  delegatorRewardAddresses: ["P-fuji19fc97zn3mzmwr827j4d3n45refkksgms4y2yzz"],
})

// X-Chain wallet operations
const xChainWallet = walletClient.xChain

// Prepare base transaction
const baseTx = await xChainWallet.prepareBaseTxn({
  outputs: [{
    addresses: ["X-avax18jma8ppw3nhx5r4ap8clazz0dps7rv5ukulre5"],
    amount: avaxToNanoAvax(1), // 1 AVAX
  }],
})

// C-Chain wallet operations
const cChainWallet = walletClient.cChain

// Prepare export transaction
const exportTx = await cChainWallet.prepareExportTxn({
  to: "P-fuji1j2zllfqv4mgg7ytn9m2u2x0q3h3jqkzq8q8q8q8",
  amount: avaxToNanoAvax(1), // 1 AVAX = 1_000_000_000 nAvax
  destinationChain: "X"
})
```

## 特征

-   **多钱支持**: 与所有雪崩链相互作用:
    -   P-Chain(平面链)
    -   X-Chain(交换链)
    -   C-Chain(合同链)
-   **钱包功能**: 完成钱包操作,包括:
    -   交易签名和发送
    -   信件签名
    -   账户管理
    -   特定交易链的准备
-   **API 客户端**数字 :
    -   管理 API
    -   信息 API
    -   卫生协会
    -   索引 API
-   **类型脚本支持**: 带有类型定义的完整类型脚本支持
-   **模块设计**: 通过专用客户端访问特定功能

## 可用的客户端

### 链式客户端

-   **P- Chain 客户端**: 平台链操作
-   **X-Chain 客户端**: 交换链业务
-   **C-Chain 客户端**: 合同链业务

### API 客户端

-   **管理客户端**行政业务
-   **信息客户端**: 网络信息
-   **保健客户**: 健康检查终点
-   **索引客户端**数字 :
    -   索引 P- Chain 块
    -   指数 C- Chain 块
    -   索引 X- Chain 块
    -   索引 X-Chain 交易
-   **提议客户端**: 提案人 VM 信息

### 钱包客户端

-   **雪崩钱包客户端**: 一般钱包操作
-   **P- 钱钱包客户端**: P-Chain 特定钱包操作
-   **X-Chain 钱包客户端**: X- Chain 特定钱包操作
-   **C-Chain 钱包客户端**: C-Chain 特定钱包操作

## 配置

SDK可以配置各种选项:

```typescript
const client = createAvalancheClient({
  chain: avalanche, // Chain configuration
  transport: {
    type: "<transportType>", // Transport type
    url: "<url>",
    config: {
      // Transport-specific configuration
    }
  },
  apiKey: "", // Optional API key
  rlToken: "", // Optional rate limit token
})
```

### 运输配置

SDK支持多种运输类型连接到Avalanche节点. 每个传输类型都有特定的配置选项:

#### HTTP 运输(建议)

```typescript
const client = createAvalancheClient({
  chain: avalanche,
  transport: {
    type: "http",
    url: "https://api.avax.network/ext/bc/C/rpc", // Optional custom RPC URL
    config: {
      // HTTP-specific configuration
      fetchOptions: {
        headers: {
          "Custom-Header": "value"
        },
      }
      retryCount: 3,
      retryDelay: 1000,
      timeout: 5000
    }
  }
})
```

**HTTP 传输特性 :**

-   **自动 URL 分辨率**: 如果没有提供URL,请使用链条默认的 RPC 端点
-   **自定义信头**: 支持自定义 HTTP 信头通过 `fetchOptions.headers`
-   **API 密钥支持**: 自动添加 `x-glacier-api-key` 当标题 `apiKey` 提供
-   **费率限制支持**: 自动添加 `rlToken` 当标题 `rlToken` 提供

#### WebSocket 运输

```typescript
const client = createAvalancheClient({
  chain: avalanche,
  transport: {
    type: "ws",
    url: "wss://api.avax.network/ext/bc/C/ws", // Optional custom WebSocket URL
    config: {
      // WebSocket-specific configuration
      retryCount: 3,
      retryDelay: 1000
    }
  }
})
```

**WebSocket 运输特性 :**

-   **实时更新**: 支持用于实时数据的 WebSocket 连接
-   **自动重接**: 内置重试逻辑, 并带有可配置重试计数和延迟
-   **事件驱动**: 签署屏蔽链事件和实时更新的理想

#### 自定义运输

```typescript
const client = createAvalancheClient({
  chain: avalanche,
  transport: {
    type: "custom",
    provider: window.avalanche, // Custom provider implementation
    config: {
      // Custom transport configuration
    }
  }
})
```

**自定义运输特性 :**

-   **供应商一体化**: 与自定义 RPC 供应商或中间软件整合
-   **弹性配置**:全面控制运输行为
-   **钱包支持**: 钱包客户端的特殊处理

#### 后退运输

```typescript
const client = createAvalancheClient({
  chain: avalanche,
  transport: {
    type: "fallback",
    transports: [
      { type: "http", url: "https://primary-rpc.com" },
      { type: "http", url: "https://backup-rpc.com" }
    ],
    config: {
      // Fallback configuration
      retryCount: 3,
      retryDelay: 1000
    }
  }
})
```

**退后运输特性 :**

-   **高可用性**: 多个 RPC 端点之间自动失效

### 高级配置示例

#### 自定义 HTTP 信头和超时

```typescript
const client = createAvalancheClient({
  chain: avalanche,
  transport: {
    type: "http",
    config: {
      fetchOptions: {
        headers: {
          "X-Custom-Header": "custom-value"
        },
      }
    }
  }
})
```

#### 多个倒计时终点

```typescript
const client = createAvalancheClient({
  chain: avalanche,
  transport: {
    type: "fallback",
    transports: [
      { type: "http", url: "https://api.avax.network/ext/bc/C/rpc" },
      { type: "http", url: "https://rpc.ankr.com/avalanche" },
      { type: "http", url: "https://avalanche.public-rpc.com" }
    ],
    config: {
      retryCount: 5,
      retryDelay: 2000
    }
  }
})
```

#### 带有自定义配置的 WebSocket

```typescript
const client = createAvalancheClient({
  chain: avalanche,
  transport: {
    type: "ws",
    config: {
      retryCount: 5,
      retryDelay: 2000,
      maxRetryDelay: 30000
    }
  }
})
```

### 运输选择准则

-   **HTTP 运输**: 最适合大多数使用的大小写, 简单配置, 宽相容性
-   **WebSocket 运输**: 实时应用程序的理想,事件订阅,实时更新
-   **自定义运输**: 与特定提供者或中间软件集成时使用
-   **后退运输**: 建议用于需要大量供应的生产应用

### 环境考虑因素

-   **浏览器**: HTTP 和 WebSocket 传输已完全支持
-   **节点.js**: 所有运输类型都得到支持
-   **移动**: 建议移动应用的HTTP运输
-   **生产**: 考虑使用具有多个RPC端点的倒置运输实现可靠性

## 输出模块和公用事业

### 主要出口

SDK输出出所有viem的公用设施和类型,加上Avalanche特有的功能:

```typescript
import { 
  createAvalancheClient,
  createAvalancheWalletClient,
  // All viem exports
  createClient,
  createPublicClient,
  createWalletClient,
  // ... and many more
} from '@avalanche-sdk/client'
```

### 账户管理

```typescript
import { 
  privateKeyToAvalancheAccount,
  mnemonicsToAvalancheAccount,
  hdKeyToAvalancheAccount,
  privateKeyToXPAddress,
  publicKeyToXPAddress,
  // ... and more
} from '@avalanche-sdk/client/accounts'
```

### 链式配置

```typescript
import { 
  avalanche,
  avalancheFuji,
  // ... and more
} from '@avalanche-sdk/client/chains'
```

### 方法

访问特定方法类别:

```typescript
// P-Chain methods
import { /* P-Chain methods */ } from '@avalanche-sdk/client/methods/pChain'

// X-Chain methods  
import { /* X-Chain methods */ } from '@avalanche-sdk/client/methods/xChain'

// C-Chain methods
import { /* C-Chain methods */ } from '@avalanche-sdk/client/methods/cChain'

// Wallet methods
import { /* Wallet methods */ } from '@avalanche-sdk/client/methods/wallet'

// Public methods
import { /* Public methods */ } from '@avalanche-sdk/client/methods/public'

// Admin methods
import { /* Admin methods */ } from '@avalanche-sdk/client/methods/admin'

// Info methods
import { /* Info methods */ } from '@avalanche-sdk/client/methods/info'

// Health methods
import { /* Health methods */ } from '@avalanche-sdk/client/methods/health'

// Index methods
import { /* Index methods */ } from '@avalanche-sdk/client/methods/index'

// proposervm methods
import { /* proposervm methods */ } from '@avalanche-sdk/client/methods/proposervm'
```

### 公用事业

```typescript
import { 
  CB58ToHex,
  hexToCB58,
  getTxFromBytes,
  getUnsignedTxFromBytes,
  getUtxoFromBytes,
  getUtxosForAddress,
  // All viem utilities
  formatEther,
  parseEther,
  keccak256,
  // ... and many more
} from '@avalanche-sdk/client/utils'
```

### 额外模块

```typescript
// Node utilities
import { /* Node utilities */ } from '@avalanche-sdk/client/node'

// Nonce management
import { /* Nonce utilities */ } from '@avalanche-sdk/client/nonce'

// Serializable utilities
import { /* Serializable utilities */ } from '@avalanche-sdk/client/serializable'

// SIWE (Sign-In with Ethereum)
import { /* SIWE utilities */ } from '@avalanche-sdk/client/siwe'

// Window utilities
import { /* Window utilities */ } from '@avalanche-sdk/client/window'
```

## 可用方法

### P-钱方法

-   [`getBalance`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getBalance.ts) - 返回平台链上地址的余额,从 `platform.getUTXOs`。 。 。 . [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetutxos)
-   [`getBlock`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getBlock.ts) - 得到一个街区的身份证. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetblock)
-   [`getBlockByHeight`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getBlockByHeight.ts) - 得到一个街区的高度. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetblockbyheight)
-   [`getBlockchainStatus`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getBlockchainStatus.ts) - 返回块链状态. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetblockchainstatus)
-   [`getBlockchains`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getBlockchains.ts) - 堕落了 返回所有存在的块链(不包括P-Chain). 使用索引器, 如数据 API `@avalanche-sdk/chainkit`,转而. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetblockchains)
-   [`getCurrentSupply`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getCurrentSupply.ts) - 返回当前系统中的AVAX供应. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetcurrentsupply)
-   [`getCurrentValidators`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getCurrentValidators.ts) - 返回给定子网的当前验证符. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetcurrentvalidators)
-   [`getFeeConfig`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getFeeConfig.ts) - 返回P-Chain的收费配置. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetfeeconfig)
-   [`getFeeState`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getFeeState.ts) - 返回 P-Chain 目前的收费状况. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetfeestate)
-   [`getHeight`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getHeight.ts) - 返回最近块的高度. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetheight)
-   [`getL1Validator`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getL1Validator.ts) - 返回关于L1验证器的信息. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetl1validator)
-   [`getMinStake`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getMinStake.ts) - 返回验证所请求的Subnet所需的最低nAVAX. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetminstake)
-   [`getProposedHeight`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getProposedHeight.ts) - 返回最近区块的拟议高度. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetproposedheight)
-   [`getRewardUTXOs`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getRewardUTXOs.ts) - 堕落了 返回交易的奖励 UTXOs 。 使用索引器, 如数据 API 在 `@avalanche-sdk/chainkit`,转而. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetrewardutxos)
-   [`getStake`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getStake.ts) - 堕落了 返回一组地址所显示的 nAVAX 值 。 AvalancheGo计划在即将发行的版本中移除. 计算赌注 `getCurrentValidators` 财务报告和审定财务报表 `getTx` 换句话说. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetstake)
-   [`getStakingAssetID`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getStakingAssetID.ts) - 返回用于取用所请求的子网的资产识别. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetstakingassetid)
-   [`getSubnet`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getSubnet.ts) - 返回关于子网的信息. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetsubnet)
-   [`getSubnets`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getSubnets.ts) - 堕落了 返回所有子网。 使用 `getSubnet` 用于一个子网,或者一个索引器,例如: `@avalanche-sdk/chainkit`,为列表. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetsubnets)
-   [`getTimestamp`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getTimestamp.ts) - 返回当前 P-Chan 的时间戳. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgettimestamp)
-   [`getTotalStake`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getTotalStake.ts) - 返回所请求的Subnet上标注的总金额. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgettotalstake)
-   [`getTx`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getTx.ts) - 返回指定的交易. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgettx)
-   [`getTxStatus`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getTxStatus.ts) - 返回指定交易的状况. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgettxstatus)
-   [`getUTXOs`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getUTXOs.ts) - 返回引用特定地址的UTXOs. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetutxos)
-   [`getValidatorsAt`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getValidatorsAt.ts) - 在指定高度返回子网的验证器及其重量. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetvalidatorsat)
-   [`issueTx`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/issueTx.ts) - 向平台链发送交易. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformissuetx)
-   [`sampleValidators`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/sampleValidators.ts) - 特定子网的样本验证器. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformsamplevalidators)
-   [`validatedBy`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/validatedBy.ts) - 获取验证特定区块链的子网. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformvalidatedby)
-   [`validates`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/validates.ts) - 获得区块链的ID 一个子网验证. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformvalidates)
-   [`getAllValidatorsAt`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/pChain/getAllValidatorsAt.ts) - 获取所有L1的验证器及其重量 以及P-Chain高度的初级网络. [文档](https://build.avax.network/docs/api-reference/p-chain/api#platformgetallvalidatorsat)

### X-Chain 方法

-   [`buildGenesis`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/buildGenesis.ts) - 为X-Chain建造一个起源区块. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmbuildgenesis)
-   [`getAllBalances`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/getAllBalances.ts) - 堕落了 返回给定地址的所有余额。 AvalancheGo计划在即将发行的版本中移除. 使用 `getUTXOs` 并添加只有地址拥有的未解锁的传输输出量. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmgetallbalances)
-   [`getAssetDescription`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/getAssetDescription.ts) - 归还资产信息. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmgetassetdescription)
-   [`getBalance`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/getBalance.ts) - 堕落了 返回地址所持有资产的余额。 AvalancheGo计划在即将发行的版本中移除. 使用 `getUTXOs` 并添加只有地址拥有的未解锁的传输输出量. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmgetbalance)
-   [`getBlock`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/getBlock.ts) - 得到一个街区的身份证. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmgetblock)
-   [`getBlockByHeight`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/getBlockByHeight.ts) - 得到一个街区的高度. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmgetblockbyheight)
-   [`getHeight`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/getHeight.ts) - 返回最近块的高度. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmgetheight)
-   [`getTx`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/getTx.ts) - 返回指定的交易. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmgettx)
-   [`getTxFee`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/getTxFee.ts) - 退还特定交易的费用. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmgettxfee)
-   [`getTxStatus`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/getTxStatus.ts) - 堕落了 返回指定交易的状态。 AvalancheGo计划在即将发行的版本中移除. 使用 `getTx` 相反:当 `getTx` 返回它. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmgettxstatus)
-   [`getUTXOs`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/getUTXOs.ts) - 返回引用特定地址的UTXOs. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmgetutxos)
-   [`issueTx`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/xChain/issueTx.ts) - 给X -Chain开个交易. [文档](https://build.avax.network/docs/api-reference/x-chain/api#avmissuetx)

### C-Chain 方法问题

-   [`getAtomicTx`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/cChain/getAtomicTx.ts) - 返回指定的原子交易. [文档](https://build.avax.network/docs/api-reference/c-chain/api#avaxgetatomictx)
-   [`getAtomicTxStatus`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/cChain/getAtomicTxStatus.ts) - 堕落了 返回指定的原子交易状态。 赫利孔升级后不可用. 使用 `getAtomicTx` 换句话说. [文档](https://build.avax.network/docs/api-reference/c-chain/api#avaxgetatomictxstatus)
-   [`getUTXOs`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/cChain/getUTXOs.ts) - 返回引用特定地址的UTXOs. [文档](https://build.avax.network/docs/api-reference/c-chain/api#avaxgetutxos)
-   [`issueTx`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/cChain/issueTx.ts) - 给C -Chain发个交易. [文档](https://build.avax.network/docs/api-reference/c-chain/api#avaxissuetx)

### 钱包方法

-   [`getAccountPubKey`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/getAccountPubKey.ts) - 获取经常账户的公用钥匙. [文档](https://docs.core.app/docs/reference/avalanche_getaccountpubkey)
-   [`send`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/send.ts) - 用钱包发送交易. [文档](https://docs.core.app/docs/reference/avalanche_sendtransaction)
-   [`sendXPTransaction`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/sendXPTransaction.ts) - 在X-Chain或P-Chain上签名并发送交易. [文档](https://docs.core.app/docs/reference/avalanche_sendtransaction)
-   [`signXPMessage`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/signXPMessage.ts) - 在X-Chain或P-Chain上签名. [文档](https://docs.core.app/docs/reference/avalanche_signmessage)
-   [`signXPTransaction`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/signXPTransaction.ts) - 在X-Chain或P-Chain上签个字. [文档](https://docs.core.app/docs/reference/avalanche_signtransaction)
-   [`waitForTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/waitForTxn.ts) - 等待交易被接受. [文档](https://docs.core.app/docs/reference/avalanche_sendtransaction)

### P-Chain钱包方法

-   [`prepareAddAutoRenewedValidatorTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareAddAutoRenewedValidatorTxn.ts) - 准备增加自动更新验证器交易. [非加太国家-236](https://build.avax.network/docs/acps/236-auto-renewed-staking)
-   [`prepareAddPermissionlessDelegatorTx`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareAddPermissionlessDelegatorTxn.ts) - 准备一个没有授权的委托人交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-add-permissionless-delegator-tx)
-   [`prepareAddPermissionlessValidatorTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareAddPermissionlessValidatorTxn.ts) - 准备额外无授权的验证交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-add-permissionless-validator-tx)
-   [`prepareAddSubnetValidatorTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareAddSubnetValidatorTxn.ts) - 准备添加子网验证器交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-add-validator-tx)
-   [`prepareBaseTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareBaseTxn.ts) - 准备基础交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-basetx)
-   [`prepareConvertSubnetToL1Txn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareConvertSubnetToL1Txn.ts) - 准备将子网转换为L1交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-convert-subnet-to-l1-tx)
-   [`prepareCreateChainTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareCreateChainTxn.ts) - 准备一个创建链交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-create-chain-tx)
-   [`prepareCreateSubnetTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareCreateSubnetTxn.ts) - 准备一个创建子网交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-create-subnet-tx)
-   [`prepareDisableL1ValidatorTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareDisableL1ValidatorTxn.ts) - 准备禁用 L1 验证器交易 . [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-disable-l1-validator-tx)
-   [`prepareExportTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareExportTxn.ts) - 准备出口交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-export-tx)
-   [`prepareImportTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareImportTxn.ts) - 准备进口交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-import-tx)
-   [`prepareIncreaseL1ValidatorBalanceTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareIncreaseL1ValidatorBalanceTxn.ts) - 准备增加L1验证器余额交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-increase-l1-validator-balance-tx)
-   [`prepareRegisterL1ValidatorTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareRegisterL1ValidatorTxn.ts) - 编制登记册L1验证器交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-register-l1-validator-tx)
-   [`prepareRemoveSubnetValidatorTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareRemoveSubnetValidatorTxn.ts) - 准备删除子网验证器交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-remove-validator-tx)
-   [`prepareSetAutoRenewedValidatorConfigTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareSetAutoRenewedValidatorConfigTxn.ts) - 准备一套自动更新的验证器配置交易. [非加太国家-236](https://build.avax.network/docs/acps/236-auto-renewed-staking)
-   [`prepareSetL1ValidatorWeightTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/pChain/prepareSetL1ValidatorWeightTxn.ts) - 准备一套L1验证器重量交易. [文档](https://build.avax.network/docs/api-reference/p-chain/txn-format#unsigned-set-l1-validator-weight-tx)

### X-钱钱包方法

-   [`prepareBaseTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/xChain/prepareBaseTxn.ts) - 为X-Chain准备基础交易. [文档](https://build.avax.network/docs/api-reference/x-chain/txn-format#unsigned-basetx)
-   [`prepareExportTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/xChain/prepareExportTxn.ts) - 准备X-Chain的出口交易. [文档](https://build.avax.network/docs/api-reference/x-chain/txn-format#unsigned-export-tx)
-   [`prepareImportTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/xChain/prepareImportTxn.ts) - 准备X-Chain的进口交易. [文档](https://build.avax.network/docs/api-reference/x-chain/txn-format#unsigned-import-tx)

### C-钱钱包方法

-   [`prepareExportTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/cChain/prepareExportTxn.ts) - 准备从C-Chan到另一链的出口交易. [文档](https://build.avax.network/docs/api-reference/c-chain/txn-format#exporttx)
-   [`prepareImportTxn`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/wallet/cChain/prepareImportTxn.ts) - 准备从另一条链子到C -Chain的进口交易. [文档](https://build.avax.network/docs/api-reference/c-chain/txn-format#importtx)

### 公共方法

-   [`baseFee`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/public/baseFee.ts) - 返回下一个区块的基准费. [文档](https://build.avax.network/docs/api-reference/c-chain/api#eth_basefee)
-   [`getChainConfig`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/public/getChainConfig.ts) - 返回链式配置. [文档](https://build.avax.network/docs/api-reference/subnet-evm-api#eth_getchainconfig)
-   [`maxPriorityFeePerGas`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/public/maxPriorityFeePerGas.ts) - 退还每根气体的最高优先费. [文档](https://build.avax.network/docs/api-reference/c-chain/api#eth_maxpriorityfeepergas)
-   [`feeConfig`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/public/feeConfig.ts) - 返回指定块的收费配置. [文档](https://build.avax.network/docs/api-reference/subnet-evm-api#eth_feeconfig)
-   [`getActiveRulesAt`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/public/getActiveRulesAt.ts) - 在指定的时间戳返回活动规则. [文档](https://build.avax.network/docs/api-reference/subnet-evm-api#eth_getactiverulesat)

### 管理方法

-   [`alias`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/admin/alias.ts) - 指定一个API端点 一个别名. [文档](https://build.avax.network/docs/api-reference/admin-api#adminalias)
-   [`aliasChain`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/admin/aliasChain.ts) -给块链一个别名. [文档](https://build.avax.network/docs/api-reference/admin-api#adminaliaschain)
-   [`getChainAliases`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/admin/getChainAliases.ts) - 返回链的别名. [文档](https://build.avax.network/docs/api-reference/admin-api#admingetchainaliases)
-   [`getLoggerLevel`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/admin/getLoggerLevel.ts) - 返回日志和显示日志的级别. [文档](https://build.avax.network/docs/api-reference/admin-api#admingetloggerlevel)
-   [`loadVMs`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/admin/loadVMs.ts) - 动态加载节点上安装的任何虚拟机器作为插件. [文档](https://build.avax.network/docs/api-reference/admin-api#adminloadvms)
-   [`lockProfile`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/admin/lockProfile.ts) - 写一个mutex统计图 锁定.profile. [文档](https://build.avax.network/docs/api-reference/admin-api#adminlockprofile)
-   [`memoryProfile`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/admin/memoryProfile.ts) - 给Mem.profile写一个记忆简介. [文档](https://build.avax.network/docs/api-reference/admin-api#adminmemoryprofile)
-   [`setLoggerLevel`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/admin/setLoggerLevel.ts) - 设置日志和显示日志的级别. [文档](https://build.avax.network/docs/api-reference/admin-api#adminsetloggerlevel)
-   [`startCPUProfiler`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/admin/startCPUProfiler.ts) - 开始剖析节点的CPU利用情况. [文档](https://build.avax.network/docs/api-reference/admin-api#adminstartcpuprofiler)
-   [`stopCPUProfiler`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/admin/stopCPUProfiler.ts) - 停止先前启动的CPU配置文件. [文档](https://build.avax.network/docs/api-reference/admin-api#adminstopcpuprofiler)

### 信息方法

-   [`acps`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/acps.ts) - 回归阿瓦兰切社区提案的同伴偏好. [文档](https://build.avax.network/docs/api-reference/info-api#infoacps)
-   [`getBlockchainID`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/getBlockchainID.ts) - 鉴于块链的别名, 获取其身份. [文档](https://build.avax.network/docs/api-reference/info-api#infogetblockchainid)
-   [`getNetworkID`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/getNetworkID.ts) - 获取这个节点参与的网络的ID. [文档](https://build.avax.network/docs/api-reference/info-api#infogetnetworkid)
-   [`getNetworkName`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/getNetworkName.ts) - 获取这个节点参与的网络名称. [文档](https://build.avax.network/docs/api-reference/info-api#infogetnetworkname)
-   [`getNodeID`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/getNodeID.ts) - 拿到身份证 BLS钥匙 和这个节点的持有证明. [文档](https://build.avax.network/docs/api-reference/info-api#infogetnodeid)
-   [`getNodeIP`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/getNodeIP.ts) - 获取这个节点的IP. [文档](https://build.avax.network/docs/api-reference/info-api#infogetnodeip)
-   [`getNodeVersion`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/getNodeVersion.ts) - 获取这个节点的版本. [文档](https://build.avax.network/docs/api-reference/info-api#infogetnodeversion)
-   [`getTxFee`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/getTxFee.ts) - 为指定的交易类型收取交易费. [文档](https://build.avax.network/docs/api-reference/info-api#infogettxfee)
-   [`getVMs`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/getVMs.ts) - 得到这个节点支持的虚拟机. [文档](https://build.avax.network/docs/api-reference/info-api#infogetvms)
-   [`isBootstrapped`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/isBootstrapped.ts) - 检查一个链条是否完成了拖带. [文档](https://build.avax.network/docs/api-reference/info-api#infoisbootstrapped)
-   [`peers`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/peers.ts) - 描述一下对等关系. [文档](https://build.avax.network/docs/api-reference/info-api#infopeers)
-   [`uptime`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/uptime.ts) - 返回网络观察到的这个节点的恢复时间. [文档](https://build.avax.network/docs/api-reference/info-api#infouptime)
-   [`upgrades`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/info/upgrades.ts) - 返回网络的升级历史和配置. [文档](https://build.avax.network/docs/api-reference/info-api#infoupgrades)

### 卫生方法

-   [`health`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/health/health.ts) - 返回最后一套健康检查结果. [文档](https://build.avax.network/docs/api-reference/health-api#healthhealth)
-   [`liveness`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/health/liveness.ts) - 一旦有终点,返回健康. [文档](https://build.avax.network/docs/api-reference/health-api#healthliveness)
-   [`readiness`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/health/readiness.ts) - 节点完成初始化后返回健康. [文档](https://build.avax.network/docs/api-reference/health-api#healthreadiness)

### 指数方法

-   [`getContainerByID`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/index/getContainerByID.ts) -通过身份证取出集装箱. [文档](https://build.avax.network/docs/api-reference/index-api#indexgetcontainerbyid)
-   [`getContainerByIndex`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/index/getContainerByIndex.ts) -按指数算. [文档](https://build.avax.network/docs/api-reference/index-api#indexgetcontainerbyindex)
-   [`getContainerRange`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/index/getContainerRange.ts) - 按指数范围取出容器. [文档](https://build.avax.network/docs/api-reference/index-api#indexgetcontainerrange)
-   [`getIndex`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/index/getIndex.ts) - 获取一个容器的索引. [文档](https://build.avax.network/docs/api-reference/index-api#indexgetindex)
-   [`getLastAccepted`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/index/getLastAccepted.ts) - 拿到最后一个接受的容器. [文档](https://build.avax.network/docs/api-reference/index-api#indexgetlastaccepted)
-   [`isAccepted`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/index/isAccepted.ts) - 如果容器在此索引中, 返回真实性 . [文档](https://build.avax.network/docs/api-reference/index-api#indexisaccepted)

### 建议的方法

-   [`getCurrentEpoch`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/proposervm/getCurrentEpoch.ts) - 返回当前时代信息. [文档](https://build.avax.network/docs/api-reference/proposervm-api#proposervmgetcurrentepoch)
-   [`getProposedHeight`](https://npmcn.com/package/%40avalanche-sdk/client/src/methods/proposervm/getProposedHeight.ts) - 返回此节点目前的提议者 VM 高度 . [文档](https://build.avax.network/docs/api-reference/proposervm-api#proposervmgetproposedheight)

## 实例

> **说明:** 确保创建自己的 `.env` 通过复制 `.env.example` 文档并更新值。 你还需要修改 `config.ts` 要指向您的文件 `.env` 文件路径。 默认情况下,示例使用来自 `.env.example`,以及示例中提及的作为注释的测试地址(如 `0x76Dd3d7b2f635c2547B861e55aE8A374E587742D` 财务报告和审定财务报表 `X-fuji19fc97zn3mzmwr827j4d3n45refkksgms4y2yzz`)来自该文件中的私钥值.

看看这个 [实例](https://npmcn.com/package/%40avalanche-sdk/client/examples) 用于综合使用的文件夹示例 :

### 基本实例

-   [`sendAvax.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/sendAvax.ts) - 使用SDK发送AVAX的基本实例

### 主网络交易示例

这个 [`prepare-primary-network-txns`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns) 文件夹中包含准备各类交易的示例 :

#### 跨海峡传输示例

-   [`transfer-avax-from-x-chain-to-p-chain.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/transfer-avax-from-x-chain-to-p-chain.ts) - 将AVAX从X-Chain转移到P-Chain
-   [`transfer-avax-from-p-chain-to-x-chain.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/transfer-avax-from-p-chain-to-x-chain.ts) - 将AVAX从P-Chan转移到X-Chan
-   [`transfer-avax-from-x-chain-to-c-chain.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/transfer-avax-from-x-chain-to-c-chain.ts) - 把AVAX从X-Chan转到C-Chan
-   [`transfer-avax-from-c-chain-to-x-chain.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/transfer-avax-from-c-chain-to-x-chain.ts) - 把AVAX从C-Chan转到X-Chan
-   [`transfer-avax-from-p-chain-to-c-chain.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/transfer-avax-from-p-chain-to-c-chain.ts) - 将AVAX从P-Chain转移到C-Chain
-   [`transfer-avax-from-c-chain-to-p-chain.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/transfer-avax-from-c-chain-to-p-chain.ts) - 把AVAX从C-Chan转到P-Chan

#### X-Chain 交易实例

-   [`exportTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/x-chain/exportTx.ts) - 准备X-Chain出口交易
-   [`importTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/x-chain/importTx.ts) - 准备X-Chain进口交易

#### P-Chain 交易实例

-   [`addAutoRenewedValidatorTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/p-chain/addAutoRenewedValidatorTx.ts) - 添加自动更新的验证器交易
-   [`addSubnetValidatorTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/p-chain/addSubnetValidatorTx.ts) - 添加子网验证器交易
-   [`baseTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/p-chain/baseTx.ts) - 基础交易实例
-   [`convertSubnetToL1Tx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/p-chain/convertSubnetToL1Tx.ts) - 将子网转换为L1交易
-   [`createChainTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/p-chain/createChainTx.ts) - 创建链式交易
-   [`createSubnetTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/p-chain/createSubnetTx.ts) - 创建子网交易
-   [`exportTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/p-chain/exportTx.ts) - 准备P-Chain出口交易
-   [`importTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/p-chain/importTx.ts) - 准备P-Chain进口交易
-   [`removeSubnetValidatorTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/p-chain/removeSubnetValidatorTx.ts) - 删除子网验证交易
-   [`setAutoRenewedValidatorConfigTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/p-chain/setAutoRenewedValidatorConfigTx.ts) - 设置自动更新的验证器配置交易

#### C-Chain 交易实例

-   [`exportTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/c-chain/exportTx.ts) - 准备C-Chain出口交易
-   [`importTx.ts`](https://npmcn.com/package/%40avalanche-sdk/client/examples/prepare-primary-network-txns/c-chain/importTx.ts) - 准备C-Chain进口交易

有关每个实例的更详细资料,请参见: [实例](https://npmcn.com/package/%40avalanche-sdk/client/examples/README.md)。 。 。 .

## 捐款

欢迎捐款! 请随意提交拉力请求 对于重大变动,请先开出一个问题来讨论你想要改变什么.

## 许可证

这个项目根据BSD 3-Clause许可证获得许可——详情见\[LICENSE\]./(LICENSE)文件.

## 支助

如果遇到问题或有问题,请:

1.  检查 [文档](https://github.com/ava-labs/avalanche-sdk-typescript/tree/main/client#readme)
2.  打开一个 [问题](https://github.com/ava-labs/avalanche-sdk-typescript/issues)
3.  加入我们的社区求助渠道

## 链接

-   [GitHub 仓库](https://github.com/ava-labs/avalanche-sdk-typescript)
-   [文档](https://github.com/ava-labs/avalanche-sdk-typescript/tree/main/client#readme)
-   [问题跟踪器](https://github.com/ava-labs/avalanche-sdk-typescript/issues)

## 常见问题

### @avalanche-sdk/client 是什么？

一个TypeScript SDK用于通过JSON-RPC API与Avalanche网络互动\. 这个SDK提供了一整套工具,可以与所有Avalanche链\(P-Chain,X-Chain,C-Chain\)和各种API交互,包括tranca的钱包功能

### 如何安装 @avalanche-sdk/client？

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

### @avalanche-sdk/client 支持 TypeScript 吗？

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

### @avalanche-sdk/client 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

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

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

### @avalanche-sdk/client 可以商用吗？

@avalanche-sdk/client 使用 BSD-3-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括，不构成法律意见，请以许可原文为准。

### @avalanche-sdk/client 的下载量有多少？

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

### @avalanche-sdk/client 还在维护吗？

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