⛏️快速开始

快速入门指南可以很好的帮助开发者通过几个步骤开始并运行 Web3 App。

1. 注册 SolarPath 账户

要在 SolarPath 网站上注册一个帐户,请输入您的电子邮件地址和密码,然后单击“注册”。

提示:注册后需要激活您的帐户,请到您的邮箱中点击链接来验证您的账户,并按引导创建您的第一个App。

2. 创建App

激活账户后,您将来到Dashboard页面,您可以创建新的App、设置请求安全、EventHook事件通知、查看分析、数据监控等。

SolarPath 支持主链和网络:

  • 您必须先创建一个 App 并获得API-KEY来验证你发出的请求。

  • 点击 Dashboard 列出的 App 卡片,进入要访问的 App,查看你的API-KEY:

3. 增强 API-KEY 安全访问

通过设置 API-KEY 的访问限制来增加安全访问,进入 APP,点击 Edit App,使用白名单列表来增强您的访问安全性:

  • 白名单合约地址列表: 只有批准的合约地址才允许进行交互,如不设置即允许所有合约地址。

  • 白名单域名: 只有批准的来源请求域,才允许请求,如不设置即允许所有来源域请求。

  • 白名单IP: 只有批准的来源 IP 才允许请求,如不设置即允许所有来源 IP 请求。

白名单域名匹配规则如: www.solarpath.io、*.solarpath.io

白名单IP匹配规则IPv4如: 192.168.1.0、225.225.225.100

4. 发送请求

通过 SolarPath 提供的 HTTPS 连接端点,发送 Web3 请求与链上进行交互。以下示例使用 HTTP 发送请求与以太坊网络进行交互。

所有请求均为 POST 请求。

4.1 获取当前区块号:

curl https://eth-mainnet.solarpath.io/v1/YOUR-API-KEY \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc": "2.0", "id": 1, "method": "eth_blockNumber", "params": []}'

Response:

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x7b887a"
}

返回的结果为十六进制,前缀为 0x,将 7b887a 转换为十进制,得到的数字为 8095866。

4.2 查询余额:

curl https://eth-mainnet.solarpath.io/v1/YOUR-API-KEY \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc": "2.0", "id": 1, "method": "eth_getBalance", "params": ["0xf31D0046D26AF057Ba51EF4B2E0372cF9aD990fb", "latest"]}'

Response:

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x62e7750f619827b"
}

返回的结果为十六进制,以Wei为单位(以太币最小面额单位)。转十进制为 445424602766213760 Wei,等于 0.44542460276621376 Ether。

5. 查看SolarPath Dashboard

SolarPath Dashboard为您显示性能和 API 使用情况,例如调用的方法、成功率、使用统计和活跃的范围。

通过定期查看Dashboard来优化您的应用程序并更好的了解您的用户。

6. 管理账户

您可以在账户管理中修改您的登录邮箱、修改登录密码、开启2FA验证等。也可以根据自身业务量,动态添加请求包或升级订阅计划。

最后更新于