client

type BatchID string // hex encoded [32]byte

type BuyStampResponse struct {
	BatchID BatchID `json:"batchID"`
}

type Client interface {
	// Stamps fetches purchased stamp batches via /stamps endpoint.
	Stamps(
		ctx context.Context,
	) (StampsResponse, error)

	// BuyStamp buys a new postage stamp batch.
	BuyStamp(
		ctx context.Context,
		amount *big.Int,
		depth uint8,
		immutable bool,
	) (BuyStampResponse, error)

	// UploadBytes arbitrary bytes data via /bytes endpoint.
	UploadBytes(
		ctx context.Context,
		data []byte,
		batchID BatchID,
	) (UploadResponse, error)

	// DownloadBytes bytes data via /bytes endpoint.
	DownloadBytes(
		ctx context.Context,
		addr swarm.Address,
	) (io.ReadCloser, error)

	// DownloadChunk downloads Chunk via /chunks endpoint.
	DownloadChunk(
		ctx context.Context,
		addr swarm.Address,
	) (io.ReadCloser, error)

	// UploadSoc uploads Single Owner Chunk data via /soc endpoint.
	UploadSoc(
		ctx context.Context,
		owner common.Address,
		id SocID,
		data []byte,
		signature SocSignature,
		batchID BatchID,
	) (UploadSocResponse, error)

	// FeedIndexLatest returns the most recent feed's index from /feeds/owner/topic.
	FeedIndexLatest(
		ctx context.Context,
		owner common.Address,
		topic Topic,
	) (FeedIndexResponse, error)
}

type Config struct {
	NodeURL string
}

type FeedIndexResponse struct {
	Reference swarm.Address `json:"reference"`
	Current   uint64        // passed via header
	Next      uint64        // passed via header
}

type SocID = soc.ID

type SocSignature []byte // [65]bytes (swarm.SocSignatureSize)

type Stamp struct {
	BatchID       BatchID        `json:"batchID"`
	Utilization   uint32         `json:"utilization"`
	Usable        bool           `json:"usable"`
	Label         string         `json:"label"`
	Depth         uint8          `json:"depth"`
	Amount        *bigint.BigInt `json:"amount"`
	BucketDepth   uint8          `json:"bucketDepth"`
	BlockNumber   uint64         `json:"blockNumber"`
	ImmutableFlag bool           `json:"immutableFlag"`
	Exists        bool           `json:"exists"`
	BatchTTL      int64          `json:"batchTTL"`
	Expired       bool           `json:"expired"`
}

type StampsResponse struct {
	Stamps []Stamp `json:"stamps"`
}

type Topic []byte

type UploadResponse struct {
	Reference swarm.Address `json:"reference"`
}

type UploadSocResponse struct {
	Reference swarm.Address `json:"reference"`
}