Helius 文档和 Solana 中使用术语的快速参考定义。每个条目链接到相关的产品页面或指南(如适用)。 跳转到: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 产品和平台
自动扩展
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.com 为 beta.helius-rpc.com 来访问。
请参阅Gatekeeper和介绍 Gatekeeper 的博客文章以了解架构背景。
LaserStream
Helius 的高性能 gRPC 流服务,用于 Solana 链上数据,具有历史重放、多区域故障转移和 Helius 流产品中最丰富的功能集。官方 SDK 提供 JavaScript/TypeScript、Rust 和 Go。增强的 WebSockets 在相同的基础设施上运行。 查看 LaserStream 和 LaserStream 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获取最近的区块哈希。