IpfsApi 0.2.0

IpfsApi 0.2.0

Jay Lee 维护。



IpfsApi 0.2.0

ios-ipfs-api

为 iOS 提供的 IPFS 客户端 HTTP-API 封装。

CI Status Version License Platform

查看客户端 API 参考以获得完整的命令参考。

示例

要运行示例项目,请克隆仓库,然后首先从 Example 目录中运行 pod install

    import Ipfs
    
    .
    .
    .
    
    //Default base address: "http://127.0.0.1:5001/api/v0"
    
    //Do nothing...
    //Or
    Ipfs.shared().setBase(address: "http://your.ipfs.address")
    //Or
    Ipfs.shared().setBase(address: "http://your.ipfs.address", port: 5001)
    //Or
    Ipfs.shared().setBase(address: "http://your.ipfs.address", port: 5001, apiVersionPath: "/api/v0")
    
    .
    .
    .

需求

  • iOS 8.0+
  • Xcode 9.3+
  • Swift 4.1+

安装

IpfsApi 通过 CocoaPods 提供。要安装,只需将以下行添加到您的 Podfile 中

pod 'IpfsApi'

测试环境设置

使用 Docker (https://github.com/ipfs/go-ipfs)

IPFS 的 Docker 镜像托管在 hub.docker.com/r/ipfs/go-ipfs。要使容器内的文件可见,您需要使用带有 -v 选项的 docker 将主机目录挂载。选择一个您希望用于从 IPFS 导入/导出文件的目录。您还应选择一个目录来存储 IPFS 文件,以便在容器重启时保持持久。

export ipfs_staging=</absolute/path/to/somewhere/>
export ipfs_data=</absolute/path/to/somewhere_else/>

启动一个运行 ipfs 的容器并公开端口 4001、5001 和 8080

docker run -d --name ipfs_host -v $ipfs_staging:/export -v \
    $ipfs_data:/data/ipfs -p 4001:4001 -p 127.0.0.1:8080:8080 \
    -p 127.0.0.1:5001:5001 ipfs/go-ipfs:latest

观看 ipfs 日志

docker logs -f ipfs_host

等待 ipfs 启动。您可以在看到以下内容时确定 ipfs 运行正常:

Gateway (readonly) server
listening on /ip4/0.0.0.0/tcp/8080

现在您可以停止观看日志。

运行 ipfs 命令

docker exec ipfs_host ipfs <args...>

例如:连接到对等节点

docker exec ipfs_host ipfs swarm peers

添加文件

cp -r <something> $ipfs_staging
docker exec ipfs_host ipfs add -r /export/<something>

停止正在运行的容器

docker stop ipfs_host

作者

kjaylee, [email protected]

许可

IpfsApi 在 MIT 许可下可用。有关更多信息,请参阅 LICENSE 文件。