api

Documentation

Index

• Variables
• func Bool(v bool) (p *bool)
• type BadRequestError
  • func NewBadRequestError(errors ...string) (err *BadRequestError)
  • func (e *BadRequestError) Error() (s string)
  • func (e *BadRequestError) Errors() (errs []string)
• type BzzChunkService
  • func (b *BzzChunkService) Download(ctx context.Context, a swarm.Address) (resp io.ReadCloser, err error)
  • func (b *BzzChunkService) Upload(ctx context.Context, a swarm.Address, data io.Reader) (resp BzzChunkUploadResponse, err error)
• type BzzChunkUploadResponse
• type BzzService
  • func (b *BzzService) Download(ctx context.Context, a swarm.Address) (resp io.ReadCloser, err error)
  • func (b *BzzService) Upload(ctx context.Context, data io.Reader) (resp UploadResponse, err error)
• type Client
  • func NewClient(baseURL *url.URL, o *ClientOptions) (c *Client)
• type ClientOptions
• type PingPongService
  • func (p *PingPongService) Ping(ctx context.Context, a swarm.Address) (resp Pong, err error)
• type Pong
• type UploadResponse

Variables

var (
	ErrUnauthorized        = errors.New("unauthorized")
	ErrForbidden           = errors.New("forbidden")
	ErrNotFound            = errors.New("not found")
	ErrMethodNotAllowed    = errors.New("method not allowed")
	ErrTooManyRequests     = errors.New("too many requests")
	ErrInternalServerError = errors.New("internal server error")
	ErrServiceUnavailable  = errors.New("service unavailable")
)

Errors that are returned by the API.

Functions

func Bool

func Bool(v bool) (p *bool)

Bool is a helper routine that allocates a new bool value to store v and returns a pointer to it.

Types

type BadRequestError

type BadRequestError struct {
	// contains filtered or unexported fields
}

BadRequestError holds list of errors from http response that represent invalid data submitted by the user.

func NewBadRequestError

func NewBadRequestError(errors ...string) (err *BadRequestError)

NewBadRequestError constructs a new BadRequestError with provided errors.

func (*BadRequestError) Error

func (e *BadRequestError) Error() (s string)

func (*BadRequestError) Errors

func (e *BadRequestError) Errors() (errs []string)

Errors returns a list of error messages.

type BzzChunkService

type BzzChunkService service

BzzChunkService represents Bee's Bzz service

func (*BzzChunkService) Download

func (b *BzzChunkService) Download(ctx context.Context, a swarm.Address) (resp io.ReadCloser, err error)

Download downloads data from the node

func (*BzzChunkService) Upload

func (b *BzzChunkService) Upload(ctx context.Context, a swarm.Address, data io.Reader) (resp BzzChunkUploadResponse, err error)

Upload uploads data to the node

type BzzChunkUploadResponse

type BzzChunkUploadResponse struct {
	Message string `json:"message,omitempty"`
	Code    int    `json:"code,omitempty"`
}

BzzChunkUploadResponse represents Upload's response

type BzzService

type BzzService service

BzzService represents Bee's Bzz service

func (*BzzService) Download

func (b *BzzService) Download(ctx context.Context, a swarm.Address) (resp io.ReadCloser, err error)

Download downloads data from the node

func (*BzzService) Upload

func (b *BzzService) Upload(ctx context.Context, data io.Reader) (resp UploadResponse, err error)

Upload uploads data to the node

type Client

type Client struct {

	// Services that API provides.
	Bzz      *BzzService
	BzzChunk *BzzChunkService
	PingPong *PingPongService
	// contains filtered or unexported fields
}

Client manages communication with the Bee API.

func NewClient

func NewClient(baseURL *url.URL, o *ClientOptions) (c *Client)

NewClient constructs a new Client.

type ClientOptions

type ClientOptions struct {
	HTTPClient *http.Client
}

ClientOptions holds optional parameters for the Client.

type PingPongService

type PingPongService service

PingPongService represents Bee's PingPong service

func (*PingPongService) Ping

func (p *PingPongService) Ping(ctx context.Context, a swarm.Address) (resp Pong, err error)

Ping pings given node

type Pong

type Pong struct {
	RTT string `json:"rtt"`
}

Pong represents Ping's response

type UploadResponse

type UploadResponse struct {
	Hash swarm.Address `json:"hash"`
}

UploadResponse represents Upload's response