tmstore

Documentation

Overview

Package tmstore implements a store that saves all the segments in a tendermint app

Index

• Constants
• type Batch
  • func NewBatch(a *TMStore) *Batch
  • func (b *Batch) Write() (err error)
• type Config
• type Info
• type TMStore
  • func New(config *Config) *TMStore
  • func NewFromClient(config *Config, clientFactory func(endpoint string) client.Client) *TMStore
  • func (t *TMStore) AddDidSaveChannel(saveChan chan *cs.Segment)
  • func (t *TMStore) DeleteSegment(linkHash *types.Bytes32) (segment *cs.Segment, err error)
  • func (t *TMStore) DeleteValue(key []byte) (value []byte, err error)
  • func (t *TMStore) FindSegments(filter *store.SegmentFilter) (segmentSlice cs.SegmentSlice, err error)
  • func (t *TMStore) GetInfo() (interface{}, error)
  • func (t *TMStore) GetMapIDs(filter *store.MapFilter) (ids []string, err error)
  • func (t *TMStore) GetSegment(linkHash *types.Bytes32) (segment *cs.Segment, err error)
  • func (t *TMStore) GetValue(key []byte) (value []byte, err error)
  • func (t *TMStore) NewBatch() (store.Batch, error)
  • func (t *TMStore) RetryStartWebsocket(interval time.Duration) error
  • func (t *TMStore) SaveSegment(segment *cs.Segment) error
  • func (t *TMStore) SaveValue(key, value []byte) error
  • func (t *TMStore) StartWebsocket() error
  • func (t *TMStore) StopWebsocket()

Constants

const (
	// Name is the name set in the store's information.
	Name = "tm"

	// Description is the description set in the store's information.
	Description = "Stratumn TM Store"

	// DefaultEndpoint is the default Tendermint endpoint.
	DefaultEndpoint = "tcp://127.0.0.1:46657"

	// DefaultWsRetryInterval is the default interval between Tendermint Wbesocket connection tries.
	DefaultWsRetryInterval = 5 * time.Second
)

Types

type Batch

type Batch struct {
	*store.BufferedBatch
	// contains filtered or unexported fields
}

Batch is the type that implements github.com/stratumn/sdk/store.Batch.

func NewBatch

func NewBatch(a *TMStore) *Batch

NewBatch creates a new Batch.

func (*Batch) Write

func (b *Batch) Write() (err error)

type Config

type Config struct {
	// A version string that will be set in the store's information.
	Version string

	// A git commit hash that will be set in the store's information.
	Commit string

	// Endoint used to communicate with Tendermint core
	Endpoint string
}

Config contains configuration options for the store.

type Info

type Info struct {
	Name        string      `json:"name"`
	Description string      `json:"description"`
	TMAppInfo   interface{} `json:"tmAppDescription"`
	Version     string      `json:"version"`
	Commit      string      `json:"commit"`
}

Info is the info returned by GetInfo.

type TMStore

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

TMStore is the type that implements github.com/stratumn/sdk/store.Adapter.

func New

func New(config *Config) *TMStore

New creates a new instance of a TMStore.

func NewFromClient

func NewFromClient(config *Config, clientFactory func(endpoint string) client.Client) *TMStore

NewFromClient creates a new instance of a TMStore with the given client.

func (*TMStore) AddDidSaveChannel

func (t *TMStore) AddDidSaveChannel(saveChan chan *cs.Segment)

AddDidSaveChannel implements github.com/stratumn/sdk/fossilizer.Store.AddDidSaveChannel.

func (*TMStore) DeleteSegment

func (t *TMStore) DeleteSegment(linkHash *types.Bytes32) (segment *cs.Segment, err error)

DeleteSegment implements github.com/stratumn/sdk/store.Adapter.DeleteSegment.

func (*TMStore) DeleteValue

func (t *TMStore) DeleteValue(key []byte) (value []byte, err error)

DeleteValue implements github.com/stratumn/sdk/store.Adapter.DeleteValue.

func (*TMStore) FindSegments

func (t *TMStore) FindSegments(filter *store.SegmentFilter) (segmentSlice cs.SegmentSlice, err error)

FindSegments implements github.com/stratumn/sdk/store.Adapter.FindSegments.

func (*TMStore) GetInfo

func (t *TMStore) GetInfo() (interface{}, error)

GetInfo implements github.com/stratumn/sdk/store.Adapter.GetInfo.

func (*TMStore) GetMapIDs

func (t *TMStore) GetMapIDs(filter *store.MapFilter) (ids []string, err error)

GetMapIDs implements github.com/stratumn/sdk/store.Adapter.GetMapIDs.

func (*TMStore) GetSegment

func (t *TMStore) GetSegment(linkHash *types.Bytes32) (segment *cs.Segment, err error)

GetSegment implements github.com/stratumn/sdk/store.Adapter.GetSegment.

func (*TMStore) GetValue

func (t *TMStore) GetValue(key []byte) (value []byte, err error)

GetValue implements github.com/stratumn/sdk/store.Adapter.GetValue.

func (*TMStore) NewBatch

func (t *TMStore) NewBatch() (store.Batch, error)

NewBatch implements github.com/stratumn/sdk/store.Adapter.NewBatch.

func (*TMStore) RetryStartWebsocket

func (t *TMStore) RetryStartWebsocket(interval time.Duration) error

RetryStartWebsocket starts the websocket client and wait for New Block events, it retries on errors.

func (*TMStore) SaveSegment

func (t *TMStore) SaveSegment(segment *cs.Segment) error

SaveSegment implements github.com/stratumn/sdk/store.Adapter.SaveSegment.

func (*TMStore) SaveValue

func (t *TMStore) SaveValue(key, value []byte) error

SaveValue implements github.com/stratumn/sdk/store.Adapter.SaveValue.

func (*TMStore) StartWebsocket

func (t *TMStore) StartWebsocket() error

StartWebsocket starts the websocket client and wait for New Block events.

func (*TMStore) StopWebsocket

func (t *TMStore) StopWebsocket()

StopWebsocket stops the websocket client.