Infura Filecoin API开发文档

Infura的Filecoin API服务目前提供了Filecoin RPC API的一个子集。PHP开发工程师 可以使用Filecoin.PHP开发库来访问Infura的Filecoin API服务。

访问鉴权

Infura提供的访问点需要http basic身份认证，用户名和密码分别为 Infura分配的Project ID和Project Secret，你可以在 这里设置。

无状态和流式API

大部分的RPC方法都是无状态的，因此可以通过HTTPS调用。例如使用 curl调用ChainHead方法：

curl -X POST -H "Content-Type: application/json"
  --user <PROJECT_ID>:<PROJECT_SECRET>
  --url https://filecoin.infura.io
  --data '{ "id": 0, "jsonrpc": "2.0", "method": "Filecoin.ChainHead", "params": [] }'

需要流式更新的API方法只能通过Websockets访问。例如使用 wscat监听链通知事件：

wscat --auth <PROJECT_ID>:<PROJECT_SECRET> --connect wss://filecoin.infura.io

> { "jsonrpc": "2.0", "method": "Filecoin.ChainNotify", "params": [], "id": 3 }

Infura Filecoin API清单

Chain/区块链

• ChainNotify - 注册TipSet更新回调
• ChainHead - 返回当前TipSet
• ChainGetBlock - 读取区块
• ChainGetTipSet - 读取指定TipSet
• ChainGetBlockMessages - 读取区块内消息
• ChainGetParentReceipts - 读取父TipSet中的收据
• ChainGetParentMessages - 读取父TipSet中的消息
• ChainGetTipSetByHeight - 读取指定高度的TipSet
• ChainReadObj - 读取指定对象
• ChainHasObj - 检查链库中是否存在指定对象
• ChainStatObj - 返回指定对象的统计信息
• ChainGetGenesis - 读取创世TipSet
• ChainTipSetWeight - 计算指定TipSet的权重
• ChainGetMessage - 读取指定消息
• ChainGetPath - 返回TipSet变换路径

Gas/手续费

• GasEstimateFeeCap - 估算手续费封顶值
• GasEstimateGasLimit - 估算Gas上限
• GasEstimateGasPremium - 估算Gas用量
• GasEstimateMessageGas - 估算消息Gas用量

Sync/区块同步

• SyncState - 返回同步状态
• SyncIncomingBlocks - 注册区块头接收回调
• Mpool:
• MpoolPending - 返回内存池中的待定消息
• MpoolPush - 将指定签名消息推入内存池
• MpoolGetNonce - 返回指定地址的下一随机值
• MpoolSub - 注册内存池状态更新回调
• Wallet:
• WalletBalance - 查询钱包余额
• WalletVerify - 验证签名有效性
• WalletValidateAddress - 验证指定的地址字符串

Client/节点

• ClientQueryAsk - 查询StorageAsk

State/世界状态

• StateReplay - 重放指定的消息
• StateGetActor - 查询指定的Actor
• StateReadState - 查询读取状态
• StateListMessages - 列表返回消息
• StateNetworkName - 查询当前网络名称
• StateMinerSectors - 查询矿工扇区信息
• StateMinerPower - 查询指定矿工的算力
• StateMinerInfo - 查询指定矿工的基本信息
• StateMinerFaults - 查询指定矿工的故障信息
• StateSearchMsg - 搜索链上消息
• StateWaitMsg - 查找并等待指定消息上链
• StateListMiners - 列表返回矿工
• StateListActors - 列表返回全部Actor
• StateMarketBalance - 查询指定地址的存储市场余额
• StateMarketParticipants - 列表返回市场参与各方
• StateMarketDeals - 列表返回市场交易
• StateMarketStorageDeal - 查询指定的存储交易
• StateLookupID - 查找指定的地址
• StateAccountKey - 查询账号公钥
• StateGetReceipt - 查询指定的收据
• StateMinerSectorCount - 查询矿工扇区数量