msp

type CSPNewOpts struct {
	Version MSPVersion
}

type Configuration struct {
	// OrganizationalUnitIdentifiers 是 OUs 列表。如果设置了此值，则 MSP 将认为只有包含这些 OUs 中的至少一个的标识才是有效的。
	OrganizationalUnitIdentifiers []*OrganizationalUnitIdentifiersConfiguration `yaml:"OrganizationalUnitIdentifiers,omitempty"`
	// NodeOUs 使 MSP 能够根据身份的 OU 区分 clients、peers 和 orderers。
	NodeOUs *NodeOUs `yaml:"NodeOUs,omitempty"`
}

type Identity interface {
	// ExpiresAt 返回身份的过期时间。
	ExpiresAt() time.Time

	// GetIdentifier 获取身份标识。
	GetIdentifier() *IdentityIdentifier

	// GetMSPIdentifier 获取 msp 的标识符。
	GetMSPIdentifier() string

	// Validate 验证身份的正确性。
	Validate() error

	// GetOrganizationalUnits 返回与此身份关联的组织单元。
	GetOrganizationalUnits() []*OUIdentifier

	// Anonymous 返回此身份是否是匿名的。
	Anonymous() bool

	// Verify 验证给定消息和签名的正确性。
	Verify(msg []byte, signature []byte) error

	// Serialize 将身份信息序列化成字节数组。
	Serialize() ([]byte, error)

	// SatisfiesPrinciple 检查此身份实例是否与 MSPPrinciple 中提供的描述匹配。
	SatisfiesPrinciple(principal *pmsp.MSPPrinciple) error
}

type IdentityDeserializer interface {
	DeserializeIdentity(serializedIdentity []byte) (Identity, error)

	// IsWellFormed 检查给定的序列化的身份是否能够反序列化成指定的形式。
	IsWellFormed(serializedIdentity *pmsp.SerializedIdentity) error
}

type IdentityIdentifier struct {
	Mspid string
	Id    string
}

type MSP interface {
	IdentityDeserializer

	Setup(config *pmsp.MSPConfig) error

	GetVersion() MSPVersion

	// GetType 目前只会返回 "csp"。
	GetType() ProviderType

	GetIdentifier() string

	GetDefaultSigningIdentity() (SigningIdentity, error)

	// GetTLSRootCerts 返回此 MSP 的根 TLS 证书。
	GetTLSRootCerts() [][]byte

	// GetTLSIntermediateCerts 返回此 MSP 的 TLS 中级证书。
	GetTLSIntermediateCerts() [][]byte

	// Validate 验证给定的身份是否合法。
	Validate(id Identity) error

	// SatisfiesPrinciple 检查给定的身份实例是否与给定的 MSPPrinciple 中提供的描述匹配。
	SatisfiesPrinciple(id Identity, principal *pmsp.MSPPrinciple) error
}

type MSPManager interface {
	IdentityDeserializer

	Setup(msps []MSP) error

	GetMSPs() map[string]MSP
}

type MSPVersion int

type NewOpts interface {
	GetVersion() MSPVersion
}

type NodeOUs struct {
	Enable bool `yaml:"Enable,omitempty"`
	// ClientOUIdentifier 规定了如何根据 OU 识别 clients。
	ClientOUIdentifier *OrganizationalUnitIdentifiersConfiguration `yaml:"ClientOUIdentifier,omitempty"`
	// PeerOUIdentifier 规定了如何根据 OU 识别 peers。
	PeerOUIdentifier *OrganizationalUnitIdentifiersConfiguration `yaml:"PeerOUIdentifier,omitempty"`
	// AdminOUIdentifier 规定了如何根据 OU 识别 admins。
	AdminOUIdentifier *OrganizationalUnitIdentifiersConfiguration `yaml:"AdminOUIdentifier,omitempty"`
	// OrdererOUIdentifier 规定了如何根据 OU 识别 orderers。
	OrdererOUIdentifier *OrganizationalUnitIdentifiersConfiguration `yaml:"OrdererOUIdentifier,omitempty"`
}

type OUIdentifier struct {
	// CertifiersIdentifier 一连串证书链的标识符（哈希值），由同一个机构签发的不同证书，
	// 所计算出来的 CertifiersIdentifier 是一样的。
	CertifiersIdentifier []byte
	// OrganizationalUnitIdentifier 组织单元标识符。
	OrganizationalUnitIdentifier string
}

type OrganizationalUnitIdentifiersConfiguration struct {
	// Certificate 表示根证书或中级证书的存放路径。
	Certificate string `yaml:"Certificate,omitempty"`
	// OrganizationalUnitIdentifier 表示组织单元的名字。
	OrganizationalUnitIdentifier string `yaml:"OrganizationalUnitIdentifier,omitempty"`
}

type ProviderType int

type SigningIdentity interface {
	Identity

	Sign(msg []byte) ([]byte, error)

	// GetPublicVersion 返回此身份的公开部分。
	GetPublicVersion() Identity
}