accounts

package
v0.162.14 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 3, 2023 License: MPL-2.0 Imports: 16 Imported by: 0

Documentation

Index

Constants

View Source
const (
	SyncedFromBackup         = "backup"        // means a account is coming from backed up data
	SyncedFromLocalPairing   = "local-pairing" // means a account is coming from another device when user is reocovering Status account
	ThirtyDaysInMilliseconds = 30 * 24 * 60 * 60 * 1000
)
View Source
const (
	// NodeConfigTag tag for a node configuration.
	NodeConfigTag = "node_config"
)

Variables

View Source
var (
	ErrDbKeypairNotFound                           = errors.New("accounts: keypair is not found")
	ErrCannotRemoveProfileKeypair                  = errors.New("accounts: cannot remove profile keypair")
	ErrDbAccountNotFound                           = errors.New("accounts: account is not found")
	ErrCannotRemoveProfileAccount                  = errors.New("accounts: cannot remove profile account")
	ErrCannotRemoveDefaultWalletAccount            = errors.New("accounts: cannot remove default wallet account")
	ErrAccountWrongPosition                        = errors.New("accounts: trying to set wrong position to account")
	ErrNotTheSameNumberOdAccountsToApplyReordering = errors.New("accounts: there is different number of accounts between received sync message and db accounts")
	ErrNotTheSameAccountsToApplyReordering         = errors.New("accounts: there are differences between accounts in received sync message and db accounts")
	ErrMovingAccountToWrongPosition                = errors.New("accounts: trying to move account to a wrong position")
	ErrKeypairDifferentAccountsKeyUID              = errors.New("cannot store keypair with different accounts' key uid than keypair's key uid")
	ErrKeypairWithoutAccounts                      = errors.New("cannot store keypair without accounts")
)
View Source
var (
	ErrNoKeycardForPassedKeycardUID = errors.New("keycard: no keycard for the passed keycard uid")
)

Functions

func Contains added in v0.161.6

func Contains[T comparable](container []T, element T, isEqual func(T, T) bool) bool

func HaveSameElements added in v0.161.6

func HaveSameElements[T comparable](a []T, b []T, isEqual func(T, T) bool) bool

func MockTestAccounts added in v0.158.0

func MockTestAccounts(tb testing.TB, db *sql.DB, accounts []*Account)

func SameAccounts added in v0.152.2

func SameAccounts(expected, real *Account) bool

func SameAccountsIncludingPosition added in v0.162.9

func SameAccountsIncludingPosition(expected, real *Account) bool

func SameAccountsWithDifferentOperable added in v0.152.2

func SameAccountsWithDifferentOperable(expected, real *Account, expectedOperableValue AccountOperable) bool

func SameKeycards added in v0.152.2

func SameKeycards(expected, real *Keycard) bool

func SameKeypairs added in v0.152.2

func SameKeypairs(expected, real *Keypair) bool

func SameKeypairsWithDifferentSyncedFrom added in v0.152.2

func SameKeypairsWithDifferentSyncedFrom(expected, real *Keypair, ignoreSyncedFrom bool, expectedSyncedFromValue string,
	expectedOperableValue AccountOperable) bool

Types

type Account

type Account struct {
	Address               types.Address             `json:"address"`
	KeyUID                string                    `json:"key-uid"`
	Wallet                bool                      `json:"wallet"`
	Chat                  bool                      `json:"chat"`
	Type                  AccountType               `json:"type,omitempty"`
	Path                  string                    `json:"path,omitempty"`
	PublicKey             types.HexBytes            `json:"public-key,omitempty"`
	Name                  string                    `json:"name"`
	Emoji                 string                    `json:"emoji"`
	ColorID               common.CustomizationColor `json:"colorId,omitempty"`
	Hidden                bool                      `json:"hidden"`
	Clock                 uint64                    `json:"clock,omitempty"`
	Removed               bool                      `json:"removed,omitempty"`
	Operable              AccountOperable           `json:"operable"` // describes an account's operability (read an explanation at the top of this file)
	CreatedAt             int64                     `json:"createdAt"`
	Position              int64                     `json:"position"`
	ProdPreferredChainIDs string                    `json:"prodPreferredChainIds"`
	TestPreferredChainIDs string                    `json:"testPreferredChainIds"`
}

func GetWatchOnlyAccountsForTest added in v0.152.2

func GetWatchOnlyAccountsForTest() []*Account

func (*Account) IsOwnAccount added in v0.64.6

func (a *Account) IsOwnAccount() bool

IsOwnAccount returns true if this is an account we have the private key for NOTE: Wallet flag can't be used as it actually indicates that it's the default Wallet

func (*Account) MarshalJSON added in v0.100.0

func (a *Account) MarshalJSON() ([]byte, error)

type AccountOperable added in v0.152.2

type AccountOperable string
const (
	AccountNonOperable       AccountOperable = "no"        // an account is non operable it is not a keycard account and there is no keystore file for it and no keystore file for the address it is derived from
	AccountPartiallyOperable AccountOperable = "partially" // an account is partially operable if it is not a keycard account and there is created keystore file for the address it is derived from
	AccountFullyOperable     AccountOperable = "fully"     // an account is fully operable if it is not a keycard account and there is a keystore file for it

	ProdPreferredChainIDsDefault = "1:10:42161"
	TestPreferredChainIDsDefault = "5:420:421613"
)

func (AccountOperable) String added in v0.152.2

func (a AccountOperable) String() string

type AccountType added in v0.106.3

type AccountType string
const (
	AccountTypeGenerated AccountType = "generated"
	AccountTypeKey       AccountType = "key"
	AccountTypeSeed      AccountType = "seed"
	AccountTypeWatch     AccountType = "watch"
)

func GetAccountTypeForKeypairType added in v0.161.2

func GetAccountTypeForKeypairType(kpType KeypairType) AccountType

func (AccountType) String added in v0.106.3

func (a AccountType) String() string

type Database

type Database struct {
	*settings.Database
	*notificationssettings.NotificationsSettings
	*sociallinkssettings.SocialLinksSettings
	// contains filtered or unexported fields
}

Database sql wrapper for operations with browser objects.

func NewDB

func NewDB(db *sql.DB) (*Database, error)

NewDB returns a new instance of *Database

func (*Database) AddressExists

func (db *Database) AddressExists(address types.Address) (exists bool, err error)

AddressExists returns true if given address is stored in database.

func (*Database) CheckAndDeleteExpiredKeypairsAndAccounts added in v0.162.13

func (db *Database) CheckAndDeleteExpiredKeypairsAndAccounts(time uint64) error

func (*Database) Close

func (db *Database) Close() error

Close closes database.

func (*Database) DB added in v0.93.2

func (db *Database) DB() *sql.DB

DB Gets db sql.DB

func (*Database) DeleteAllKeycardsWithKeyUID added in v0.161.6

func (db *Database) DeleteAllKeycardsWithKeyUID(keyUID string, clock uint64) (err error)

func (*Database) DeleteKeycard added in v0.161.6

func (db *Database) DeleteKeycard(kcUID string, clock uint64) (err error)

func (*Database) DeleteKeycardAccounts added in v0.161.6

func (db *Database) DeleteKeycardAccounts(kcUID string, accountAddresses []types.Address, clock uint64) (err error)

func (*Database) GetAccountByAddress added in v0.62.16

func (db *Database) GetAccountByAddress(address types.Address) (*Account, error)

Returns account if it is not marked as removed.

func (*Database) GetActiveAccounts added in v0.162.13

func (db *Database) GetActiveAccounts() ([]*Account, error)

Returns active accounts (excluding removed).

func (*Database) GetActiveKeypairs added in v0.162.13

func (db *Database) GetActiveKeypairs() ([]*Keypair, error)

Returns active keypairs (excluding removed and excluding removed accounts).

func (*Database) GetActiveWatchOnlyAccounts added in v0.162.13

func (db *Database) GetActiveWatchOnlyAccounts() (res []*Account, err error)

Returns active watch only accounts (excluding removed).

func (*Database) GetAddresses

func (db *Database) GetAddresses() (rst []types.Address, err error)

func (*Database) GetAllAccounts added in v0.162.13

func (db *Database) GetAllAccounts() ([]*Account, error)

Returns all accounts (including removed).

func (*Database) GetAllKeypairs added in v0.162.13

func (db *Database) GetAllKeypairs() ([]*Keypair, error)

Returns all keypairs (including removed and removed accounts).

func (*Database) GetAllKnownKeycards added in v0.161.6

func (db *Database) GetAllKnownKeycards() ([]*Keycard, error)

func (*Database) GetAllWatchOnlyAccounts added in v0.162.13

func (db *Database) GetAllWatchOnlyAccounts() (res []*Account, err error)

Returns all watch only accounts (including removed).

func (*Database) GetChatAddress

func (db *Database) GetChatAddress() (rst types.Address, err error)

func (*Database) GetClockOfLastAccountsPositionChange added in v0.162.9

func (db *Database) GetClockOfLastAccountsPositionChange() (result uint64, err error)

func (*Database) GetKeycardByKeycardUID added in v0.161.6

func (db *Database) GetKeycardByKeycardUID(keycardUID string) (*Keycard, error)

func (*Database) GetKeycardsWithSameKeyUID added in v0.161.6

func (db *Database) GetKeycardsWithSameKeyUID(keyUID string) ([]*Keycard, error)

func (*Database) GetKeypairByKeyUID added in v0.152.2

func (db *Database) GetKeypairByKeyUID(keyUID string) (*Keypair, error)

Returns keypair if it is not marked as removed and its accounts which are not marked as removed.

func (*Database) GetNodeConfig added in v0.38.4

func (db *Database) GetNodeConfig() (*params.NodeConfig, error)

func (*Database) GetPath added in v0.102.6

func (db *Database) GetPath(address types.Address) (path string, err error)

GetPath returns true if account with given address was recently key and doesn't have a key yet

func (*Database) GetPositionForNextNewAccount added in v0.161.2

func (db *Database) GetPositionForNextNewAccount() (int64, error)

func (*Database) GetPositionForNextNewKeycard added in v0.161.6

func (db *Database) GetPositionForNextNewKeycard() (uint64, error)

func (*Database) GetWalletAddress

func (db *Database) GetWalletAddress() (rst types.Address, err error)

func (*Database) GetWalletAddresses added in v0.40.0

func (db *Database) GetWalletAddresses() (rst []types.Address, err error)

func (*Database) IsAnyAccountPartiallyOrFullyOperableForKeyUID added in v0.161.2

func (db *Database) IsAnyAccountPartiallyOrFullyOperableForKeyUID(keyUID string) (bool, error)

func (*Database) KeycardLocked added in v0.161.6

func (db *Database) KeycardLocked(kcUID string, clock uint64) (err error)

func (*Database) KeycardUnlocked added in v0.161.6

func (db *Database) KeycardUnlocked(kcUID string, clock uint64) (err error)

func (*Database) KeypairExists added in v0.161.6

func (db *Database) KeypairExists(keyUID string) (exists bool, err error)

KeypairExists returns true if given address is stored in database.

func (*Database) MoveWalletAccount added in v0.162.9

func (db *Database) MoveWalletAccount(fromPosition int64, toPosition int64, clock uint64) (err error)

Moves wallet account fromPosition to toPosition.

func (*Database) RemoveAccount added in v0.162.13

func (db *Database) RemoveAccount(address types.Address, clock uint64) error

func (*Database) RemoveKeypair added in v0.162.13

func (db *Database) RemoveKeypair(keyUID string, clock uint64) error

func (*Database) ResolveAccountsPositions added in v0.162.9

func (db *Database) ResolveAccountsPositions(clock uint64) (err error)

Updates positions of accounts respecting current order.

func (*Database) SaveOrUpdateAccounts added in v0.152.2

func (db *Database) SaveOrUpdateAccounts(accounts []*Account, updateKeypairClock bool) error

Saves accounts, if an account already exists, it will be updated.

func (*Database) SaveOrUpdateKeycard added in v0.161.6

func (db *Database) SaveOrUpdateKeycard(keycard Keycard, clock uint64, updateKeypairClock bool) error

func (*Database) SaveOrUpdateKeypair added in v0.152.2

func (db *Database) SaveOrUpdateKeypair(keypair *Keypair) error

Saves a keypair and its accounts, if a keypair with `key_uid` already exists, it will be updated, if any of its accounts exists it will be updated as well, otherwise it will be added. Since keypair type contains `Keycards` as well, they are excluded from the saving/updating this way regardless they are set or not.

func (*Database) SetAccountOperability added in v0.161.2

func (db *Database) SetAccountOperability(address types.Address, operable AccountOperable) (err error)

This function should not update the clock, cause it marks accounts locally.

func (*Database) SetKeycardName added in v0.161.6

func (db *Database) SetKeycardName(kcUID string, kpName string, clock uint64) (err error)

func (*Database) SetWalletAccountsPositions added in v0.162.9

func (db *Database) SetWalletAccountsPositions(accounts []*Account, clock uint64) (err error)

Sets positions for passed accounts.

func (*Database) UpdateKeycardUID added in v0.161.6

func (db *Database) UpdateKeycardUID(oldKcUID string, newKcUID string, clock uint64) (err error)

func (*Database) UpdateKeypairName added in v0.152.2

func (db *Database) UpdateKeypairName(keyUID string, name string, clock uint64, updateChatAccountName bool) error

type Keycard added in v0.152.2

type Keycard struct {
	KeycardUID        string          `json:"keycard-uid"`
	KeycardName       string          `json:"keycard-name"`
	KeycardLocked     bool            `json:"keycard-locked"`
	AccountsAddresses []types.Address `json:"accounts-addresses"`
	KeyUID            string          `json:"key-uid"`
	Position          uint64
}

func GetKeycardForSeedImportedKeypair1ForTest added in v0.152.2

func GetKeycardForSeedImportedKeypair1ForTest() *Keycard

func GetKeycardForSeedImportedKeypair2ForTest added in v0.152.2

func GetKeycardForSeedImportedKeypair2ForTest() *Keycard

func GetProfileKeycardForTest added in v0.152.2

func GetProfileKeycardForTest() *Keycard

func (*Keycard) FromSyncKeycard added in v0.152.2

func (kp *Keycard) FromSyncKeycard(kc *protobuf.SyncKeycard)

func (*Keycard) ToSyncKeycard added in v0.152.2

func (kp *Keycard) ToSyncKeycard() *protobuf.SyncKeycard

type Keypair added in v0.152.2

type Keypair struct {
	KeyUID                  string      `json:"key-uid"`
	Name                    string      `json:"name"`
	Type                    KeypairType `json:"type"`
	DerivedFrom             string      `json:"derived-from"`
	LastUsedDerivationIndex uint64      `json:"last-used-derivation-index,omitempty"`
	SyncedFrom              string      `json:"synced-from,omitempty"` // keeps an info which device this keypair is added from can be one of two values defined in constants or device name (custom)
	Clock                   uint64      `json:"clock,omitempty"`
	Accounts                []*Account  `json:"accounts,omitempty"`
	Keycards                []*Keycard  `json:"keycards,omitempty"`
	Removed                 bool        `json:"removed,omitempty"`
}

func GetPrivKeyImportedKeypairForTest added in v0.152.2

func GetPrivKeyImportedKeypairForTest() *Keypair

func GetProfileKeypairForTest added in v0.152.2

func GetProfileKeypairForTest(includeChatAccount bool, includeDefaultWalletAccount bool, includeAdditionalAccounts bool) *Keypair

func GetSeedImportedKeypair1ForTest added in v0.152.2

func GetSeedImportedKeypair1ForTest() *Keypair

func GetSeedImportedKeypair2ForTest added in v0.152.2

func GetSeedImportedKeypair2ForTest() *Keypair

func (*Keypair) CopyKeypair added in v0.152.2

func (a *Keypair) CopyKeypair() *Keypair

func (*Keypair) GetChatPublicKey added in v0.154.2

func (a *Keypair) GetChatPublicKey() types.HexBytes

func (*Keypair) MarshalJSON added in v0.152.2

func (a *Keypair) MarshalJSON() ([]byte, error)

type KeypairType added in v0.152.2

type KeypairType string
const (
	KeypairTypeProfile KeypairType = "profile"
	KeypairTypeKey     KeypairType = "key"
	KeypairTypeSeed    KeypairType = "seed"
)

func (KeypairType) String added in v0.152.2

func (a KeypairType) String() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL