跳转到主要内容
RPC 方法允许您请求向指定帐户空投 SOL (lamports)。此方法仅适用于非主网环境,例如 Devnet 和 Testnet,在这些环境中它用作水龙头,为开发人员提供免费的 SOL 以测试他们的应用程序。 重要提示:此方法在 Mainnet Beta 上无效。

常见用例

  • **测试钱包资金:**获取 SOL 以支付交易费用并在 Devnet 或 Testnet 上部署程序。
  • **自动化测试:**脚本可以使用此方法以确保测试帐户在运行测试套件之前拥有足够的 SOL。
  • **开发与实验:**快速获取 SOL 以在开发期间与链上程序进行交互。

请求参数

  1. **(字符串,必需):**接收空投 lamports 的帐户的公钥,提供为 base-58 编码的字符串。
  2. **(u64,必需):**请求的 lamports 数量。(1 SOL = 1,000,000,000 lamports)。
  3. **(对象,可选):**可选的配置对象可以包括:
    • **(字符串,可选):**指定在确认空投交易时等待的承诺级别(例如,“processed”、“confirmed”、“finalized”)。如果省略,则使用节点默认的空投承诺级别。

响应结构

JSON-RPC 响应中的字段是一个字符串,表示空投的交易签名,base-58 编码。 示例响应: 该签名可以与其他工具或 Solana 浏览器一起使用,以跟踪空投交易的状态。

代码示例

开发者提示

  • **特定网络:**此方法仅在具有水龙头功能的测试网络(Devnet,Testnet)上可用。在主网 Beta 上将失败。
  • **限速:**空投水龙头通常有限速以防止滥用。如果您在短时间内发出太多请求,则可能会收到错误。
  • **金额限制:**对每次空投或每个时间段内可以请求的 SOL 数量可能有限制。
  • **确认:**在方法返回签名后,交易仍需由网络处理和确认。您可以使用其他工具或轮询节点以等待确认。
本指南解释了如何使用 requestAirdrop 为 Solana 开发网络上的测试账户提供资金。

相关方法