sec

type ErrPeerIDMismatch struct {
	// Expected 期望的对等节点ID
	Expected peer.ID
	// Actual 实际的对等节点ID
	Actual peer.ID
}

type SecureConn interface {
	net.Conn
	network.ConnSecurity
}

type SecureTransport interface {
	// SecureInbound 用于安全化入站连接
	// 参数：
	//   - ctx: context.Context 上下文对象，用于控制操作的生命周期
	//   - insecure: net.Conn 未加密的原始连接
	//   - p: peer.ID 对等节点ID，如果为空则接受任何对等节点的连接
	//
	// 返回值：
	//   - SecureConn: 安全的加密连接
	//   - error: 如果发生错误，返回错误信息
	SecureInbound(ctx context.Context, insecure net.Conn, p peer.ID) (SecureConn, error)

	// SecureOutbound 用于安全化出站连接
	// 参数：
	//   - ctx: context.Context 上下文对象，用于控制操作的生命周期
	//   - insecure: net.Conn 未加密的原始连接
	//   - p: peer.ID 目标对等节点ID
	//
	// 返回值：
	//   - SecureConn: 安全的加密连接
	//   - error: 如果发生错误，返回错误信息
	SecureOutbound(ctx context.Context, insecure net.Conn, p peer.ID) (SecureConn, error)

	// ID 返回安全协议的协议ID
	// 返回值：
	//   - protocol.ID: 协议标识符
	ID() protocol.ID
}