address

package
v0.52.0-beta.1 Latest Latest
Warning

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

Go to latest
Published: Sep 11, 2024 License: Apache-2.0 Imports: 8 Imported by: 1,048

README

Account

This package defines Cosmos SDK address-related functions.

References

Documentation

Index

Constants

View Source
const Len = sha256.Size

Len is the length of base addresses

View Source
const MaxAddrLen = 255

MaxAddrLen is the maximum allowed length (in bytes) for an address.

Variables

This section is empty.

Functions

func Compose

func Compose(typ string, subAddresses []Addressable) ([]byte, error)

Compose creates a new address based on sub addresses.

func Derive

func Derive(address, key []byte) []byte

Derive derives a new address from the main `address` and a derivation `key`. This function is used to create a sub accounts. To create a module accounts use the `Module` function.

func Hash

func Hash(typ string, key []byte) []byte

Hash creates a new address from address type and key. The functions should only be used by new types defining their own address function (eg public keys).

func LengthPrefix

func LengthPrefix(bz []byte) ([]byte, error)

LengthPrefix prefixes the address bytes with its length, this is used for example for variable-length components in store keys.

func Module

func Module(moduleName string, derivationKeys ...[]byte) []byte

Module is a specialized version of a composed address for modules. Each module account is constructed from a module name and a sequence of derivation keys (at least one derivation key must be provided). The derivation keys must be unique in the module scope, and is usually constructed from some object id. Example, let's a x/dao module, and a new DAO object, its address would be:

address.Module(dao.ModuleName, newDAO.ID)

func MustLengthPrefix

func MustLengthPrefix(bz []byte) []byte

MustLengthPrefix is LengthPrefix with panic on error.

Types

type Addressable

type Addressable interface {
	Address() []byte
}

Addressable represents any type from which we can derive an address.

Jump to

Keyboard shortcuts

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