thirdparty

Documentation

Index

• func GetAsciiBaseDomain(domain string) (string, error)
• func VerifyDomainNameOwnership(ctx context.Context, owner *common.Account, domain string) (bool, error)
• type BlockchainMessage
  • func DecodeBlockchainMessage(payload []byte) (*BlockchainMessage, error)
  • func NewNaclBoxBlockchainMessage(senderDomain string, plaintextMessage string, sender *common.Account, ...) (*BlockchainMessage, error)
  • func (m *BlockchainMessage) Encode() ([]byte, error)
  • func (m *BlockchainMessage) ToProto(sender *common.Account, signature string, ts time.Time) (*chatpb.ChatMessage, error)
• type BlockchainMessageType
• type DomainVerifier

Functions

func GetAsciiBaseDomain

func GetAsciiBaseDomain(domain string) (string, error)

GetAsciiBaseDomain gets the ASCII base domain for a given string.

func VerifyDomainNameOwnership

func VerifyDomainNameOwnership(ctx context.Context, owner *common.Account, domain string) (bool, error)

VerifyDomainNameOwnership verifies a public key owns a domain. It is the official DomainValidator implementation.

todo: this needs caching todo: improve testing so we don't have to go out to app.getcode.com

Types

type BlockchainMessage

type BlockchainMessage struct {
	Type             BlockchainMessageType
	Version          uint8
	Flags            uint32
	SenderDomain     string // Subdomains are allowed, but unused. There could be something there as a feature.
	ReceiverAccount  *common.Account
	Nonce            []byte
	EncryptedMessage []byte
}

BlockchainMessage is an encrypted message, plus associated metadata, sent over the blockchain.

func DecodeBlockchainMessage

func DecodeBlockchainMessage(payload []byte) (*BlockchainMessage, error)

DecodeBlockchainMessages attempts to decode a byte payload into a BlockchainMessage

func NewNaclBoxBlockchainMessage

func NewNaclBoxBlockchainMessage(
	senderDomain string,
	plaintextMessage string,
	sender *common.Account,
	receiver *common.Account,
) (*BlockchainMessage, error)

NewNaclBoxBlockchainMessage returns a new BlockchainMessage using a NCAL box where the shared key is derived using ECDH.

func (*BlockchainMessage) Encode

func (m *BlockchainMessage) Encode() ([]byte, error)

Encode encodes the BlockchainMessage into a format compatible with the Solana memo instruction.

func (*BlockchainMessage) ToProto

func (m *BlockchainMessage) ToProto(
	sender *common.Account,
	signature string,
	ts time.Time,
) (*chatpb.ChatMessage, error)

ToProto creates the proto representation of a BlockchainMessage

type BlockchainMessageType

type BlockchainMessageType uint8

const (
	NaclBoxBlockchainMessage BlockchainMessageType = iota
)

type DomainVerifier

type DomainVerifier func(ctx context.Context, owner *common.Account, domain string) (bool, error)

DomainVerifier is a validation function to verify if a public key is owned by a domain. Implementations are not responsible for verifying the owner account via a signature, and must occur at the system requiring domain verification.