131 lines
3.3 KiB
Go
131 lines
3.3 KiB
Go
package api
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/filecoin-project/go-lotus/chain"
|
|
"github.com/filecoin-project/go-lotus/chain/address"
|
|
"github.com/filecoin-project/go-lotus/chain/types"
|
|
|
|
"github.com/ipfs/go-cid"
|
|
"github.com/ipfs/go-filestore"
|
|
"github.com/libp2p/go-libp2p-core/peer"
|
|
)
|
|
|
|
// Version provides various build-time information
|
|
type Version struct {
|
|
Version string
|
|
|
|
// TODO: git commit / os / genesis cid?
|
|
}
|
|
|
|
type Import struct {
|
|
Status filestore.Status
|
|
Key cid.Cid
|
|
FilePath string
|
|
Size uint64
|
|
}
|
|
|
|
type MsgWait struct {
|
|
InBlock cid.Cid
|
|
Receipt types.MessageReceipt
|
|
}
|
|
|
|
// API is a low-level interface to the Filecoin network
|
|
type API interface {
|
|
// Auth
|
|
AuthVerify(ctx context.Context, token string) ([]string, error)
|
|
AuthNew(ctx context.Context, perms []string) ([]byte, error)
|
|
|
|
// chain
|
|
|
|
ChainHead(context.Context) (*chain.TipSet, error) // TODO: check serialization
|
|
ChainSubmitBlock(ctx context.Context, blk *chain.BlockMsg) error // TODO: check serialization
|
|
ChainGetRandomness(context.Context, *chain.TipSet) ([]byte, error)
|
|
ChainWaitMsg(context.Context, cid.Cid) (*MsgWait, error)
|
|
ChainGetBlock(context.Context, cid.Cid) (*chain.BlockHeader, error)
|
|
ChainGetBlockMessages(context.Context, cid.Cid) ([]*chain.SignedMessage, error)
|
|
|
|
// messages
|
|
|
|
// // wait
|
|
// // send
|
|
// // status
|
|
// // mpool
|
|
// // // ls / show / rm
|
|
MpoolPending(context.Context, *chain.TipSet) ([]*chain.SignedMessage, error)
|
|
MpoolPush(context.Context, *chain.SignedMessage) error
|
|
|
|
// dag
|
|
|
|
// // get block
|
|
// // (cli: show / info)
|
|
|
|
// network
|
|
|
|
NetPeers(context.Context) ([]peer.AddrInfo, error)
|
|
NetConnect(context.Context, peer.AddrInfo) error
|
|
NetAddrsListen(context.Context) (peer.AddrInfo, error)
|
|
// // ping
|
|
|
|
// Struct
|
|
|
|
// miner
|
|
|
|
// // create
|
|
// // owner
|
|
// // power
|
|
// // set-price
|
|
// // set-perrid
|
|
MinerStart(context.Context, address.Address) error
|
|
MinerCreateBlock(context.Context, address.Address, *chain.TipSet, []chain.Ticket, chain.ElectionProof, []*chain.SignedMessage) (*chain.BlockMsg, error)
|
|
|
|
// // UX ?
|
|
|
|
// wallet
|
|
|
|
WalletNew(context.Context, string) (address.Address, error)
|
|
WalletList(context.Context) ([]address.Address, error)
|
|
WalletBalance(context.Context, address.Address) (types.BigInt, error)
|
|
WalletSign(context.Context, address.Address, []byte) (*chain.Signature, error)
|
|
WalletDefaultAddress(context.Context) (address.Address, error)
|
|
|
|
// Really not sure where this belongs. It could go on the wallet, or the message pool, or the chain...
|
|
MpoolGetNonce(context.Context, address.Address) (uint64, error)
|
|
|
|
// // import
|
|
// // export
|
|
// // (on cli - cmd to list associations)
|
|
|
|
// dht
|
|
|
|
// // need ?
|
|
|
|
// paych
|
|
|
|
// // todo
|
|
|
|
// retrieval
|
|
|
|
// // retrieve piece
|
|
|
|
// Other
|
|
|
|
// ClientImport imports file under the specified path into filestore
|
|
ClientImport(ctx context.Context, path string) (cid.Cid, error)
|
|
|
|
// ClientUnimport removes references to the specified file from filestore
|
|
//ClientUnimport(path string)
|
|
|
|
// ClientListImports lists imported files and their root CIDs
|
|
ClientListImports(ctx context.Context) ([]Import, error)
|
|
|
|
//ClientListAsks() []Ask
|
|
|
|
// ID returns peerID of libp2p node backing this API
|
|
ID(context.Context) (peer.ID, error)
|
|
|
|
// Version provides information about API provider
|
|
Version(context.Context) (Version, error)
|
|
}
|