statusproto

README

status-protocol-go

This is the Status Protocol implementation in Go.

TBD

Documentation

Index

• Variables
• func WithChats(publicChatNames []string, publicKeys []*ecdsa.PublicKey, ...) func(c *config) error
• func WithOnNewInstallationsHandler(h func([]*multidevice.Installation)) func(c *config) error
• func WithOnNewSharedSecret(h func([]*sharedsecret.Secret)) func(c *config) error
• func WithSendV1Messages() func(c *config) error
• type Chat
• type Messenger
  • func NewMessenger(identity *ecdsa.PrivateKey, server transport.Server, shh *whisper.Whisper, ...) (*Messenger, error)
  • func (m *Messenger) AddMailserver(enode string) error
  • func (m *Messenger) DisableInstallation(id string) error
  • func (m *Messenger) EnableInstallation(id string) error
  • func (m *Messenger) Installations() ([]*multidevice.Installation, error)
  • func (m *Messenger) Join(chat Chat) error
  • func (m *Messenger) Leave(chat Chat) error
  • func (m *Messenger) Mailservers() ([]string, error)
  • func (m *Messenger) RemoveMailserver(id string) error
  • func (m *Messenger) Retrieve(ctx context.Context, chat Chat, c RetrieveConfig) (messages []*protocol.Message, err error)
  • func (m *Messenger) SelectMailserver(id string) error
  • func (m *Messenger) Send(ctx context.Context, chat Chat, data []byte) ([]byte, error)
  • func (m *Messenger) SetInstallationMetadata(id string, data *multidevice.InstallationMetadata) error
• type Option
• type RetrieveConfig

Variables

var (
	ErrChatIDEmpty    = errors.New("chat ID is empty")
	ErrNotImplemented = errors.New("not implemented")
)

var (
	RetrieveLatest  = RetrieveConfig{/* contains filtered or unexported fields */}
	RetrieveLastDay = RetrieveConfig{/* contains filtered or unexported fields */}
)

var (
	// ErrMsgAlreadyExist returned if msg already exist.
	ErrMsgAlreadyExist = errors.New("message with given ID already exist")
)

Functions

func WithChats

func WithChats(
	publicChatNames []string,
	publicKeys []*ecdsa.PublicKey,
	secrets []filter.NegotiatedSecret,
) func(c *config) error

func WithOnNewInstallationsHandler

func WithOnNewInstallationsHandler(h func([]*multidevice.Installation)) func(c *config) error

func WithOnNewSharedSecret

func WithOnNewSharedSecret(h func([]*sharedsecret.Secret)) func(c *config) error

func WithSendV1Messages

func WithSendV1Messages() func(c *config) error

Types

type Chat

type Chat interface {
	ID() string
	PublicName() string
	PublicKey() *ecdsa.PublicKey
}

type Messenger

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

Messenger is a entity managing chats and messages. It acts as a bridge between the application and encryption layers. It needs to expose an interface to manage installations because installations are managed by the user. Similarly, it needs to expose an interface to manage mailservers because they can also be managed by the user.

func NewMessenger

func NewMessenger(
	identity *ecdsa.PrivateKey,
	server transport.Server,
	shh *whisper.Whisper,
	dataDir string,
	dbKey string,
	installationID string,
	opts ...Option,
) (*Messenger, error)

func (*Messenger) AddMailserver

func (m *Messenger) AddMailserver(enode string) error

NOT_IMPLEMENTED

func (*Messenger) DisableInstallation

func (m *Messenger) DisableInstallation(id string) error

func (*Messenger) EnableInstallation

func (m *Messenger) EnableInstallation(id string) error

func (*Messenger) Installations

func (m *Messenger) Installations() ([]*multidevice.Installation, error)

func (*Messenger) Join

func (m *Messenger) Join(chat Chat) error

func (*Messenger) Leave

func (m *Messenger) Leave(chat Chat) error

func (*Messenger) Mailservers

func (m *Messenger) Mailservers() ([]string, error)

NOT_IMPLEMENTED

func (*Messenger) RemoveMailserver

func (m *Messenger) RemoveMailserver(id string) error

NOT_IMPLEMENTED

func (*Messenger) Retrieve

func (m *Messenger) Retrieve(ctx context.Context, chat Chat, c RetrieveConfig) (messages []*protocol.Message, err error)

func (*Messenger) SelectMailserver

func (m *Messenger) SelectMailserver(id string) error

NOT_IMPLEMENTED

func (*Messenger) Send

func (m *Messenger) Send(ctx context.Context, chat Chat, data []byte) ([]byte, error)

func (*Messenger) SetInstallationMetadata

func (m *Messenger) SetInstallationMetadata(id string, data *multidevice.InstallationMetadata) error

type Option

type Option func(*config) error

type RetrieveConfig

type RetrieveConfig struct {
	From time.Time
	To   time.Time
	// contains filtered or unexported fields
}