当前位置：首页 > news >正文

Polkadot-API (PAPI) 简介与使用指南

news 来源：原创 2025/5/25 23:48:35

在 Polkadot 生态系统中，去中心化应用（dApp）、网页和钱包的开发者通常使用 JavaScript 和 TypeScript 进行开发。与基于 Polkadot SDK 的区块链进行交互，传统上主要依赖于 Polkadot JS 库。然而，最近波卡生态中出现了一款备受关注的新工具——Polkadot-API (PAPI)，它提供了更现代化、模块化的开发体验，并针对轻客户端进行了优化。本文将介绍 PAPI 的特点、环境搭建、基本用法以及其在实际开发中的优势。

PAPI 的特点

Polkadot-API（PAPI）是一个为去中心化应用程序（dApp）开发者提供的模块化、可组合的库，专门针对“轻客户端优先”方法设计。其目标是提供一套全面的工具，帮助开发者构建高效、完全去中心化的应用程序。PAPI 具备以下特点：

轻客户端优化：通过新版本的 JSON-RPC 规范支持完全去中心化的交互。
强大的 TypeScript 支持：通过链上元数据自动生成类型定义和文档，简化开发工作，并实现无缝访问链上存储、常量、交易、事件和运行时调用。
多链兼容性：允许开发者同时连接多个区块链，并提供多描述符支持和运行时更新兼容性检查。
性能优化：利用原生 BigInt 类型、动态导入和模块化子路径来避免捆绑不必要的资源，从而提高性能。
灵活的 API 选项：支持基于承诺和可观察的 API，方便与 Polkadot.js 集成，并可通过浏览器扩展或私钥提供签名选项。
这一切使得 PAPI 成为构建去中心化应用程序的理想工具，既提高开发效率，又优化了应用的性能和可扩展性。从实际使用来看，PAPI 最吸引人的特点之一是它能够基于链的 Metadata 轻松生成 TypeScript 类型定义，详细文档可参考 Polkadot 官方文档，或访问 PAPI 官方网站。

Polkadot 官方文档 :

https://docs.polkadot.com/develop/toolkit/api-libraries/papi/

PAPI 官方网站: https://papi.how/

环境搭建

安装依赖

首先我们需要按照它，通过 npm 或者 yarn。

npm i polkadot-api

获取链的 Metadata
像波卡的 relay chain，在脚本中已经有了默认的支持，可以直接使用名字来获取，当你运行帮助，可以得到列表, polkadot，kusama 以及它们的系统平行链都有。

npx papi add -h
在添加的时候可以给一个名字

npx papi add dot -n polkadot
也可以添加一个不在列表里面的链，使用 -w 选项。我们启动本地服务器一条链，使用默认端口，并添加。

npx papi add asset -w ws://10.0.0.11:9944
在成功的添加后，项目目录下会出现一个隐藏目录，名字是.papi ,里面会根据获取的 Metadata 生成类型文件。

它的原理是在 packagejson 里面增加一个依赖，包含 descriptor。

“dependencies”: {

编程体验
为了查看后台日志方便调试，代码都是和本地的节点进行交互。从官方文档来看，client 是支持不同的模式的，比如 Smoldot，这里只演示基本的 web 方式。

获取 Client API
首先通过 ws provider 指定链的 RPC 节点地址和端口，然后初始化一个 client。所以的类型是通过 getTypedApi 方法来获取的，这种获取的方式十分便捷，对于习惯强类型编程的开发者非常友好。

类型的定义就是上一个步骤使用命令生成的。

import { asset } from ‘@polkadot-api/descriptors’;
得到常量和变量
然后通过 api 可以简单和链交互，这里获取 balances 里面的一个常量和变量。代码分别打印出帐号的最小余额和帐号 Alice 的可用余额。

import { asset } from ‘@polkadot-api/descriptors’;
‍发送交易
这里完成一个最简单的从 Alice 到 Bob 的转账操作。得到 api 后，我们分别导入 Alice 和 Bob 二个帐号，并初始化 Alice 的 signer，把 Bob 的 public key 转换成 MultiAddress 的格式。最后签名并发送这个交易。

import { MultiAddress } from “@polkadot-api/descriptors”
当交易成功完成后，结果的格式如下

{
监听事件
在 Dapp 的开发中，对事件的处理也是必不可少的，下面的代码演示链如何获取。

import { asset } from ‘@polkadot-api/descriptors’;
获取的事件格式如下。对于监听还可以应用一些 Filter，可以通过发送者，接收者地址过滤等等，这些可以自己去尝试。

{

总结
PAPI 相较于传统的 Polkadot JS 库，提供了更现代化的开发体验，特别是对 TypeScript 类型定义的自动生成，使得开发者能够更清晰地理解链上数据结构，极大地提高了开发效率。其模块化设计、轻客户端优先的策略以及多链兼容性，使其成为 Polkadot 生态中值得关注的新工具。当然，由于 PAPI 仍在持续优化中，开发者在使用过程中可能会遇到一些 bug，欢迎大家积极反馈并贡献 PR。希望 PAPI 能进一步推动波卡生态发展，为开发者提供更便捷的区块链交互方式！

「区块链技术开发入门 17 期」
正式开启报名
由 OneBlock+ 和 Polkadot 联合推出的「区块链技术开发入门 17 期 | Polkadot 上的 Solidity 开发」即将启程！本期课程将于 2025 年 3 月 7 日正式开课，历时 6 周，包含 6 个录播课时、6 个 Task 任务及多个 Workshop。通过系统化学习与实践，助你深入探索区块链技术，开启加密未来的新篇章！✨ 本期课程完全免费开放，采用申请入学制，名额有限！立即点击下方链接填写申请表，审核通过后我们将主动联系你，锁定学习席位！立即申请入学：https://wj.qq.com/s2/17653871/18t2/

免责声明：由 PaperMoon 提供并包含在本文中的材料仅用于学习目的，它们不构成财务或投资建议，也不应被解读为任何商业决策的指导。我们建议读者在做出任何投资或商业相关的决定之前，进行独立研究并咨询专业人士。PaperMoon 对根据本文内容采取的任何行动不承担任何责任。