用途:near-api-js 是 NEAR 区块链的 JavaScript/TypeScript 客户端库(v7),用于在浏览器或 Node.js 中构建与 NEAR 交互的应用。
主要能力:通过 JsonRpcProvider/FailoverRpcProvider 查询链上数据;用 Account 类管理账户余额、转账、调用合约方法、签名并发送交易;支持 KeyPairSigner、MultiKeySigner 等签名器;提供 NEAR、FungibleToken 等代币与单位换算工具;支持 ABI 的类型化 Contract、种子短语、NEP-413 消息签名与验签、元交易、并发交易以及细粒度 RPC 错误处理。
使用方式:以 import 引入核心模块,例如从 "near-api-js" 引入 Account、JsonRpcProvider,从 "near-api-js/tokens" 引入 NEAR,从 "near-api-js/rpc-errors" 引入错误类型。只读调用可经 provider.callFunction;写操作需 Account 配置签名器后调用 callFunction 或 signAndSendTransaction。RPC 可用 https://rpc.mainnet.near.org、https://free.rpc.fastnear.com、https://rpc.testnet.near.org、https://test.rpc.fastnear.com。常用命令:npm 安装包名 near-api-js。
适用场景:需要读取 NEAR 链数据、发起转账或合约调用、集成钱包式签名、构建代币/NEP-413 相关功能的前后端应用。
限制:资料未提供版本升级细节、收费价格或性能基准;公共 RPC 端点可能变化,硬编码前应查阅 RPC Providers 列表。