Wallets

Wallets

Wallet

struct Wallet {
  bytes32 membersIdsHash;
  bytes32 publicKeyX;
  bytes32 publicKeyY;
}

Data

struct Data {
  mapping(bytes32 => struct Wallets.Wallet) registry;
  uint256[49] __gap;
}

validatePublicKey

function validatePublicKey(struct Wallets.Data self, bytes publicKey) internal view

Performs preliminary validation of a new group public key. The group public key must be unique and have 64 bytes in length. If the validation fails, the function reverts. This function must be called first for a public key of a wallet added with addWallet function.

Parameters

addWallet

function addWallet(struct Wallets.Data self, bytes32 membersIdsHash, bytes publicKey) internal returns (bytes32 walletID, bytes32 publicKeyX, bytes32 publicKeyY)

Registers a new wallet. This function does not validate parameters. The code calling this function must call validatePublicKey first.

Uses a public key hash as a unique identifier of a wallet.

Parameters

Return Values

deleteWallet

function deleteWallet(struct Wallets.Data self, bytes32 walletID) internal

Deletes wallet with the given ID from the registry. Reverts if wallet with the given ID has not been registered or if it has already been closed.

isWalletRegistered

function isWalletRegistered(struct Wallets.Data self, bytes32 walletID) internal view returns (bool)

Checks if a wallet with the given ID is registered.

Parameters

Return Values

getWalletMembersIdsHash

function getWalletMembersIdsHash(struct Wallets.Data self, bytes32 walletID) internal view returns (bytes32)

Returns Keccak256 hash of the wallet signing group members identifiers array. Group members do not include operators selected by the sortition pool that misbehaved during DKG. Reverts if wallet with the given ID is not registered.

Parameters

Return Values

getWalletPublicKeyCoordinates

function getWalletPublicKeyCoordinates(struct Wallets.Data self, bytes32 walletID) internal view returns (bytes32 x, bytes32 y)

Gets public key of a wallet with the given wallet ID. The public key is returned as X and Y coordinates. Reverts if wallet with the given ID is not registered.

Parameters

Return Values

getWalletPublicKey

function getWalletPublicKey(struct Wallets.Data self, bytes32 walletID) internal view returns (bytes)

Gets public key of a wallet with the given wallet ID. The public key is returned in an uncompressed format as a 64-byte concatenation of X and Y coordinates. Reverts if wallet with the given ID is not registered.

Parameters

Return Values