跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Helius 文档和 Solana 中使用术语的快速参考定义。每个条目链接到相关的产品页面或指南(如适用)。 跳转到:

Helius 产品和平台

自动扩展

Helius 的法币计划自动充值机制。当每月信贷配额耗尽时,自动扩展会在用户设定的限额内购买额外的信贷,防止 429 错误中断生产流量。加密计划没有自动扩展。相反,他们使用预付信贷,需要手动购买。 参见自动扩展

信贷

Helius 计费 API 和流媒体使用的单位。RPC 方法、DAS 调用和流媒体吞吐量各有特定的信贷成本。每个计划都包括一个每月的信贷配额,每个计费周期重置(未使用的信贷不结转)。 参见信贷以获取完整的成本表。

DAS API

数字资产标准——一个为 Solana 数字资产(NFTs、压缩 NFTs、可替代代币、铭文)提供统一接口的开放规范。Helius 的 DAS API 实现返回丰富的元数据、所有权和定价的结构化响应,消除对链上资产数据自定义解析器的需求。 参见DAS API

专用节点

私人 Helius RPC 节点没有速率限制或信贷计量,以固定月费计费。适合需要无限吞吐量的狭窄用例;大多数应用程序最好由常规 Helius RPC 服务,因为其性能更优、故障转移能力强、功能覆盖全面。 请参阅专用节点

增强交易

Helius 的解析交易 API 可将原始 Solana 交易解码成人类可读的事件——代币转移、NFT 销售、交换、质押操作等——无需每个程序指令解析器。 请参阅增强交易

增强 WebSockets

Helius 的持久性 WSS 流服务,具有超出标准 Solana WebSocket 方法的扩展过滤和精细的订阅控制。由支持 LaserStream 的相同基础设施提供支持。 请参阅增强 WebSockets

错误代码

Helius API 返回的标准 HTTP 状态代码,具有 Helius 特定的上下文:
  • 400 Bad Request — 无效参数或格式错误的请求(例如,地址格式无效,缺少必填字段,JSON 格式错误)
  • 401 Unauthorized — 缺失或无效的 API 密钥
  • 403 Forbidden — 访问被拒绝,通常是因为 IP 限制、订阅不包括端点或 API 密钥权限不足
  • 404 Not Found — 请求资源无可用数据(对于未知钱包的身份查找来说很正常)
  • 429 Too Many Requests — 信用限额已用尽、超出速率限制或达到并发请求限制
  • 5xx — Helius 端问题;请重试,使用指数退避
有关详细信息和故障排除步骤,请参阅错误代码

Gatekeeper

通过将请求路由到全球分布的代理舰队,Helius 的边缘网关提供了显著低于标准 RPC 调用的延迟。在 RPC URL 中替换 mainnet.helius-rpc.combeta.helius-rpc.com 来访问。 请参阅Gatekeeper介绍 Gatekeeper 的博客文章以了解架构背景。

LaserStream

Helius 的高性能 gRPC 流服务,用于 Solana 链上数据,具有历史重放、多区域故障转移和 Helius 流产品中最丰富的功能集。官方 SDK 提供 JavaScript/TypeScript、Rust 和 Go。增强的 WebSockets 在相同的基础设施上运行。 查看 LaserStreamLaserStream SDK 性能博客文章,深入了解 SDK 基准测试。

优先费用 API

Helius 的费用估算端点根据实时链上费用市场返回推荐的优先费用值。在拥堵期间无需猜测或过度支付,即可实现竞争性费用定价。 查看 优先费用 API

速率限制

在特定 Helius 计划下允许的每秒最大请求数。速率限制因计划级别和 API 家族(标准 RPC、增强 API、流媒体)而异。超过限制将返回 429 Too Many Requests 查看 速率限制

发送者

Helius 专为低延迟交易者打造的专业交易着陆服务,结合优先费用、Jito 提示和权益连接路由以最大化着陆率。可用于 https://sender.helius-rpc.com/fast 查看 发送者

碎片交付

Helius 的服务通过 UDP 流式传输 Solana 原始碎片——这是链上的最早信号,在最终区块组装之前传输。Helius 从跨区域的分布式验证者网络中聚合碎片,以最小化单个验证者的地理延迟差异。适用于高频交易、套利和其他低延迟应用。 查看 碎片交付 和博客文章 赢得毫秒之战:碎片、LaserStream 和 Solana 边缘,深入了解碎片工作原理。

权益连接

Helius 付费计划的默认交易提交路径。权益连接通过 Solana 的协议级别权益加权服务质量(SWQoS)将交易路由到即将到来的区块领导者,基于验证者权益授予优先连接插槽,并在拥堵期间减少数据包丢失。Helius 的付费计划继承了这一着陆率优势,调用方无需直接操作大量权益的验证者。 请参阅优化交易和博客文章基于权益的服务质量:您需要了解的一切

Wallet API

Helius 的 REST API 用于查询 Solana 钱包的余额、交易历史、转账、身份和资金来源——提供结构化的、以美元计价的响应,而不是原始 RPC 输出。它接受 SNS .sol 和 ANS 域名以及地址。 请参阅钱包 API

Solana 基础

账户

一个在 Solana 上持久保存数据的容器,由一个 32 字节的公钥标识。所有链上状态——用户余额、程序代码、代币元数据——都存在于账户中,包括程序本身。每个账户都有一个所有者,这是一个可以修改其数据或提取 lamports 的程序,并且必须保持最低 SOL 余额(免租)以持久存在。 有关更深层次的介绍,请参阅博客文章Solana 编程模型:Solana 开发简介

空投

向一个地址授予 SOL 或 SPL 代币。在 Devnet 和 Testnet 上,空投通常指来自水龙头的一小部分测试 SOL,用于资助开发钱包;在 Mainnet 上,它指向现有持有人的批量代币分发。Devnet 空投可通过Devnet 水龙头获得。

关联代币账户(ATA)

一个确定性派生的代币账户,用于为给定钱包地址持有特定的 SPL 代币。每个钱包每个代币铸造最多有一个 ATA,是查询用户代币余额的规范位置。它是使用钱包地址和代币铸造作为种子派生的。

承诺级别

交易被纳入区块链的信心程度:
  • processed — 当前领导者已看到但尚未投票;如果区块未获得共识,仍可能被丢弃(约0.4秒)
  • confirmed — 区块获得≥66%权益加权验证者投票;历史上,没有已确认区块被回滚(约0.6秒)
  • finalized — 区块获得≥66%投票加31个后续区块建立其之上(即Tower BFT最大锁定),使其实际上不可逆转(约13秒)
confirmed 是推荐的默认值。使用 processed 进行UI反馈,使用 finalized 进行高价值操作,如交易所存款或跨链桥。finalized 获取的区块哈希比 confirmed 过期更快,从而缩短交易过期前的窗口。 请参阅博客文章 Solana 承诺级别是什么? 以深入了解。

计算单位(CU)

Solana 用于衡量交易执行的计算工作量,类似于以太坊上的 gas。每个交易指定计算单位上限和计算单位价格(每CU的优先费用以微拉姆波特为单位);其乘积决定总优先费用成本。超过上限则交易失败。

纪元

大约432,000个Solana slots的聚集区间——Solana更新其验证者集、领导者计划、权益委托和奖励分配的更高层级组织间隔。根据当前slot目标,每个纪元大约需时2天。 请参阅博客文章 理解Solana的Slots、Blocks和Epochs 以深入了解。

指令

Solana 交易内部的最小工作单元——单个程序调用及相关账户和数据。一个交易捆绑一个或多个指令,原子执行(全部成功或全部回滚)。 请参阅博客文章Solana 编程模型:Solana 开发入门以获得更深入的了解。

Lamport

SOL 的最小单位:1 SOL = 1,000,000,000 lamports (10⁻⁹ SOL),以图灵奖获得者、分布式系统基础工作的 Leslie Lamport 命名。原始 Solana RPC 方法以 lamports 返回余额和费用;Helius 的钱包 API自动处理转换。优先费用以 microlamports 表示——lamport 的百万分之一 (10⁻¹⁵ SOL)。

Program

一个可执行账户,包含编译后的 sBPF 字节码(即 Solana 上的智能合约)。程序是无状态的——它们读取和写入其拥有的数据账户,并通过程序 ID(其 32 字节地址)标识。Solana 自带了一组原生程序(System、Stake、Vote 等),内置于运行时;其他一切都是用户部署的程序。 请参阅博客文章Solana 编程模型:Solana 开发入门以获得更深入的了解。

Program Derived Address (PDA)

从程序 ID 和一组种子中派生出的确定性地址。PDAs 允许程序为其控制的账户签名,使其成为有状态程序设计的关键。PDAs 有意通过曲线,因此没有其对应的私钥。

Rent / Rent-exempt

每个 Solana 账户必须持有的 SOL 余额才能在链上持久化,与账户的存储大小成比例。账户必须以免租金方式创建:任何使账户低于最低限度的交易都会失败。一旦免租金,账户将无限期地持久存在而无需进一步付款。

Slot

Solana 的基本时间单位,在此期间,指定的领导验证者有机会生产一个区块。当前目标是 400 毫秒的 slots,尽管实际持续时间可能因网络状况而异。如果领导者未能在其 slot 期间生成区块,则跳过该 slot——网络将继续到下一个 slot,而不等待,因此并不是每个 slot 都会产生一个区块。 请参阅博客文章理解Solana上的Slots、Blocks和Epochs以深入了解。

验证者

Solana网络中的一个节点,通过在指定的领导者时段内生成区块并对其他验证者的区块进行投票来参与共识。验证者根据其活跃抵押量按比例选定为领导者时段。

交易机制

地址查找表 (ALT)

一个链上表格,允许版本化交易使用1字节索引而不是完整的32字节公钥来引用Solana地址,使单个交易最多可引用256个账户。对于复杂DeFi操作,这是必要的,否则将超过交易大小限制。

区块哈希

识别最近区块的32字节哈希,每个Solana交易中包含以证明是最新的。区块哈希在大约150个时段(约1分钟)后过期;过期的区块哈希会导致交易被拒绝。客户端在签署前通过getLatestBlockhash获取最近的区块哈希。

优先费

每个计算单元支付的小费,给予某个交易相对于其他交易的优先权,改善其纳入时间。优先费以每计算单元微Lamports (µLamports/CU) 设置。Helius的优先费API基于最近的链上费用市场实时返回估算值。

Shred

Solana区块最小的单位。区块被拆分(即撕碎)为Shreds,通过Turbine在验证者网络中进行并行传播。Shred级别的访问优于区块组装,可以提供最早的链上信号。 请参阅Shred交付

版本化交易

一种支持地址查找表的新Solana交易格式,允许一个交易最多引用256个账户(相比于传统交易约35个)。大多数现代DeFi集成需要版本化交易。它们在序列化交易的开头由一个版本字节表示。

代币和资产

压缩帐户

压缩帐户是一个Solana帐户,其数据通过交易日志提交到分类账中,只有哈希指纹存储在验证器状态中,而不是完整数据占用验证器磁盘上的传统帐户插槽。开发人员可以像处理常规帐户一样处理压缩帐户;索引器(如 Photon)解析交易日志以重建当前状态,当通过 ZK Compression 读取或修改帐户时,使用恒定大小的 Groth16 零知识证明来验证完整性。此模型最适合小数据帐户——较大的数据(超过约 100 字节)会使压缩变得不切实际。

压缩 NFT (cNFT)

一种 Solana NFT 表示为链上并发 Merkle 树中的叶子,而不是作为其自己的帐户存在。该树驻留在一个 Solana 帐户中,其状态转换由分类账保障;NFT 的当前状态由能生成与树的链上根验证的 Merkle 证明的索引器从交易历史中导出。因此,读取 cNFT 需要像 DAS API 这样的索引器 —— 标准的 Solana RPC 无法直接返回 cNFT 数据。与标准 NFT 相比,此模型将铸造成本最多减少 99%。

铸造帐户

定义 SPL 代币属性(供应、十进制和铸造/冻结授权)的链上帐户。铸造帐户的地址是代币的规范标识符(在以太坊术语中是其“合约地址”)。

SPL 代币

通过 Solana 程序库(SPL)的代币程序发行的 Solana 代币。可替代代币(USDC、BONK、JUP 等)是 SPL 代币;标准(非压缩)NFT 也是 SPL 代币,铸造时供应为 1 且小数为 0。SPL 代币大致相当于以太坊上的 ERC-20 和 ERC-721。Token-2022 是一个更新的程序,扩展了此界面,提供了传输费用和机密传输等可选功能。

Token 账户

一个链上账户,持有特定所有者的特定SPL代币余额。钱包可以拥有任意的代币账户,但约定俗成的是使用一个关联代币账户(ATA)——由关联代币账户程序按(钱包,铸造)对确定性派生的代币账户。

Token-2022(代币扩展)

SPL Token Program的一个变体,支持可选扩展(例如转账费用、保密转账、带息代币、不可转让代币)。Token-2022作为一个独立的链上程序运行,具有自己的程序ID,但设计为经典Token Program的兼容继任者,因此SDK通常可以处理两者。必须在Token-2022程序下创建铸币才能使用扩展。 请参阅博客文章 什么是代币扩展?

ZK 压缩

ZK 压缩是由Helius和Light Protocol开发的Solana原生技术,通过将账户数据提交到分类账中的交易日志并仅在验证者状态中存储哈希指纹,大幅降低链上存储成本。通过从索引交易数据生成的恒定大小Groth16零知识证明来保持加密完整性。该原语不同于压缩的NFT,后者使用并发Merkle树且不使用零知识证明。 查看 ZK 压缩 和博客文章 Solana 构建者:ZK 压缩 以深入了解。

连接和流媒体

gRPC

gRPC是一种通用的高性能二进制RPC协议(gRPC远程过程调用的递归缩写)。在Solana的上下文中,“gRPC”通常指的是Yellowstone gRPC——基于Solana的Geyser插件系统构建的流接口,通过gRPC暴露账户和交易更新。Helius的 LaserStream 服务是基于Yellowstone接口构建的,附加了历史重播、多区域故障转移和托管基础设施等功能。

RPC

RPC代表远程过程调用,这是一种将服务器方法调用视为本地函数的通用模式。在Solana中,“RPC”通常指的是RPC节点—跟踪Solana状态但不参与共识的节点,专注于通过JSON-RPC接口提供数据请求(例如,账户状态、交易历史、交易提交)。相比之下,验证者则负责生成区块并对其进行投票。Helius的RPC服务是一个为生产工作负载优化的全球分布式RPC节点群。 请参阅博客文章Solana节点—Solana RPC、验证者和RPC提供者指南进行更深入的了解。

Webhook

Webhook是在订阅事件发生时由服务器发送到接收器URL的HTTP POST请求—“反向”HTTP,由服务器发起调用。Helius Webhooks将Solana链上事件(转账、NFT销售、自定义程序活动)推送到注册的终端,消除了轮询的需要。

WebSocket (WSS)

WebSocket是一种从HTTP升级的持久双向TCP连接,用于无重复HTTP请求的Solana数据推送流。WSS(WebSocket Secure)是相同协议在TLS上的运行变体,是用于生产Solana连接的变体。Helius的标准和增强WebSockets都使用WSS。

生态系统

Anchor

Anchor是一个用于快速安全地构建Solana程序的Rust框架。它通过过程宏处理账户序列化、验证和指令分发等样板代码,让开发者专注于程序逻辑而不是低级细节。大多数Solana开发者选择使用Anchor而非编写原生Rust程序。 请参阅博客文章 An Introduction to Anchor: A Beginner’s Guide to Building Solana Programs 以深入了解。

IDL

IDL 代表接口定义语言。IDL 是一个描述 Solana 程序的指令、账户和数据类型的 JSON 架构;客户端使用它构建交易并解码程序数据,而无需手动编写指令布局。Anchor 会自动生成 IDL,并默认在专用账户上链发布,以便于公共发现。