Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

age

package module

Go to main page

Versions in this module

v1

v1.5.0

Apr 13, 2026

Changes in this version

type Identity

+ func GeneratePQIdentity(kem PQKemType) (Identity, error)

+ type PQKemType string

+ const DefaultPQKemEnv

+ const PQKemHPKEMLKEM768X25519

+ const PQKemXWing

+ func SupportedPQKems() []PQKemType

+ type XWingIdentity struct

+ func GenerateXWingIdentity() (*XWingIdentity, error)

+ func ParseXWingIdentity(s string) (*XWingIdentity, error)

+ func (i *XWingIdentity) Recipient() *XWingRecipient

+ func (i *XWingIdentity) String() string

+ func (i *XWingIdentity) Unwrap(stanzas []*Stanza) ([]byte, error)

+ type XWingRecipient struct

+ func ParseXWingRecipient(s string) (*XWingRecipient, error)

+ func (r *XWingRecipient) String() string

+ func (r *XWingRecipient) Wrap(fileKey []byte) ([]*Stanza, error)

+ func (r *XWingRecipient) WrapWithLabels(fileKey []byte) ([]*Stanza, []string, error)

v1.4.0

Apr 9, 2026

Changes in this version

+ var ErrIncorrectIdentity = errors.New("incorrect identity for recipient block")

+ func Decrypt(src io.Reader, identities ...Identity) (io.Reader, error)

+ func DecryptHeader(header []byte, identities ...Identity) ([]byte, error)

+ func DecryptReaderAt(src io.ReaderAt, encryptedSize int64, identities ...Identity) (io.ReaderAt, int64, error)

+ func Encrypt(dst io.Writer, recipients ...Recipient) (io.WriteCloser, error)

+ func EncryptReader(src io.Reader, recipients ...Recipient) (io.Reader, error)

+ func ExtractHeader(src io.Reader) ([]byte, error)

+ type HybridIdentity struct

+ func GenerateHybridIdentity() (*HybridIdentity, error)

+ func ParseHybridIdentity(s string) (*HybridIdentity, error)

+ func (i *HybridIdentity) Recipient() *HybridRecipient

+ func (i *HybridIdentity) String() string

+ func (i *HybridIdentity) Unwrap(stanzas []*Stanza) ([]byte, error)

+ type HybridRecipient struct

+ func ParseHybridRecipient(s string) (*HybridRecipient, error)

+ func (r *HybridRecipient) String() string

+ func (r *HybridRecipient) Wrap(fileKey []byte) ([]*Stanza, error)

+ func (r *HybridRecipient) WrapWithLabels(fileKey []byte) ([]*Stanza, []string, error)

+ type Identity interface

+ Unwrap func(stanzas []*Stanza) (fileKey []byte, err error)

+ func NewInjectedFileKeyIdentity(fileKey []byte) Identity

+ func ParseIdentities(f io.Reader) ([]Identity, error)

+ type NoIdentityMatchError struct

+ Errors []error

+ StanzaTypes []string

+ func (e *NoIdentityMatchError) Error() string

+ func (e *NoIdentityMatchError) Unwrap() []error

+ type Recipient interface

+ Wrap func(fileKey []byte) ([]*Stanza, error)

+ func ParseRecipients(f io.Reader) ([]Recipient, error)

+ type RecipientWithLabels interface

+ WrapWithLabels func(fileKey []byte) (s []*Stanza, labels []string, err error)

+ type ScryptIdentity struct

+ func NewScryptIdentity(password string) (*ScryptIdentity, error)

+ func (i *ScryptIdentity) SetMaxWorkFactor(logN int)

+ func (i *ScryptIdentity) Unwrap(stanzas []*Stanza) ([]byte, error)

+ type ScryptRecipient struct

+ func NewScryptRecipient(password string) (*ScryptRecipient, error)

+ func (r *ScryptRecipient) SetWorkFactor(logN int)

+ func (r *ScryptRecipient) Wrap(fileKey []byte) ([]*Stanza, error)

+ func (r *ScryptRecipient) WrapWithLabels(fileKey []byte) (stanzas []*Stanza, labels []string, err error)

+ type Stanza struct

+ Args []string

+ Body []byte

+ Type string

+ type X25519Identity struct

+ func GenerateX25519Identity() (*X25519Identity, error)

+ func ParseX25519Identity(s string) (*X25519Identity, error)

+ func (i *X25519Identity) Recipient() *X25519Recipient

+ func (i *X25519Identity) String() string

+ func (i *X25519Identity) Unwrap(stanzas []*Stanza) ([]byte, error)

+ type X25519Recipient struct

+ func ParseX25519Recipient(s string) (*X25519Recipient, error)

+ func (r *X25519Recipient) String() string

+ func (r *X25519Recipient) Wrap(fileKey []byte) ([]*Stanza, error)