client

package

v0.0.13 Latest Latest Go to latest Published: Aug 29, 2025 License: Apache-2.0, MIT Imports: 20 Imported by: 0

Details

This section is empty.

This section is empty.

This section is empty.

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

func New(endpoint *url.URL, opts ...Option) (*Client, error)

New creates a new PDP API client and automatically detects the server type

func NewFromConfig(cfg config.Client) (*Client, error)

func (c *Client) AddRoots(ctx context.Context, proofSetID uint64, roots []types.RootAdd) (common.Hash, error)

func (c *Client) AllocatePiece(ctx context.Context, allocation types.PieceAllocation) (*types.AllocatedPiece, error)

func (c *Client) CreateProofSet(ctx context.Context, recordKeeper common.Address) (common.Hash, error)

func (c *Client) FindPiece(ctx context.Context, piece types.Piece) (cid.Cid, bool, error)

func (c *Client) GetProofSet(ctx context.Context, proofSetID uint64) (*types.ProofSet, error)

func (c *Client) GetProofSetStatus(ctx context.Context, txHash common.Hash) (*types.ProofSetStatus, error)

func (c *Client) ListProofSet(ctx context.Context) ([]types.ProofSet, error)

func (c *Client) ReadPiece(ctx context.Context, piece cid.Cid) (*types.PieceReader, error)

func (c *Client) RemoveRoot(ctx context.Context, proofSetID uint64, rootID uint64) (common.Hash, error)

func (c *Client) UploadPiece(ctx context.Context, upload types.PieceUpload) error

type EndpointType string

const (
	GenericEndpoint EndpointType = "generic"
	PiriEndpoint    EndpointType = "piri"
)

type ErrFailedResponse struct {
	StatusCode int
	Body       string
}

func (e ErrFailedResponse) Error() string

type Option func(c *Client) error

func WithBearerFromSigner(id principal.Signer) Option

func WithEndpointType(t EndpointType) Option

func WithHTTPClient(client *http.Client) Option