# @evolution-sdk/evolution 中文文档

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

版本：0\.8\.0
npm 元数据更新时间：2026-10-28T03:12:48.656Z
中文译文更新时间：2026-11-14T02:32:19.626Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：6.3 MB，1118 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2025-07-30T17:45:25.494Z
- 最新版本发布：2026-10-28T03:12:48.299Z
- 近 30 天下载量：17439（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：63（近 12 个月 61 个）

## 中文简介

用于 Cardano 块链开发的现代类型SDK

## 安装

```sh
npm install @evolution-sdk/evolution
```

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

## README

# 进化 SDK

## 快速启动

````typescript
import * as Evolution from "@evolution-sdk/evolution";

// Create and validate addresses
const address = Evolution.Address.fromBech32(
  "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3jcu5d8ps7zex2k2xt3uqxgjqnnj0vs2qd4a8cpkp0k8cqq0sq2nq"
); TypeScript SDK for Cardano blockchain development.

## Installation

```bash
pnpm add @evolution-sdk/evolution

# Or use npm
npm install @evolution-sdk/evolution

# Or use yarn
yarn add @evolution-sdk/evolution
````

## 快速启动

```typescript
import * as Evolution from "@evolution-sdk/evolution"

// Create and validate addresses
const address = Evolution.Address.fromBech32(
  "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3jcu5d8ps7zex2k2xt3uqxgjqnnj0vs2qd4a8cpkp0k8cqq0sq2nq"
)

// Work with Plutus Data
const Data = Evolution.Data
const Codec = Data.Codec()

// Create basic data types
const plutusInt = 42n
const plutusBytes = "deadbeef"
const plutusList = [1n, 2n, "cafe"]

// Create a Plutus Map
const plutusMap = Data.map([
  { key: "cafe", value: 42n },
  { key: 99n, value: "deadbeef" }
])

// Create a Constructor (like Haskell data types)
const constructor = Data.constr(0n, [plutusInt, plutusBytes, plutusList])

// Encode to CBOR and decode back
const encoded = Codec.Encode.cborHex(constructor)
const decoded = Codec.Decode.cborHex(encoded)

// Complex nested structures
const complex = Data.constr(0n, [
  [1n, 2n, "cafe"],
  Data.map([
    { key: 42n, value: ["deadbeef"] },
    { key: "deadbeef", value: Data.constr(1n, [-999n]) }
  ]),
  Data.constr(7n, [[], Data.map([])])
])
```

## 特征

-   **地址管理**: 创建、验证并转换 Cardano 地址
-   **交易公用事业**: 构建和序列化交易
-   **CBOR 支持**: 编码并解码 Cardano 二进制数据
-   **类型安全**: 包含全类型脚本支持
-   **效果整合**: 严格处理错误的效果

## API 参考

### 地址

```typescript
// Create from Bech32
const address = Evolution.Address.fromBech32("addr1...")

// Create from hex bytes
const address = Evolution.Address.fromBytes(hexBytes)

// Get network ID
const networkId = Evolution.Address.getNetworkId(address)
```

### 交易

```typescript
// Create transaction hash
const hash = Evolution.TransactionHash.fromHex("915cb8...")

// Create transaction input
const input = Evolution.TransactionInput.make({
  transactionId: hash,
  index: 0
})
```

### 发展网络

```typescript
// Start a development network
const devnet = await Evolution.Devnet.Cluster.makeOrThrow({
  clusterName: "my-devnet",
  kupo: { enabled: true },
  ogmios: { enabled: true }
})

await Evolution.Devnet.Cluster.startOrThrow(devnet)
```

## 文档

完整文件,访问 [进化- sdk.dev](https://evolution-sdk.dev/)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @evolution-sdk/evolution 是什么？

用于 Cardano 块链开发的现代类型SDK

### 如何安装 @evolution-sdk/evolution？

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

### @evolution-sdk/evolution 支持 TypeScript 吗？

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

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

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @evolution-sdk/evolution 可以商用吗？

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

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

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

### @evolution-sdk/evolution 还在维护吗？

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